> ## 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 Code 文档](https://code.claude.com/docs/en/setup) 进行安装。

## 配置 MiniMax API

<Warning>
  **重要提示**：

  在配置前，请确保清除以下 Anthropic 相关的环境变量，以免影响 MiniMax API 的正常使用：

  * `ANTHROPIC_AUTH_TOKEN`
  * `ANTHROPIC_BASE_URL`

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

  若以上变量在 `~/.bashrc` / `~/.zshrc` 中被永久导出，请同步删除对应行，否则新开 shell 会再次注入。
</Warning>

<Steps>
  <Step title="API 配置">
    <Tabs>
      <Tab title="使用 cc-switch（推荐）">
        [cc-switch](https://github.com/farion1231/cc-switch) 是一个便捷的工具，可以快速切换 Claude Code 的 API 配置。

        **1. 安装 cc-switch**

        <Tabs>
          <Tab title="macOS / Linux">
            ```bash theme={null}
            brew tap farion1231/ccswitch
            brew install --cask cc-switch
            brew upgrade --cask cc-switch
            ```
          </Tab>

          <Tab title="Windows">
            前往 [cc-switch GitHub Releases](https://github.com/farion1231/cc-switch/releases) 页面下载最新版本的安装包。
          </Tab>
        </Tabs>

        **2. 添加 MiniMax 配置**

        启动 cc-switch，点击右上角 **"+"** ，选择预设的 MiniMax 供应商，并填写从 [MiniMax 开放平台](https://platform.minimaxi.com/user-center/payment/token-plan) (国际用户可访问 [MiniMax Developer Platform](https://platform.minimax.io/user-center/payment/token-plan)) 获取的 MiniMax API Key。 <img src="https://filecdn.minimax.chat/public/0acbfee9-8871-4171-af19-e318476456a4.png" alt="choose" />

        **3. 配置模型名称**

        将模型名称全部改为 `MiniMax-M2.7`，完成后点击右下角的 **"添加"**。 <img src="https://filecdn.minimax.chat/public/1ceadee0-5488-44a1-82bb-94af0fc8d3b7.png" alt="add" />

        **4. 启用配置**

        回到首页，点击 **"启用"** <img src="https://filecdn.minimax.chat/public/0c5cbe27-1a6d-4583-9ad9-b48222055c3b.png" alt="start" />

        **5. 编辑配置文件**

        编辑或新增 `.claude.json` 文件，MacOS & Linux 为 `~/.claude.json`，Windows 为`用户目录/.claude.json`

        ```json theme={null}
        # 新增 `hasCompletedOnboarding` 参数
        {
          "hasCompletedOnboarding": true
        }
        ```
      </Tab>

      <Tab title="手动编辑配置文件">
        ```json theme={null}
        # Stpe1: 编辑或创建 Claude Code 的配置文件
        # MacOS & Linux 为 `~/.claude/settings.json`
        # Windows 为`用户目录/.claude/settings.json`
        # `MINIMAX_API_KEY` 需替换为您的 MiniMax API Key
        # 环境变量 `ANTHROPIC_AUTH_TOKEN` 和 `ANTHROPIC_BASE_URL` 优先级高于配置文件
        {
          "env": {
            "ANTHROPIC_BASE_URL": "https://api.minimaxi.com/anthropic",
            "ANTHROPIC_AUTH_TOKEN": "MINIMAX_API_KEY",
            "API_TIMEOUT_MS": "3000000",
            "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
            "ANTHROPIC_MODEL": "MiniMax-M2.7",
            "ANTHROPIC_DEFAULT_SONNET_MODEL": "MiniMax-M2.7",
            "ANTHROPIC_DEFAULT_OPUS_MODEL": "MiniMax-M2.7",
            "ANTHROPIC_DEFAULT_HAIKU_MODEL": "MiniMax-M2.7"
          }
        }
        # Step2: 编辑或新增 `.claude.json` 文件
        # MacOS & Linux 为 `~/.claude.json`
        # Windows 为`用户目录/.claude.json`
        # 新增 `hasCompletedOnboarding` 参数
        {
          "hasCompletedOnboarding": true
        }
        ```
      </Tab>
    </Tabs>
  </Step>

  <Step title="启动 Claude Code">
    配置完成后，进入工作目录，在终端中运行 `claude` 命令以启动 Claude Code
  </Step>

  <Step title="信任文件夹">
    启动后，选择 **信任此文件夹 (Trust This Folder)**，以允许 Claude Code 访问该文件夹中的文件，随后开始在 Claude Code 中使用 MiniMax-M2.7

    ![](https://filecdn.minimax.chat/public/7ca00f05-81bd-4058-a357-3bb79eabd738.jpg)
  </Step>
</Steps>

<Warning>
  **重要提示**：

  在配置完成后，如果您还想要使用 图片理解 & 网络搜索 能力，则需要根据 [此教程](https://platform.minimaxi.com/docs/token-plan/mcp-guide) 来配置图片理解 & 网络搜索 MCP
</Warning>

## 验证配置生效

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

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

* `/status` 应显示 `ANTHROPIC_BASE_URL` 指向 `api.minimaxi.com/anthropic`（国际用户为 `api.minimax.io/anthropic`）。
* `/model` 应显示当前模型为 `MiniMax-M2.7`。

## 在 Claude Code for VS Code 插件中使用

<Steps>
  <Step title="安装插件">
    安装 Claude Code for VS Code 插件

    <img src="https://filecdn.minimax.chat/public/6939e914-b090-4f4f-9c0b-1e394828c23c.jpg" width="80%" />
  </Step>

  <Step title="打开设置">
    完成安装后，点击 **Settings**

    ![](https://filecdn.minimax.chat/public/d538a295-18e1-4381-ab35-3cfd2fbb7cfc.png)
  </Step>

  <Step title="配置模型">
    配置模型为 `MiniMax-M2.7`

    * Settings → `Claude Code: Selected Model` 输入 `MiniMax-M2.7`

    ![](https://filecdn.minimax.chat/public/058af0b8-0db8-4d90-9ef5-73690c643227.png)

    或者

    * 点击 **Edit in settings.json**，进入配置文件，修改 `claude-code.selectedModel` 为 `MiniMax-M2.7`

    ```json theme={null}
    {
      "claudeCode.preferredLocation": "panel",
      "claudeCode.selectedModel": "minimax-m2.7",
      "claudeCode.environmentVariables": []
    }
    ```
  </Step>

  <Step title="配置环境变量">
    * 若已安装 Claude Code，请参考上方配置进行环境变量配置
    * 若尚未安装 Claude Code，点击 `Edit in settings.json`

    ![](https://filecdn.minimax.chat/public/c875e19d-7741-4068-880d-830834651ed2.png)

    将 `claudeCode.environmentVariables` 变量更改为以下设置：

    ```json theme={null}
    "claudeCode.environmentVariables": [
      {
        "name": "ANTHROPIC_BASE_URL",
        "value": "https://api.minimaxi.com/anthropic"
      },
      {
        "name": "ANTHROPIC_AUTH_TOKEN",
        "value": "<MINIMAX_API_KEY>"
      },
      {
        "name": "API_TIMEOUT_MS",
        "value": "3000000"
      },
      {
        "name": "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC",
        "value": "1"
      },
      {
        "name": "ANTHROPIC_MODEL",
        "value": "MiniMax-M2.7"
      },
      {
        "name": "ANTHROPIC_DEFAULT_SONNET_MODEL",
        "value": "MiniMax-M2.7"
      },
      {
        "name": "ANTHROPIC_DEFAULT_OPUS_MODEL",
        "value": "MiniMax-M2.7"
      },
      {
        "name": "ANTHROPIC_DEFAULT_HAIKU_MODEL",
        "value": "MiniMax-M2.7"
      }
    ],
    ```
  </Step>
</Steps>