DevTk.AI
GLM-5.3Claude Code智谱Z.AIAI 编程

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 的成本测算。

作者 发布于 11 分钟阅读

智谱(国际站 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.510M × $4.00 = $40.0090M × $0.20 = $18.002M × $20.00 = $40.00$98.00
Claude Sonnet 5.510M × $2.00 = $20.0090M × $0.10 = $9.002M × $10.00 = $20.00$49.00
GLM-5.310M × $1.40 = $14.0090M × $0.26 = $23.402M × $4.40 = $8.80$46.20
GLM-5.3 Flash10M × $0.15 = $1.5090M × $0.03 = $2.702M × $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 小时额度每周额度
Lite2,00010,000
Pro12,00060,000
Max28,000140,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

相关阅读

下一步

相关文章