环境配置

获得解字计划的资助后，你会被加入 MiniMax 团队。本指南帮你把 MiniMax 的 AI 模型接入编程工具。

前置准备

确认你已被加入 MiniMax 团队
登录 MiniMax 开放平台，在团队空间获取 API Key

Claude Code（推荐）

Claude Code 是 Anthropic 出品的终端 AI 编程 Agent，也是解字计划最推荐的工具。

安装

参考 Claude Code 官方文档安装。

方式一：cc-switch（推荐）

cc-switch 可以一键切换 Claude Code 的 API 配置。

macOS / Linux：

brew tap nicepkg/tap
brew install --cask cc-switch

Windows：

前往 cc-switch Releases 下载安装包。

安装后：

启动 cc-switch，点击右上角 ”+”
选择预设的 MiniMax 供应商
填入你的 MiniMax API Key
将模型名称改为 MiniMax-M2.7
点击 “添加”，回首页点击 “启用”

方式二：手动配置

第 1 步：先清除可能冲突的环境变量：

unset ANTHROPIC_AUTH_TOKEN
unset ANTHROPIC_BASE_URL

如果这些变量在 ~/.bashrc 或 ~/.zshrc 中被永久导出，请删除对应行。

第 2 步：编辑 Claude Code 配置文件：

macOS / Linux：~/.claude/settings.json
Windows：用户目录/.claude/settings.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.7",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "MiniMax-M2.7",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "MiniMax-M2.7",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "MiniMax-M2.7"
  }
}

第 3 步：编辑 ~/.claude.json（Windows 为 用户目录/.claude.json）：

{
  "hasCompletedOnboarding": true
}

验证配置

启动 Claude Code 后，输入以下命令验证：

/status

确认 ANTHROPIC_BASE_URL 指向 api.minimaxi.com/anthropic。

/model

确认当前模型为 MiniMax-M2.7。

VS Code 插件

如果你用 VS Code，可以安装 Claude Code for VS Code 插件：

安装插件
打开 Settings → Claude Code: Selected Model，输入 MiniMax-M2.7
如果已配置好 ~/.claude/settings.json，插件会自动读取环境变量
如果没有，在 VS Code settings.json 中添加：

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

其他支持的工具

MiniMax 的 API 兼容 Anthropic 格式，以下工具都可以使用：

工具	配置方式	参考文档
Cline	VS Code 插件设置中填入 Base URL + API Key	MiniMax Cline 指南
Cursor	Settings → Models → 添加自定义模型	MiniMax Cursor 指南
TRAE	设置中配置 API	MiniMax TRAE 指南
Roo Code	同 Cline 配置方式	—

验证一切正常

配置完成后，让 AI 帮你写一个小程序试试：

帮我写一个 Python 脚本，输出当前时间和一句随机的鼓励语

如果 AI 正常响应并生成了代码，恭喜你，配置成功！

常见问题

报错 “API Key 无效”

确认使用的是团队空间的 Key，不是个人的。登录 MiniMax 开放平台后，切换到团队空间获取。

响应很慢或超时

检查网络连接，校园网可能需要切换热点
确认 API_TIMEOUT_MS 设置为 3000000（50 分钟）

Claude Code 启动后还是用的 Anthropic

检查是否有残留的环境变量：

echo $ANTHROPIC_AUTH_TOKEN
echo $ANTHROPIC_BASE_URL

如果有输出，说明还有旧变量未清除。用 unset 清除后重启终端。