企业官网建设流程全解析

1. 为什么要在 Claude Code 里接 MinMax 的 Token Plan

Claude 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 读取配置的位置分平台：

Windows 下的「用户目录」通常就是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_TOKEN，Claude Code 不知道听谁的。解决办法就是在settings.json的env里加一行"ANTHROPIC_API_KEY": ""显式清空，也就是上面骨架里已经带的那行。如果系统层面还 export 过，去 shell 配置里删掉对应行再重开终端。

5.2 改了配置没生效

先确认你改的是 Claude Code 真正读取的那个文件。macOS / Linux 是~/.claude/settings.json，不是项目目录下的。Windows 是用户目录下的.claude。改完要完全退出 Claude Code 再重开，热重载不一定认。

5.3 模型名写错导致 404

ANTHROPIC_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"确认链路，再进大项目。这一步花十秒，能省掉后面半小时的排查。