CC Switch 是把 Claude Code、Codex 等 AI 程式工具的供應商與模型設定集中管理的第三方桌面工具。官方 v4.0.25 README 列出 12 種支援工具，並提供 MCP、Skills、提示詞及用量等管理功能。若你只用一套官方帳號、很少改設定，未必需要多裝一個管理器；如果你經常在不同工具與供應商之間切換，它才比較有價值。
官方下載： GitHub Releases v4.0.26／ccswitch.io。補充查證： 2026-11-06；v4.0.26 於 2026-11-05 15:25 UTC 發布，台灣為 11 月 5 日晚間。本頁的支援表與 Codex 額度保護按下文標明的 v4.0.25 文件解釋，v4.0.26 的相關變更見文末版本補充。
先分清楚：管理設定，不等於提供模型
直連模式下，CC Switch 負責把選定的連線設定寫進工具；真正發出模型請求的仍是該 AI 工具。官方說明指出，切換會替換 endpoint、金鑰、模型等關鍵欄位，其他設定通常共同沿用；不能把不同供應商卡片當成完全隔離的工作環境。切換說明／設定編輯說明
判斷是否要用它，可以看兩件事：
- 你要減少哪一種重複工作？ 如果困擾是反覆改端點、模型與供應商設定，集中管理有幫助；如果困擾只是模型答案不好，增加一個切換工具不會直接解決。
- 你能否辨認目前用哪一套設定？ 帳號、endpoint、模型 ID 與計費來源要一起看。只有「已啟用」標示，不足以證明每一項都切對；第一次設定的核對順序見 CC Switch 設定教學。
支援哪些 AI 工具？
同版本 README 明列以下 12 種工具。這是「可管理的工具清單」，不是每種工具都有相同功能；MCP、Skills、登入與連線模式仍要分別看官方功能矩陣。支援工具與功能矩陣
| 設定方式 | README 列出的工具 |
|---|---|
| 以目前啟用的供應商為主 | Claude Code、Claude Desktop、Codex、Gemini CLI、Grok Build |
| 可讓多組供應商設定並存 | OpenCode、OpenClaw、Hermes、Pi、MiniMax Code、Kimi Code、Oh My Pi |
「多組設定並存」也不等於同時使用多個付費帳號。登入帳號管理、API 供應商卡片及實際送出的請求，是三個需要分別確認的項目。供應商切換與並存型工具說明
下載與安裝：先選對系統版本
依官方安裝指南，CC Switch 支援 Windows、macOS 與 Linux。從官方網站或 Releases 取得檔案，核對 CPU 架構；不要把要求儲值的同名網站當成官方下載入口。官方安裝指南
| 系統 | 官方提供的開始方式 | 先確認 |
|---|---|---|
| Windows 10 以上 | MSI 安裝包，或解壓使用的 Portable ZIP | x64 與 ARM64 檔案不同 |
| macOS 12 以上 | DMG／ZIP；也可依文件使用 Homebrew | 官方說明為 Intel 與 Apple Silicon 通用版本 |
| Linux | 依發行版選 DEB、RPM 或 AppImage | 需要 glibc 2.35 以上及 WebKitGTK 4.1，不能只看「Linux」字樣 |
安裝管理器與設定模型服務是兩件事。接著先選一個要管理的工具，再新增一組你有權使用的供應商設定；不必一開始就開路由或聚合。具體的設定、請求核對與還原步驟放在 CC Switch 第一次切換教學。
直連、路由與聚合，差別在哪？
| 模式 | 請求如何走 | 什麼情況再考慮 |
|---|---|---|
| 直連 Direct | 工具依目前的供應商設定直接連線 | 先確認單一端點、模型與帳號是否符合需求 |
| 路由 Routing | 請求先經 CC Switch 的本機服務，再轉送上游 | 需要官方文件所列的格式轉換或路由能力 |
| 聚合 Aggregation | 多家供應商的模型放進同一模型清單，依所選模型分流 | 已需要在 Claude Code 或 Codex 中選用多家模型 |
聚合模式不提供故障轉移；它也不會把多家供應商變成同一份授權或帳單。Codex 的聚合模型清單變動後需要完整重啟。先把直連設定辨認清楚，再決定要不要增加本機服務，通常比較容易排除問題。連線模式／聚合模式與限制
多帳號管理，支援範圍要分開看
官方設定手冊把 Accounts 列為 Beta 功能，可集中管理 GitHub Copilot、ChatGPT／Codex 及 xAI 登入，並在多個帳號中設定預設帳號；同版本 README 另列出 Kimi Code 的多官方帳號支援。這些說明不代表所有工具、所有登入方式都能任意互換。Accounts 說明／同版本 README
官方也明示，部分帳號反向代理使用逆向整理的 OAuth 整合，可能不受上游支援，並有帳號限制或服務條款風險。若只需要管理一般 API 供應商，不必為了「多帳號」名稱就啟用這類路徑；涉及公司或客戶資料時，先確認允許的端點與授權方式。官方風險說明
v4.0.25 的 Codex 額度保護，能做什麼？
2026-11-02 發布的 v4.0.25 新增官方額度保護：可在「設定 → 應用配置 → Codex 應用增強」開啟，當五小時或每週使用率達設定門檻，就暫停新的官方請求；預設門檻為 95% 與 98%。v4.0.25 發布說明
使用前要看清楚三個條件：
- 只作用於經 CC Switch 本機路由的 Codex 官方請求，預設關閉。 不能把它當成所有 Codex 工作的通用額度上限。
- 讀不到額度時會放行。 網路問題或登入失效時，不會因為無法查詢就擋住所有請求。
- 暫停會直接回傳錯誤，不會轉交故障轉移佇列的其他供應商。 它不是自動替你換帳號或增加方案額度的功能。
同版也加入 MCP 連通性檢查，並修正 Windows 供應商表單閃爍、Codex 模型映射下用量重複計算等問題。連通性與用量畫面可以提供線索，但仍不能取代實際供應商的帳單與設定核對。同版本英文更新紀錄
升級與費用，哪些不能混在一起？
CC Switch 以 MIT 授權提供原始碼；模型訂閱、API 用量與第三方供應商費用則要另外判斷。v4.0.25 的用量頁可選自動匯率，但費用仍以美元記錄，換算只影響顯示，不是更改供應商費率。專案授權／匯率顯示說明
從 3.x 升級也不要把「裝回舊版」當成完整回復方法。官方 v4.0 升級說明指出資料庫結構升到 20，舊版可能無法讀取新資料庫；應先保留升級前資料庫與設定備份，再決定版本變更。v4.0 升級須知
下一步
- 已決定使用：讀 CC Switch 設定教學：切換供應商、驗證與還原。
- 想釐清 Codex 能讀寫什麼：讀 Codex 權限設定。
- 要保留工作環境再調整：讀 Codex 備份與還原。
資料來源與查證日期
查證日期：2026-11-05。主要版本：CC Switch v4.0.25，2026-11-02 發布；tag 對應 commit a3eafa408ae679db2e3401fca767ed2b89d9a2b2。
版本補充（2026-11-06）：v4.0.26 的固定 commit 為 f621d4216189ef06bcc6acd3588c84937b9794e1。它加入帳號方案顯示等變更；Kimi 的非 Codex 預設有新預設模型，不能套到本頁設定教學的 Codex 卡片。Kimi For Coding／Global 與 DeepSeek 的相關 Codex 預設和 v4.0.25 相同。具體端點、憑證與費用核對併在同一篇設定教學，不另建重複更新頁。
- v4.0.25 README：工具清單、功能矩陣與基本流程。
- 官方安裝指南：系統需求與下載檔案。
- 供應商切換／編輯設定：模式、生效方式與共同設定。
- Accounts 設定手冊：多帳號與風險界線。
- 聚合模式：模型清單、重啟及限制。
- v4.0.25 發布／英文更新紀錄：額度保護與修正。
- v4.0 升級說明：資料庫版本與回復限制。