HopBase 文檔CC Switch
建立 HopBase 密鑰，匯入 CC Switch，並在 Codex App、Codex CLI 或 Claude Code 中使用。
CC Switch 是適用於 Windows 和 macOS 的桌面配置管理工具。偏好圖形介面，或經常切換 Claude Code、Codex 供應商時使用。它負責管理配置，不會安裝 Codex App、Node.js、Claude Code 或 Codex CLI。
只有連接開發工具才需要看這一頁
如果只是製作商品圖片或影片，不需要建立 API 密鑰，請直接使用創作工作台。
完整操作路徑
建立 HopBase 密鑰 → 匯入 CCS → 選擇 Claude Code 或 Codex CLI → 在 CC Switch 確認 → 啟用
開始前準備
按模型選擇密鑰
先準備目標客戶端：Codex App、Codex CLI 或 Claude Code。
按模型選擇密鑰：Claude 使用 Claude 分組密鑰，GPT 使用 OpenAI / Codex 分組密鑰，GLM 使用 GLM 分組密鑰。
更新 CC Switch：使用最新版本；GLM 路由需要 3.17.0 或更高版本。
安裝 CC Switch
從 CC Switch 發布頁下載最新的 .dmg。完成安裝後至少啟動一次，讓瀏覽器在導入時可以喚起 CC Switch。
從 HopBase 控制檯導入
填寫名稱並選擇模型群組
填寫一個容易識別的名稱，選擇要使用的模型群組，再點擊「建立」。Claude 模型選擇 Claude 群組，GPT 模型選擇 OpenAI / Codex 群組，GLM 模型選擇 GLM 群組；到期時間可以留空。
選擇客戶端
使用 Codex App 或 Codex CLI 時，都選擇「Codex CLI」；使用 Claude Code 時選擇「Claude Code」。兩類客戶端都要使用，請分別匯入一次。
核對並確認
瀏覽器提示時點 Open CC Switch。核對供應商名稱、Base URL 和已遮罩的密鑰，再點 Import。
啟用供應商
在 CC Switch 中打開對應的 Claude Code 或 Codex 頁簽，找到剛導入的供應商，點 Enable。供應商顯示「目前啟用」即完成切換。
在新終端機中驗證
執行 claude 或 codex，傳送一個簡短測試。使用 Codex App 時，請完全退出並重新開啟應用程式，再開始測試任務。如果已開啟的終端機仍使用舊供應商，請關閉終端機後重新開啟。
Codex App 和 Codex CLI
CC Switch 寫入使用者層級 Codex 供應商設定。切換供應商後，請完全退出並重新啟動 Codex App，或開啟新的 Codex CLI 工作階段，讓客戶端重新載入設定。
在 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 執行。其他錯誤見疑難排解。