Skip to main content
MiniMax Code 支持 macOS 和 Windows。安装完成后，使用 MiniMax 账号登录即可开始创建任务。

​
下载地址

国内版

适合中国大陆用户访问。

海外版

适合海外网络环境访问。

​
系统要求

​
安装步骤

1

下载安装包

打开下载页，选择与你设备匹配的安装包。Apple 芯片 Mac 选择 arm64，Intel Mac 选择 x64。
2

安装应用

macOS 打开 .dmg 并拖入 Applications；Windows 运行安装程序并按提示完成。
3

登录账号

启动 MiniMax Code，使用你的 MiniMax 账号登录。
4

检查更新

后续有新版本时，应用会提示更新；也可以在设置中手动检查。

​
使用 Homebrew 安装

Homebrew 仅支持 macOS。Windows 用户请使用上方的安装包。
在已安装 Homebrew 的 Mac 上，可以用 cask 直接安装 MiniMax Code：
  • 不传 --language 时默认安装国内版
  • 命令会自动添加对应的 tap，无需先手动执行 brew tap
  • 地区选择会被记录，之后执行 brew upgrade 会沿用同一版本
  • cask 要求 macOS 12 Monterey 及以上；在更早的系统上会停止安装并提示前往官网
更新到最新版本：

​
安装遇到问题

请按实际看到的提示选择对应条目。如果没有明确提示，或窗口一闪就退出，请看下方的「安装后仍无法启动」。

​
macOS

请先检查系统版本，再确认安装包与你的 Mac 芯片匹配。
  1. 打开屏幕左上角的 苹果菜单 › 关于本机，查看 macOS 版本。当前版本需要 macOS 12 Monterey 及以上，macOS 11 Big Sur 不受支持
  2. 查看「芯片」或「处理器」：Apple M 系列下载 arm64，Intel 下载 x64
  3. 如果系统版本过低，先通过 系统设置 › 通用 › 软件更新 更新系统；较早系统的入口是 系统偏好设置 › 软件更新
如果这台 Mac 无法升级到受支持的系统，重新下载安装包也不能解决兼容性问题。
这表示 macOS 检测到应用被修改或损坏。先换用官方下载页当前提供的安装包，排除旧包或下载不完整的情况。
  1. 退出 MiniMax Code，将「应用程序」中的 MiniMax Code 应用移到废纸篓；只移除应用，不删除本地数据目录
  2. 回到本页「下载地址」，用浏览器重新下载与你芯片匹配的安装包，不要重复使用原来的 .dmg
  3. 等下载完成后打开 .dmg，将 MiniMax Code 拖入「应用程序」，再从「应用程序」启动
如果仍出现相同提示，请记录安装包文件名和完整提示，按下方「仍然无法解决」反馈。不要反复重装，也不要通过终端修改应用签名或关闭系统安全检查。
这类提示与「无法验证开发者」不同，请不要按下一条的「仍要打开」操作。MiniMax Code 曾有旧版本因签名证书问题被系统拦截，维护者已重新签名并替换当时的安装包。但相似提示不一定都是同一个原因，不能直接当作误报。
  1. 停止运行当前被拦截的应用，不从废纸篓恢复它
  2. 回到本页「下载地址」，重新下载当前官方安装包，拖入「应用程序」后再试
  3. 如果新下载的官方包仍被拦截，保留错误截图和安装包文件名，按下方「仍然无法解决」反馈，等待核查
不要关闭系统防护或自行重新签名。历史问题的处理记录见 GitHub Issue #95。
这表示 macOS 无法验证应用的开发者身份或公证信息，不能仅凭提示判断是网络问题。请先确认安装包来自本页的官方下载地址，且未被修改；确认可信后，再按以下步骤操作。
  1. 点「完成」或「取消」关闭提示
  2. 打开 系统设置 › 隐私与安全性，滚动到「安全性」
  3. 找到 MiniMax Code 被阻止的说明，点「仍要打开」
  4. 按提示输入 Mac 登录密码，再点「打开」
macOS 12 的路径是 系统偏好设置 › 安全性与隐私 › 通用。如果没有「仍要打开」按钮、设备由公司管理，或你无法确认安装包是否可信，请联系 IT 管理员或按下方「仍然无法解决」反馈。

​
Windows

这是 Microsoft Defender SmartScreen 的信誉检查提示，新发布的安装包可能尚未积累足够信誉。它与杀毒软件检测到具体威胁是不同的情况。
  1. 确认安装包来自本页的官方下载地址，再点 更多信息 查看应用名称和发布者
  2. 确认来源和发布者可信后，点 仍要运行
如果发布者未知、信息不符，或没有「仍要运行」按钮，请停止安装并按下方「仍然无法解决」反馈。公司管理的电脑可能限制运行，请联系 IT 管理员处理。
先确认是哪款安全软件拦截了哪个文件，再判断下一步，不要直接关闭防护或把整个安装目录加入白名单。
  1. 如果使用 Windows 自带防护，打开 Windows 安全中心 › 病毒和威胁防护 › 保护历史记录；其他安全软件查看「隔离区」或「查杀记录」
  2. 展开对应记录，保存威胁名称、被拦截的文件路径和截图
  3. 按下方「仍然无法解决」反馈，由支持人员核查；经确认属于误报后，再按安全软件或 IT 管理员的指引恢复对应文件并重新安装
未确认原因前，反复下载同一个安装包通常仍会被拦截。如果没有拦截记录，请按下方「安装后仍无法启动」排查。
如果出现 Failed to open: 找不到应用程序。 (0x800401F5) 或 no_default_browser，请检查默认浏览器设置。
  1. 确认已安装 Edge、Chrome 等浏览器，并且浏览器可以正常打开网页
  2. Windows 11：打开 设置 › 应用 › 默认应用，选择该浏览器并点「设置默认值」；Windows 10：在 设置 › 应用 › 默认应用 › Web 浏览器 中选择该浏览器
  3. 重新打开 MiniMax Code，点击登录
如果浏览器已经打开，只是登录页报错或登录后没有返回客户端，则不属于这一问题，请记录浏览器中的提示并按下方方式反馈。

​
安装后仍无法启动

这些现象可能有不同原因。请先完成以下检查，不要把它们直接归因于安装位置或网络。
  1. 确认系统满足本页「系统要求」。macOS 还需确认已将应用拖入「应用程序」，并从那里启动
  2. 保存其他工作后重启电脑，再尝试打开 MiniMax Code，排除残留进程的影响
  3. 如果是旧版本，或更新后才出现问题，从本页「下载地址」重新下载当前安装包并安装；不要手动删除 MiniMax Code 的本地配置或会话数据
  4. 仍然失败时，记录是「没有窗口」「窗口闪退」还是「服务启动失败」，保存弹窗中的完整错误信息，并按下方方式反馈
Windows 用户如果没有弹窗，可以打开 事件查看器 › Windows 日志 › 应用程序，查找故障时间附近与 MiniMax Code 对应的错误，附上「故障模块名称」和「异常代码」（如有）。仅凭闪退现象不能确定是显卡、安装权限还是程序本身的问题。

​
仍然无法解决

  • 客户端可以打开：按问题反馈中的步骤提交；能上传日志时附上日志上传 ID。
  • 客户端装不上或打不开：直接在浏览器中打开 GitHub 问题反馈，登录 GitHub 后选择「Bug report / 问题反馈」。问题类型选 Startup / install / update，无法上传日志时，在 Upload ID 中填写 cannot upload。
  • 不方便使用 GitHub：可通过欢迎页的飞书用户交流群反馈，无需先启动 MiniMax Code。
请附上系统版本、设备芯片或处理器、安装包文件名、完整错误截图，以及已经尝试过的步骤。无法进入客户端查看版本时，可提供安装包文件名并说明「客户端无法打开」。GitHub Issue 为公开内容，请先遮盖截图或日志中的账号、密钥及私人文件信息。