logo

如何在 Claude Code 中使用 GLM-5.2（完整設定）

最近更新: 2026-07-15 09:30:03

你今天就可以在 Claude Code 中執行 GLM-5.2，而且設定大約只要兩分鐘。Claude Code 可以與任何支援 Anthropic 的 Messages API 的端點通訊，而 Zhipu 也正好為 GLM 提供這項支援——把 Claude Code 指向 z.ai 就完成了。進入方式有兩種：一個是一鍵切換器應用程式（最簡單，而且讓你隨時切回 Claude），另一個是手動編輯設定檔。本指南會涵蓋這兩種方法，適用於 macOS、Windows 和 Linux，另外也會說明當你需要時如何切回 Claude。

最快的方式：CC Switch

如果你已經同時使用多個供應商，就跳過手動設定，改用 CC Switch（開源、MIT 授權、Windows/macOS/Linux）。這是一個桌面應用程式，可管理 Claude Code、Codex、Gemini CLI 以及其他幾個 CLI 的供應商設定，所以你不需要手動編輯 JSON。

1. 從 ccswitch.io 或其 GitHub repo 安裝 CC Switch。點擊主視窗右上角的橙色 + 按鈕以開啟 Add Provider，然後選擇 Claude Provider 分頁。 2. 在預設搜尋中輸入 zhipu。會顯示兩個預設 — Zhipu GLM（中國大陸端點）和 Zhipu GLM en。在中國大陸以外，請選擇 Zhipu GLM en 作為國際端點。

CC Switch Add New Provider screen with "zhipu" typed in the preset search box, showing the Zhipu GLM and Zhipu GLM en presets under the Claude Provider tab

3. 向下捲動，並將您的 z.ai API key 貼到 API Key 欄位中。預設會自動填入其餘內容：Anthropic Messages (Native) 格式、ANTHROPIC_AUTH_TOKEN 驗證欄位，以及 base URL。

4. 在 Model Mapping 中，將每個角色——Sonnet、Opus、Fable 和 Haiku——所要求的模型設為 glm-5.2，讓每個請求都會路由到 GLM，而不論 Claude Code 會選用哪個層級。勾選某個角色上的 1M 方框，向 Claude Code 宣告百萬 token 上下文。儲存。

CC Switch Edit Provider model-mapping table with Sonnet, Opus, Fable, and Haiku roles all set to glm-5.2, using Anthropic Messages Native format and ANTHROPIC_AUTH_TOKEN

5. 返回提供者清單後，點擊 Zhipu GLM 項目上的 啟用（像 Claude Official 這類既有提供者可以保留在清單中，以便之後切換回去），然後重新啟動 Claude Code，以確保它已套用新的提供者。執行 /status 以確認模型顯示為 glm-5.2。

CC Switch provider list showing Zhipu GLM with its Enable button, alongside a Claude Official provider to switch back to

為什麼要用 app 而不是靜態設定：它為大多數你想嘗試的供應商預先提供了 preset——Kimi、MiniMax、MiMo、Qwen、DeepSeek 等等——因此每個都只是設定 preset 和 key，而不是重寫設定，並且在它們之間切換（或切回 Claude）只需要點幾下。這就是下面混合工作流程的實際基礎。

使用 settings.json 進行手動設定

偏好自行設定，或在沒有 GUI 的情況下設定 CI 機器？直接編輯檔案。

1. 從 Z.AI API console 取得 API key。按量付費的 key 或 GLM Coding Plan 訂閱 key 都可以。 2. 將這個 env 區塊合併到你的 Claude Code 設定檔中（保留任何現有的 keys —— 不要覆寫整個檔案）。這個區塊在所有平台上都相同；只有路徑不同： - macOS / Linux: ~/.claude/settings.json - Windows: %USERPROFILE%\.claude\settings.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.z.ai/api/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "your_zai_api_key",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-5.2",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-5.2",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-5.2",
    "API_TIMEOUT_MS": "3000000"
  }
}

3. 重新啟動 Claude Code，然後執行 /status。模型列應顯示 glm-5.2（或 glm-5.2[1m]，代表百萬 token 版本）。如果它仍然顯示 Claude 模型，表示該檔案沒有被載入 — 請檢查 JSON 語法錯誤並確認路徑。

如果您不想動到檔案，這裡有兩個以 shell 為基礎的替代方法：

  • macOS / Linux — 匯出變數（bash/zsh）以供一次性工作階段，然後啟動：

export ANTHROPIC_BASE_URL="https://api.z.ai/api/anthropic"
export ANTHROPIC_AUTH_TOKEN="your_zai_api_key"
export ANTHROPIC_DEFAULT_OPUS_MODEL="glm-5.2"
export ANTHROPIC_DEFAULT_SONNET_MODEL="glm-5.2"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="glm-5.2"
claude

關閉終端機後，你就會回到正常設定。

  • Windows — 在 PowerShell 中設定持久的使用者環境變數，然後重新啟動終端機：

setx ANTHROPIC_BASE_URL "https://api.z.ai/api/anthropic"
setx ANTHROPIC_AUTH_TOKEN "your_zai_api_key"
setx ANTHROPIC_DEFAULT_OPUS_MODEL "glm-5.2"
setx ANTHROPIC_DEFAULT_SONNET_MODEL "glm-5.2"
setx ANTHROPIC_DEFAULT_HAIKU_MODEL "glm-5.2"

ANTHROPIC_DEFAULT_* 變數會重新對應 Claude Code 轉送到的模型角色——Opus、Sonnet 和 Haiku（較新的版本會新增 Fable 角色，CC Switch 也會公開它）。將它們全部設為 glm-5.2 會把每個請求都送到 GLM；如果你想讓背景任務保持便宜又快速，不妨把 Haiku 這個欄位指向 glm-4.5-air。要使用完整的一百萬 token 視窗，請使用 glm-5.2[1m]。較長的 API_TIMEOUT_MS 比看起來更重要：GLM 的回應通常比 Claude 慢，而預設逾時會截斷較長的生成內容。

該選哪條路：z.ai 原生、代理，還是 Coding Plan？

將 GLM-5.2 導入 Claude Code 的三種實用方式，而且它們並不能互換。

z.ai 原生端點（推薦）。 上方的 https://api.z.ai/api/anthropic URL。它支援 Anthropic 協議，因此 Claude Code 無需中介層即可連線——預設選擇。

一個翻譯代理。 其他主機（Fireworks、NVIDIA NIM、自架權重）透過相容於 OpenAI 的 API 提供 GLM-5.2，而 Claude Code 無法直接讀取，因此它們需要一個可轉換格式的代理。claude-code-router 可處理這件事。只有在你已經在那些平台之一上擁有額度或硬體時才值得這麼做。

GLM Coding Plan 訂閱。 一個固定月費方案（每月 $18 起，詳見 z.ai 的訂閱頁面），使用相同的 z.ai endpoint，但改為收取固定費用，而非按 token 計費。如果你每天都在 Claude Code 中寫程式，訂閱通常比按量計費的 token 更便宜，也更可預測；請根據你每月的 token 花費試算一下損益兩平點。如果你的使用量起伏很大，按用量付費會更划算。

在 GLM-5.2 和 Claude 之間切換

Claude Code 一次只使用一個啟用中的提供者，因此你是以「切換」而不是「分配槽位」的方式操作：日常大量工作時執行 GLM-5.2，而當你需要 Claude 來處理架構、安全敏感程式碼或審查時，則在 CC Switch 中啟用你的 Claude 官方提供者。Claude 端任何相容 Anthropic 的端點都可以使用——你的 Anthropic 帳號，或像 AIReiter 這類轉發服務，這只是眾多選項之一。若要在不同提供者之間進行自動的逐請求路由，像 claude-code-router 這樣的 gateway 會負責派送。

疑難排解

症狀

可能原因

修正

/status 仍顯示 Claude 模型

settings.json 未載入

檢查 JSON 是否有效；確認你已編輯 ~/.claude/settings.json；重新啟動 Claude Code

model not found 錯誤

模型 ID 錯誤（區分大小寫）

請精確使用 glm-5.2、glm-5.2[1m] 或 glm-4.5-air

401 / 驗證失敗

金鑰/端點不匹配

不要將 OpenRouter 金鑰與 z.ai URL 配對；如有需要請重新產生金鑰

長篇生成被截斷

逾時設定太低

將 API_TIMEOUT_MS 設高一些（例如 3000000）

工具呼叫失敗或迴圈重複

工具 JSON 格式錯誤

減少平行子代理；重試；簡化指令

常見問題

GLM-5.2 在 Claude Code 中是免費的嗎？

不過，並非無限期免費；z.ai 曾在 GLM-5.2 上推出限時免費時段，而 Coding Plan 的起價為每月 $18。即使按完整按量計費費率（每百萬 $1.40 / $4.40），輕度使用的費用也只需幾分錢。

GLM-5.2 是否在 Claude Code 中支援 1M token 上下文？

是。將您的 ANTHROPIC_DEFAULT_* 變數中的模型 ID 設為 glm-5.2[1m]，而不是 glm-5.2，Claude Code 就會使用百萬 token 視窗。

在 Claude Code 中，GLM-5.2 和 Claude 哪個更適合寫程式？

對於例行、順序性的編輯，價格差異使 GLM-5.2 成為合理的預設選擇。Claude 在多步驟架構、安全敏感工作，以及高併發 subagent 工作流程方面往往更勝一籌。切換設定讓你能在各自最擅長的地方使用它們，而不是只選擇其中一個。

我可以在 Claude Code 以外的工具中使用 GLM-5.2 嗎？

是。相同的 z.ai 端點與金鑰也可與其他 agentic CLI 搭配使用——OpenCode、Cline 和 Kilo Code 都支援自訂 base URL，而 CC Switch 可管理其中多個工具的預設設定。

我需要付費的 Claude 訂閱才能在 Claude Code 中使用 GLM-5.2 嗎？

不。Claude Code 只是用戶端；一旦你將它指向 z.ai，費用就會由 z.ai 收取，而不是 Anthropic。只有在你將 Claude 保持為可切換的供應商時，才需要 Claude 帳號。

在 CC Switch 中切換供應商後，我需要重新啟動 Claude Code 嗎？

根據 CC Switch 的文件，Claude Code 支援在不重新啟動的情況下熱切換提供者資料，而大多數其他 CLI 工具確實需要重新啟動終端機或應用程式。實務上，重新啟動 Claude Code 是確認切換已生效的可靠方式。

我如何在 CC Switch 中切換回 Claude（官方登入）？

從預設清單中新增一個 Claude 官方 provider，將其啟用，然後執行一次 Claude Code 的正常登出 / 登入（OAuth）流程。之後，您就可以在官方 Claude 登入與第三方 providers（如 z.ai）之間自由切換。

CC Switch 是免費且安全可用的嗎？

是的——它採用 MIT 授權且免費開源。您的設定會以 SQLite 資料庫的形式本機儲存，並支援原子寫入；而且依設計，它只會對每個工具自身的設定做最少變更，因此即使您解除安裝此應用程式，您的 CLI 仍可正常運作。

相關閱讀