CC Switch:Claude Code/Codex/Gemini 多工具統一管理器
farion1231/cc-switch
跨平臺桌面應用,統一管理 Claude Code、Codex、OpenCode、Gemini CLI、Hermes Agent 等 AI 程式設計工具的配置切換與技能管理
成熟度:維護活躍,最近提交 0 天前,open issues 1532 個,持續高頻迭代中
项目体检
技术 · Rust + TypeScript,基于 Tauri 2 框架构建跨平台桌面应用
许可 · MIT 协议,可自由商用、修改和分发
活跃 · 最新版本 v3.16.3 发布于 8 天前,177 位贡献者参与,最近提交 0 天前,保持高频更新
解決什麼
AI 程式設計工具爆發式增長後,開發者常需在 Claude Code、Codex、Gemini CLI、OpenCode、Hermes Agent 等多個工具間切換。每個工具都有獨立的配置檔案(API Key、模型引數、MCP 伺服器、技能包),手動編輯 JSON 配置既繁瑣又易出錯。CC Switch 提供統一的視覺化介面,集中管理所有工具的配置、快速切換 API 提供商(官方/中轉服務)、同步技能包,並支援 WSL 環境下的配置對映,讓多工具協作變得絲滑。
為何火
該專案在 GitHub 獲得 10.5 萬+ stars,核心原因是踩中了 AI 程式設計工具碎片化管理的痛點。通常開發者需要在命令列手動編輯 ~/.claude/config.json、~/.codex/settings.yaml 等配置檔案,CC Switch 將這些操作封裝成跨平臺桌面應用,支援一鍵切換 API 提供商(如從官方切到 PackyCode 中轉)、批次匯入技能包、視覺化管理 MCP 伺服器。專案基於 Tauri 2 框架,安裝包體積小(約 10MB),啟動速度快,且支援 Windows/macOS/Linux 三大平臺及 WSL 環境,覆蓋了主流開發場景。
核心功能
- 統一配置管理:在單一介面管理 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw、Hermes Agent 的 API Key、模型引數、代理設定
- 快速切換提供商:預設多個 API 中轉服務(PackyCode、AIGoCode、AICodeMirror 等),一鍵切換官方/中轉通道,無需手動編輯配置
- 技能包(Skills)管理:視覺化匯入/匯出/同步技能包,支援跨工具共享自定義 Prompt 模板
- MCP 伺服器管理:統一配置 Model Context Protocol 伺服器,控制工具的上下文增強能力
- WSL 支援:自動檢測 WSL 環境,將配置同步到 Linux 子系統中的工具
- 多語言介面:支援中文、英文、日文、德文,降低非英語使用者的使用門檻
安裝
- 訪問 GitHub Releases 下載對應平臺的安裝包:
- Windows:
.msi或.exe - macOS:
.dmg(Apple Silicon/Intel 通用) - Linux:
.AppImage或.deb
- Windows:
- 安裝後首次啟動,根據嚮導配置需要管理的工具路徑(通常自動檢測)
- 在"提供商"頁面新增 API Key,選擇官方或中轉服務
- 在"技能"頁面匯入已有的 Prompt 模板或從社群下載
中國使用者注意:訪問官方 API(如 Claude/Gemini)需梯子,或直接使用 README 中列出的國內中轉服務(PackyCode 等),註冊時輸入 cc-switch 優惠碼可享折扣。
適合誰
- 多工具重度使用者:同時使用 Claude Code、Codex、Gemini CLI 等 3 個以上 AI 程式設計工具,需要頻繁切換配置
- API 中轉使用者:因網路限制使用國內中轉服務,需要快速切換不同供應商以對比穩定性和價格
- 技能包管理者:維護大量自定義 Prompt 模板,需要跨工具同步和版本管理
- WSL 開發者:在 Windows 上使用 WSL 進行開發,需要同步配置到 Linux 子系統
- 團隊協作場景:需要標準化團隊的 AI 工具配置,通過匯出/匯入配置檔案快速複製環境
不適合只使用單一工具且配置簡單的使用者,此時直接編輯配置檔案更直接。
社群評價
暫無足量社群公開討論,以下為基於專案本身的中立評估:
專案在 GitHub 上獲得超 10 萬 stars,顯示出強烈的市場需求。從 issues 數量(1532 個)來看,使用者活躍度高,但也反映出功能複雜度帶來的支援壓力。README 中大量贊助商(PackyCode、AIGoCode 等 API 中轉服務)表明專案已形成商業生態,但需注意這些中轉服務的穩定性和合規性因供應商而異。專案基於 MIT 協議開源,程式碼透明度高,Tauri 2 技術棧保證了跨平臺一致性和效能,但 Rust 後端可能增加二次開發門檻。從更新頻率(最近提交 0 天前)和版本號(v3.16.3)看,專案處於快速迭代期,功能持續完善中。
選型對比
vs 手動編輯配置檔案:
- CC Switch 優勢:視覺化介面降低出錯率,一鍵切換提供商,支援批次操作
- 手動編輯優勢:無需額外工具,適合配置簡單且變動少的場景
vs 各工具自帶的配置介面(如 Claude Desktop 設定):
- CC Switch 優勢:統一管理多工具,跨工具共享技能包,支援 WSL 同步
- 工具自帶優勢:與工具深度整合,無需第三方依賴
vs 商業化配置管理方案(如企業內部的配置中心):
- CC Switch 優勢:開源免費,輕量級桌面應用,個人和小團隊零成本
- 商業方案優勢:企業級許可權管理、審計日誌、雲端同步
CC Switch 的核心價值在於"統一"和"視覺化",適合需要頻繁切換配置的個人開發者和小團隊。
已知坑
- 中轉服務依賴:README 中推薦的 API 中轉服務(PackyCode、AIGoCode 等)穩定性和合規性需自行評估,部分服務可能存在賬號封禁風險
- 配置同步衝突:若同時在 CC Switch 和工具原生介面修改配置,可能導致配置覆蓋或不一致,建議統一使用 CC Switch 管理
- WSL 路徑檢測:部分 WSL 發行版的配置路徑可能無法自動檢測,需手動指定
- 高 issues 數:1532 個 open issues 表明功能複雜度高,部分邊緣場景可能存在未修復的 bug,建議關注 GitHub Issues 確認已知問題
- 贊助商繫結:專案與多個 API 中轉服務深度繫結(README 中大量推廣連結),使用者需注意區分專案功能和商業推廣
- Tauri 2 依賴:基於較新的 Tauri 2 框架,部分老舊系統可能不相容,需檢查系統要求
- 技能包格式:不同工具的技能包格式可能不完全相容,跨工具共享時需驗證
建議在生產環境使用前,先在測試環境驗證配置同步邏輯,並備份原有配置檔案。
安装方式:下载桌面安装包(Windows/macOS/Linux)