MiniMax-M2 全方位配置手册：覆盖 Claude Code, Cursor, Cline 等工具

YoungHong19922025-11-10 23:00

在 AI 编程工具里使用 M2

MiniMax-M2 具备良好的代码理解、多轮对话和推理能力，兼容 OpenAI 和Anthropic 接口协议，适用于代码助手、Agent 工具、AI IDE 等多种场景。

获取 API Key

  • 访问 MiniMax 开放平台

  • 点击"创建新的密钥"按钮，输入项目名称以创建新的 API Key

  • 创建成功后，系统将展示 API Key。请务必复制并妥善保存 ，该密钥只会显示一次，无法再次查看

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

安装 Claude Code

可参考 Claude Code 文档 进行安装。

配置 MiniMax API

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

    json 复制代码 
    {
  "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 变量更改为以下设置

    json 复制代码 
    "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"

在 Cline 中使用 MiniMax-M2

安装 Cline

  1. 打开 VS Code，点击左侧活动栏中的扩展图标，在搜索框中输入 Cline

  2. 点击 Install 按钮进行安装，安装完成后，可能需要重启 VS Code

  3. 完成安装后，可以在左侧活动栏中看到 "Cline" 的图标.若已安装 Cline，请升级至 3.34.1 或更高版本，并重启插件和 VS code 以确保正常使用。

在 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

    bash 复制代码 
    npm install -g @vibe-kit/grok-cli

在 Grok CLI 中配置 MiniMax API

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

    markdown 复制代码 
    export GROK_BASE_URL="https://api.minimaxi.com/v1"
export GROK_API_KEY="<MINIMAX_API_KEY>"

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

    bash 复制代码 
    grok --model MiniMax-M2

在 Codex CLI 中使用 MiniMax-M2

为了方便将模型与 Codex CLI 集成，建议使用 codex-MiniMax-M2 模型名称。虽然模型可以通过 Bash 等工具与文件进行交互，但这种方式并非 Agent 工作流的最佳实践。为实现 Agent 开发实践的最佳效果，建议使用 Claude Code 或 Cursor 工具。

安装 Codex CLI

  1. 使用 npm 全局安装 Codex CLI

    bash 复制代码 
    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。

    bash 复制代码 
    codex --profile m2

在 Droid 中使用 MiniMax-M2

安装 Droid

对于 Mac/Linux 用户，请使用以下指令安装：

复制代码 
```bash  theme={null}
curl -fsSL https://app.factory.ai/cli | sh
```

对于 Windows 用户，请使用以下指令安装：

复制代码 
```bash  theme={null}
irm https://app.factory.ai/cli/windows | iex
```

更多信息可参考 Droid 文档 。

在 Droid 中配置 MiniMax API

  1. 使用以下指令，更新 Droid 配置文件，该配置文件的路径为 ~/.factory/config.json。其中，需要将 MINIMAX_API_KEY 替换为从 MiniMax 开发者平台 获取的 API Key

提示:

  • 配置文件的路径为 ~/.factory/config.json, 并非 ~/.factory/settings.json

  • 清空 ANTHROPIC_AUTH_TOKEN 环境变量，否则会覆盖 .factory/config.json 中的 API Key 并导致错误

    bash 复制代码 
    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
        }
    ]
}

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

    bash 复制代码 
    cd /path/to/your/project
droid

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

在 OpenCode 中使用 MiniMax-M2

安装 OpenCode

  • 使用 curl 安装 OpenCode

    bash 复制代码 
    curl -fsSL https://opencode.ai/install | bash

  • 使用 npm 安装 OpenCode

    bash 复制代码 
    npm i -g opencode-ai

更多信息请参考 OpenCode 官网

配置 MiniMax API

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

    json 复制代码 
    {
  "$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"
        }
      }
    }
  }
}

其他认证方式：

如果你不想在配置文件中直接添加 API 密钥，可以使用交互式登录命令进行认证。按照以下步骤操作：

i. 运行认证命令：

复制代码 
```bash  theme={null}
opencode auth login
```

ii. 当提示选择 provider 时，选择 "Other"：

复制代码 
<img src="https://filecdn.minimax.chat/public/f616dac4-2ec4-4fc0-aabb-9776d5ec9043.png" width="60%" />

iii. 输入 provider ID "minimax"：

复制代码 
<img src="https://filecdn.minimax.chat/public/4a7d2327-651d-450a-b041-dd17e5ac78ec.png" width="60%" />

iv. 当提示输入 API 密钥时，输入你的 MiniMax API Key：

复制代码 
<img src="https://filecdn.minimax.chat/public/74a8214a-8f4a-4019-b335-c9a9717db8da.png" width="80%" />

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

    bash 复制代码 
    cd /path/to/your/project

opencode

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

常见问题

API Error

复制代码 
```bash  theme={null}
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. 触发速率限制，请稍后再试。
相关推荐
吴法刚1 天前
Gemini cli 源码分析之-Agent分析-Agent架构系统分析
架构·agent·ai编程·gemini
这儿有一堆花1 天前
重磅推出！Google Antigravity：一次 “以 Agent 为中心 (agent-first)” 的 IDE 革命
vscode·ai·ai编程·googlecloud
良逍Ai出海2 天前
Build in Public｜为什么我开始做一款相册清理 App（听说有竞品年收益40W）
ios·uni-app·ai编程·coding
Allen_LVyingbo2 天前
智能医疗时代的技术基石与人才蓝图：医疗AI工程师的技能树、三阶段进阶路线图
健康医疗·ai编程
safestar20122 天前
n8n 架构深度解构：从设计哲学到企业级实践
人工智能·ai编程
该用户已不存在3 天前
在 Gemini CLI 中使用 Gemini 3 Pro 实操指南
人工智能·ai编程·gemini
云起SAAS3 天前
食材美食火锅三消消消乐小游戏抖音快手微信小程序看广告流量主开源
ai编程·看广告变现轻·食材美食火锅三消消消乐小游戏
沟通QQ:688238863 天前
NRBO - Transformer - BiLSTM回归：Matlab实现的数据预测魔法
ai编程
酷柚易汛智推官3 天前
AI编程不是低代码的“终结者”，而是进化的“催化剂”
低代码·ai编程·酷柚易汛
万少3 天前
我是如何使用 Trae IDE 完成《流碧卡片》项目的完整记录
前端·后端·ai编程
热门推荐
01GitHub 镜像站点02BongoCat - 跨平台键盘猫动画工具03UV安装并设置国内源04【保姆级教程】免费使用Gemini3的5种方法！免翻墙/国内直连05Linux下V2Ray安装配置指南06安娜的档案(Anna’s Archive) 镜像网站/国内最新可访问入口（持续更新）07KGG转MP3工具|非KGM文件|解密音频08全球最强模型Grok4，国内已可免费使用！（附教程）09“我的电脑”图标没了怎么办 4种方法找回1046个Nano-banana 精选提示词，持续更新中