CC Switch
安裝 CC Switch，並為 Claude Code 與 Codex CLI 導入、啟用或切換 HopBase 供應商。
CC Switch 是適用於 Windows 和 macOS 的桌面配置管理工具。偏好圖形介面，或經常切換 Claude Code、Codex 供應商時使用。它負責管理配置，不會安裝 Node.js、Claude Code 或 Codex CLI。
開始前準備
按模型選擇密鑰
先安裝目標 CLI：Claude Code 或 Codex CLI。
按模型選擇密鑰：Claude 使用 Claude 分組密鑰，GPT 使用 OpenAI / Codex 分組密鑰，GLM 使用 GLM 分組密鑰。
更新 CC Switch：使用最新版本；GLM 路由需要 3.17.0 或更高版本。
安裝 CC Switch
從 CC Switch 發布頁下載最新的 .dmg。完成安裝後至少啟動一次，讓瀏覽器在導入時可以喚起 CC Switch。
從 HopBase 控制檯導入
發起導入
打開密鑰右側的 ··· 選單，點「導入 CCS」，再選擇 Claude Code 或 Codex CLI。兩個客戶端都要使用時，請分別導入一次。
核對並確認
瀏覽器提示時點 Open CC Switch。核對供應商名稱、Base URL 和已遮罩的密鑰，再點 Import。
啟用供應商
在 CC Switch 中打開對應的 Claude Code 或 Codex 頁簽，找到剛導入的供應商，點 Enable。供應商顯示「目前啟用」即完成切換。
在新終端機中驗證
執行 claude 或 codex，傳送一個簡短測試。如果已經打開的 Codex 終端機仍使用舊供應商，請關閉終端機後重新打開。
在 Claude Code 中使用 GLM-5.2
GLM-5.2 使用 OpenAI Chat Completions，而 Claude Code 傳送 Anthropic Messages。CC Switch 必須保持本地路由執行，才能在兩種協議之間轉換。
| 欄位 | 填寫值 |
|---|---|
| CC Switch 版本 | 3.17.0 或更高版本 |
| 供應商頁簽 | Claude Code |
| 請求地址 | https://api.hop-base.com/v1 |
| API 格式 | OpenAI Chat Completions（需開啟路由） |
| 預設兜底模型 | glm-5.2 |
儲存供應商後，進入「設定 → 路由 → 本地路由」，先打開路由總開關，再打開 Claude Code。回到供應商卡片點 Enable，並保持 CC Switch 在背景執行。模型映射和驗證方法見 GLM-5.2。
常見問題
瀏覽器沒有打開 CC Switch：手動啟動一次，再重新點「導入 CCS」。
供應商沒有切換：進入對應客戶端頁簽，在剛導入的供應商卡片上點 Enable。
找不到命令或仍是舊供應商：安裝 Node.js LTS 和目標 CLI，再使用新終端機。
GLM 路由錯誤：核對 API 格式，打開兩個本地路由開關，並保持 CC Switch 執行。其他錯誤見疑難排解。