CC Switch

CC Switch 是一個開源桌面應用，用來統一管理 Claude Code、Codex、Gemini CLI 等程式設計工具的服務商配置。它會自動改寫這些工具的配置檔案，不用手動設定環境變數；匯入上上之钥的 Key 後，還能在 CC Switch 裡直接看到餘額。

最快的方式是在控制台 API 金鑰頁面點選 Key 右側的匯入到 CCS，一鍵寫入介面地址、金鑰和餘額查詢，不需要手動填寫任何內容。

第一步：安裝 CC Switch

安裝包可以在 CC Switch 官網或 GitHub Releases 下載。

安裝後請至少開啟一次 CC Switch。首次開啟時它會向系統註冊 ccswitch:// 連結，之後網頁上的一鍵匯入才能喚起它。

第二步：一鍵匯入 Key

登入控制台，進入 API 金鑰頁面。還沒有 Key 的話先點建立金鑰；在要使用的 Key 右側點選匯入到 CCS（也可以點使用金鑰，在彈窗裡點一鍵匯入到 CC Switch）；在彈出的列表裡選擇要使用的工具：Claude Code、Codex、Gemini CLI、Grok Build、OpenCode、OpenClaw、Hermes、Pi、Antigravity CLI。當前分組用不了的工具會置灰並寫明原因；Claude Desktop 目前 CC Switch 還不支援一鍵匯入，需要在 CC Switch 裡手動新增；瀏覽器詢問「是否開啟 CC Switch」時選擇允許 / 開啟； CC Switch 彈出匯入確認視窗，確認後就會新增一個名為上上之钥的供應商。

匯入時會自動帶上：

介面地址：Claude Code 為 https://upupkey.com，Codex 為 https://upupkey.com（CC Switch 會自己拼上 /v1）；你的 API Key；餘額查詢指令碼：每 30 分鐘重新整理一次，在供應商卡片上顯示剩餘額度；介面協議：按工具自動選擇（Claude Code 用 Anthropic，Codex / Grok Build 用 Responses，OpenCode / OpenClaw / Hermes / Pi 用 Chat Completions）；預設模型：Codex、Grok Build、OpenCode、OpenClaw、Hermes、Pi 會帶上分組裡的預設模型（Claude 分組預設 claude-sonnet-5-5，OpenAI 分組預設 gpt-5.5）。

一次只能匯入一個工具。想在多個工具裡使用，重複點「匯入到 CCS」並分別選擇即可。需要 CC Switch 4.0.10 或更新版本。

點選按鈕後沒有任何反應，或提示「CC Switch 未安裝」，通常是因為還沒有開啟過 CC Switch。請先開啟一次 CC Switch，再回到網頁重試。

第三步：啟用並開始使用

在 CC Switch 左側選中對應工具（Claude Code / Codex / Gemini CLI）；找到剛匯入的上上之钥供應商，點選啟用。也可以在系統托盤選單裡直接點供應商名稱切換；開啟終端開始使用：

切換後的生效方式：

手動新增（不使用一鍵匯入）

如果瀏覽器無法喚起 CC Switch，也可以手動新增：

在左側選中要配置的工具，點選右上角的 +（新增供應商）；選擇建立自定義配置；按下表填寫，儲存後點擊啟用。

地址末尾不要加 /v1，否則會變成 /v1/v1/... 導致請求失敗。供應商卡片上的檢測連通只檢查地址能不能連上，不會驗證 Key 和模型名，Key 是否正確請以實際對話為準。

常見問題

餘額顯示「查詢失敗」

一般是請求地址被手動改成了別的路徑。把地址改回 https://upupkey.com，或刪除供應商後重新一鍵匯入即可。

Codex 報模型不存在

在 CC Switch 中編輯供應商，把模型改成你的分組裡能用的模型。可用模型可以在本站模型頁面或 API 金鑰的使用金鑰彈窗中檢視。

提示餘額不足或 401

確認 Key 沒有被停用、沒有過期，並且帳戶餘額充足。可以在控制台 API 金鑰頁面檢視 Key 狀態。