通过 AI 编程工具接入

​

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

​

安装 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.5，完成后点击右下角的 “添加”。 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.5

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

或者

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

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

​

在 Cursor 中使用 MiniMax-M2.5

​

安装 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.5”后，点击“Add”按钮

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

​

在 TRAE 中使用 MiniMax-M2.5

​

安装 TRAE

1

下载并安装 TRAE

访问 Trae 官网 下载并安装 TRAE

2

完成初始设置

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

3

登录 TRAE

登录 TRAE

4

选择 MiniMax-M2.5 模型

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

​

在 TRAE 中使用自定义模型

1

打开设置

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

2

选择模型页签

3

添加模型

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

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

4

填写 API 密钥

5

完成添加

点击 添加模型 按钮

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

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

​

在 OpenCode 中使用 MiniMax-M2.5

​

安装 OpenCode

• 使用 curl 安装 OpenCode

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

• 使用 npm 安装 OpenCode

npm i -g opencode-ai

​

使用内置的 MiniMax-M2.5

​

配置 MiniMax API

1

运行认证命令

复制

opencode auth login

2

选择 Provider

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

3

输入 API Key

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

4

开始使用

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

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.5": {
          "name": "MiniMax-M2.5"
        }
      }
    }
  }
}

2

启动 OpenCode

进入项目目录，启动 opencode

复制

cd /path/to/your/project

opencode

3

选择模型

输入 /models，选择 “MiniMax-M2.5” 模型并在 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”

​

在 OpenClaw 中使用 MiniMax-M2.5

​

安装 Openclaw

curl -fsSL https://openclaw.bot/install.sh | bash

iwr -useb https://openclaw.ai/install.ps1 | iex

​

配置 MiniMax 模型

• 通过OAuth登录
• 手动安装与配置

1

选择配置选项

如果openclaw的初始配置引导没有出现模型配置，则可以通过以下命令再次进行 openclaw 配置：

复制

openclaw configure

2

选择配置选项

• Where will the Gateway run? → 选择 Local (this machine)
• Select sections to configure → 选择 Model
• Model/auth provider → 选择 MiniMax
• MiniMax auth method → 选择MiniMax OAuth
• MiniMax endpoint → 选择 CN

3

登录授权

自动弹出登录页，登录并授权。

4

确认模型选择

OAuth 登录完成后，进入模型选择。系统会默认勾选 minimax-portal/MiniMax-M2.1 和 minimax-portal/MiniMax-M2.5，并将 minimax-portal/MiniMax-M2.5 设为默认模型，可直接按回车确认使用。

5

测试对话

输入 openclaw tui，若成功对话则表示配置成功：

推荐使用「一键安装OAuth并登录」的方式进行安装。若登录失败，可尝试以下方法。

1

进入配置流程

初次安装时一般会直接进入配置流程。若没有自动开始，可通过以下命令手动启动：

复制

openclaw onboard --install-daemon

基本配置选择：

• Step 1: 同意声明 → 选择 Yes
• Step 2: Onboarding Mode → 选择 QuickStart

如果openclaw的初始配置引导没有出现模型配置，则可以通过以下命令进入 openclaw 配置：

复制

openclaw configure

对于 “Where will the Gateway run?” 项，选择 Local (this machine)；对于 “Select sections to configure”项，选择 Model。

2

模型配置

• Step 1: Model/auth provider → 选择 MiniMax
• Step 2: MiniMax auth method → 选择 MiniMax M2.5
• Step 3: MiniMax API key → 填入您的 MiniMax API Key
• Step 4: Models in /model picker → 直接回车使用默认选项

此处默认使用的是 MiniMax 海外版 API Key。如果需要使用 MiniMax 国内 API Key，请在完成配置引导流程后，按照下方「国内用户配置」步骤进行修改。

3

功能配置

• Step 1: 按需选择 channel（需要在什么 App 中进行对话）
• Step 2: 按需配置 Skill
• Step 3: 按需启用 Hooks（可选）：
  • 💾 session-memory: 执行 /new 时自动保存会话上下文
  • 📝 command-logger: 记录所有命令到日志文件
  • 🚀 boot-md: 网关启动时运行 BOOT.md

4

国内用户配置

如果您使用的是 MiniMax 海外版服务，可以跳过此步骤。

• 方法一：修改配置文件
• 方法二：前端界面修改

在终端中输入以下命令打开配置文件：

复制

open ~/.openclaw/openclaw.json

将 model 字段的 baseUrl 从 https://api.minimax.io/anthropic 修改为 https://api.minimaxi.com/anthropic

复制

"models": {
  "mode": "merge",
  "providers": {
    "minimax": {
      "baseUrl": "https://api.minimaxi.com/anthropic", # 修改此处（注意：后缀改成.com，且 minimax 后还有个i）
      "api": "anthropic-messages",
      "models": [
        {
          "id": "MiniMax-M2.5",
          "name": "MiniMax M2.5",
          "reasoning": false,
          "input": [
            "text"
          ],
          "cost": {
            "input": 15,
            "output": 60,
            "cacheRead": 2,
            "cacheWrite": 10
          },
          "contextWindow": 200000,
          "maxTokens": 8192
        }
      ]
    }
  }
}

1. 在终端中启动网关：

复制

openclaw gateway run

2. 打开浏览器访问 http://127.0.0.1:18789
3. 进入 Config 配置界面，点击 models 栏目
4. 将 baseUrl 修改为 https://api.minimaxi.com/anthropic，并打开 Auth Header 开关
5. 点击右上角 Save 按钮保存，然后点击 Update 按钮更新配置

5

测试对话

输入 openclaw tui ，若成功对话则表示配置成功：

​

在 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/codex@0.57.0

​

在 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.5

​

安装 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.5",
            "model": "MiniMax-M2.5",
            "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.5” 模型，并在 Droid 中使用

​

在 Zed 中使用 MiniMax-M2.5

​

安装 Zed

​

配置 MiniMax API

1

进入智能体面板

点击右下角 ✨ 号进入智能体面板：

2

进入配置页面

点击右上角三点标志进入 setting 进行配置：

3

添加 LLM Provider

找到 LLM Provider 模块，点击 +Add Provider 并在出现的下拉框中选择 OpenAI 进行模型添加：

4

填写配置信息

进入添加面板，根据以下信息填写：

配置项	值
Provider Name	根据需要设置
API URL	https://api.minimaxi.com/v1
API Key	从官网获取的 API Key，请参考快速开始进行获取
Model Name	MiniMax-M2.5

其他配置根据个人使用需要变更。完整配置参考如下：

5

保存配置

点击 Save Provider 保存，LLM Provider 已包含我们配置好的 MiniMax, 点击 MiniMax，再次输入您的 API Key，并按Enter保存 ：

6

选择模型并开始使用

返回智能体面板，点击右下角 Select a Model 选择刚刚配置好的 MiniMax-M2.5 模型：即可使用 MiniMax-M2.5 模型进行辅助开发工作。

​

在 MonkeyCode 中使用 MiniMax-M2.5

​

在 MonkeyCode 中配置 MiniMax API

1

登录 MonkeyCode

访问 MonkeyCode 官网 进行登录。

2

进入任务页面

登录后，点击「开始使用」按钮，进入 MonkeyCode 智能开发平台任务页面：

3

进入系统配置页面

点击页面右下角「配置」按钮，进入系统配置页面：

4

绑定 AI 大模型

在 AI 大模型模块中，点击「绑定」按钮：

5

配置 MiniMax-M2.5

依次执行以下操作来绑定个人 MiniMax-M2.5：

配置项	值
模型 API 地址	将默认 URL 替换为 MiniMax Coding 专属接口地址：https://api.minimaxi.com/anthropic
API Key	从 MiniMax 开放平台 获取
接口格式类型	选择 anthropic
模型名称	选择 MiniMax-M2.5

完成上述配置后，点击页面「保存」按钮，确认所有设置生效：

6

使用 MiniMax-M2.5 模型

返回 MonkeyCode 主界面，输入 Prompt 后，点击「执行」按钮，即可调用配置的 MiniMax-M2.5 模型：

​

常见问题

​

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. 触发速率限制，请稍后再试。

• 通过邮箱 Model@minimaxi.com 等官方渠道联系我们的技术支持团队
• 在我们的 Github 仓库提交Issue

​

推荐阅读