1.2c MiniMax
目标:把 MiniMax 的 API Key 配进 Claude Code,完成第一次对话验证。
本关任务简报
这条路线适合你,如果:
- 你在国内,想走国产高性价比模型路线
- MiniMax M 系列在国产模型中综合排名靠前,在软件工程任务上表现出色
- 你偏向按量计费,不想绑定套餐
如果你想要套餐制的国内路线,可以比较一下 1.2b 智谱 GLM →。
通关奖励:解锁以下技能
- 在 MiniMax 开放平台注册、充值并拿到 API Key
- 把 MiniMax 配进 Claude Code(环境变量或
settings.json) - 用
/doctor+/model验证接入,并避开国内站 / 国际站搞混的坑
机制解析
可用模型
| 模型 | 定位 |
|---|---|
| MiniMax-M3 | 官方接入 Claude Code 时使用的模型,代码与推理综合表现强 |
ℹ️ 网站内容不定期更新,表格里不一定是平台最新模型;作者会尽量确保模型信息准确,请以平台官网和
/model实际显示为准。
只有一个模型名
官方接入文档里,Claude Code 的几档模型(opus / sonnet / haiku)全部映射到同一个 MiniMax-M3,不需要在意 /model 里选的是哪一档,实际都会走 MiniMax-M3。
国内站 / 国际站别搞混
MiniMax 分国内站和国际站两个站点,注册平台、获取API Key、使用Base URL 必须同属一套,跨站会鉴权失败导致无法正常使用:
- 国内站:注册用
platform.minimaxi.com,Base URL用https://api.minimaxi.com/anthropic(本页的配置模板用的是国内站) - 国际站:注册用
platform.minimax.io,Base URL用https://api.minimax.io/anthropic
开始闯关
第 1 步:注册并获取 API Key
访问 MiniMax 开放平台:https://platform.minimaxi.com(注册并完成实名认证,新账户通常送少量体验金,可先免费试跑)
注册后:
- 进入 账户管理 → 接口密钥
- 点击 创建新密钥,给它取个名字(比如
claude-code) - 立刻复制保存,关闭弹窗后无法再次查看完整 Key
Key 安全
不要提交进 Git,不要在截图或群聊中暴露。怀疑泄露时立刻在控制台删除并重新生成。
第 2 步:充值
平台 → 充值 页面,选择适合你的套餐或按量充值方式,完成充值后 Key 才能调用模型。
第 3 步:配置 Claude Code
Windows PowerShell
$env:ANTHROPIC_API_KEY = "你的 MiniMax API Key"
$env:ANTHROPIC_BASE_URL = "https://api.minimaxi.com/anthropic"
claudemacOS / Linux
export ANTHROPIC_API_KEY="你的 MiniMax API Key"
export ANTHROPIC_BASE_URL="https://api.minimaxi.com/anthropic"
claude上面是临时写法,只在当前终端窗口生效。长期使用推荐写进 Claude Code 配置文件,并按官方文档补上超时和上下文窗口设置(MiniMax 模型上下文长、单次响应可能较久,默认超时容易误判为失败):
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.minimaxi.com/anthropic",
"ANTHROPIC_AUTH_TOKEN": "你的 MiniMax API Key",
"ANTHROPIC_MODEL": "MiniMax-M3",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "MiniMax-M3",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "MiniMax-M3",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "MiniMax-M3",
"API_TIMEOUT_MS": "3000000",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
"CLAUDE_CODE_AUTO_COMPACT_WINDOW": "512000"
}
}文件位置:~/.claude/settings.json
这几个额外变量是干什么的
API_TIMEOUT_MS:把请求超时拉长到约 50 分钟,避免长任务被默认超时打断(官方推荐值)。CLAUDE_CODE_AUTO_COMPACT_WINDOW:把自动压缩的上下文窗口设为 512K,匹配 MiniMax-M3 的上下文容量。CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC:关闭非必要的后台请求(这些请求打到兼容接口上意义不大)。ANTHROPIC_AUTH_TOKEN与示例里的ANTHROPIC_API_KEY作用相同,填同一个 Key、设一个即可。
切换前先清掉旧变量
如果你之前配过别的平台,先确认终端里没有残留的 ANTHROPIC_AUTH_TOKEN / ANTHROPIC_BASE_URL(旧值会覆盖 settings.json,导致看起来配了却连不上)。
通关检定
进入 Claude Code 后:
> /doctor确认没有连接报错,然后切换模型:
> /model选择 MiniMax-M3,发一句话:
> 你好,请用中文介绍一下你自己自查清单:
- [ ] 注册站点、API Key、Base URL 同属一套(国内站 / 国际站没混用)
- [ ] 账户已充值,Key 完整无多余空格
- [ ]
/doctor无报错,/model看到 MiniMax 系列 - [ ] 发一句话能稳定收到回复
全部点亮就算通关 ✓
卡关了?翻车指南在这
| 现象 | 原因 | 解决 |
|---|---|---|
/doctor 报认证失败 | Key 粘贴有误,或国内站 / 国际站混用 | 确认 Key 完整无空格,且站点与 Base URL 同属一套 |
| 连接超时 | 网络问题 | 检查网络,或换个时间段重试 |
| 余额不足错误 | 账户充值不足 | 去平台充值 |
这条路线的优点和代价
优点:国内直连,稳定;MiniMax M 系列在软件工程任务上表现出色;按量计费灵活,不用担心套餐闲置。
代价:这是兼容接入层,不是 Anthropic 官方路线;部分高级能力(如扩展思考)可能受兼容层限制。
💬 还是搞不定?
配置过程中遇到困难?加入群聊与众多战友探讨交流,寻找高效解决方案。
下一关
接入跑通后,回到 1.2 接入模型 → 选择其他路线,或直接进入 1.3 第一次对话 →。