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

# Claude Code

> 在 Claude Code 中使用最新的 MiniMax M 系列模型进行 AI 编程。

<div style={{background:"#fffbeb",borderLeft:"4px solid #d97706",padding:"12px 16px",borderRadius:"6px",margin:"16px 0"}}>[**Claude Code**](https://github.com/anthropics/claude-code) 是 Anthropic 出品的官方终端原生编程 Agent，由 Claude 驱动。</div>

## 安装 Claude Code

如果使用下方一键配置向导，可跳过本节。向导检测不到 `claude` 命令时，会询问是否运行 Claude Code 官方安装脚本。

可参考 [Claude Code 文档](https://code.claude.com/docs/en/setup) 进行安装。

## 配置 MiniMax API

<Warning>
  配置前请清除以下环境变量，它们的优先级高于配置文件，会覆盖 MiniMax 设置：

  ```bash theme={null}
  unset ANTHROPIC_AUTH_TOKEN
  unset ANTHROPIC_BASE_URL
  ```

  如果 `~/.bashrc` 或 `~/.zshrc` 中导出了这两个变量，请同时删除对应行，否则新开的终端会重新加载。
</Warning>

<Tabs sync={false}>
  <Tab title="方式一：一键配置向导">
    直接运行：

    ```bash theme={null}
    npx -y mmx-cli@latest agent setup
    ```

    在工具列表中选择 **Claude Code**。如果尚未安装，在第二个多选列表中保留 Claude Code。向导会运行官方安装脚本并检查 `claude --version`，然后更新 `~/.claude/settings.json`，配置 MiniMax 模型列表。

    命令参数与备份说明见 [MiniMax CLI](/docs/m-plan/minimax-cli)。
  </Tab>

  <Tab title="方式二：手动编辑配置文件">
    1. 编辑或创建 `~/.claude/settings.json`（Windows 为 `用户目录\.claude\settings.json`），将 `<MINIMAX_API_KEY>` 替换为你的 [订阅 Key](https://platform.minimax.cn/console/plan)：

       ```json theme={null}
       {
         "env": {
           "ANTHROPIC_BASE_URL": "https://api.minimax.cn/anthropic",
           "ANTHROPIC_AUTH_TOKEN": "<MINIMAX_API_KEY>",
           "CLAUDE_CODE_AUTO_COMPACT_WINDOW": "524288",
           "ANTHROPIC_MODEL": "MiniMax-M3.1-Flash-Preview[1m]",
           "ANTHROPIC_DEFAULT_SONNET_MODEL": "MiniMax-M3.1-Flash-Preview[1m]",
           "ANTHROPIC_DEFAULT_OPUS_MODEL": "MiniMax-M3.1-Flash-Preview[1m]",
           "ANTHROPIC_DEFAULT_HAIKU_MODEL": "MiniMax-M3.1-Flash-Preview[1m]"
         }
       }
       ```

    2. 编辑或创建 `~/.claude.json`（Windows 为 `用户目录\.claude.json`），加入：

       ```json theme={null}
       {
         "hasCompletedOnboarding": true
       }
       ```

    3. 进入工作目录，运行 `claude`，选择 **信任此文件夹（Trust This Folder）** 后即可开始使用。

    手动示例使用推荐的 512K 自动压缩窗口（`CLAUDE_CODE_AUTO_COMPACT_WINDOW=524288`），详见[512K 配置建议](/docs/m-plan/codex#context-window-512k)。
  </Tab>

  <Tab title="方式三：使用 cc-switch">
    [cc-switch](https://github.com/farion1231/cc-switch) 可以快速切换 Claude Code 的 API 配置。

    1. 安装 cc-switch：macOS / Linux 运行 `brew tap farion1231/ccswitch && brew install --cask cc-switch`；Windows 从 [GitHub Releases](https://github.com/farion1231/cc-switch/releases) 下载安装包。
    2. 启动 cc-switch，点击右上角 **+**，选择预设的 MiniMax 供应商，填入你的 [订阅 Key](https://platform.minimax.cn/console/plan)。
    3. 将所有模型名称改为 `MiniMax-M3.1-Flash-Preview`，勾选 **声明支持1M**。
    4. 在该供应商配置 JSON 的 `env` 中加入 `"CLAUDE_CODE_AUTO_COMPACT_WINDOW": "524288"`，然后点击右下角 **添加**。
    5. 回到首页，点击 **启用**。
    6. 按「方式二」第 2 步在 `~/.claude.json` 中加入 `hasCompletedOnboarding`。
  </Tab>
</Tabs>

配置完成后如需网络搜索，请参考 [网络搜索 MCP](/docs/m-plan/mcp-guide)。

## 验证配置生效

启动 `claude` 后，在 TUI 中依次输入以下 slash 命令，确认已切换到 MiniMax：

```text theme={null}
/status
/model
```

* `/status` 应显示 `ANTHROPIC_BASE_URL` 指向 `api.minimax.cn/anthropic`。
* `/model` 应显示当前模型为 `MiniMax-M3.1-Flash-Preview`。

<Tip>
  MiniMax-M3.1-Flash-Preview 默认开启思考且不可关闭。
</Tip>