> ## Documentation Index
> Fetch the complete documentation index at: https://agent.minimaxi.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 下载与安装

> 下载 MiniMax Code 桌面端，并在 macOS 或 Windows 上完成安装。

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

## 下载地址

> [card] [国内版](https://code.minimax.cn/about)
>
> 适合中国大陆用户访问。

> [card] [海外版](https://code.minimax.io/about)
>
> 适合海外网络环境访问。

## 系统要求

| 平台 | 要求 |
| - | - |
| macOS | macOS 12 Monterey 及以上 |
| Windows | Windows 10 及以上 |

## 安装步骤

**1. 下载安装包**

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

**2. 安装应用**

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

**3. 登录账号**

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

**4. 检查更新**

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

## 使用 Homebrew 安装

> [!NOTE]
>
> Homebrew 仅支持 macOS。Windows 用户请使用上方的安装包。

在已安装 Homebrew 的 Mac 上，可以用 cask 直接安装 MiniMax Code：

```bash theme={null}
# 国内版
brew install --cask minimax-ai/tap/minimax-code

# 海外版
brew install --cask minimax-ai/tap/minimax-code --language=en
```

* 不传 `--language` 时默认安装国内版
* 命令会自动添加对应的 tap，无需先手动执行 `brew tap`
* 地区选择会被记录，之后执行 `brew upgrade` 会沿用同一版本
* cask 要求 macOS 12 Monterey 及以上；在更早的系统上会停止安装并提示前往官网

更新到最新版本：

```bash theme={null}
brew upgrade --cask minimax-ai/tap/minimax-code
```

## 安装遇到问题

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

### macOS

> [accordion] 提示「这个版本不能与此版本的 macOS 配合使用」
>
> 请先检查系统版本，再确认安装包与你的 Mac 芯片匹配。
>
> 1. 打开屏幕左上角的 **苹果菜单 › 关于本机**，查看 macOS 版本。当前版本需要 macOS 12 Monterey 及以上，macOS 11 Big Sur 不受支持
> 2. 查看「芯片」或「处理器」：Apple M 系列下载 arm64，Intel 下载 x64
> 3. 如果系统版本过低，先通过 **系统设置 › 通用 › 软件更新** 更新系统；较早系统的入口是 **系统偏好设置 › 软件更新**
>
> 如果这台 Mac 无法升级到受支持的系统，重新下载安装包也不能解决兼容性问题。

> [accordion] 提示「已损坏，无法打开」
>
> 这表示 macOS 检测到应用被修改或损坏。先换用官方下载页当前提供的安装包，排除旧包或下载不完整的情况。
>
> 1. 退出 MiniMax Code，将「应用程序」中的 MiniMax Code 应用移到废纸篓；只移除应用，不删除本地数据目录
> 2. 回到本页「下载地址」，用浏览器重新下载与你芯片匹配的安装包，不要重复使用原来的 .dmg
> 3. 等下载完成后打开 .dmg，将 MiniMax Code 拖入「应用程序」，再从「应用程序」启动
>
> 如果仍出现相同提示，请记录安装包文件名和完整提示，按下方「仍然无法解决」反馈。不要反复重装，也不要通过终端修改应用签名或关闭系统安全检查。

> [accordion] 提示「包含恶意软件」「将损坏你的电脑」，或应用被移到废纸篓
>
> 这类提示与「无法验证开发者」不同，请不要按下一条的「仍要打开」操作。
>
> MiniMax Code 曾有旧版本因签名证书问题被系统拦截，维护者已重新签名并替换当时的安装包。但相似提示不一定都是同一个原因，不能直接当作误报。
>
> 1. 停止运行当前被拦截的应用，不从废纸篓恢复它
> 2. 回到本页「下载地址」，重新下载当前官方安装包，拖入「应用程序」后再试
> 3. 如果新下载的官方包仍被拦截，保留错误截图和安装包文件名，按下方「仍然无法解决」反馈，等待核查
>
> 不要关闭系统防护或自行重新签名。历史问题的处理记录见 [GitHub Issue #95](https://github.com/MiniMax-AI/minimax-code/issues/95)。

> [accordion] 提示「无法验证开发者」或「Apple 无法检查是否包含恶意软件」
>
> 这表示 macOS 无法验证应用的开发者身份或公证信息，不能仅凭提示判断是网络问题。请先确认安装包来自本页的官方下载地址，且未被修改；确认可信后，再按以下步骤操作。
>
> 1. 点「完成」或「取消」关闭提示
> 2. 打开 **系统设置 › 隐私与安全性**，滚动到「安全性」
> 3. 找到 MiniMax Code 被阻止的说明，点「仍要打开」
> 4. 按提示输入 Mac 登录密码，再点「打开」
>
> macOS 12 的路径是 **系统偏好设置 › 安全性与隐私 › 通用**。
>
> 如果没有「仍要打开」按钮、设备由公司管理，或你无法确认安装包是否可信，请联系 IT 管理员或按下方「仍然无法解决」反馈。

### Windows

> [accordion] 提示「Windows 已保护你的电脑」
>
> 这是 Microsoft Defender SmartScreen 的信誉检查提示，新发布的安装包可能尚未积累足够信誉。它与杀毒软件检测到具体威胁是不同的情况。
>
> 1. 确认安装包来自本页的官方下载地址，再点 **更多信息** 查看应用名称和发布者
> 2. 确认来源和发布者可信后，点 **仍要运行**
>
> 如果发布者未知、信息不符，或没有「仍要运行」按钮，请停止安装并按下方「仍然无法解决」反馈。公司管理的电脑可能限制运行，请联系 IT 管理员处理。

> [accordion] 安装包被安全软件隔离或删除
>
> 先确认是哪款安全软件拦截了哪个文件，再判断下一步，不要直接关闭防护或把整个安装目录加入白名单。
>
> 1. 如果使用 Windows 自带防护，打开 **Windows 安全中心 › 病毒和威胁防护 › 保护历史记录**；其他安全软件查看「隔离区」或「查杀记录」
> 2. 展开对应记录，保存威胁名称、被拦截的文件路径和截图
> 3. 按下方「仍然无法解决」反馈，由支持人员核查；经确认属于误报后，再按安全软件或 IT 管理员的指引恢复对应文件并重新安装
>
> 未确认原因前，反复下载同一个安装包通常仍会被拦截。如果没有拦截记录，请按下方「安装后仍无法启动」排查。

> [accordion] 点击登录后打不开浏览器，提示「找不到应用程序」
>
> 如果出现 `Failed to open: 找不到应用程序。 (0x800401F5)` 或 `no_default_browser`，请检查默认浏览器设置。
>
> 1. 确认已安装 Edge、Chrome 等浏览器，并且浏览器可以正常打开网页
> 2. Windows 11：打开 **设置 › 应用 › 默认应用**，选择该浏览器并点「设置默认值」；Windows 10：在 **设置 › 应用 › 默认应用 › Web 浏览器** 中选择该浏览器
> 3. 重新打开 MiniMax Code，点击登录
>
> 如果浏览器已经打开，只是登录页报错或登录后没有返回客户端，则不属于这一问题，请记录浏览器中的提示并按下方方式反馈。

### 安装后仍无法启动

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

### 仍然无法解决

* **客户端可以打开**：按[问题反馈](https://agent.minimaxi.com/docs/code/help/feedback.md)中的步骤提交；能上传日志时附上日志上传 ID。
* **客户端装不上或打不开**：直接在浏览器中打开 [GitHub 问题反馈](https://github.com/MiniMax-AI/minimax-code/issues/new/choose)，登录 GitHub 后选择「Bug report / 问题反馈」。问题类型选 `Startup / install / update`，无法上传日志时，在 Upload ID 中填写 `cannot upload`。
* **不方便使用 GitHub**：可通过[欢迎页的飞书用户交流群](https://agent.minimaxi.com/docs/code/welcome.md#加入社群)反馈，无需先启动 MiniMax Code。

> [!NOTE]
>
> 请附上系统版本、设备芯片或处理器、安装包文件名、完整错误截图，以及已经尝试过的步骤。无法进入客户端查看版本时，可提供安装包文件名并说明「客户端无法打开」。GitHub Issue 为公开内容，请先遮盖截图或日志中的账号、密钥及私人文件信息。