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真相，以及為什麼軟技能比語法更值錢。
合作
我每天在用的工具，社群可以拿到更好的條件。