Z.ai Coding Plan：Base URL 与 API key 配置
发布于:
阅读时间: 2 min
主题: 技术
作者: Leandro Valencia
GLM Coding Plan 的确切端点：Claude Code 和 Cline 各自的 base URL、该用哪把 key，以及为什么端点用错时额度永远不会被扣。
目录
- 端点，不绕弯子
- 官方捷径
- Claude Code，逐步配置
- Cline、Roo 和 OpenAI 兼容客户端
- 没人诊断得出来的错误："能用，但什么都不扣"
- 到底该创建哪把 key
- Lite、Pro 和 Max：实际变化的只有这些
- 配置清单
- 继续阅读
端点，不绕弯子
| 工具 | Base URL |
|---|---|
| Claude Code（Anthropic 兼容端点） | https://api.z.ai/api/anthropic |
| Cline、Roo、Kilo、VS Code（OpenAI 兼容） | https://api.z.ai/api/coding/paas/v4 |
| 引导式配置 | npx @z_ai/coding-helper |
两种情况下，token 都是你的 GLM Coding Plan API key。
而这里有个烧钱的细节：两者不能互换。/api/anthropic 是 Claude Code 认识的端点，/api/coding/paas/v4 是 OpenAI 兼容的。把一个贴到另一个该在的地方，要么能用但额度永远不掉，要么直接失败而且报错不告诉你为什么。
官方捷径
动手手动配置之前：
npx @z_ai/coding-helper
Z.ai 的助手会带你完成工具和套餐的安装配置。如果你不确定哪个端点适用于你，这条路把问题整个消掉：它替你写好配置。
什么时候手动配置才合理：你已经清楚自己要什么、要在多台机器上自动化部署，或者助手不支持你的客户端。
Claude Code，逐步配置
思路是让 Claude Code 指向 Z.ai 而不是 Anthropic：
- Base URL:
https://api.z.ai/api/anthropic - Token: 你的 Coding Plan API key
当前细节在 Z.ai 的 Claude Code 文档。我强调"当前"：如果你照抄一篇 2024 年的、URL 不同的教程，结果要么是把额度烧在错误的地方，要么是根本不烧。
Cline、Roo 和 OpenAI 兼容客户端
在 VS Code 里用 Cline：
- API Provider →
OpenAI Compatible（如果列表里出现 "Z AI" 供应商就选它）。 - Base URL →
https://api.z.ai/api/coding/paas/v4 - API Key → 你的 Coding Plan key。
- Model → 你套餐里可用的 GLM。
Z.ai 的 Cline 文档比你在论坛里翻到的任何旧截图都可靠。
OpenCode、Roo 以及其他客户端都是同一个模式：coding 端点 + 套餐 key。
没人诊断得出来的错误："能用，但什么都不扣"
这是最贵也最安静的故障，所以它值得单独一节。
有两种错法，症状完全相同：
1. 端点错了。 如果你贴的是通用聊天端点而不是 coding 端点，请求可能照样成功，但它不走你的订阅额度。Z.ai 在文档里明确写了这一点。
2. key 错了。 如果你付了订阅费，却创建了按用量付费 key 而不是 Coding Plan key，用量会被单独计费。你付两遍钱：为没在用的订阅付一遍，为正在用的用量再付一遍。
怎么抓出来：发一条真实提示词——不是"你好"——然后盯着控制台里的用量。数字不动，这两个问题你必占其一。
到底该创建哪把 key
付款到账后，进控制台（标签页叫 API Keys 或 Billing 之类的名字；每次改版名字都会变，概念不会）：
- 创建 Coding Plan key。不是单独的按用量付费 key。
- 只复制一次。把它当密码对待。
- 不要推进 repo，不要贴进 Discord，不要留在截图里。
以后轮换 key，你更新工具就行；不需要再付一次套餐的钱。
Lite、Pro 和 Max：实际变化的只有这些
三档套餐用的是同一批模型。唯一变化是你拿到多少额度。
这让决策比看起来简单：从 Lite 月付开始，真的不够用了再升。两条具体警告：
- Z.ai 订阅购买后不可退款。
- 第一天别跟 Max 年付锁死。大数字闻着像"省钱"，其实是承诺。
如果你在拿这个套餐和 OpenCode 的订阅做比较，我们在Z.ai GLM与OpenCode Go：价格和套餐对比里拆解过。
配置清单
- 创建了 Coding Plan key（不是按用量付费的）。
- 工具对应的端点没错：Claude Code 用
/api/anthropic，OpenAI 客户端用/api/coding/paas/v4。 - 发出过一条真实提示词。
- 在控制台核实过用量：不降就有问题。
- 先配好一个工具，再加第二个。
继续阅读
- 完整上手：如何使用Z.ai（GLM）：注册、订阅与第一个提示词
- 价格对比：Z.ai GLM与OpenCode Go：价格和套餐对比
- 如果你的客户端是 OpenCode：OpenCode 安装失败：常见错误与解决方法
Step-by-step guide
创建套餐 key
在 Z.ai 控制台创建套餐 key，不是按用量付费 key。拿错那把，额度永远不会被扣。
选对工具的端点
Claude Code 用 `/api/anthropic`。Cline、Roo 和 OpenAI 客户端用 `/api/coding/paas/v4`。
贴 base URL 和 key
token 就是你的 Coding Plan API key。在 Claude Code 里作为 Anthropic 兼容端点的 token 填入。
确认额度在掉
发一条真实提示词，去控制台看用量。数字不动，就是端点或 key 错了。
其他的以后再说
一个工具、一个端点、一条提示词。同一天配置三个客户端，是最快让你搞不清哪里坏了的方法。
Frequently asked questions
Z.ai Coding Plan 的 base URL 是什么？
取决于工具。Claude Code 用 Anthropic 兼容端点：`https://api.z.ai/api/anthropic`。Cline、Roo、Kilo 和所有 OpenAI 兼容客户端用 `https://api.z.ai/api/coding/paas/v4`。两者不能互换。
npx @z_ai/coding-helper 是干什么的？
这是 Z.ai 的官方捷径：一个终端助手，带你完成工具和套餐的安装配置，不用手动粘贴端点。不确定手动配置怎么弄的话，从这里开始。
为什么明明能用，套餐额度却永远不减？
因为你打的是通用聊天端点而不是 coding 端点，或者用的是按用量付费 key 而不是 Coding Plan key。Z.ai 明确提醒过：端点用错，套餐额度不会被扣。典型症状就是「能用，但我的 Lite 不掉」。
该用哪把 key，套餐的还是单独的？
Coding Plan 的 key。如果你付了订阅费却创建了按用量付费 key，用量会单独计费，不从额度里扣。在 Z.ai 控制台里它们在不同地方创建，就算改版把界面改了名，概念不变。
Lite、Pro、Max 用的模型不一样吗？
不一样。三档用的是同一批 GLM 模型，唯一变化是额度多少。所以合理的做法是先订 Lite 月付，真的不够用了再升级。
GLM Coding Plan 能退款吗？
不能。Z.ai 订阅一旦购买不可退款。这正是第一天就别锁定 Max 年付、而从 Lite 月付开始的最强理由。
相关文章
继续探索您可能感兴趣的相似内容
Z.ai 与它的 GLM 模型：谁是谁，各自什么时候用
Z.ai 模型实用目录 —GLM-5.3、Flash、4.6V、OCR、GLM-Image、CogVideoX 和 Coding Plan—：每个模型做什么、多少钱、如何为每类任务选对模型。
2026年真正值得使用的IDE和代码代理（以及为什么opencode赢得了它的地位）
2026年最佳IDE和代码代理的完整指南：opencode、Claude Code、Cursor、Cline、Kilo Code、Crush、Droid等。比较分析、价格和按开发者角色的推荐。
Claude Code vs OpenCode：AI时代的5个真相
锁定、每月1000美元的开支与air-gapped隐私模式：没人告诉你的Claude Code与OpenCode真相，以及为什么软技能比语法更值钱。
合作
我每天在用的工具，社区可以拿到更好的条件。