Claude Code 接入 GLM-5.3 教程:智谱官方配置与成本对比(2026)
按智谱 / Z.AI 官方文档,用 Anthropic 兼容接口让 Claude Code 跑在 GLM-5.3 和 GLM-5.3 Flash 上:settings.json 完整配置、按量付费和 GLM Coding Plan 该用哪种 key,以及和 Claude Opus 5.5 的成本测算。
智谱(国际站 Z.AI)官方文档介绍了如何通过 Anthropic 兼容端点让 Claude Code 跑在 GLM-5.3 上。可以用标准 API key 按 token 付费,也可以用 GLM Coding Plan 订阅的 key。配置方式一样,计费方式由 key 决定。
本文按智谱 BigModel 的 Claude Code 文档 和 Z.AI 的 Claude Code 文档、切换模型指南、API Key 管理指南 整理,核对日期 2026-11-16。价格来自 Z.AI 价格页 和 Anthropic 官方价格页,与本站模型数据一致。
谁来支持这套配置: 这是智谱 / Z.AI 官方文档写明并支持的接法。Anthropic 的 Claude Code 文档写明 Anthropic 不支持把 Claude Code 路由到非 Claude 模型。
先看结论
| 配置项 | 值 |
|---|---|
| 端点(国内 BigModel 开放平台) | https://open.bigmodel.cn/api/anthropic |
| 端点(国际站 Z.AI) | https://api.z.ai/api/anthropic |
| Opus 和 Sonnet 档 | glm-5.3[1m] |
| Haiku 档 | glm-5.3-flash[1m] |
| 写在哪里 | ~/.claude/settings.json 的 env 字段 |
| 计费 | 由 key 类型决定(见下文) |
第一步:选对 API Key
Z.AI 国际站从 2026-10-16 起把标准 API 和 GLM Coding Plan 的 key 分开管理;此日起新建的 key 由 key 类型决定计费,与调用哪个端点无关:
| 需求 | key 类型 | 计费方式 |
|---|---|---|
| 按 token 付费 | 标准 API Key | 账户余额或资源包,不消耗 Coding Plan 额度 |
| 使用个人 GLM Coding Plan | 个人 Coding Plan key | 套餐的 5 小时和每周额度 |
| 使用团队套餐 | Team Plan key | 团队套餐和席位规则 |
Z.AI 举的例子:即使你订阅了 Coding Plan,在编程工具里用标准 key 也会按量扣费。2026-10-16 之前创建的 key 已自动归类,不确定的话去控制台看 key 的标签。以上规则来自 Z.AI 国际站文档;国内 BigModel 平台请以其控制台和文档为准。
第二步:安装 Claude Code
npm install -g @anthropic-ai/claude-code
cd your-project
claude
需要 Node.js 18 及以上,Windows 还需要 Git for Windows。
第三步:配置 settings.json
智谱 BigModel 文档的手动配置(在 ~/.claude/settings.json 中新增或修改这些键,不要覆盖其他字段):
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
"ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-5.3-flash[1m]",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-5.3[1m]",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-5.3[1m]",
"CLAUDE_CODE_AUTO_COMPACT_WINDOW": "1000000",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1,
"API_TIMEOUT_MS": "3000000",
"DISABLE_TELEMETRY": "1",
"CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT": "0",
"CLAUDE_CODE_MAX_CONTEXT_TOKENS": "1000000"
}
}
国际站 Z.AI 的 key 把 ANTHROPIC_BASE_URL 换成 https://api.z.ai/api/anthropic,其余相同。BigModel 文档还要求在 ~/.claude.json 里加上 "hasCompletedOnboarding": true。
配置完成后打开一个新终端,在项目目录运行 claude;如果提示 “Do you want to use this API key”,选 Yes。这个文件里有明文 key,不要提交到 git。
想全部用更便宜的 Flash,Z.AI 的切换指南是把三个档位都设成 glm-5.3-flash[1m]。
智谱也提供自动配置脚本和 npx @z_ai/coding-helper 工具,写入的是同一个文件。上面的手动配置能让你看清每一项改动。
换成 GLM-5.3 后有哪些变化
| 方面 | 变化 |
|---|---|
| Claude 订阅 | ANTHROPIC_AUTH_TOKEN 里是智谱的 key,Claude Pro/Max/Ultra 额度不会被使用。 |
| 推理 | GLM-5.3 始终开启推理,有 low、high、max 三档强度。 |
| 遥测 | 官方配置关闭了 Claude Code 的非必要流量和遥测。 |
| Coding Plan 适用工具 | Z.AI 规定 GLM Coding Plan 只能在官方支持的工具中使用,Claude Code 在支持列表内。 |
成本:按量付费
根据 Anthropic 的模型配置文档,Claude Code 在付费套餐和 API 上默认使用 Claude Opus 5.5。下表使用 Z.AI 国际站美元价格;国内 BigModel 平台按人民币计费,请以其价格页为准。
假设用量: 每月 1 亿(100M)输入 token、200 万(2M)输出 token,90% 输入命中缓存(90M 命中、10M 未命中),全部走 Opus/Sonnet 档。不计 Anthropic 的缓存写入加价。
| 模型 | 未命中输入 | 缓存命中输入 | 输出 | 每月合计 |
|---|---|---|---|---|
| Claude Opus 5.5 | 10M × $4.00 = $40.00 | 90M × $0.20 = $18.00 | 2M × $20.00 = $40.00 | $98.00 |
| Claude Sonnet 5.5 | 10M × $2.00 = $20.00 | 90M × $0.10 = $9.00 | 2M × $10.00 = $20.00 | $49.00 |
| GLM-5.3 | 10M × $1.40 = $14.00 | 90M × $0.26 = $23.40 | 2M × $4.40 = $8.80 | $46.20 |
| GLM-5.3 Flash | 10M × $0.15 = $1.50 | 90M × $0.03 = $2.70 | 2M × $0.50 = $1.00 | $5.20 |
按量付费时,GLM-5.3 在这个用量下不到 Opus 5.5 的一半,但和 Sonnet 5.5 差不多:它的缓存读取价($0.26/M)比 Sonnet($0.10/M)高,而 Agent 流量里缓存读取占大头。GLM-5.3 Flash 才是便宜选项,约为 Opus 的 5%。
成本:GLM Coding Plan 额度
Z.AI 公开了 GLM Coding Plan 的计量方式,可以估算你的用量够不够:
- 消耗额度 =(输入 token × 输入倍率 + 缓存 token × 缓存倍率 + 输出 token × 输出倍率)/ 10,000。
- GLM-5.3 倍率:输入 6.9、缓存输入 1.7、输出 24。GLM-5.3 Flash:2.3、0.56、8。
- 闲时按标准额度的 50% 计算。高峰为周一至周五 14:00-18:00(新加坡时间 UTC+8,与北京时间相同)。
| 套餐 | 5 小时额度 | 每周额度 |
|---|---|---|
| Lite | 2,000 | 10,000 |
| Pro | 12,000 | 60,000 |
| Max | 28,000 | 140,000 |
同样的用量全部按高峰计算:
- 未命中输入:10,000,000 × 6.9 / 10,000 = 6,900
- 缓存输入:90,000,000 × 1.7 / 10,000 = 15,300
- 输出:2,000,000 × 24 / 10,000 = 4,800
- 合计每月 27,000 额度,按每月 4.33 周算约每周 6,200。
如果均匀分布,这在 Lite 每周 10,000 的额度以内,闲时使用还能再减半;对集中爆发式的使用来说,Lite 每 5 小时 2,000 的上限更容易先碰到。Z.AI 文档只写了套餐起价每月 $18,没有列出 Pro 和 Max 的价格,购买前请看订阅页面。以上额度规则来自 Z.AI 国际站,国内 BigModel 的 GLM Coding Plan 价格和额度请以其官网为准。
常见问题
| 现象 | 处理方法 |
|---|---|
| 配置不生效 | 关闭所有 Claude Code 窗口,打开新终端;检查 JSON 格式 |
| 没有消耗套餐额度 | 可能用的是标准 key,请在 Personal Coding Plan 下新建 Coding Plan key |
| 出现意外的按量扣费 | 同上,计费由 key 类型决定,而不是端点 |
| 旧模型名 | Coding Plan 会把 GLM-5.2/5.1 请求路由到 GLM-5.3,但建议显式写 glm-5.3 |