不少开发者喜欢的是 Claude Code 这个工具本身:终端里的智能体,会规划、会改代码、会自己跑命令。可一旦天天用,账单就让人犹豫了。Claude Pro 每月 20 美元,Max 100 美元起。另一边,国产编程套餐已经又便宜又能打:智谱 Z.ai 的 GLM Coding Plan 18 美元起,MiniMax 的 M Plan 22 美元起,BytePlus 的 Coding Plan 10 美元起,阶跃星辰的 Step Plan 6.99 美元起。阿里云的通义千问 Coding Plan Pro 每月 50 美元,一个订阅就能用 Qwen、GLM、Kimi 和 MiniMax 的模型。
好消息是,用这些套餐不必放弃 Claude Code。下面每一家都提供兼容 Anthropic 协议的接口,也都写了自己的 Claude Code 接入文档。我们在 2026 年 10 月 8 日把这些官方页面逐一看过,文中的地址、变量名、模型 ID 和使用规则全部出自那里。官方没写的,我们会直说。
原理很简单
Claude Code 用的是 Anthropic 的 Messages 协议。只要换一个同样支持这套协议的服务器,它就能用别家的模型干活。实际要改的是三样东西:
- ANTHROPIC_BASE_URL — 把 Anthropic 的地址换成厂商的套餐接口。
- 密钥 — 套餐专用的 Key,一般填在 ANTHROPIC_AUTH_TOKEN 里。Kimi 例外,用的是 ANTHROPIC_API_KEY。
- 模型映射 — Claude Code 会按名字请求 Opus、Sonnet、Haiku(有时还有 Fable 或子智能体模型)。ANTHROPIC_DEFAULT_OPUS_MODEL、ANTHROPIC_DEFAULT_SONNET_MODEL、ANTHROPIC_DEFAULT_HAIKU_MODEL、ANTHROPIC_DEFAULT_FABLE_MODEL 和 CLAUDE_CODE_SUBAGENT_MODEL 负责把这些请求对应到厂商的模型 ID。漏掉哪一个,用到它的后台任务(生成标题、摘要、子智能体)往往就会悄悄失败。
多数厂商建议把这些写进 ~/.claude/settings.json 的 env 字段(Windows 上是用户目录下的 .claude\settings.json),按 JSON 的键和字符串值来写,这样不管怎么启动 Claude Code 都生效。在终端里 export 也行,但只对当前这个终端有效。有一点容易踩坑:按 Kimi 和阶跃星辰文档的说法,settings.json 里 env 的值会盖过终端里导出的同名变量。
两个习惯能省很多事。第一,套餐 Key 配套餐地址。这几家都另有按量付费的地址和 Key,混用要么报错,要么悄悄从账户余额扣钱,而不是走套餐额度。第二,开始前先清掉旧配置。MiniMax 和 BytePlus 都要求先 unset 终端里已有的 ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_BASE_URL(.bashrc、.zshrc 里写过的也要删),否则残留的值会覆盖新配置。
阿里云、BytePlus、Kimi 以及智谱国内站还会让你在 ~/.claude.json 里加上 "hasCompletedOnboarding": true。注意这和 settings.json 不是同一个文件。它的作用是跳过 Claude Code 首次启动时的 Anthropic 登录,没有 Anthropic 账号、或者人在 Claude Code 不提供服务的地区时,这一步本来会卡住。
GLM Coding Plan(智谱 Z.ai)
在 Z.ai 开放平台的 API Keys 页面创建一个 Key,然后在 env 里写:
- ANTHROPIC_AUTH_TOKEN:你的 Z.ai API Key
- ANTHROPIC_BASE_URL:https://api.z.ai/api/anthropic
- ANTHROPIC_DEFAULT_OPUS_MODEL:glm-5.3[1m]
- ANTHROPIC_DEFAULT_SONNET_MODEL:glm-5.3[1m]
- ANTHROPIC_DEFAULT_HAIKU_MODEL:glm-5.3-flash[1m]
- CLAUDE_CODE_AUTO_COMPACT_WINDOW:1000000
- CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC:1
- API_TIMEOUT_MS:3000000
所有档位都只能调用两个模型:GLM-5.3 和 GLM-5.3-Flash。模型名后面加 [1m]、再配上压缩窗口,就能用 1M 上下文;如果 Claude Code 提示带 [1m] 的模型不存在,智谱给的办法是升级 Claude Code。还有个小出入:同一页面上写的默认映射三个槽位都是 GLM-5.3-Flash,手动配置示例里 Opus 和 Sonnet 却用的 GLM-5.3。两个模型都在套餐里,用哪种都可以。
不想手改 JSON 的话,可以用智谱的 Coding Tool Helper(通过 npx 运行 @z_ai/coding-helper)自动配置。国内用户如果是在智谱 bigmodel.cn 开的套餐,Base URL 换成 https://open.bigmodel.cn/api/anthropic,Key 也用那边的。
按智谱的使用规则,套餐只能在官方支持的工具里用。Claude Code 在支持列表里,但订阅不能共享,违规多次可能被封号。
通义千问 Coding Plan(阿里云百炼)
在百炼的 Coding Plan 页面复制套餐专用 Key,格式是 sk-sp- 开头。百炼的通用 Key 以 sk- 开头,走按量计费,这里别用它。
- ANTHROPIC_AUTH_TOKEN:你的 sk-sp- Key
- ANTHROPIC_BASE_URL:https://coding-intl.dashscope.aliyuncs.com/apps/anthropic
- ANTHROPIC_MODEL:qwen3.7-plus
- ANTHROPIC_DEFAULT_HAIKU_MODEL:qwen3.7-plus
- ANTHROPIC_DEFAULT_SONNET_MODEL:qwen3.7-plus
- ANTHROPIC_DEFAULT_OPUS_MODEL:qwen3.7-plus
- CLAUDE_CODE_SUBAGENT_MODEL:qwen3.7-plus
再在 ~/.claude.json 里加上 "hasCompletedOnboarding": true,然后新开一个终端。阿里云国内站的账号,地址换成 https://coding.dashscope.aliyuncs.com/apps/anthropic。
只认下面这些模型 ID,而且区分大小写:推荐的 qwen3.7-plus、qwen3.6-plus、kimi-k2.5、glm-5、MiniMax-M2.5,以及 qwen3.5-plus、qwen3-max-2026-01-23、qwen3-coder-next、qwen3-coder-plus、glm-4.7。其他名字一律报错。
六家里规矩最严的就是这家。阿里云写明套餐只能在编程工具里交互使用,把 Key 用在自动化脚本、应用后端或任何非交互式调用上都算违规,可能被暂停订阅或封禁 Key。Key 仅限本人使用,套餐也不能退款。额度按模型调用次数算,不是按提问次数:阿里云说简单任务一般要 5–10 次调用,复杂任务 10–30 次甚至更多。额度用完请求就直接失败,不会自动转成按量付费。阿里云的常见问题里还提到,Claude Code 的 Agent Teams 在这个套餐上用不了。
MiniMax M Plan
在 MiniMax 控制台的 Plan Details 里拿到 Subscription Key。它和普通 API Key 是两套东西,不能混用。先把终端里旧的 ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_BASE_URL 清掉,再设置:
- ANTHROPIC_BASE_URL:https://api.minimax.io/anthropic
- ANTHROPIC_AUTH_TOKEN:你的 Subscription Key
- CLAUDE_CODE_AUTO_COMPACT_WINDOW:524288
- ANTHROPIC_MODEL:MiniMax-M3.1-Flash-Preview[1m]
- ANTHROPIC_DEFAULT_SONNET_MODEL:MiniMax-M3.1-Flash-Preview[1m]
- ANTHROPIC_DEFAULT_OPUS_MODEL:MiniMax-M3.1-Flash-Preview[1m]
- ANTHROPIC_DEFAULT_HAIKU_MODEL:MiniMax-M3.1-Flash-Preview[1m]
MiniMax 也有一键配置向导(运行 npx -y mmx-cli@latest agent setup,选 Claude Code),能把上面这些都写好。检查是否生效:在 Claude Code 里输入 /status,看到 api.minimax.io/anthropic 就对了;再输入 /model,应显示 MiniMax-M3.1-Flash-Preview。这个模型始终开启思考,关不掉。MiniMax 国内平台的地址是 https://api.minimax.cn/anthropic。
用量按 5 小时窗口和每周窗口计算,接入的所有工具共用一份。用 Subscription Key 时不会动你的账户余额;额度用完后,如果买了加量包,会接着扣加量包。MiniMax 把这个套餐定位为个人交互式使用,生产环境建议走按量付费。
Kimi Code(Kimi 会员)
需要开通带 Kimi Code 权益的 Kimi 会员,而且档位有讲究:新版 Go 档完全没有编程额度。在 Kimi Code 控制台创建 Key(只显示一次)。Kimi 的教程第一步是跑一小段脚本,跳过 Anthropic 登录,并清掉 settings.json 里旧的 ANTHROPIC 配置。也可以手动做:在 ~/.claude.json 里设 "hasCompletedOnboarding": true,再删掉旧的地址、Key 和模型配置。然后:
- ANTHROPIC_BASE_URL:海外用 https://api.kimi.ai/coding/,国内用 https://api.kimi.com/coding/
- ANTHROPIC_API_KEY:你的 Kimi Code Key(注意是 API_KEY,不是 AUTH_TOKEN)
- ANTHROPIC_MODEL、ANTHROPIC_DEFAULT_FABLE_MODEL、ANTHROPIC_DEFAULT_OPUS_MODEL、ANTHROPIC_DEFAULT_SONNET_MODEL、ANTHROPIC_DEFAULT_HAIKU_MODEL、CLAUDE_CODE_SUBAGENT_MODEL:都填 k3-256k
- CLAUDE_CODE_EFFORT_LEVEL:high
- CLAUDE_CODE_AUTO_COMPACT_WINDOW:262144
- CLAUDE_CODE_MAX_CONTEXT_TOKENS:262144
能用哪些模型取决于会员档位。Plus(旧版叫 Moderato)可以用 k3、k3-256k 和 kimi-for-coding。Pro 及以上(旧版 Allegretto 及以上)多一个 kimi-for-coding-highspeed,还能用 1M 版的 k3:所有模型槽位都填 k3[1m],两个窗口值都改成 1048576。Kimi 说 1M 的 k3 消耗额度约是 k3-256k 的两倍。旧版 Andante 会员只能用 kimi-for-coding。
Claude Code 问是否使用这个 API Key 时,选是。/status 里如果还显示 Claude 的模型名,不用慌,只要 Base URL 显示的是 api.kimi.ai/coding/,请求就是发给 Kimi 的。Kimi 还提醒:篡改客户端的 User-Agent 算违规,可能被停掉会员权益。
BytePlus ModelArk Coding Plan
在 ModelArk 控制台创建 API Key。先清掉旧的 ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_BASE_URL,再设置:
- ANTHROPIC_AUTH_TOKEN:你的 ModelArk API Key
- ANTHROPIC_BASE_URL:https://ark.ap-southeast.bytepluses.com/api/coding
- ANTHROPIC_MODEL、ANTHROPIC_DEFAULT_HAIKU_MODEL、ANTHROPIC_DEFAULT_SONNET_MODEL、ANTHROPIC_DEFAULT_OPUS_MODEL、CLAUDE_CODE_SUBAGENT_MODEL:填 ark-code-latest,或具体的模型名
- CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC:1
然后在 ~/.claude.json 里加上 "hasCompletedOnboarding": true。地址要看仔细:BytePlus 提醒,以 /api/v3 结尾的普通模型地址不走套餐额度,会另外计费。关闭非必要流量这一项在这里比想象中重要。BytePlus 说,不设的话 Claude Code 的后台遥测请求也会走你的 Base URL,白白消耗套餐额度。
用 ark-code-latest 时,在控制台的管理页面选模型,3–5 分钟后生效。填具体模型名时,就在 Claude Code 里切换(启动时用 claude --model 加模型名,会话中用 /model)。可用的模型有 dola-seed-2.0-pro、dola-seed-2.0-lite、dola-seed-2.0-code、bytedance-seed-code、glm-5.3-flash、glm-5.2、glm-5.1、kimi-k2.5、gpt-oss-120b、deepseek-v4.1-flash、deepseek-v4-flash 和 deepseek-v4-pro。BytePlus 建议 Haiku 槽位填小模型。glm-5.2、deepseek-v4-flash、deepseek-v4-pro 要用 1M 上下文,就在模型名后加 [1m],并把 CLAUDE_CODE_AUTO_COMPACT_WINDOW 设为 1000000。如果之前登录过 Claude Code、出现登录提示,先输入 /logout 再重新启动。
套餐额度只能在支持的编程工具里用,不能拿来做 API 调用。BytePlus 说,在别处使用套餐的 Key 和地址可能被认定为滥用,导致订阅停用或账号封禁。不想手改文件的话,可以用 BytePlus 的 ArkCLI Helper 自动配置 Claude Code。
阶跃星辰 Step Plan
在阶跃开放平台的 API Keys 页面创建 Key。阶跃的配置是六家里最省事的:
- ANTHROPIC_AUTH_TOKEN:你的 Step API Key
- ANTHROPIC_BASE_URL:https://api.stepfun.ai/step_plan
- model:step-5-preview(这一项写在 settings.json 的最外层,不在 env 里)
也可以把 ANTHROPIC_DEFAULT_SONNET_MODEL、ANTHROPIC_DEFAULT_OPUS_MODEL、ANTHROPIC_DEFAULT_HAIKU_MODEL、ANTHROPIC_DEFAULT_FABLE_MODEL 和 CLAUDE_CODE_SUBAGENT_MODEL 都映射到 step-5-preview。Step Plan 的其他模型 ID 有 step-3.7-flash、step-3.5-flash-2603 和 step-3.5-flash。Step 5 Preview 有 1M 上下文,但 Claude Code 可能按 200K 来算。解决办法是把 CLAUDE_CODE_MAX_CONTEXT_TOKENS 和 CLAUDE_CODE_AUTO_COMPACT_WINDOW 设为 1000000(写纯数字,别写 1M)。推理强度分 low、medium、high 三档,xhigh 和 max 会按 high 处理。
地址后面别加 /v1。Claude Code 会自己补上 /v1/messages;而只写 https://api.stepfun.ai 的话走的是按量付费通道,不扣套餐。阶跃用 Claude Code 2.1.209 做过兼容性验证。和其他几家不同,Step Plan 的官方介绍写明没有平台限制,Credits 按月发放,没有 5 小时窗口,也不限请求频率。
怎么切回 Claude
Claude Code 官方文档解释了为什么这一步要小心:ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_API_KEY 的优先级都高于 Claude 订阅登录,只要其中一个还在,你的 Pro 或 Max 套餐就不会被用上。切回去的步骤:
- 删掉 env 里厂商相关的配置:ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN 或 ANTHROPIC_API_KEY、所有模型映射变量,以及 CLAUDE_CODE_AUTO_COMPACT_WINDOW、CLAUDE_CODE_MAX_CONTEXT_TOKENS、CLAUDE_CODE_EFFORT_LEVEL、API_TIMEOUT_MS 这类附加项。用过阶跃的,还要删掉最外层那行 model。
- 检查终端配置文件和项目里的 .claude/settings.json 有没有残留。
- ANTHROPIC_BASE_URL 也要删,别只删 Key。Anthropic 文档说,只留着地址的话,Claude Code 照样把请求发过去,只是带上的是你的 claude.ai 登录凭证。
- 设过 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 的,要直接删掉,别改成 0。改成 0 在 Claude Code 看来仍然是开启。
- 新开终端,启动 claude,需要时输入 /login,再用 /status 看当前用的是哪种凭证。
经常来回切的话,别老改同一个文件。Claude Code 的 --settings 参数可以只为本次会话加载一个设置文件,每家厂商各存一份,主配置留给 Claude 就行。阿里云、MiniMax 和 BytePlus 的文档也都提到了 CC Switch,一个社区开源的桌面工具,点一下就能切换。
常见报错
- 401、Key 无效、认证失败 — 多半是 Key 和地址对不上:按量付费的通用 Key 配了套餐地址,或者反过来;复制 Key 时多了空格;订阅已过期。Kimi 要确认 Key 填在 ANTHROPIC_API_KEY 里。阶跃提醒,别只改了 ANTHROPIC_API_KEY,却把旧的 ANTHROPIC_AUTH_TOKEN 留着。
- 提示 Unable to connect to Anthropic services,并提到 api.anthropic.com — Claude Code 还在连 Anthropic。要么配置没加载,要么 ~/.claude.json 里没设 "hasCompletedOnboarding"。新开终端,用 /status 查一下。
- 404 且没有返回内容 — 地址末尾多了一段路径。阿里云和阶跃都要求 Claude Code 里的地址不带 /v1。
- 模型不支持或找不到 — 模型 ID 拼错或大小写不对、套餐里没有这个模型,或者某个槽位没映射。如果只有后台任务或子智能体报错,通常是 Haiku、Fable 或子智能体槽位漏了。
- 买了套餐还在扣余额 — 你走的是按量付费通道。在智谱这表现为 1113 余额不足报错。检查地址里是否带套餐路径(coding、api/anthropic、step_plan 等),以及用的是不是套餐 Key。
- 额度报错 — 阿里云碰到上限会返回 hour allocated quota exceeded(或 week、month),高峰期还可能出现 concurrency allocated quota exceeded。阶跃返回 402 quota_exceeded。智谱、MiniMax 和阿里云在高峰时段都会收紧并发。
- 改了配置不生效 — settings.json 里的残留值会盖过终端变量,终端 export 也只管当前会话。彻底退出 Claude Code 再重启。
下单前要知道的事
套餐规则是认真的。 这些订阅都是给一个人在编程工具里交互使用的。阿里云明令禁止脚本和后端调用;智谱和 BytePlus 限定在支持的工具里用;Kimi 禁止伪装客户端;MiniMax 建议生产环境走按量付费;只有阶跃写明没有平台限制。阿里云和智谱的套餐都不能退款,最好先从最便宜的档位试起。
额度掉得比想象中快。 Claude Code 做一个任务要调用很多次模型:读文件、跑工具、检查结果。按请求或调用次数计的套餐,消耗速度比聊天快得多。
部分 Claude Code 功能会失效。 按 Anthropic 文档的说法,ANTHROPIC_BASE_URL 一旦指向 Anthropic 以外的地址,Remote Control 就会关闭,MCP 工具搜索默认也会关掉。Claude Code 自带的网页搜索是服务端工具,Anthropic 只列了自家 API 和几个云平台可用;这几家的 Claude Code 文档都没承诺能用,智谱和 MiniMax 另外提供了自己的网页搜索 MCP。接口不支持计算 Token 的话,/context 显示的只是估算值。网页版的云端会话始终用你的 Claude 订阅,不读这些变量。另外,智谱和 BytePlus 推荐设置的 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 会顺带关掉 Claude Code 的自动更新,记得隔一阵手动运行 claude update。
留意数据条款。 阿里云国内站的页面写明,使用 Coding Plan 期间,模型输入和生成内容会用于服务改进与模型优化;我们看的国际站页面没有提这一点。选哪家,都建议读一下它的隐私条款。
名字变得很快。 好几家今年都改过套餐:阿里云停售了 Lite,MiniMax 用 M Plan 替换了 Token Plan,Kimi 推出了新的会员档位,阶跃改成了按 Credits 计费。本文内容以 2026 年 10 月 8 日为准;哪天配置突然不灵了,先去看厂商的 Claude Code 接入页。
