通过 AI 编程工具接入

​

在 Claude Code 中使用 MiniMax-M2.1（推荐）

​

安装 Claude Code

​

配置 MiniMax API

1

API 配置

• 使用 cc-switch（推荐）
• 手动编辑配置文件

cc-switch 是一个便捷的工具，可以快速切换 Claude Code 的 API 配置。1. 安装 cc-switch

• macOS / Linux
• Windows

复制

brew tap farion1231/ccswitch
brew install --cask cc-switch
brew upgrade --cask cc-switch

前往 cc-switch GitHub Releases 页面下载最新版本的安装包。

2. 添加 MiniMax 配置启动 cc-switch，点击右上角 ”+” ，选择预设的 MiniMax 供应商，并填写您的 MiniMax API Key。 3. 配置模型名称将模型名称全部改为 MiniMax-M2.1，完成后点击右下角的 “添加”。 4. 启用配置回到首页，点击 “启用” 即可开始使用。 5. 编辑配置文件编辑或新增 .claude.json 文件，MacOS & Linux 为 ~/.claude.json，Windows 为用户目录/.claude.json

复制

# 新增 `hasCompletedOnboarding` 参数
{
  "hasCompletedOnboarding": true
}

复制

       # 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.1",
           "ANTHROPIC_SMALL_FAST_MODEL": "MiniMax-M2.1",
           "ANTHROPIC_DEFAULT_SONNET_MODEL": "MiniMax-M2.1",
           "ANTHROPIC_DEFAULT_OPUS_MODEL": "MiniMax-M2.1",
           "ANTHROPIC_DEFAULT_HAIKU_MODEL": "MiniMax-M2.1"
         }
       }
       # Step2: 编辑或新增 `.claude.json` 文件
       # MacOS & Linux 为 `~/.claude.json`
       # Windows 为`用户目录/.claude.json`
       # 新增 `hasCompletedOnboarding` 参数
       {
         "hasCompletedOnboarding": true
       }

2

启动 Claude Code

配置完成后，进入工作目录，在终端中运行 claude 命令以启动 Claude Code

3

信任文件夹

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

​

在 Claude Code for VS Code 插件中使用

1

安装插件

安装 Claude Code for VS Code 插件

2

打开设置

完成安装后，点击 Settings

3

配置模型

配置模型为 MiniMax-M2.1

• Settings → Claude Code: Selected Model 输入 MiniMax-M2.1

或者

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

4

配置环境变量

• 若已安装 Claude Code，请参考文档进行环境变量配置
• 若尚未安装 Claude Code，点击 Edit in settings.json

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

复制

"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.1"
        },
        {
            "name": "ANTHROPIC_SMALL_FAST_MODEL",
            "value": "MiniMax-M2.1"
        },
        {
            "name": "ANTHROPIC_DEFAULT_SONNET_MODEL",
            "value": "MiniMax-M2.1"
        },
        {
            "name": "ANTHROPIC_DEFAULT_OPUS_MODEL",
            "value": "MiniMax-M2.1"
        },
        {
            "name": "ANTHROPIC_DEFAULT_HAIKU_MODEL",
            "value": "MiniMax-M2.1"
        }
    ],

​

在 Cursor 中使用 MiniMax-M2.1

​

安装 Cursor

1. 通过 Cursor 官网 下载并安装 Cursor
2. 打开 Cursor，右上角“设置”按钮，进入设置界面。点击“Sign in”按钮，登录自己的 Cursor 账户

​

在 Cursor 中配置 MiniMax API

1. 点击左侧栏的 “Models”，进入模型配置页面
2. 展开 “API Keys” 部分，配置 API 信息：
   • 勾选 “Override OpenAI Base URL”
   • 在下方输入 MiniMax 的调用地址 https://api.minimaxi.com/v1
3. 在 OpenAI API Key 输入框，配置您的 MiniMax API Key
4. 点击 “OpenAI API Key” 栏右侧的按钮

5. 在弹出的窗口中点击 “Enable OpenAI API Key” 按钮，完成设置验证

6. 在 Models 板块中，点击 “View All Models” 按钮，并点击 “Add Custom Model” 按钮

7. 输入模型名称“MiniMax-M2.1”后，点击“Add”按钮

8. 启用刚添加的 “MiniMax-M2.1” 模型
9. 在聊天面板中选择 “MiniMax-M2.1” 模型，开始使用 “MiniMax-M2.1”

​

在 TRAE 中使用 MiniMax-M2.1

​

安装 TRAE

1

下载并安装 TRAE

访问 Trae 官网 下载并安装 TRAE

2

完成初始设置

TRAE 首次启动时，你会进入以下页面，请根据指引完成初始设置

3

登录 TRAE

登录 TRAE

4

选择 MiniMax-M2.1 模型

TRAE 中国版内置了 MiniMax-M2.1 模型，你可以直接选用，开启高效编程之旅

​

在 TRAE 中使用自定义模型

1

打开设置

在 AI 对话框右上角，点击 设置 图标

2

选择模型页签

3

添加模型

点击 + 添加模型 按钮，选择服务商 MiniMax-CN，模型选择 MiniMax-M2.1

Coding Plan API Key 无法选择 MiniMax-M2.1-lightning，如果您想使用，请输入按量付费 API Key

4

填写 API 密钥

5

完成添加

点击 添加模型 按钮

TRAE 将调用服务商的接口来检测 API 密钥是否有效。可能的结果如下：

• 若连接成功，该自定义模型会被添加。
• 若连接失败，添加模型 窗口中展示错误信息和服务商返回的错误日志，你可以参考这些信息排查问题。

​

在 OpenCode 中使用 MiniMax-M2.1

​

安装 OpenCode

• 使用 curl 安装 OpenCode

curl -fsSL https://opencode.ai/install | bash

• 使用 npm 安装 OpenCode

npm i -g opencode-ai

​

配置 MiniMax API

1

运行认证命令

复制

opencode auth login

2

选择 Provider

当提示选择 provider 时，搜索并选择 “MiniMax（China）”

3

输入 API Key

当提示输入 API 密钥时，输入您的 MiniMax API Key

4

开始使用

回到命令行界面，输入 opencode 开始使用 MiniMax-M2.1

1

编辑配置文件

编辑 OpenCode 的配置文件，路径为 ~/.config/opencode/opencode.json，将以下配置添加到配置文件中：

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

• ANTHROPIC_AUTH_TOKEN
• ANTHROPIC_BASE_URL

复制

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "minimax": {
      "npm": "@ai-sdk/anthropic",
      "options": {
        "baseURL": "https://api.minimaxi.com/anthropic/v1",
        "apiKey": "<MINIMAX_API_KEY> (可选)"
      },
      "models": {
        "MiniMax-M2.1": {
          "name": "MiniMax-M2.1"
        }
      }
    }
  }
}

2

启动 OpenCode

进入项目目录，启动 opencode

复制

cd /path/to/your/project

opencode

3

选择模型

输入 /models，选择 “MiniMax-M2.1” 模型并在 OpenCode 中开始使用

​

在 Kilo Code 中使用 MiniMax-M2.1

​

安装 Kilo Code

1. 打开 VS Code，点击左侧活动栏中的扩展图标，在搜索框中输入 Kilo Code
2. 点击 Install 按钮进行安装，安装完成后，可能需要重启 VS Code

​

在 Kilo Code 中配置 MiniMax API

1. 点击”Settings”按钮，进入参数配置界面

2. API Provider -> 选择”MiniMax”
3. MiniMax Entrypoint -> api.minimaxi.com
4. MiniMax API Key 输入您的 API Key
5. Model 选择 MiniMax-M2.1
6. 依次点击右上角的”Save”和”Done”按钮，保存配置

7. 开始使用”MiniMax-M2.1”

​

在 Cline 中使用 MiniMax-M2.1

​

安装 Cline

1. 打开 VS Code，点击左侧活动栏中的扩展图标，在搜索框中输入 Cline
2. 点击 Install 按钮进行安装，安装完成后，可能需要重启 VS Code

3. 完成安装后，可以在左侧活动栏中看到 “Cline” 的图标

​

在 Cline 中配置 MiniMax API

1. 点击”Use your own API key”按钮，进入 Cline 的参数配置界面
2. API Provider -> 选择”MiniMax”
3. MiniMax Entrypoint -> api.minimaxi.com
4. MiniMax API Key -> 输入您的 API Key
5. 点击右上角的 “Done”，保存配置

6. 勾选 Auto-approve 中的”Edit”选项框，开始使用“MiniMax-M2.1”

​

在 Roo Code 中使用 MiniMax-M2.1

​

安装 Roo Code

1. 打开 VS Code，点击左侧活动栏中的扩展图标，在搜索框中输入 Roo Code
2. 点击 Install 按钮进行安装，安装完成后，可能需要重启 VS Code

​

在 Roo Code 中配置 MiniMax API

1. 点击”Settings”按钮，进入参数配置界面

2. API Provider -> 选择”MiniMax”
3. MiniMax Entrypoint -> api.minimaxi.com
4. MiniMax API Key 输入您的 API Key
5. Model 选择 MiniMax-M2.1
6. 依次点击右上角的”Save”和”Done”按钮，保存配置

7. 开始使用”MiniMax-M2.1”

​

在 Grok CLI 中使用 MiniMax-M2.1（不推荐）

​

安装 Grok CLI

1. 使用 npm 全局安装 Grok CLI

npm install -g @vibe-kit/grok-cli

​

在 Grok CLI 中配置 MiniMax API

1. 通过环境变量配置 URL 和 API Key

export GROK_BASE_URL="https://api.minimaxi.com/v1"
export GROK_API_KEY="<MINIMAX_API_KEY>"

2. 使用指定模型”MiniMax-M2.1”启动 Grok CLI

grok --model MiniMax-M2.1

​

在 Codex CLI 中使用 MiniMax-M2.1（不推荐）

​

安装 Codex CLI

1. 使用 npm 全局安装 Codex CLI

# 建议使用 0.57.0 版本
npm i -g @openai/[email protected]

​

在 Codex CLI 中配置 MiniMax API

1. 编辑 Codex 的配置文件，路径为 .codex/config.toml，将以下配置添加到配置文件中。

[model_providers.minimax]
name = "MiniMax Chat Completions API"
base_url = "https://api.minimaxi.com/v1"
env_key = "MINIMAX_API_KEY"
wire_api = "chat"
requires_openai_auth = false
request_max_retries = 4
stream_max_retries = 10
stream_idle_timeout_ms = 300000

[profiles.m21]
model = "codex-MiniMax-M2.1"
model_provider = "minimax"

2. 出于安全考虑，请在当前终端会话中通过环境变量设置 API Key

export MINIMAX_API_KEY="<MINIMAX_API_KEY>"

3. 使用指定的配置文件启动 Codex CLI。

codex --profile m21

​

在 Droid 中使用 MiniMax-M2.1

​

安装 Droid

curl -fsSL https://app.factory.ai/cli | sh

irm https://app.factory.ai/cli/windows | iex

​

在 Droid 中配置 MiniMax API

1. 使用以下指令，更新 Droid 配置文件，该配置文件的路径为 ~/.factory/config.json。

{
    "custom_models": [
        {
            "model_display_name": "MiniMax-M2.1",
            "model": "MiniMax-M2.1",
            "base_url": "https://api.minimaxi.com/anthropic",
            "api_key": "<MINIMAX_API_KEY>",
            "provider": "anthropic",
            "max_tokens": 64000
        }
    ]
}

2. 进入项目目录，启动 Droid

cd /path/to/your/project
droid

3. 输入 /model, 选择 “MiniMax-M2.1” 模型，并在 Droid 中使用

​

常见问题

​

API Error

API Error: Cannot read properties of undefined (reading 'map')

1. 确保已正确设置 API Host: https://api.minimaxi.com
2. 确认已将 <MINIMAX_API_KEY> 替换为你在 MiniMax 开发者平台 或 账户管理/Conding Plan获取的真实 API Key。
3. 如果使用 Claude Code 或 Droid，请清除环境变量：ANTHROPIC_AUTH_TOKEN
4. 如果在 VSCode 或 Cursor 中使用 Claude Code，请确保配置模型为 MiniMax-M2.1，详见在 Claude Code for VS Code 中使用 M2.1
5. 触发速率限制，请稍后再试。

• 通过邮箱 [email protected] 等官方渠道联系我们的技术支持团队
• 在我们的 Github 仓库提交Issue

​

推荐阅读