> ## 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 上完成安装。

<div className="code-docs">
  MiniMax Code 支持 macOS 和 Windows。安装完成后，使用 MiniMax 账号登录即可开始创建任务。

  ## 下载地址

  <CardGroup cols={2}>
    <Card title="国内版" icon="download" href="https://agent.minimaxi.com/download">
      适合中国大陆用户访问。
    </Card>

    <Card title="海外版" icon="download" href="https://agent.minimax.io/download">
      适合海外网络环境访问。
    </Card>
  </CardGroup>

  ## 系统要求

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

  ## 安装步骤

  <Steps>
    <Step title="下载安装包">
      打开下载页，选择与你设备匹配的安装包。Apple 芯片 Mac 选择 arm64，Intel Mac 选择 x64。
    </Step>

    <Step title="安装应用">
      macOS 打开 .dmg 并拖入 Applications；Windows 运行安装程序并按提示完成。
    </Step>

    <Step title="登录账号">
      启动 MiniMax Code，使用你的 MiniMax 账号登录。
    </Step>

    <Step title="检查更新">
      后续有新版本时，应用会提示更新；也可以在设置中手动检查。
    </Step>
  </Steps>

  ## 使用 Homebrew 安装

  <Note>
    Homebrew 仅支持 macOS。Windows 用户请使用上方的安装包。
  </Note>

  在已安装 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

  <AccordionGroup>
    <Accordion title="提示「这个版本不能与此版本的 macOS 配合使用」">
      请先检查系统版本，再确认安装包与你的 Mac 芯片匹配。

      1. 打开屏幕左上角的 **苹果菜单 › 关于本机**，查看 macOS 版本。当前版本需要 macOS 12 Monterey 及以上，macOS 11 Big Sur 不受支持
      2. 查看「芯片」或「处理器」：Apple M 系列下载 arm64，Intel 下载 x64
      3. 如果系统版本过低，先通过 **系统设置 › 通用 › 软件更新** 更新系统；较早系统的入口是 **系统偏好设置 › 软件更新**

      如果这台 Mac 无法升级到受支持的系统，重新下载安装包也不能解决兼容性问题。
    </Accordion>

    <Accordion title="提示「已损坏，无法打开」">
      这表示 macOS 检测到应用被修改或损坏。先换用官方下载页当前提供的安装包，排除旧包或下载不完整的情况。

      1. 退出 MiniMax Code，将「应用程序」中的 MiniMax Code 应用移到废纸篓；只移除应用，不删除本地数据目录
      2. 回到本页「下载地址」，用浏览器重新下载与你芯片匹配的安装包，不要重复使用原来的 .dmg
      3. 等下载完成后打开 .dmg，将 MiniMax Code 拖入「应用程序」，再从「应用程序」启动

      如果仍出现相同提示，请记录安装包文件名和完整提示，按下方「仍然无法解决」反馈。不要反复重装，也不要通过终端修改应用签名或关闭系统安全检查。
    </Accordion>

    <Accordion title="提示「包含恶意软件」「将损坏你的电脑」，或应用被移到废纸篓">
      这类提示与「无法验证开发者」不同，请不要按下一条的「仍要打开」操作。

      MiniMax Code 曾有旧版本因签名证书问题被系统拦截，维护者已重新签名并替换当时的安装包。但相似提示不一定都是同一个原因，不能直接当作误报。

      1. 停止运行当前被拦截的应用，不从废纸篓恢复它
      2. 回到本页「下载地址」，重新下载当前官方安装包，拖入「应用程序」后再试
      3. 如果新下载的官方包仍被拦截，保留错误截图和安装包文件名，按下方「仍然无法解决」反馈，等待核查

      不要关闭系统防护或自行重新签名。历史问题的处理记录见 [GitHub Issue #95](https://github.com/MiniMax-AI/minimax-code/issues/95)。
    </Accordion>

    <Accordion title="提示「无法验证开发者」或「Apple 无法检查是否包含恶意软件」">
      这表示 macOS 无法验证应用的开发者身份或公证信息，不能仅凭提示判断是网络问题。请先确认安装包来自本页的官方下载地址，且未被修改；确认可信后，再按以下步骤操作。

      1. 点「完成」或「取消」关闭提示
      2. 打开 **系统设置 › 隐私与安全性**，滚动到「安全性」
      3. 找到 MiniMax Code 被阻止的说明，点「仍要打开」
      4. 按提示输入 Mac 登录密码，再点「打开」

      macOS 12 的路径是 **系统偏好设置 › 安全性与隐私 › 通用**。

      如果没有「仍要打开」按钮、设备由公司管理，或你无法确认安装包是否可信，请联系 IT 管理员或按下方「仍然无法解决」反馈。
    </Accordion>
  </AccordionGroup>

  ### Windows

  <AccordionGroup>
    <Accordion title="提示「Windows 已保护你的电脑」">
      这是 Microsoft Defender SmartScreen 的信誉检查提示，新发布的安装包可能尚未积累足够信誉。它与杀毒软件检测到具体威胁是不同的情况。

      1. 确认安装包来自本页的官方下载地址，再点 **更多信息** 查看应用名称和发布者
      2. 确认来源和发布者可信后，点 **仍要运行**

      如果发布者未知、信息不符，或没有「仍要运行」按钮，请停止安装并按下方「仍然无法解决」反馈。公司管理的电脑可能限制运行，请联系 IT 管理员处理。
    </Accordion>

    <Accordion title="安装包被安全软件隔离或删除">
      先确认是哪款安全软件拦截了哪个文件，再判断下一步，不要直接关闭防护或把整个安装目录加入白名单。

      1. 如果使用 Windows 自带防护，打开 **Windows 安全中心 › 病毒和威胁防护 › 保护历史记录**；其他安全软件查看「隔离区」或「查杀记录」
      2. 展开对应记录，保存威胁名称、被拦截的文件路径和截图
      3. 按下方「仍然无法解决」反馈，由支持人员核查；经确认属于误报后，再按安全软件或 IT 管理员的指引恢复对应文件并重新安装

      未确认原因前，反复下载同一个安装包通常仍会被拦截。如果没有拦截记录，请按下方「安装后仍无法启动」排查。
    </Accordion>

    <Accordion title="点击登录后打不开浏览器，提示「找不到应用程序」">
      如果出现 `Failed to open: 找不到应用程序。 (0x800401F5)` 或 `no_default_browser`，请检查默认浏览器设置。

      1. 确认已安装 Edge、Chrome 等浏览器，并且浏览器可以正常打开网页
      2. Windows 11：打开 **设置 › 应用 › 默认应用**，选择该浏览器并点「设置默认值」；Windows 10：在 **设置 › 应用 › 默认应用 › Web 浏览器** 中选择该浏览器
      3. 重新打开 MiniMax Code，点击登录

      如果浏览器已经打开，只是登录页报错或登录后没有返回客户端，则不属于这一问题，请记录浏览器中的提示并按下方方式反馈。
    </Accordion>
  </AccordionGroup>

  ### 安装后仍无法启动

  <AccordionGroup>
    <Accordion title="双击没有反应、窗口一闪就退出，或提示「服务启动失败」">
      这些现象可能有不同原因。请先完成以下检查，不要把它们直接归因于安装位置或网络。

      1. 确认系统满足本页「系统要求」。macOS 还需确认已将应用拖入「应用程序」，并从那里启动
      2. 保存其他工作后重启电脑，再尝试打开 MiniMax Code，排除残留进程的影响
      3. 如果是旧版本，或更新后才出现问题，从本页「下载地址」重新下载当前安装包并安装；不要手动删除 MiniMax Code 的本地配置或会话数据
      4. 仍然失败时，记录是「没有窗口」「窗口闪退」还是「服务启动失败」，保存弹窗中的完整错误信息，并按下方方式反馈

      Windows 用户如果没有弹窗，可以打开 **事件查看器 › Windows 日志 › 应用程序**，查找故障时间附近与 MiniMax Code 对应的错误，附上「故障模块名称」和「异常代码」（如有）。仅凭闪退现象不能确定是显卡、安装权限还是程序本身的问题。
    </Accordion>
  </AccordionGroup>

  ### 仍然无法解决

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

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