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 小时前
到底是选Workflow还是Agent？你真的搞明白你要什么了？别再盲目大力Agentic
ai编程
挖掘狂人1 小时前
从 "调模型" 到 "搭系统"：Harness Engineering 凭什么成为 2026 年 AI 圈最热的新词
人工智能·agent·ai编程
Flynt1 小时前
这个日增 1400 星的 E2E 框架说"第二次跑不调模型"，我改了按钮文案试了试
agent·ai编程·测试
飞哥数智坊2 小时前
AI 帮我把 Mac 下的 3D 鱼缸搬到了 Windows
人工智能·ai编程
洛小豆3 小时前
我是 AI 牛马，老板说：做个简单的原生跨平台 Markdown 编辑器
人工智能·ai编程·markdown
颜进强4 小时前
20 · NestJs循环依赖与 forwardRef:容器为什么在环面前会死,"占位再补齐"怎么救
前端·后端·ai编程
颜进强4 小时前
19 · NestJs @Global 落地账:装饰器与 `isGlobal` 参数,各在什么场景上岗
前端·后端·ai编程
空心木偶☜4 小时前
LangChain 概述
python·ai·langchain·ai编程
颜进强4 小时前
18 · NestJS动态模块与 forRoot:`imports: [ConfigModule.forRoot({...})]` 到底在 import 什么
前端·后端·ai编程
fitpolo4 小时前
AI编程入门
ai编程
热门推荐
01如何新建文件夹？ 电脑新建文件夹的4种方法02历年考研数学一、数学二、数学三真题试卷及答案PDF03国内可直接用、免费额度/永久免费的大模型API清单（含 SiliconFlow、火山、阿里、智谱、百度、Kimi、DeepSeek、DMXAPI 等）04Telegram APK 下载安装完整指南 — 2026年最新05蜘蛛磁力 搜索引擎大全，如何使用蜘蛛磁力查找磁力链接06GitHub 镜像站点07Windows 10/11 如何退出微软账户并改用本地账户登录（含找不到选项的解决方法）08微信历史版本含下载地址（ Windows PC | 安卓 | MAC ）及设置微信不更新092026 爱知・名古屋亚运会怎么看？直播平台+赛程安排分享10给AI一张“业务概念地图“：本体如何从哲学走向企业智能