MiniMax M2.7 接入 AI 编程工具完全指南

MiniMax-M2.7 和 MiniMax-M2.7-highspeed 兼容 OpenAI 和 Anthropic 接口协议，适用于代码助手、Agent 工具、AI IDE 等多种场景。本文详细介绍各主流工具的接入方法及注意事项。

前置准备

通用注意事项：

使用 MiniMax API 前，必须清除竞品环境变量，否则可能无法正常调用
- Claude Code / OpenCode / Kilo Code / Cline 等基于 Anthropic 协议的工具：清除 ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_BASE_URL
- Cursor 基于 OpenAI 协议的工具：清除 OPENAI_API_KEY 和 OPENAI_BASE_URL
API Key 获取地址：MiniMax Platform

一、Claude Code（推荐）

方式一：cc-switch 可视化切换（推荐）

安装 cc-switch：

# macOS / Linux
brew tap farion1231/ccswitch
brew install --cask cc-switch

# Windows
# 前往 GitHub Releases 下载安装包

启动 cc-switch，点击右上角 “+”，选择预设的 MiniMax 供应商，填写 API Key
将所有模型名称改为 MiniMax-M2.7，点击 “添加”
回到首页，点击 “启用”
编辑 ~/.claude.json，添加：
```
{ "hasCompletedOnboarding": true }
```

方式二：手动配置

编辑 ~/.claude/settings.json：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.minimaxi.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "你的API_KEY",
    "API_TIMEOUT_MS": "3000000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "ANTHROPIC_MODEL": "MiniMax-M2.7",
    "ANTHROPIC_SMALL_FAST_MODEL": "MiniMax-M2.7",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "MiniMax-M2.7",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "MiniMax-M2.7",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "MiniMax-M2.7"
  }
}

然后在 ~/.claude.json 添加 { "hasCompletedOnboarding": true }。

Claude Code for VS Code 插件

安装插件后，在 Settings 中配置：

Claude Code: Selected Model → minimax-m2.7
环境变量中添加 ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN 等（同上）

二、Cursor

前提：Cursor 仅支持高级会员及以上用户配置自定义模型。

Settings → Models → 勾选 “Override OpenAI Base URL”
填入 https://api.minimaxi.com/v1
在 OpenAI API Key 输入框填入 MiniMax API Key，点击 Enable
点击 “Add Custom Model”，输入 MiniMax-M2.7
启用模型，在聊天面板选择使用

常见问题： 若模型无返回，可将 Cursor 的 Network 设置改为 HTTP/1.0。

三、TRAE

TRAE 中国版内置了 MiniMax-M2.7，可直接选用。

内置方式

安装 TRAE（官网）并登录
在 AI 对话框直接选择 MiniMax-M2.7 模型

自定义 API 方式

设置 → 模型 → 点击 “+ 添加模型”
选择服务商 MiniMax-CN，模型选 MiniMax-M2.7
填入 API Key，添加模型

⚠️ Token Plan API Key 无法选择 MiniMax-M2.7-lightning，如需使用请切换为按量付费 API Key。

四、OpenCode

方式一：交互式登录

opencode auth login
# 选择 "MiniMax（minimaxi.com）" provider
# 输入 API Key
opencode  # 启动使用

方式二：配置文件

编辑 ~/.config/opencode/opencode.json：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "minimax": {
      "npm": "@ai-sdk/anthropic",
      "options": {
        "baseURL": "https://api.minimaxi.com/anthropic/v1",
        "apiKey": "<你的API_KEY>"
      },
      "models": {
        "MiniMax-M2.7": { "name": "MiniMax-M2.7" }
      }
    }
  }
}

五、Kilo Code（VS Code 扩展）

在 VS Code 扩展市场搜索安装 Kilo Code
点击 Settings → 配置参数：
- API Provider → MiniMax
- MiniMax Entrypoint → api.minimaxi.com
- MiniMax API Key → 填入你的 Key
- Model → MiniMax-M2.7
Save → Done，开始使用

六、OpenClaw

OpenClaw 支持 OAuth 一键登录或手动 API Key 配置，推荐使用 OAuth。

OAuth 方式（推荐）

openclaw configure
# 选择 Local → Model → MiniMax → MiniMax CN — OAuth (minimaxi.com)
# 自动弹出登录页授权
# 默认选中 MiniMax-M2.7，确认即可

API Key 方式

openclaw onboard --install-daemon
# 选择 Model → MiniMax → MiniMax CN — API Key (minimaxi.com)
# 填入 API Key

💡 通过 OAuth 登录后，OpenClaw 的 image 工具会自动配置 MiniMax 图像理解 MCP 服务，无需额外配置即可支持图像理解。

七、Hermes Agent

开源自主学习 AI 智能体，安装后运行：

hermes model
# 选择 "MiniMax China (mainland China endpoint)"
# 输入 Token Plan API Key
# 选择 MiniMax-M2.7 模型

八、Cline（VS Code 扩展）

在 VS Code 安装 Cline 扩展（版本 ≥ 3.47.0）
扩展设置中配置：
- API Provider → anthropic
- Anthropic API Key → 你的 MiniMax API Key
- Anthropic Base URL → https://api.minimaxi.com/anthropic
- Model ID → MiniMax-M2.7
重启 VS Code 开始使用

工具对比一览

工具	协议	难度	推荐度	备注
Claude Code	Anthropic	⭐⭐	⭐⭐⭐⭐⭐	功能最全，cc-switch 简化配置
Claude Code VS Code 插件	Anthropic	⭐⭐	⭐⭐⭐⭐	适合 IDE 党
Cursor	OpenAI	⭐⭐	⭐⭐⭐	需高级会员
TRAE	内置/自定义	⭐	⭐⭐⭐⭐	中国版内置，最简单
OpenCode	Anthropic	⭐	⭐⭐⭐	命令行友好
Kilo Code	自定义	⭐⭐	⭐⭐⭐	VS Code 扩展
OpenClaw	两者皆可	⭐	⭐⭐⭐⭐	消息平台集成
Hermes Agent	自定义	⭐	⭐⭐⭐	持久记忆能力强
Cline	Anthropic	⭐⭐	⭐⭐	VS Code 扩展

注意事项总结

先清环境变量再配置——这是最常见的接入失败原因
Token Plan Key vs 按量付费 Key——部分工具（如 TRAE 的 M2.7-lightning）仅支持按量付费 Key
超时设置——建议将 API_TIMEOUT_MS 设为 3000000（3分钟），代码分析任务耗时较长
Cursor 高级会员——自定义模型是 Cursor 高级会员专属功能
cc-switch 简化配置——Claude Code 用户强烈推荐使用 cc-switch，可视化切换比手改 JSON 方便太多

本文整理自 MiniMax 官方文档，实测时间：2026-04-17。