AIREITER

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

最近更新: 2026-07-29 11:06:32

想在 Claude Code 裡直接跑 GLM-5.2，設定大約只要兩分鐘。關鍵在於 Claude Code 可連接任何支援 Anthropic Messages API 的端點，而智譜為 GLM 提供了相容介面；只要把端點指向 z.ai 即可。你可以選擇最省事的一鍵切換工具，也可以自行修改設定檔。以下會完整說明 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 畫面，在預設集搜尋欄輸入「zhipu」後，於 Claude Provider 分頁顯示 Zhipu GLM 與 Zhipu GLM en 預設集
  1. 往下捲動，將 z.ai API 金鑰貼到 API Key 欄位。預設集會自動帶入其餘設定，包括 Anthropic Messages (Native) 格式、ANTHROPIC_AUTH_TOKEN 驗證欄位與 base URL。
  2. 在 Model Mapping 中，將每個角色所要求的模型，也就是 Sonnet、Opus、Fable 與 Haiku，全部設為 glm-5.2。如此一來，無論 Claude Code 要求哪個層級，都會路由至 GLM。若要向 Claude Code 宣告某個角色可使用百萬 Token 上下文，請勾選該角色的 1M 方塊。完成後儲存。
CC Switch 的 Edit Provider 模型對應表，Sonnet、Opus、Fable 與 Haiku 角色皆設為 glm-5.2，並使用 Anthropic Messages Native 格式及 ANTHROPIC_AUTH_TOKEN
  1. 回到供應商清單後，在 Zhipu GLM 項目點選 Enable。既有的供應商，例如 Claude Official，可以保留在清單中供日後切回。接著重新啟動 Claude Code，確保它讀取新的供應商設定。輸入 /status，確認顯示的模型為 glm-5.2。
CC Switch 供應商清單，顯示 Zhipu GLM 的 Enable 按鈕，以及可切回使用的 Claude Official 供應商

相較於固定的設定檔，CC Switch 的實用之處在於它內建多數你可能想嘗試的供應商預設集，包括 Kimi、MiniMax、MiMo、Qwen、DeepSeek 等。每個服務只需選預設集、填入金鑰，不用反覆重寫設定；在它們之間或切回 Claude，也只要幾次點擊。這正是下文混合工作流能順暢運作的基礎。

手動修改 settings.json 設定 GLM-5.2

如果你偏好自行設定，或是要在沒有 GUI 的 CI 主機上部署，可以直接編輯設定檔。

  1. 取得 API 金鑰：前往 Z.AI API console。隨用隨付金鑰或 GLM Coding Plan 訂閱金鑰都可使用。
  2. 將以下 env 區塊合併至 Claude Code 設定檔。請保留既有鍵值，不要直接覆寫整個檔案。各平台的設定內容相同，差別只在檔案路徑：

- 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"
  }
}
  1. 重新啟動 Claude Code，然後輸入 /status。模型欄位應顯示 glm-5.2；若使用百萬 Token 版本，則會是 glm-5.2[1m]。若仍顯示 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。它支援 Anthropic 協定，因此 Claude Code 不需透過中介層即可連線，也是預設首選。

格式轉換代理。其他託管平台，例如 Fireworks、NVIDIA NIM，或自行託管的權重，可能透過 OpenAI 相容 API 提供 GLM-5.2；Claude Code 無法直接讀取這種格式，因此需要負責轉換協定的代理。claude-code-router 可處理這件事。只有當你已在這些平台擁有額度或硬體時，才值得考慮此路線。

GLM Coding Plan 訂閱。這是固定月費方案，依 z.ai's subscribe page 資訊，價格從 $18/month 起。它使用同一個 z.ai 端點，但以固定費用取代按 Token 計費。若你每天都在 Claude Code 寫程式，訂閱通常比按量計費更便宜、成本也更可預期；請以每月 Token 用量計算損益平衡點。若使用量忽高忽低，隨用隨付更有利。

在 GLM-5.2 與 Claude 之間切換

Claude Code 一次只能啟用一個供應商，因此這不是把不同模型分配到不同槽位，而是需要時再切換：日常大量工作交給 GLM-5.2；遇到架構設計、安全敏感程式碼或程式碼審查，再到 CC Switch 啟用 Claude Official 供應商。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 格式不正確減少平行子代理數量、重試，或簡化指令

常見問答

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

並非無限制免費，不過 z.ai 曾針對 GLM-5.2 推出限時免費窗口，而 Coding Plan 月費從 $18/month 起。即使以完整的隨用隨付價格計算，也就是每百萬 Token $1.40 / $4.40，輕度使用的成本仍只需幾美分。

GLM-5.2 在 Claude Code 支援 1M Token 上下文嗎？

支援。只要在 ANTHROPIC_DEFAULT_* 變數中，將模型 ID 從 glm-5.2 改成 glm-5.2[1m]，Claude Code 就會使用百萬 Token 上下文窗口。

在 Claude Code 寫程式，GLM-5.2 還是 Claude 較好？

對於日常、循序漸進的修改，GLM-5.2 的價格優勢使它成為合理的預設選擇。至於多步驟架構設計、安全敏感工作，以及高併發子代理工作流，Claude 通常更具優勢。透過切換設定，你可以各取所長，而不是只能二選一。

除了 Claude Code，還能在其他工具使用 GLM-5.2 嗎？

可以。同一組 z.ai 端點與金鑰也能用於其他 agentic CLI；OpenCode、Cline 與 Kilo Code 都支援自訂 base URL，而 CC Switch 也為其中多款工具提供預設集管理。

要在 Claude Code 使用 GLM-5.2，是否需要付費訂閱 Claude？

不需要。Claude Code 只是用戶端；將它指向 z.ai 後，費用會由 z.ai 計算，而不是 Anthropic。只有當你想保留 Claude 作為可切換的供應商時，才需要 Claude 帳號。

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

依照 CC Switch 文件，Claude Code 支援不重啟就熱切換供應商資料，然而多數其他 CLI 工具仍需重新啟動終端機或應用程式。實務上，重新啟動 Claude Code 是確認切換確實生效的可靠作法。

如何在 CC Switch 切回 Claude 官方登入？

先從預設集清單新增 Claude Official 供應商並啟用，然後依 Claude Code 一般的登出／登入（OAuth）流程操作一次。完成後，你便能自由切換官方 Claude 登入與 z.ai 等第三方供應商。

CC Switch 免費且安全嗎？

是。它採 MIT 授權開源且免費使用。你的設定會儲存在本機 SQLite 資料庫，並透過原子寫入保存；其設計上只會對各工具自身設定做最小幅度的變更，因此即使解除安裝應用程式，CLI 也能維持正常運作。

延伸閱讀