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