
CC Switch 完整指南3分鐘統一管理AI編程工具一鍵切換供應商【免費下載鏈接】cc-switchA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build Hermes Agent. Only official website: ccswitch.io項目地址: https://gitcode.com/GitHub_Trending/cc/cc-switchCC Switch 是一款面向 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw 等 AI 編程工具的跨平臺全能桌面助手把供應商管理、一鍵切換、本地代理和用量統計收進同一個窗口。同時維護多個 AI 編程工具和多份 API 配置時過去你要反復手改各家 CLI 的配置文件。CC Switch 把所有供應商配置存進本地數據庫切換時替你改寫對應工具的端點與密鑰點一下按鈕就完成整套動作。按下面的順序操作5 分鐘內可以從安裝走到第一次成功切換。3分鐘裝好CC Switch各系統一鍵安裝CC Switch 支持 Windows、macOS、Linux按你的系統選一種方式macOSbrew install --cask cc-switch一條命令完成官方包已簽名并公證可直接打開Windows從官網下載.msi安裝若雙擊安裝程序無反應右鍵文件 → 屬性 → 在安全里勾選解除鎖定Linux按架構安裝 deb 包或給 AppImage 加執行權限后直接運行開發者也可以從源碼啟動本地開發環境git clone https://gitcode.com/GitHub_Trending/cc/cc-switch cd cc-switch pnpm install pnpm tauri dev被管理的 CLI 工具本身依賴 Node.js 18如果還沒裝 Claude Code、Codex、Gemini CLI用npm install -g全局安裝對應包即可。確認安裝成功啟動后檢查兩件事主界面頂部能看到應用切換器列出了你啟用的受管應用系統托盤出現了 CC Switch 圖標。兩者都在就可以開始添加供應商。設置里還能調整語言、主題和退出時是否最小化到托盤。5分鐘添加第一個供應商三步填好API Key點擊主界面右上角的按鈕在預設下拉框選擇供應商常用預設包括智譜 GLM、DeepSeek、Kimi、MiniMax 等找不到就選自定義粘貼 API Key點擊添加預設就像填空題模板端點地址、模型參數都由 CC Switch 預先填好你只負責 Key。添加完成后供應商以卡片形式出現在列表里可以立即用內置的速度測試驗證連通性測速通過再啟用更穩妥。切換之后如何生效點擊供應商卡片上的啟用按鈕CC Switch 會把配置寫入對應 CLI 工具的配置文件。不同工具的生效方式不同應用生效方式Claude Code即時生效支持熱重載Gemini CLI即時生效每次請求重新讀配置Codex / OpenCode / OpenClaw關閉終端重新打開切換還有一個快捷入口右鍵系統托盤圖標在按應用分級的菜單里直接點供應商名稱不用打開主窗口。所有供應商數據都保存在~/.cc-switch/cc-switch.db這個 SQLite 數據庫里每次導入配置前會自動創建備份遷移新機器時用內置導入功能即可整體恢復。? 開啟本地代理與應用接管本地代理像一個快遞中轉站API 請求先經過這個站點再轉發給真實供應商用量、延遲、成敗都順手記錄下來。點擊主界面頂部的代理開關即可啟動默認監聽127.0.0.1:15721開啟應用接管后工具配置被自動改寫到指向本地代理停止代理時配置會自動還原只支持 OpenAI 兼容 API 的供應商也能通過代理的格式轉換用在 Claude Code 上流式與非流式請求都支持代理面板實時顯示活躍連接、總請求數和成功率超過 90% 為綠色請求是否通暢一眼可見。監聽地址保持127.0.0.1即可只有局域網內多臺機器共用時才需要改0.0.0.0。更完整的參數說明見 代理服務章節。智能故障轉移與用量統計配置故障轉移隊列故障轉移是主供應商掉線時的自動換人請求失敗后自動切到隊列里下一個供應商繼續完成。配套的熔斷器類似電路里的保險絲某家供應商連續失敗后會被暫時斷開避免反復重試卡住請求。進入 設置 → 高級 → 故障轉移選擇應用 TabClaude / Codex / Gemini點擊添加供應商把備用供應商放進隊列拖拽調整順序序號越小優先級越高打開自動故障轉移開關供應商卡片上的健康徽章幫你判斷狀態綠色健康、黃色降級連續失敗 1-2 次、紅色熔斷連續失敗 3 次以上。默認失敗閾值 4 次、恢復等待 60 秒Claude 因請求耗時更長閾值放寬到 8 次、等待 90 秒都可以按需調整。查看用量與估算費用打開設置 → 用量頂部 Hero 卡匯總總請求數、真實消耗 Tokens、緩存命中率、估算費用和成功率切換日期、應用、供應商篩選時數字同步刷新。數據有兩個來源代理請求日志需要代理和應用接管都在運行以及CLI 會話日志——直接解析各工具自己的會話歷史文件不依賴代理。也就是說即使不開代理也能看到 Claude、Codex、Gemini 各自的 Token 消耗與費用估算。問題速查癥狀一步處理macOS 提示來自身份不明的開發者系統設置 → 隱私與安全性 → 點仍要打開Windows 安裝程序雙擊無反應右鍵安裝包 → 屬性 → 勾選解除鎖定代理啟動失敗、端口被占用先停止代理在設置里更換端口后重新啟動切換供應商后不生效關閉終端重新打開Codex / OpenCode / OpenClaw 需要API Key 校驗失敗去掉 Key 首尾空格用內置速度測試復測配置丟失、供應商列表為空到~/.cc-switch/backups/找最近備份恢復 生態與貢獻入口完整功能手冊MCP、Prompts、Skills、會話管理在 用戶手冊 中。想參與開發克隆倉庫后pnpm install再pnpm tauri dev啟動本地調試按倉庫內 CONTRIBUTING.md 的規范提交 PR。如果你每天要在多個 AI 編程工具之間來回配置CC Switch 可以把這些動作收斂成一次點擊。【免費下載鏈接】cc-switchA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build Hermes Agent. Only official website: ccswitch.io項目地址: https://gitcode.com/GitHub_Trending/cc/cc-switch創作聲明:本文部分內容由AI輔助生成(AIGC),僅供參考