CC Switch - AI CLI 統一管理工具
CC Switch 教程 — 跨平臺 AI CLI 管理工具,統一管理 Claude Code、Codex、Gemini CLI、OpenCode 等 AI 程式設計工具的 Provider 配置、MCP 伺服器與系統提示詞。對接 88API 一鍵填入。
🔀 CC Switch 是一款開源、跨平臺的桌面工具,可統一管理 Claude Code、Claude Desktop、Codex、Gemini CLI、 OpenCode、OpenClaw 等 10 款 AI 程式設計工具的 Provider 配置、MCP 伺服器、系統提示詞(Prompts)與 Skills, 並內建 88API 預設(填入 API Key 即可使用),讓你在多個 AI 程式設計助手之間自由切換,無需手動編輯配置檔案。
- GitHub 倉庫:https://github.com/farion1231/cc-switch
- 下載地址:GitHub Releases
核心特性
🔌 Provider 管理
- 一鍵切換 — 在 Claude Code、Codex、Gemini 的 API 配置之間一鍵切換,無需手動修改環境變數或配置檔案
- 多端點支援 — 每個 Provider 可配置多個端點,支援 API Key 管理與延遲測速
- Claude 模型對應 — Claude 支援主模型及 Haiku / Sonnet / Opus 預設模型對應
🛠️ MCP 伺服器管理
- 跨應用統一管理 — 單面板管理 Claude / Codex / Gemini 三端的 MCP 伺服器
- 三種傳輸型別 — 支援 stdio、HTTP、SSE(Server-Sent Events)
- 自動同步 — 統一匯入匯出 + 雙向同步
💬 Prompts 管理
- 多預設系統提示詞 — 無限預設、快速切換
- 跨應用支援 — Claude(
CLAUDE.md)、Codex(AGENTS.md)、Gemini(GEMINI.md) - Markdown 編輯器 — CodeMirror 6 + 實時預覽
🌐 多平臺支援
- 桌面應用 — Windows、macOS、Linux 原生安裝包
- CLI(社群版) — 伺服器 / SSH 環境可使用 SaladDay/cc-switch-cli
88API 接入方法
方式一:使用 CC Switch 內建的 88API 預設(推薦)
CC Switch 已內建 88API 預設,API 請求地址和模型都已填好,只需要貼上 API Key。
-
選擇工具並新增供應商 開啟 CC Switch,在左側選擇要設定的工具(如 Codex、Claude Code),點選右上角「新增供應商」(添加供应商)。
-
選擇 88API 預設 在「第三方平臺」(第三方平台)中找到 88API(也可以在頂部搜尋框輸入
88API),點選它。如果找不到 88API,請先把 CC Switch 升級到最新版。
截圖為 CC Switch 的簡體中文介面,其他語言介面的操作步驟相同。
-
只填寫 API Key 在「API Key」中貼上從 88API 控制檯「API 金鑰」頁面複製的金鑰,然後點選右下角「新增」(添加)。名稱、官網連結和 API 請求地址都由預設自動填好,不用修改;Codex 的請求地址是
https://api.88api.ai/v1,「完整 URL」保持關閉。
-
啟用 88API 回到供應商列表,點選 88API 右側的 ▶ 按鈕啟用,狀態變為「使用中」即完成設定。

生效方式:Claude Code 立即生效;Codex 和 Gemini CLI 需要重啟終端或對應的 CLI,Codex 桌面版需要完全退出後重新開啟。
預設自帶的 Codex 模型取決於 CC Switch 版本,部分版本為 gpt-5.6-sol(仍可正常使用)。我們推薦點選 88API 右側的編輯按鈕,把模型改為 gpt-6.1-sol。所選模型必須在該金鑰的分組中可用。
如果不想使用預設、要手動新增供應商,請注意 CC Switch 不會自動補全或去掉 /v1,各工具填寫的地址不同:
| 工具 | API 地址 | 推薦模型 |
|---|---|---|
| Claude Code | https://api.88api.ai(不要帶 /v1) | claude-sonnet-5-5(Opus 檔 claude-opus-5-5,Haiku 檔 claude-haiku-5-5) |
| Codex | https://api.88api.ai/v1(必須帶 /v1) | gpt-6.1-sol |
| Gemini CLI | https://api.88api.ai(不要帶 /v1) | gemini-3.8-flash |
OpenCode、OpenClaw、Hermes、Pi、MiniMax Code 等其他工具也請直接選用內建的 88API 預設。
方式二:從 88API 控制檯一鍵匯入
也可以在 88API 控制檯把某個 API 金鑰一鍵匯入 CC Switch。匯入的名稱、API 地址和模型與 CC Switch 內建的 88API 預設一致,不需要自己填寫。
一鍵匯入支援 Claude Code CLI、Codex、Gemini CLI、Grok Build。Claude Desktop、OpenCode、OpenClaw、Hermes、Pi、MiniMax Code 暫不支援一鍵匯入,請用「方式一」新增。
前提:已按下方「安裝方式」安裝 CC Switch,並至少開啟過一次(macOS 需先拖入「應用程式」資料夾再開啟),否則瀏覽器無法喚起
ccswitch://連結。
-
打開匯入視窗 在 88API 控制檯「API 金鑰」頁面,點選目標金鑰所在行最右側的「⋯」按鈕,選擇 CC Switch,會彈出「填入 CC Switch」視窗(此時還不會開啟 CC Switch 應用)。
-
選擇應用並核對資訊 在「應用程式」中選擇要匯入的工具,視窗會顯示匯入後的名稱(88API)、API 地址、預設模型和這個金鑰的分組。


截圖為 88API 控制檯的簡體中文介面,欄位名稱請以正文為準。
各應用匯入的設定如下:
應用 API 地址 預設模型 Claude Code CLI https://api.88api.ai不指定,使用 Claude Code 自身的預設模型(與內建 88API 預設相同) Codex https://api.88api.ai/v1gpt-6.1-solGemini CLI https://api.88api.aigemini-3.8-flashGrok Build https://api.88api.ai/v1grok-4.7- 預設模型只是匯入後的初始選擇,之後可以改用該金鑰分組內的任意模型。
- 請確認金鑰分組:Claude Code CLI 需要分組提供 Claude 模型,Codex 需要 GPT 模型,Gemini CLI 需要 Gemini 模型,Grok Build 需要 Grok 模型,否則呼叫會失敗。分組不對時,先在「API 金鑰」頁面編輯該金鑰、更換分組。截圖中的分組只是範例。
- 選擇 Claude Desktop 時,按鈕會變成「複製金鑰」:複製後依「方式一」在 CC Switch 的 Claude Desktop 中選擇 88API 預設,貼上金鑰並儲存。
- 點選「應用程式」旁的 ⓘ 圖示,可以查看其他工具的新增方法。
-
匯入並生效 點選「打開 CC Switch」,瀏覽器詢問是否開啟 CC Switch 時選擇允許。CC Switch 會彈出「確認匯入供應商設定」視窗,核對供應商名稱(88API)、API 端點和模型,保持「匯入後立即切換到這個供應商」開啟,然後點選「匯入」。點選「取消」則放棄本次操作。
「API 端點」會列出兩個地址:標為「主」的
https://api.88api.ai,以及備用的https://88api.ai(Codex 和 Grok Build 結尾都帶/v1)。兩個地址都可以使用,不需要修改。生效方式與「方式一」相同。
用舊版控制檯匯入過的供應商(名稱為 My Claude / My Codex / My Gemini)仍然可以使用;如果想統一,可以在 CC Switch 中刪除舊供應商,改用新匯入的 88API。
在 CC Switch 中顯示餘額
CC Switch 可以在供應商卡片上直接顯示 88API 帳戶的錢包餘額(單位 CNY)。在 88API 控制檯建立一個存取令牌,再填到 CC Switch 的用量查詢裡即可。
-
開啟用量查詢設定 在 CC Switch 中,滑鼠移到 88API 卡片上,點擊右側的「⋯」,選擇 「設定用量查詢」(首次會彈出確認,點擊繼續)。

-
在 88API 控制檯建立存取令牌 登入 88API 控制檯,進入左側 「安全與存取」,在「存取令牌」中點擊 「建立存取令牌」。

-
設定名稱和權限 「令牌名稱」可填
餘額查詢;「過期時間」按需選擇(選擇「永不過期」時,令牌在撤銷前一直有效,請妥善保管)。「權限」中勾選「個人」下的 個人資料、用量、錢包 三項的 「查看」,不要勾選其他權限,然後點擊「建立存取令牌」,複製生成的令牌。
-
查看用戶 ID 在控制檯左側進入 「個人資料」,名稱旁邊顯示的 「用戶 ID」 就是下一步要填的數字。

-
填寫 NewAPI 範本 回到 CC Switch 的「設定用量查詢」:開啟 「啟用用量查詢」,預設範本選擇 NewAPI,「請求位址」填
https://88api.ai,「Access Token」貼上第 3 步複製的令牌,「使用者 ID」填第 4 步看到的數字。「自動查詢間隔」按需設定(單位為分鐘,填 0 不自動查詢),然後點擊「儲存設定」。
-
把單位改成 CNY 儲存後卡片會顯示餘額,但 NewAPI 範本預設把單位寫成 USD。88API 的餘額是人民幣,數字本身是對的,只需要改一下單位。

再次開啟「設定用量查詢」,向下捲動到腳本,把
unit: "USD"改為unit: "CNY",點擊「儲存設定」。
卡片會顯示「餘額 ××× CNY」。

- 存取令牌可以查看帳戶資訊,請勿分享;外洩後可在「安全與存取」中撤銷並重新建立。
- 同一個令牌可以用於多個 88API 卡片,每張卡片都要分別設定一次。
小提示:在 CC Switch 的「設定」→「通用」→「額度顯示」中,可以選擇卡片顯示「剩餘」或「已用」額度。
安裝方式
macOS(推薦 Homebrew)
brew install --cask cc-switchCC Switch 已進入 Homebrew 官方倉庫,無需再執行 brew tap farion1231/ccswitch;該第三方 tap 已停止維護,之前新增過的可用 brew untap farion1231/ccswitch 移除。
Windows
從 Releases 下載 .msi 安裝包或便攜版 .zip。
Linux
從 Releases 下載 .deb、.rpm 或 .AppImage(x86_64 / arm64)。
ArchLinux 使用者:
paru -S cc-switch-bin伺服器 / SSH 環境(無圖形介面)
CC Switch 官方只提供桌面版。伺服器或 SSH 遠端環境請使用官方 README 推薦的社群命令列版 CC Switch CLI(macOS / Linux):
curl -fsSL https://github.com/SaladDay/cc-switch-cli/releases/latest/download/install.sh | bashmacOS 也可使用 brew install cc-switch-cli。命令列版無法使用 88API 控制檯的一鍵匯入,請選擇內建的 88API 預設,或按上文「方式一」表格中的地址手動填寫。
