【Claude Code】接入 MinMax 的 Token Plan:settings.json 配置与 API KEY 验证

发布时间:2026/9/27 16:23:40
【Claude Code】接入 MinMax 的 Token Plan:settings.json 配置与 API KEY 验证 1. 为什么要在 Claude Code 里接 MinMax 的 Token PlanClaude Code 本身是个命令行里的编码 Agent它默认走 Anthropic 官方接口。但官方按 token 计费跑一个稍复杂的重构任务几轮工具调用下来消耗不小。MinMax 的 Token Plan也就是 Coding Plan 类套餐换了个计费思路按请求次数算额度每 5 小时给你几百次请求不卡 token 总量。对日常写代码、改 bug、跑 Agent 循环这种场景性价比明显更友好。我这次要做的就是让 Claude Code 不再走官方而是通过settings.json把请求转发到 MinMax 的 Anthropic 兼容端点同时把模型名切到 MiniMax-M2.7。整个过程不碰系统环境变量全部收敛在配置文件里换机器、换账号都好迁移。适合谁看已经在用 Claude Code、想换更划算的额度方案、又不想每次手动 export 一堆变量的开发者。你需要准备的东西只有两样——一个 MinMax 的 API KEY以及本机 Claude Code 的安装目录。下面从配置文件骨架开始一步步走完填写、切换、验证和排障。2. 前置准备拿到 MinMax API KEY 与确认 Claude Code 版本在动配置文件之前先把 KEY 拿到手。登录 MinMax 平台后进入用户中心的 API 管理页面创建一个新的 API KEY复制出来先放一边。注意这个 KEY 只在创建时完整显示一次关掉页面就看不全了所以别急着关。接着确认 Claude Code 已经装好。终端里执行claude --version能打印出版本号就说明命令可用。如果提示 command not found先按官方方式装好再回来。版本建议用较新的老版本对settings.json里env字段的解析行为略有差异容易踩坑。然后确认配置目录。Claude Code 读取配置的位置分平台平台settings.json 路径.claude.json 路径macOS / Linux~/.claude/settings.json~/.claude.jsonWindows用户目录/.claude/settings.json用户目录/.claude.jsonWindows 下的「用户目录」通常就是C:\Users\你的用户名。如果.claude文件夹不存在手动建一个即可Claude Code 启动时会去读。提示如果你之前用过系统环境变量方式配置ANTHROPIC_BASE_URL和ANTHROPIC_AUTH_TOKEN建议先把它们清掉否则会和配置文件里的值打架后面第 5 节会专门讲这个冲突。3. 可复制的 settings.json 骨架与模型切换打开或新建~/.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_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, ANTHROPIC_API_KEY: } }几个关键点ANTHROPIC_BASE_URL指向 MinMax 的 Anthropic 兼容端点Claude Code 会把原本发往官方的请求改发到这里。ANTHROPIC_AUTH_TOKEN填你刚复制的 KEY注意是 AUTH_TOKEN 不是 API_KEY两者在 Claude Code 里语义不同。API_TIMEOUT_MS设成 3000000 毫秒也就是 50 分钟。Agent 跑长任务时单次请求可能很久超时太短会被中途掐断。CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC设为 1关掉一些非必要的遥测请求避免它们打到不支持的端点上报错。后面四个ANTHROPIC_MODEL系列字段全部指向MiniMax-M2.7。Claude Code 内部会按任务类型选 Sonnet / Opus / Haiku 三档模型这里统一映射到同一个模型保证不管它选哪档实际调用的都是 MiniMax-M2.7。如果你后续想换 MiniMax-M2.5把这四行的值一起改掉就行。最后ANTHROPIC_API_KEY显式设为空字符串这是为了压掉可能存在的旧 KEY防止冲突。接着处理第二个文件~/.claude.json加上 onboarding 标记{ hasCompletedOnboarding: true }这个字段告诉 Claude Code 你已经完成过初始引导启动时不会再弹交互式设置流程直接进主界面。4. 验证接入是否生效一条最小请求配置写完别急着开大项目先用最小动作确认链路通了。终端里直接跑claude -p 只回复两个字通了-p是 print 模式发一条 prompt 拿到回复就退出不会进交互界面。如果配置正确你会看到类似「通了」的输出说明请求确实打到了 MinMax 并正常返回。想看得更细可以加调试输出claude -p 回复 ok --debug--debug会打印请求走向你能在日志里看到 base URL 是不是api.minimaxi.com/anthropic以及实际用的模型名。这一步能帮你区分「配置没生效」和「KEY 无效」两类问题。再进一步直接对端点发一条原始请求排除 Claude Code 本身的干扰curl https://api.minimaxi.com/anthropic/v1/messages \ -H Content-Type: application/json \ -H x-api-key: 你的MINIMAX_API_KEY \ -H anthropic-version: 2023-06-01 \ -d { model: MiniMax-M2.7, max_tokens: 64, messages: [{role: user, content: say ok}] }返回 JSON 里带content字段就说明 KEY 和端点都没问题。如果这里就报 401那问题在 KEY如果这里通、Claude Code 不通那问题在配置文件路径或字段拼写。启动交互模式后界面顶部会显示当前使用的模型。看到 MiniMax-M2.7 字样就代表切换成功。额度用量可以在 MinMax 平台的 Token Plan 页面查看跑几条请求后刷新就能看到计数变化。5. 本篇常见报错排查5.1 Auth conflict两个变量同时存在最常见的报错长这样Auth conflict: Both a token (ANTHROPIC_AUTH_TOKEN) and an API key (ANTHROPIC_API_KEY) are set.原因是你系统里还残留着ANTHROPIC_API_KEY环境变量而配置文件里又设了ANTHROPIC_AUTH_TOKENClaude Code 不知道听谁的。解决办法就是在settings.json的env里加一行ANTHROPIC_API_KEY: 显式清空也就是上面骨架里已经带的那行。如果系统层面还 export 过去 shell 配置里删掉对应行再重开终端。5.2 改了配置没生效先确认你改的是 Claude Code 真正读取的那个文件。macOS / Linux 是~/.claude/settings.json不是项目目录下的。Windows 是用户目录下的.claude。改完要完全退出 Claude Code 再重开热重载不一定认。5.3 模型名写错导致 404ANTHROPIC_MODEL的值必须和 MinMax 端支持的模型标识完全一致大小写敏感。写成minimax-m2.7或MiniMax-M2都可能被拒。以平台文档里列出的为准。5.4 超时中断长任务跑到一半断掉多半是API_TIMEOUT_MS太小。默认值往往只有几十秒Agent 连续工具调用很容易超。按骨架里的 3000000 设置基本够用。5.5 JSON 语法错误settings.json里多一个逗号、少一个引号都会让整个文件解析失败Claude Code 会静默回退到默认配置表现就是「配置像没写一样」。改完用编辑器自带的 JSON 校验看一眼或者python -m json.tool ~/.claude/settings.json验证一下。6. 把配置固化下来顺手接上更省心的方案配置文件这套方式的好处是一次写好、长期复用换项目不用重配。但如果你同时维护好几台机器或者团队里多人共用一套 Agent 工作流逐个改settings.json还是有点碎。我自己的做法是把 KEY 和端点收敛到统一入口管理本地只留一份指向。TaoToken 这边提供了模型对话、Coding Plan、控制台和 API Keys 几个入口适合把额度、密钥和调用记录集中看想先验证模型通不通用模型对话直接发一条测试请求长期跑编码和 Agent 任务看Coding Plan的额度方案要管理多个 KEY进控制台生成和轮换密钥在API Keys页面接入细节和字段说明查接入文档用 Claude Code 这类 Anthropic 兼容客户端的参考ClaudeCodeAnthropic的对接说明。API 端点统一走https://taotoken.net/api配置方式和上面 MinMax 那套逻辑一致把ANTHROPIC_BASE_URL和ANTHROPIC_AUTH_TOKEN换成对应值即可。这样本地settings.json只改两行模型名和超时参数都能沿用。最后留个实操习惯每次改完配置先跑claude -p 回复 ok确认链路再进大项目。这一步花十秒能省掉后面半小时的排查。