引言“一鍵切換 API ProviderMCP、Skills、Prompts 集中管理——不用再手動(dòng)編輯 JSON/TOML/YAML 配置文件。”這是一天一個(gè)開源項(xiàng)目系列的第 234 篇。今天的項(xiàng)目是CC Switch?，F(xiàn)在同時(shí)用好幾款 AI 編程工具已經(jīng)是常態(tài)——Claude Code 跑一個(gè)項(xiàng)目,Codex 跑另一個(gè),偶爾還要切到 Gemini CLI 或 Grok Build 對(duì)比效果。問(wèn)題是這些工具各自有一套配置格式:Claude Code 用一種 JSON 結(jié)構(gòu),Codex 用 TOML,Gemini CLI 又是另一套 YAML——每次換 Provider、換 API Key、換模型,都要翻到對(duì)應(yīng)工具的配置文件里手動(dòng)改,MCP 服務(wù)器和 Skills 還得在每個(gè)工具里各配一份。CC Switch 把這件事做成了一個(gè)統(tǒng)一的桌面應(yīng)用:一款工具,管理十款 AI 編程工具(Claude Code、Claude Desktop、Codex、Gemini CLI、Grok Build、OpenCode、OpenClaw、Hermes、Pi、MiniMax Code)的 Provider 配置,支持一鍵切換、90 Provider 預(yù)設(shè),還能做本地請(qǐng)求的格式轉(zhuǎn)換路由(Routing)和多 Provider 模型聚合(Aggregation)。142.8k Stars,MIT 協(xié)議,基于 Tauri 2 Rust React 18 構(gòu)建,目前是這個(gè)賽道里規(guī)模最大的開源項(xiàng)目之一。你將學(xué)到什么CC Switch 如何用 Switch/Coexist 兩種模式統(tǒng)一十款工具的配置管理方式Direct、Routing、Aggregation 三種連接模式的具體區(qū)別和適用場(chǎng)景最小侵入設(shè)計(jì)理念:切換 Provider 為什么不會(huì)破壞你手動(dòng)加的插件和 Hook本地請(qǐng)求路由的格式轉(zhuǎn)換與故障轉(zhuǎn)移(Failover)機(jī)制數(shù)據(jù)存儲(chǔ)設(shè)計(jì):~/.cc-switch目錄結(jié)構(gòu)與云同步方案前置知識(shí)使用過(guò)至少一款 AI 編程 CLI 工具(Claude Code、Codex、Gemini CLI 等)了解 API Provider、Base URL、API Key 這些基本概念可選:了解 MCP(Model Context Protocol)的基本用途會(huì)更容易理解集中管理部分項(xiàng)目背景項(xiàng)目簡(jiǎn)介CC Switch 的官方定位是:“面向 Claude Code、Codex、OpenCode、OpenClaw、Grok Build 和 Hermes Agent 的跨平臺(tái)桌面全能助手”。更完整的說(shuō)法是Claude Code、Claude Desktop、Codex、Gemini CLI、Grok Build、OpenCode、OpenClaw、Hermes Agent、Pi 和 MiniMax Code 的全能管理器。核心價(jià)值主張:“一鍵切換 API Provider,MCP、Skills、Prompts 集中管理——不用再手動(dòng)編輯 JSON/TOML/YAML 配置文件”。團(tuán)隊(duì)與項(xiàng)目信息作者:Jason Young(farion1231)協(xié)議:MIT License技術(shù)棧:Tauri 2、Rust、React 18、TypeScript、SQLite官網(wǎng):ccswitch.io項(xiàng)目數(shù)據(jù)? GitHub Stars:142,800 Forks:9,500 Watchers:264 協(xié)議:MIT主要功能解決什么問(wèn)題沒(méi)有 CC Switch 時(shí)的多工具管理 Claude Code → 配置文件是 JSONProvider 信息藏在深層嵌套字段 Codex → 配置文件是 TOML格式完全不同 Gemini CLI → 配置文件是 YAML又是另一套結(jié)構(gòu) ↑ 每換一次 Provider/API Key/模型都要分別打開對(duì)應(yīng)工具的配置文件手改 ↑ MCP 服務(wù)器、Skills、Prompts 要在每個(gè)工具里各自配置一份無(wú)法共享 CC Switch 的做法 一個(gè)桌面應(yīng)用統(tǒng)一管理十款工具的 Provider 配置 ↓ 一鍵切換90 預(yù)設(shè) ProviderAWS Bedrock、NVIDIA NIM、社區(qū)中轉(zhuǎn)等 ↓ MCP、Skills、Prompts 集中管理一次配置多工具復(fù)用 ↑ 切換只改動(dòng)必要的連接字段endpoint/key/model ↑ 插件、Hook、自定義配置保持不變使用場(chǎng)景同時(shí)使用多款 AI 編程 CLI 的開發(fā)者想要統(tǒng)一管理 Provider 和 API Key,而不是在每個(gè)工具的配置文件之間來(lái)回切換需要在多個(gè) Provider 之間頻繁切換測(cè)試的用戶對(duì)比不同模型/Provider 的效果,一鍵切換而不用手動(dòng)改配置文件想要跨工具復(fù)用 MCP 服務(wù)器配置的團(tuán)隊(duì)不想在 Claude Code、Codex、Gemini CLI 里分別配置同一套 MCP 服務(wù)器想在 Claude Code 里用 GPT,或者混用不同廠商模型的用戶通過(guò) Routing 模式做本地格式轉(zhuǎn)換,實(shí)現(xiàn)跨 Provider 格式兼容需要追蹤多 Provider 使用量和費(fèi)用的用戶在 Provider 卡片和系統(tǒng)托盤上直接查看 Token 用量、花費(fèi)、訂閱額度,不需要分別打開每個(gè)廠商的后臺(tái)快速開始安裝:# macOSbrewinstall--caskcc-switch# macOS 升級(jí)brew upgrade--caskcc-switch# Arch Linuxparu-Scc-switch-bin基本使用流程:1. 在側(cè)邊欄通過(guò)預(yù)設(shè)或自定義配置添加一個(gè) Provider 2. 通過(guò)主界面、系統(tǒng)托盤或項(xiàng)目切換器切換 Provider 3. 切換生效方式因工具而異Claude Code 即時(shí)生效其他工具可能需要重啟 4. 可選開啟 Routing/Aggregation 標(biāo)簽頁(yè)實(shí)現(xiàn)跨格式轉(zhuǎn)換或多 Provider 聚合 5. 通過(guò)Apps頁(yè)面管理已安裝 CLI 工具的版本核心特性1. 兩種配置管理模式模式含義Switch同一時(shí)刻只有一個(gè) Provider 處于激活狀態(tài)Coexist多個(gè) Provider 同時(shí)寫入該工具自己的配置文件2. 工具支持能力矩陣工具配置模式本地路由聚合托盤切換MCPSkillsPrompts會(huì)話用量統(tǒng)計(jì)Claude CodeSwitch?????CLAUDE.md??Claude DesktopSwitch僅模型映射–?––––僅模型映射CodexSwitch?????AGENTS.md??Gemini CLISwitch?–???GEMINI.md??Grok BuildSwitch?–???AGENTS.md??OpenCodeCoexist–––??AGENTS.md??OpenClawCoexist–––––工作區(qū)編輯器?–HermesCoexist–––??Memory?–PiCoexist–––??AGENTS.md/SYSTEM.md/提示模板??MiniMax CodeCoexist–––??AGENTS.md??3. 三種連接模式Direct(直連):工具直接連接到 ProviderRouting(路由):請(qǐng)求本地經(jīng)過(guò) CC Switch 轉(zhuǎn)發(fā),支持格式轉(zhuǎn)換和故障轉(zhuǎn)移,實(shí)現(xiàn)跨 Provider 兼容(比如在 Claude Code 里用 GPT)Aggregation(聚合):把多個(gè) Provider 的模型合并成一個(gè)選擇列表,每次請(qǐng)求路由到對(duì)應(yīng)模型的真實(shí) Provider4. 集中管理 MCP、Skills、Prompts一次配置,多工具復(fù)用,不需要在每個(gè)工具里重復(fù)設(shè)置同一套 MCP 服務(wù)器或 Skills。5. 會(huì)話閱讀視圖把原始日志轉(zhuǎn)換成可讀的步驟/文件/失敗摘要,不需要翻看原始日志文件。6. 用量與額度追蹤Token 用量、花費(fèi)、訂閱額度直接顯示在 Provider 卡片和系統(tǒng)托盤上。7. 數(shù)據(jù)存儲(chǔ)結(jié)構(gòu)默認(rèn)存儲(chǔ)在~/.cc-switch目錄:文件/目錄用途cc-switch.dbSQLite 數(shù)據(jù)庫(kù)(Provider、MCP、Prompts、Skills、項(xiàng)目、用量)settings.json設(shè)備級(jí)設(shè)置backups/自動(dòng)備份,默認(rèn)每 24 小時(shí)一次,保留最近 10 份skills/Skills 目錄(可遷移到~/.agents/skills)backups/live-first-write/安裝 CC Switch 前的原始配置快照支持 Windows 上的 WSL 路徑配置,以及通過(guò) WebDAV 或 S3 兼容存儲(chǔ)做云同步。深入剖析最小侵入設(shè)計(jì):切換只改必要字段CC Switch 有一條明確的設(shè)計(jì)原則值得關(guān)注:即使卸載這個(gè)應(yīng)用,你的工具依然能正常工作。“切換 Provider 時(shí),只會(huì)改動(dòng)關(guān)鍵字段”(endpoint、key、model),而插件、Hook、MCP,以及你自己添加的注釋保持不動(dòng)。如果切換 Provider 時(shí)整體覆蓋配置文件 用戶手動(dòng)加的 Hook/插件/注釋 → 被覆蓋丟失 ↑ 每次切換都有破壞現(xiàn)有配置的風(fēng)險(xiǎn) ↑ 用戶不敢隨意切換因?yàn)榇鷥r(jià)不可預(yù)測(cè) CC Switch 的最小侵入做法 只改動(dòng) endpoint/key/model 這幾個(gè)連接字段 ↓ 插件、Hook、MCP、自定義注釋原樣保留 ↑ 卸載 CC Switch 后工具配置文件依然是完整可用的 ↑ 用戶可以放心頻繁切換不用擔(dān)心丟失自定義配置這個(gè)設(shè)計(jì)選擇的意義在于:它把 CC Switch 定位成一個(gè)配置管理的外層工具,而不是配置文件的唯一真相源。即便某天不再使用 CC Switch,底層工具的配置依然完整、可獨(dú)立工作——這降低了用戶嘗試這個(gè)工具的心理門檻,因?yàn)橥顺龀杀颈伙@式地做到了接近零。Routing 模式:本地格式轉(zhuǎn)換加故障轉(zhuǎn)移Routing 模式的核心能力是在本地做協(xié)議格式轉(zhuǎn)換——在 Anthropic Messages、OpenAI Chat Completions、OpenAI Responses 和 Gemini Native 這幾種格式之間互相轉(zhuǎn)換,從而實(shí)現(xiàn)在 Claude Code 里用 GPT這種跨廠商兼容場(chǎng)景。沒(méi)有 Routing 時(shí) Claude Code 只認(rèn) Anthropic Messages 格式 ↑ 想用 OpenAI 格式的 Provider工具本身不支持 Routing 模式 請(qǐng)求先經(jīng)過(guò)本地 CC Switch默認(rèn) http://127.0.0.1:15721 ↓ 格式轉(zhuǎn)換Anthropic ? OpenAI Chat Completions ? OpenAI Responses ? Gemini Native ↓ 附帶斷路器circuit breaker和 Provider 健康監(jiān)控做自動(dòng)故障轉(zhuǎn)移 ↓ Rectifier 功能自動(dòng)修復(fù)部分上游無(wú)法處理的請(qǐng)求 ↑ Claude Code 不需要知道背后實(shí)際在用哪家 Provider這個(gè)設(shè)計(jì)把工具只認(rèn)一種 API 格式這個(gè)限制,轉(zhuǎn)化成了一個(gè)本地代理層能解決的問(wèn)題——用戶不需要等待工具廠商官方支持某個(gè) Provider,只要 CC Switch 支持格式轉(zhuǎn)換,跨廠商組合就是可行的。Aggregation 模式:致謝 opencodex 的設(shè)計(jì)借鑒值得一提的是,CC Switch 的聚合模式設(shè)計(jì)明確致謝了開源項(xiàng)目opencodex的設(shè)計(jì)思路。這是一個(gè)值得肯定的開源協(xié)作細(xì)節(jié)——沒(méi)有把借鑒來(lái)的設(shè)計(jì)思路據(jù)為己有,而是在文檔里明確歸功于原作者和貢獻(xiàn)者。聚合模式本身有一個(gè)明確的能力邊界:“聚合模式不提供故障轉(zhuǎn)移”——這是文檔主動(dòng)說(shuō)明的局限,而不是讓用戶自己踩坑后才發(fā)現(xiàn)。此外,Codex 在模型列表變化后需要完整重啟才能生效,而 Claude Code 則是即時(shí)更新——這種工具間行為差異也被顯式記錄在文檔里。Switch vs Coexist:兩種模式背后的工具差異CC Switch 沒(méi)有對(duì)所有工具用同一套配置管理策略,而是根據(jù)工具自身的能力邊界分成 Switch(單一激活)和 Coexist(多 Provider 共存寫入)兩類。這個(gè)劃分背后是對(duì)每個(gè)工具自身配置機(jī)制的尊重——像 Claude Code、Codex 這類支持顯式切換激活 Provider 的工具用 Switch 模式;而 OpenCode、Hermes 等工具本身的配置機(jī)制允許多個(gè) Provider 同時(shí)存在于配置文件里,CC Switch 就不強(qiáng)行套用只能激活一個(gè)的模型,而是采用 Coexist 模式寫入。這種按工具能力適配管理策略而非強(qiáng)行統(tǒng)一所有工具行為的設(shè)計(jì),體現(xiàn)了對(duì)底層工具差異的尊重,而不是用一套抽象硬套所有場(chǎng)景。對(duì)于 Headless/服務(wù)器場(chǎng)景的態(tài)度對(duì)于沒(méi)有 GUI 的無(wú)頭環(huán)境,CC Switch 沒(méi)有自己做一個(gè) CLI 版本,而是在文檔里指向一個(gè)獨(dú)立的社區(qū)項(xiàng)目CC Switch CLI(SaladDay/cc-switch-cli),并明確說(shuō)明它與桌面應(yīng)用共享~/.cc-switch數(shù)據(jù)目錄,但版本發(fā)布是獨(dú)立的,可能存在版本滯后。這是一個(gè)坦誠(chéng)的生態(tài)邊界說(shuō)明——沒(méi)有把這個(gè)能力硬塞進(jìn)自己的產(chǎn)品范圍,也沒(méi)有掩蓋兩者版本可能不同步這個(gè)潛在的使用風(fēng)險(xiǎn)。項(xiàng)目地址與資源官方資源GitHub:https://github.com/farion1231/cc-switch官網(wǎng):ccswitch.io協(xié)議:MIT License更新日志:倉(cāng)庫(kù)內(nèi)CHANGELOG.md相關(guān)資源opencodex —— CC Switch 聚合模式的設(shè)計(jì)靈感來(lái)源CC Switch CLI —— 面向 Headless/服務(wù)器環(huán)境的社區(qū) CLI 版本,共享同一數(shù)據(jù)目錄總結(jié)與展望核心要點(diǎn)回顧一個(gè)應(yīng)用統(tǒng)一管理十款 AI 編程工具的 Provider 配置:告別手動(dòng)編輯 JSON/TOML/YAML 的碎片化體驗(yàn)最小侵入設(shè)計(jì)把退出成本降到接近零:切換只改連接字段,插件/Hook/自定義配置原樣保留,卸載后工具依然能獨(dú)立工作三種連接模式覆蓋不同需求:Direct 直連、Routing 本地格式轉(zhuǎn)換加故障轉(zhuǎn)移、Aggregation 多 Provider 模型聚合按工具能力差異化管理策略:Switch(單一激活)/Coexist(多 Provider 共存)分別適配不同工具自身的配置機(jī)制坦誠(chéng)的生態(tài)邊界意識(shí):聚合模式明確標(biāo)注不提供故障轉(zhuǎn)移、致謝 opencodex 的設(shè)計(jì)借鑒、Headless 場(chǎng)景指向獨(dú)立社區(qū) CLI 項(xiàng)目而非自己硬做適合誰(shuí)同時(shí)使用多款 AI 編程 CLI 的開發(fā)者:想要一個(gè)統(tǒng)一入口管理所有工具的 Provider 和配置需要頻繁切換 Provider 對(duì)比效果的用戶:一鍵切換比手動(dòng)改配置文件效率高得多想要跨廠商混用模型的用戶:通過(guò) Routing 模式實(shí)現(xiàn)在 Claude Code 里用 GPT這類場(chǎng)景需要集中管理 MCP/Skills 的團(tuán)隊(duì):避免在每個(gè)工具里重復(fù)配置同一套能力一句話評(píng)價(jià)CC Switch 解決的不是哪個(gè) AI 編程工具更好用的問(wèn)題,而是用好幾款工具時(shí),配置管理本身不應(yīng)該成為負(fù)擔(dān)這個(gè)更樸素但更真實(shí)的痛點(diǎn)。