CC Switch 教學最容易過時的地方，是「哪一家模型需要本地路由」。截至 2026 年 8 月 5 日，CC Switch 最新正式版為 v3.19.1：DeepSeek V4 Flash、火山方舟 Coding Plan 與騰訊混元 TokenHub 已能透過原生 Responses API 直連 Codex；Kimi、GLM、SiliconFlow 等只有 Chat Completions 介面的供應商，才需要 CC Switch 做協議轉換。
這篇文章把 X 上的完整攻略重組成一條可驗收的最短路徑。第一天先在 20 分鐘內跑通一個工具、一個供應商與一個測試請求，再決定是否需要路由、MCP、Skills、Sessions 與 Memory。
先看答案：三種連線，不要混在一起
| 情境 | 建議連線 | 原因 | 驗收方式 |
|---|---|---|---|
| Claude Code 接官方 Anthropic 或有 Anthropic 相容端點的供應商 | 優先直連 | 路徑短，排障變數少 | 新終端輸入「只回覆 OK」 |
| Codex 接原生 Responses 供應商 | 直連 | 不需要把 Responses 轉成 Chat | 模型可見，且請求成功 |
| Codex 接只有 Chat Completions 的供應商 | 開啟本地路由 | CC Switch 負責格式轉換與模型映射 | 用量頁出現本機代理請求 |
CC Switch 是 Claude Code 與 Codex 旁邊的跨平台設定管理器。它替八個 AI 工具集中管理供應商、API Key、Base URL、模型、路由、MCP、提示詞、Skills、會話與用量。
原攻略哪裡需要更新
X 長文發布於 2026 年 7 月 23 日，當時以 v3.18.0 示範 Codex 接第三方模型，並把 DeepSeek 歸入需要本地路由的情境。八天後發布的 v3.19.1 改變了這條路徑。
官方 release note 明確說明，DeepSeek V4 Flash 的 Codex 預設已改用原生 Responses API，可直接連到 api.deepseek.com。火山方舟 Coding Plan 與騰訊混元 TokenHub 也採直連。本地路由仍有價值，角色則更精確：服務沒有 Responses、需要故障轉移、想集中記錄請求，或需要模型映射時才開。
DeepSeek V4 Pro 目前仍是例外。v3.19.1 的官方說明表示，廠商端尚未開放它的 Codex 直連整合；要直連先用 V4 Flash，或依 CC Switch 當前預設與文件決定是否啟用路由。不要把舊供應商卡片的設定直接當成新版預設，新建一張卡通常比猜 migration 狀態更容易驗證。
CC Switch 值得用在哪裡
它處理的是設定分散問題。
Claude Code 主要讀 ~/.claude/ 下的設定；Codex 使用 ~/.codex/auth.json 與 ~/.codex/config.toml；Gemini CLI、OpenCode、OpenClaw 與 Hermes 又有各自的檔案和工作區。只有一個工具時，手改檔案還能接受。供應商增加後，真正的成本是忘記哪一個 Key、端點、模型和環境變數正在生效。
CC Switch 用 SQLite 保存供應商快照，切換時再寫回各工具的 live config。它也能集中管理 MCP、提示詞與 Skills，並提供用量、備份、會話搜尋與本地路由。官方 GitHub 採 MIT 授權；截至本次查核，最新 release 是 v3.19.1。
20 分鐘跑通第一條鏈路
第一步：先備份，不要先清空環境
備份這些目錄中與你目前工具有關的檔案：
~/.claude/
~/.codex/
~/.gemini/
~/.cc-switch/
不要手工編輯 ~/.cc-switch/cc-switch.db。如果曾用 shell profile 設定 API 變數，先記錄再調整。環境變數可能覆蓋圖形介面的選擇，也是之後排障的重要證據。
第二步：從唯一官方來源安裝
官方網站是 ccswitch.io，原始碼與 release 位於 github.com/farion1231/cc-switch。任何要求購買 CC Switch、儲值或交出帳號密碼的網站都不符合官方免費開源聲明。
macOS 可用 Homebrew：
brew install --cask cc-switch
更新：
brew upgrade --cask cc-switch
截至 2026 年 8 月 5 日，Homebrew cask 指向 v3.19.1 的已簽章 DMG。Windows 從官方 release 下載 .msi，Linux 則按發行版選 .deb、.rpm 或 .AppImage。
第三步：只選一個工具與一個供應商
第一次開啟後，先選 Claude Code 或 Codex。不要同時設定 Claude Desktop、Gemini、Grok Build、OpenCode、OpenClaw 與 Hermes。
新增供應商時，優先用內建 preset。只填供應商文件明確提供的 API Key、Base URL 與模型 ID。Base URL 通常停在 /v1 或供應商指定層級，不要自行補上 /chat/completions；CLI 可能還會再拼一次路徑，最後得到 404。
第四步：用最小請求驗收
切換並啟用供應商後，重新開啟終端或 CLI。Claude Code 目前可熱切換部分供應商資料，但把「重開一次」當作固定驗收步驟，能排除舊 process 還保留設定的問題。
第一個請求只做一件事：
只回覆 OK
看到 OK 只是第一關。第二關要回到 CC Switch，確認目前啟用的供應商與模型；若使用本地路由，還要在用量或請求日誌看到這筆呼叫。
Codex 該直連還是走本地路由
| 供應商情境 | v3.19.1 建議 | 注意事項 |
|---|---|---|
| OpenAI 官方 | 直連 | 保留官方登入與設定 |
| DeepSeek V4 Flash 官方端點 | 直連 | 新版 preset 使用原生 Responses |
| DeepSeek V4 Pro | 依當前 preset 開路由 | v3.19.1 發布時尚未開放 Codex 直連 |
| 火山方舟 Coding Plan | 直連 | 不要誤用另外計費的按量端點 |
| 騰訊混元 TokenHub | 直連 | 需具 Hy3 權限的 TokenHub Key |
| Kimi、GLM、SiliconFlow 等 Chat 端點 | 通常開本地路由 | 讓 CC Switch 轉換 Responses 與 Chat |
本地路由預設應只監聽 127.0.0.1。它能提供協議轉換、請求日誌、用量統計、故障轉移、熔斷與健康檢查，也多了一層 process、port 與 mapping。若不知道 0.0.0.0 會把服務暴露到哪些介面，就不要使用它。
把錯誤碼對回正確的一層
| 現象 | 先檢查 | 不要先做什麼 |
|---|---|---|
| 401 | API Key、前後空白、官方與第三方登入狀態 | 不要立刻重裝 CLI |
404 或 /responses 不存在 |
供應商是否只支援 Chat、本地路由 mapping、Base URL | 不要把完整 endpoint 填進 Base URL |
| 模型不存在 | 供應商當前模型目錄與 preset | 不要猜模型 ID |
| 切換後仍用舊模型 | 供應商是否真的啟用、終端是否重開、環境變數是否覆蓋 | 不要刪除整個使用者目錄 |
| 請求成功但用量為零 | 是否直連、應用接管是否開啟、時間範圍 | 不要把直連流量誤認為路由故障 |
| 切回官方 Codex 後 401 | 版本是否至少 v3.19.1、auth.json 是否殘留第三方狀態 |
不要重複點登入造成更多狀態 |
排障時保留三份證據：目前供應商卡片、API 格式或路由頁、終端完整錯誤。截圖前遮住 API Key、餘額、OAuth token 與專屬連結。
MCP、Prompts、Skills 與 Memory 的採用順序
供應商跑通後，再依需求加一層：
- 用量與日誌：先知道請求去哪裡、用了哪個模型。
- Prompts：集中管理
CLAUDE.md、AGENTS.md、GEMINI.md。 - MCP：一次只啟用一個工具，確認目標應用真的看得到。
- Skills：先安裝一個高頻流程，例如 code review 或週報整理。
- Sessions：跨工具找回會話與 resume 指令。
- Memory／Workspace：只保存穩定偏好，不放 API Key 或密碼。
- 備份與同步：先有本機備份，再考慮 WebDAV 或雲端資料夾。
這個順序的重點是可歸因。一次只增加一個變數，錯誤才有可能在幾分鐘內定位。
Pros and Cons
| Pros | Cons |
|---|---|
| 八個 AI 工具共用一個供應商與擴充管理介面 | 會寫入各工具 live config，使用者必須理解接管狀態 |
| 50+ preset 降低 Base URL 與欄位填錯機率 | preset 與供應商能力會更新，舊教學容易過時 |
| 本地路由補上協議轉換、日誌與故障轉移 | 多一層代理就多一組 port、process 與 mapping 風險 |
| SQLite、原子寫入與自動備份降低設定損壞 | 集中管理也讓備份檔更敏感 |
| MIT 開源、Windows／macOS／Linux 可用 | 第三方供應商的隱私、費率與 SLA 仍要自行審查 |
常見問題
CC Switch 的費用與授權
官方 repo 採 MIT License，官方 release 聲明軟體免費開源。模型 API、第三方中轉與雲端同步服務可能另外收費。
DeepSeek 接 Codex 的路由需求
v3.19.1 的 DeepSeek V4 Flash 官方 preset 已改為原生 Responses 直連。V4 Pro 在該版發布時仍未開放直連；舊卡片或其他聚合商端點也可能需要路由，應以當前 preset 的 API 格式為準。
為什麼切換供應商後沒有生效？
先確認切對應用、卡片顯示啟用，再重開終端或 IDE。接著檢查系統與 shell 的 ANTHROPIC_*、OPENAI_*、GEMINI_* 或 XAI_* 變數是否覆蓋 CC Switch。
本地路由能否開放到區域網路
不建議當作預設。路由可能承載 API Key、請求內容與模型回應，優先只綁定 127.0.0.1。需要跨機器存取時，應另外設計認證、加密與防火牆。
第一週最值得設定什麼？
先跑通一個供應商，再學會看用量與錯誤。第三步才新增第二個模型；之後依序加入一個 Prompt preset、一個 MCP、一個 Skill，最後建立備份。
權威來源
- CC Switch 官方網站
- farion1231/cc-switch 官方 GitHub repository
- CC Switch v3.19.1 release notes
- CC Switch 官方本地路由手冊
- Homebrew Cask：CC Switch
Author Insight
CC Switch 最有價值的功能，是把設定變更變成可觀察、可回復的操作。穩定的 AI 開發環境依賴每次改動後的最小測試、日誌與備份。版本更新會改變最佳連線方式，這套驗收方法比較不容易過時。
如果團隊正在建立 Claude Code、Codex 與多模型的共同開發環境，Tenten 可以協助把供應商、權限、Skills、驗收與成本記錄整理成可維護的工作流。和 Tenten 討論實際導入情境。
