概覽
CC Switch 是一款跨平台桌面應用程式（Tauri + Rust），專為管理 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw、Hermes Agent 的供應商設定而設計。它提供圖形介面與系統托盤，讓你一鍵切換 API 供應商（包含智譜 Zhipu GLM 5.2），無需手動編輯 JSON/TOML 設定檔。
GLM 5.2 是智譜 AI 推出的 744B MoE 旗艦程式碼模型（1M 上下文、MIT 授權），透過 Z.ai / BigModel 平台提供。它使用 OpenAI Chat Completions 協定，而 Codex 期望的是 Responses API，因此必須啟用 CC Switch 的 Local Routing（本地路由） 代理，即時轉譯請求與回應。
前置需求
| 項目 | 說明 |
|---|---|
| 作業系統 | Windows 10+、macOS 12+、Linux（Ubuntu 22.04 / Debian 11 / Fedora 34+） |
| Node.js | ≥ 18（Codex CLI 所需） |
| Codex CLI | npm install -g @openai/codex |
| Claude Code | 已安裝並可正常執行 |
| 智譜 API Key | 前往 https://open.bigmodel.cn → API Keys → 建立新金鑰 |
步驟 1 — 安裝 CC Switch
Windows
從 GitHub Releases 下載 CC-Switch-v{version}-Windows.msi 或可攜版 .zip。
macOS（建議）
brew install --cask cc-switch
# 後續更新：brew upgrade --cask cc-switch
Linux
下載 .deb、.rpm 或 .AppImage；Arch 使用者可 paru -S cc-switch-bin。
驗證
啟動 CC Switch，主視窗頂部會有七個分頁：Claude Code、Claude Desktop、Codex、Gemini、OpenCode、OpenClaw、Hermes。
步驟 2 — 新增 Zhipu GLM 5.2 為供應商
給 Claude Code 用（Anthropic 格式）
- 切換到 Claude Code 分頁。
- 右上角點選 + → Add Provider。
- Preset（預設） 下拉選 Zhipu GLM 或 Zhipu GLM en。
- 貼上從 BigModel 取得的 API Key。
- 點選 Add。
- 在供應商清單中，對新增的 GLM 卡片點選 Enable。
→ 即時生效（Claude Code 會熱重載）。
模型對應（預設自動填入）：
| 角色 | Model ID |
|---|---|
| Sonnet（預設） | GLM-5.2 |
| Opus | GLM-5.2 |
| Haiku | GLM-5.2-Air |
如需自訂，可在供應商的 Advanced Options → Model Mapping 修改。
給 Codex 用（必須啟用 Local Routing）
- 切換到 Codex 分頁。
- 點選 + → Add Provider。
- Preset 選 Zhipu GLM / GLM en（屬於 Chat Completions protocol 預設組）。
- 貼上 API Key。
- 關鍵：Needs Local Routing 開關預設為 ON — 一定要保持開啟。
- Model Mapping 表格會自動出現，確認包含：
- Model ID：
GLM-5.2（或glm-5.2） - Display Name：
GLM 5.2 - Context Window：
1000000
- Model ID：
- 點選 Add，再 Enable 該供應商。
- 重啟終端機 / Codex 讓設定生效。
為什麼要 Local Routing？
Codex 使用 OpenAI Responses API，GLM 5.2 使用 Chat Completions。CC Switch 會在本機啟動一個代理（127.0.0.1:PORT），雙向轉換請求/回應（支援串流、推理、工具呼叫）。若不開啟，Codex 會靜默逾時。
步驟 3 — 驗證是否正常運作
Claude Code
claude
> Hello, which model are you?
# 應回覆：I'm GLM 5.2 from Zhipu AI...
Codex
codex
> /model
# 清單中出現 GLM 5.2
> /model GLM 5.2
> Write a Python function to compute fibonacci
# 正常產出程式碼
步驟 4 — 系統托盤快速切換
- 右鍵點選托盤區 CC Switch 圖示 → Claude Code 或 Codex → 選擇供應商。
- Claude Code：即時切換。
- Codex：需重啟終端機。
關鍵設定與常見坑
| 設定 | 位置 | 備註 |
|---|---|---|
| Needs Local Routing | Codex 供應商編輯 → Advanced | GLM / DeepSeek / Kimi / MiniMax 等 Chat Completions 模型必須開啟 |
| Model Mapping 表格 | 同處 | 決定 /model 顯示內容；修改後須重啟 Codex |
| Reasoning effort | Codex config.toml → model_reasoning_effort |
GLM 僅支援 開/關，不支援 low/medium/high；調整無效 |
| 1M 上下文視窗 | Codex 新增/編輯供應商 → 切換開關 | 會自動寫入 model_context_window = 1000000 + 900k 自動壓縮 |
| 跳過 Claude Code 首次運行 | Settings → General | 避免全新安裝時彈出 Anthropic 登入提示 |
| Full URL Mode | 供應商 Advanced Options | 端點非標準 /v1/chat/completions 時使用 |
替代方案：通用供應商（一套設定雙工具同步）
若兩工具使用相同 API Key / 端點：
- 在 Add Provider 面板選 Universal Provider 分頁。
- 填入：名稱、API Key、端點網址（如
https://open.bigmodel.cn/api/paas/v4）。 - 勾選 Claude Code 與 Codex 於 “Sync to apps”。
- Save and Sync → 兩工具同時取得設定。
- Codex 端仍需手動開啟 已同步供應商卡片上的 Needs Local Routing。
疑難排解
| 現象 | 解法 |
|---|---|
| Codex：Request timeout / 無回應 | 確認 Needs Local Routing = ON，且 CC Switch 顯示綠色 “Local Routing” 徽章 |
/model 沒出現 GLM 5.2 |
編輯供應商 → 確認 Model Mapping 表格 → 重啟 Codex |
| 推理功能不工作 | GLM 僅支援 on/off，勿設定 model_reasoning_effort，保持預設 |
| 認證失敗 (401/403) | API Key 錯誤或過期 → 至 BigModel 重新產生 |
| Claude Code 仍顯示 Anthropic 模型 | 對 GLM 供應商卡片點 Enable，等待 1–2 秒熱重載 |
| 供應商卡片顯示 “Session Expired”（OAuth） | OAuth Auth Center → 移除帳號 → 重新登入 |
資料儲存位置（備份/遷移用）
| 路徑 | 用途 |
|---|---|
~/.cc-switch/cc-switch.db |
SQLite DB：所有供應商、MCP、提示詞、Skills |
~/.cc-switch/settings.json |
UI 偏好（主題、托盤等） |
~/.cc-switch/backups/ |
自動輪換的 DB 備份（最近 10 份） |
~/.claude/settings.json |
Claude Code 即時設定（由 CC Switch 寫入） |
~/.codex/auth.json + config.toml |
Codex 即時設定（由 CC Switch 寫入） |
TL;DR 清單
- 安裝 CC Switch（brew / MSI / AppImage）
- 至 https://open.bigmodel.cn 取得 Zhipu API Key
- Claude Code：新增 Zhipu GLM 預設組 → Enable → 完成
- Codex：新增 Zhipu GLM 預設組 → Needs Local Routing = ON → Enable → 重啟終端機
- 用
claude與codex→/model驗證 - 之後透過托盤選單秒切模型