在 Claude Code 里用 GLM 编程套餐：完整配置步骤

2026-08-25

数据截至 2026-08，价格与限额以各官网为准。本文只讲计费与接入机制，不列具体价格数字。

把 GLM Coding Plan 接进 Claude Code，真正的难点不是装工具，而是三件事必须同时对：用的是编程套餐那把 Key（团队版的 Key 与平台其他 API Key 不通用）、Base URL 指向 Anthropic 兼容端点、settings.json 的 env 里把模型参数换成 GLM 模型编码。这三件事在官方文档里对应的失败现象并不相同，值得先分清：官方 FAQ 把「购买了编码套餐还报错 1113 余额不足、还扣账号余额」归因于三个使用条件没满足——工具不在官方指定的工具与产品环境内、没有配置特定的 Base URL 地址、以及官网体验中心本身不支持编码套餐；而 settings.json 写错会不会导致套餐额度不生效，官方文档里没有找到相关说明，能查到的只有一条：模型编码加 [1m] 后缀后若 Claude Code 提示识别模型不存在，需要升级 Claude Code 到最新版本重试。所以配完之后别急着干活，先用 /status 看一眼 Settings source 和 Model 两行，确认读的是你改的那个文件、跑的是你想要的那个模型。

先认清一条规则：套餐额度只在指定工具里生效

这条规则决定了后面所有配置动作的意义。官方文档写得很直白：GLM Coding Plan 仅限在官方支持的指定工具与产品环境中使用，在规定工具之外调用 API，不能享用 Coding 套餐的额度。如果你要在自建应用、网站、机器人、SaaS 产品里通过 API 集成模型能力，官方给的路径是改用标准 API 服务，按对应协议计费。

官方的适用工具清单里，Coding Agent 一类包含 Claude Code、Claude for IDE、ZCode、Codex、OpenCode、Cline、Roo、Kilo、Cursor、Crush、Goose、Droid、TRAE、CodeBuddy、Lingma、Qoder、Pi Coding Agent 等；另有一类叫「通用 Agent 工具」。这份清单官方会随支持范围调整，你动手前最好去接入工具页确认当前版本里有没有你要用的那个工具。这两类的待遇不一样——官方在文档里专门提示，编程任务请求会被优先保障，通用 Agent 工具采用次级调度与尽力交付策略，Coding Agent 任务享有资源抢占优先权，高负载时通用 Agent 工具的任务会自动触发动态排队、限流等公平使用策略。所以如果你打算把套餐挪去驱动一个通用助手，心里要先有这个预期。

另一条容易被忽略的红线是账号共享。官方明确写了套餐为订阅人专享，禁止账号共享或多人共用，违规可能触发风控被限流、冻结，多次违规可能封禁账号。这不是吓唬人的话术，文档里单开了一节讲永久封禁的判定原则。

第一步：取到正确的那把 API Key

套餐分个人版和团队版，取 Key 的入口不同，这一步搞混后面全白搭。

个人版套餐用户：从「个人编程套餐 > 套餐概览」页面新建 API Key。
团队版套餐成员：从「团队编程套餐 > 我的套餐」获取 API Key。

官方在多个页面反复强调同一句话：团队套餐 Key 与平台其他 API Key 不通用，使用团队额度请务必使用团队套餐 Key。之所以要反复说，是因为很多人手里早就有一把智谱平台的普通 API Key，顺手就填进去了——调用能通，但走的不是套餐额度。

官方同时提示不要把 Key 硬编码进代码，建议设置为环境变量。这一点和站内那篇API Key 安全管理讲的通用做法是一致的，编程套餐的 Key 因为绑定订阅权益，泄露的后果比一把按量计费的 Key 更严重。

第二步：Base URL 必须选对协议端点

GLM Coding Plan 同时支持 Anthropic 协议和 OpenAI 协议接入，官方列出的编程端点是三个：

协议类型	Base URL
Anthropic Message 协议	`https://open.bigmodel.cn/api/anthropic`
OpenAI Chat Completion 协议	`https://open.bigmodel.cn/api/coding/paas/v4`
OpenAI Response 协议	`https://open.bigmodel.cn/api/v1`

Claude Code 走的是第一个。官方在「如何切换模型」页面把这层对应关系写得更明确：Claude Code 与 Goose 属于 Anthropic 兼容，用 api/anthropic；Codex 用 api/v1；其他 OpenAI 兼容工具用 api/coding/paas/v4。

端点填错的后果，官方在两个地方分别写过，合起来看更完整。接入工具页的警示很短：错误配置端点将导致无法使用 GLM Coding Plan 套餐额度。FAQ 里则给了具体表现——「为什么购买了编码套餐还报错 1113 余额不足？为什么购买了编码套餐还扣账号余额？」这一问的答案，把「配置特定的 Base URL 地址才能使用」列为三个可能原因之一，另外两个是套餐仅限在官方支持的指定工具与产品环境中使用、官网体验中心不支持使用编码套餐。也就是说，端点错了不一定是悄无声息的，它可能表现为一条余额不足的报错，也可能表现为账号余额在掉，两种都不能当成「和配置无关」。文档还补了一句细节：Cherry Studio 配的地址结尾带斜杠（api/coding/paas/v4/），Claude Code 和 Cherry Studio 之外的工具用不带斜杠的写法。另外官网体验中心不支持使用编码套餐。

关于「怎么确认自己扣的到底是不是套餐」，官方给的办法是去费用明细页面看抵扣资源包那一列。这是唯一可靠的自证方式，比凭感觉判断靠谱得多，具体怎么把它纳入日常监控可以参考API 成本监控怎么做。

至于智谱这套 Anthropic 兼容层本身还有哪些差异，官方只留了一句提醒——某些场景下智谱与 Claude 接口仍存在差异，但不影响整体兼容性——具体差异点见GLM 兼容 Anthropic Claude API 的接法与差异。

第三步：改配置，两条路选一条

路线一：官方一键安装助手

智谱提供了一个命令行助手，NPM 包名是 @z_ai/coding-helper，前提条件是 Node.js 18 或更新版本。它当前支持的编码工具包括 Claude Code、Codex、OpenCode、Crush、Factory Droid，还内置了 Claude Code 插件市场。

两种启动方式：偶尔用就 npx @z_ai/coding-helper；经常用就全局安装后运行 coding-helper 或简写 chelper。向导的流程是选界面语言 → 选编码套餐 → 输入 API 密钥 → 选要管理的工具 → 自动安装工具 → 进入工具管理菜单 → 装载编码套餐到工具 → 管理 MCP 服务 → 启动编码工具。

除了交互式向导，它还能直接带参数执行。和 Claude Code 关系最直接的两条是 coding-helper auth reload claude（把最新套餐信息加载到 Claude Code）和 coding-helper doctor（检查系统配置和工具状态）。遇到问题时官方建议先跑 doctor。

助手本身也有几个已知坑，官方文档列了排查方案：npm 全局安装报 EACCES: permission denied，可以加 sudo、以管理员身份运行、或者干脆改用 npx；Node.js 程序不会自动使用系统代理，需要显式配置 HTTP_PROXY 和 HTTPS_PROXY 环境变量；Factory Droid 装完 droid 命令找不到，可能要手动把可执行文件路径加进 PATH；Claude Code 插件市场里插件状态显示不对，官方给的解法是执行 claude update 升级 Claude Code。

路线二：手动改 settings.json

如果你想自己掌控，就直接编辑 Claude Code 的配置文件。官方给出的位置是：macOS 与 Linux/WSL 下是 ~/.claude/settings.json，Windows 下是 %USERPROFILE%\.claude\settings.json。

这里有个坑官方专门加了提示：如果你用 Git Bash 或 WSL，~/.claude 可能解析到不同的主目录；同时装了 WSL 和 Windows 原生 Claude Code 的人，两边配置文件位置也可能不同。**务必确认你编辑的，是当前实际启动的那个 Claude Code 安装所读取的文件。**改了半天没生效，十有八九是改错了文件。

官方给出的 env 配置形态是这样的：

{
  "env": {
    "CLAUDE_CODE_AUTO_COMPACT_WINDOW": "1000000",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-4.7",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-5.3[1m]",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-5.3[1m]"
  }
}

官方只给了这段 JSON，并说明使用 GLM-5.3 需要在 settings.json 中添加或替换如上环境变量参数，至于 Claude Code 内部怎么用这三个变量，官方文档里没有找到相关说明。所以这里只说能确认的部分：要改的是三个独立的变量，而不是一个「当前模型」开关；官方示例里这三行填的值并不相同，ANTHROPIC_DEFAULT_HAIKU_MODEL 填的是 glm-4.7，ANTHROPIC_DEFAULT_SONNET_MODEL 和 ANTHROPIC_DEFAULT_OPUS_MODEL 填的都是 glm-5.3[1m]。落到操作上，你要做的是逐行核对：三行都在不在、值有没有写成 GLM 的模型编码、有没有漏掉其中一行还留着原来的值。另外那条 CLAUDE_CODE_AUTO_COMPACT_WINDOW 不是模型名，它配的是压缩窗口大小，和下面 1M 上下文那段是一套。具体模型编码与上下文配置请以官方文档当前版本为准。

关于 1M 上下文，官方说明是模型编码后缀要加 [1m]，也就是写成 glm-5.3[1m]，同时要配上压缩窗口大小参数 CLAUDE_CODE_AUTO_COMPACT_WINDOW。如果加了 [1m] 后 Claude Code 提示模型不存在，官方给的解法是升级 Claude Code 到最新版本再试。

第四步：用 /status 验收，别凭感觉

配完之后，官方给的验收动作很具体：启动一个新的命令行窗口，运行 claude 打开 Claude Code，输入 /status，看两行——

Settings source 是否显示你刚才改的那个 ~/.claude/settings.json；
Model 是否显示你配的 GLM 模型编码。

「启动一个新的命令行窗口」这句别跳过。旧窗口里的进程读的还是旧配置，你在老会话里怎么看都是原样，很容易误判成配置没生效然后回头乱改。

思考强度怎么切：/effort 与档位映射

Claude Code 会话里输入 /effort 命令可以切换思考强度，官方说明默认是 max 档。真正值得记的是它背后那张转换表——工具传进来的各种参数，服务端会归一到 low / high / max 三个实际档位：thinking.type 未传或为 true、enabled、adaptive 时用默认档；为 false、disabled、none、off 时落到 low，注意官方写的是「继续请求；仍会轻量思考」，也就是说关掉不等于完全不思考；reasoning_effort 传 minimal、light、low 自动转 low，medium、high 转 high，xhigh、max、ultra 转 max；传了未知字符串则回退默认档并记录提示。

优先级顺序官方也写明了：显式 Effort > thinking 开关 > 默认 max。还有一句容易被误解的补充——Claude Code 用的是 thinking.type 和 output_config.effort，Codex 用的是 reasoning.effort；关闭思考配置只会转换为 low 档，不会切换到其他模型。

这件事和用量直接相关。默认 max 意味着不动它就是最高档，日常琐碎任务是否值得一直挂在最高档，取决于你怎么算自己的额度消耗，可以对照GLM 编程套餐的用量怎么算那篇一起看。

顺手把 GLM 的 MCP 装上

套餐用户可以用官方提供的几个 Local MCP Server，其中视觉理解 MCP 基于 GLM-4.6V 能力，官方文档明确说它可为 Claude Code、Cline 等兼容 MCP 的客户端提供图像分析、视频理解等能力。

在 Claude Code 里装它，官方给的一键命令形态是 claude mcp add -s user zai-mcp-server --env Z_AI_API_KEY=YOUR_API_KEY -- npx -y "@z_ai/mcp-server"。如果 Key 填错了要重来，得先 claude mcp list 看一眼再 claude mcp remove zai-mcp-server 卸掉旧的，直接重装是不行的。手动配置的话，改的是用户目录下 .claude.json 的 mcpServers 部分——注意这个文件和前面的 settings.json 不是同一个，一个管 MCP，一个管模型映射，别改串了。

环境变量只有两个：Z_AI_API_KEY 必填，Z_AI_MODE 用来选服务平台，官方列出的可选值是 ZHIPU 或 ZAI。

Windows 用户有两条官方提示：PowerShell 里执行上面那条命令如果 -y 参数出问题，换 CMD 执行；看到 Windows requires 'cmd /c' wrapper to execute npx 这个告警可以忽略。另外官方提醒老用户可能命中 npx 旧缓存版本，需要删缓存或者给包名加 @latest 强制装最新版。

还有一个信息值得单独记：官方说明在 Claude Code 里用 GLM Coding Plan 时，模型服务端已内置 image_analysis 工具，具备图片理解能力，无需安装 MCP；只有当你要用全套视觉工具时才需要装。

配好之后最容易栽的几个坑

并发别开太猛。 官方按套餐等级给了并发建议，原则是 Max > Pro > Lite，并写明会根据资源动态调整，低峰期套餐用户享有动态提升的并发权益。文档给的建议是 Lite 同时开单个项目、Pro 同时开一到两个项目、Max 可以更多。用 Subagent 的时候尤其要留意，那本质上就是在并发调用模型。

额度耗尽不会偷偷扣你别的钱。 这条是好消息：官方 FAQ 明确回答，套餐额度耗尽后系统不会继续消耗你的其他资源包或账户余额，需要等下一个周期恢复。所以如果你发现账户余额在掉，那不是额度用完了，而是前面某个配置没对上。

套餐过期后，Claude Code 里用不了资源包。 官方原话是 Claude Code 中暂不支持使用其他资源包；在其他编码工具里可以把 Base URL 换成 https://open.bigmodel.cn/api/paas/v4 来用资源包调用。注意这个地址和前面三个编程端点都不一样，别记混。

重复购买不是叠加时间。 官方说明再次购买或升级编码套餐时，之前的套餐会作废，未使用时间折成剩余价值计入本次购买。升级的流程是在套餐计划页点订阅升级、选目标套餐、支付差额后立即生效。取消自动续费要在下一个扣费日之前留足提前量，具体天数以官方页面为准；订阅一经购买不支持退款。

收尾：出问题时的排查顺序

真遇到「配了但好像没用上」，按这个顺序查最省时间：先去费用明细看抵扣资源包那一列，确认到底扣的是不是编码套餐；确认了不是，再回头核 Base URL 是不是 Anthropic 端点；端点没错，就查 Key 是不是从编程套餐页面取的那把（团队成员尤其要确认不是随手拿的平台通用 Key）；这三样都对，再用 /status 确认 Claude Code 读的是你改的那个配置文件——Git Bash、WSL、Windows 原生三种环境混装的机器，这一步的命中率高得出乎意料。实在定位不了，跑一次 coding-helper doctor 让它自己体检。

最后提醒一句：本文依据的是智谱官方的快速开始、接入工具、切换模型、常见问题、使用须知与 MCP 相关页面。Claude Code 的接入细节官方另有单独的工具页面，本文引用范围内没有覆盖到那一页的全部内容，配置字段的最终形态请以官方 Claude Code 接入文档当前版本为准。