在 AI 编程工具里使用 M2

​

获取 API Key

• 访问 MiniMax 开放平台
• 点击“创建新的密钥”按钮，输入项目名称以创建新的 API Key
• 创建成功后，系统将展示 API Key。请务必复制并妥善保存，该密钥只会显示一次，无法再次查看

​

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

​

安装 Claude Code

​

配置 MiniMax API

1. 编辑或创建 Claude Code 的配置文件，路径为 ~/.claude/settings.json，在该文件中添加或更新 env 字段，其中，需要将 MINIMAX_API_KEY 替换为从 MiniMax 开发者平台 获取的 API Key

{
  "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",
    "ANTHROPIC_SMALL_FAST_MODEL": "MiniMax-M2",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "MiniMax-M2",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "MiniMax-M2",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "MiniMax-M2"
  }
}

2. 配置完成后，进入工作目录，在终端中运行 claude 命令以启动 Claude Code
3. 启动后，选择 信任此文件夹 (Trust This Folder)，以允许 Claude Code 访问该文件夹中的文件，随后开始在 Claude Code 中使用 MiniMax-M2

​

在 Claude Code for VS Code 插件中使用

1. 安装 Claude Code for VS Code 插件

2. 完成安装后，点击 Settings

3. 配置模型为 MiniMax-M2

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

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

4. 配置环境变量信息

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

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

​

在 Cursor 中使用 MiniMax-M2

​

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

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

​

在 Trae 中使用 MiniMax-M2

​

安装 Trae

1. 访问 Trae 官网 下载并安装 Trae
2. 完成安装后，启动 Trae IDE

​

方式一：直接使用内置模型

​

方式二：通过 OpenRouter 接入

1. 注册 OpenRouter API Key

2. 在 OpenRouter 中设置 MiniMax Key

3. 在 Trae 中添加模型

4. 选择 MiniMax M2 模型

​

在 Cline 中使用 MiniMax-M2

​

安装 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 -> 输入在 MiniMax 开放平台 获取的 key
5. 点击“Let’s go!”按钮后，点击右上角的”Done”，保存配置

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

​

在 Roo Code 中使用 MiniMax-M2

​

安装 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 输入在 MiniMax 开放平台 获取的 key
5. 依次点击右上角的“Save”和”Done”按钮，保存配置

6. 开始使用“MiniMax-M2”

​

在 Grok CLI 中使用 MiniMax-M2

​

安装 Grok CLI

1. 使用 npm 全局安装 Grok CLI

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

​

在 Grok CLI 中配置 MiniMax API

1. 通过环境变量配置 URL 和 API Key，其中，需要将 MINIMAX_API_KEY 替换为从 MiniMax 开发者平台 获取的 API Key

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

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

grok --model MiniMax-M2

​

在 Codex CLI 中使用 MiniMax-M2

​

安装 Codex CLI

1. 使用 npm 全局安装 Codex CLI

npm i -g @openai/codex

​

在 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.m2]
model = "codex-MiniMax-M2"
model_provider = "minimax"

2. 出于安全考虑，请在当前终端会话中通过环境变量设置 API Key，其中，需要将 MINIMAX_API_KEY 替换为从 MiniMax 开发者平台 获取的 API Key

export MINIMAX_API_KEY="<MINIMAX_API_KEY>"

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

codex --profile m2

​

在 Droid 中使用 MiniMax-M2

​

安装 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。其中，需要将 MINIMAX_API_KEY 替换为从 MiniMax 开发者平台 获取的 API Key

cat ~/.factory/config.json
{
    "custom_models": [
        {
            "model_display_name": "MiniMax-M2",
            "model": "MiniMax-M2",
            "base_url": "https://api.minimaxi.com/anthropic",
            "api_key": "<MINIMAX_API_KEY>",
            "provider": "anthropic",
            "max_tokens": 16384
        }
    ]
}

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

cd /path/to/your/project
droid

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

​

在 OpenCode 中使用 MiniMax-M2

​

安装 OpenCode

• 使用 curl 安装 OpenCode

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

• 使用 npm 安装 OpenCode

npm i -g opencode-ai

​

配置 MiniMax API

1. 编辑 OpenCode 的配置文件，路径为 ~/.config/opencode/opencode.json，将以下配置添加到配置文件中，其中 MINIMAX_API_KEY 设置为从 MiniMax 开发者平台 获取的 API Key。

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

opencode auth login

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

cd /path/to/your/project

opencode

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

​

常见问题

​

API Error

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

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

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

​

推荐阅读