CC Switch：AI 編碼工具設定管理員

1. 專案概覽

CC Switch 是一款跨平台桌面應用程式，將八種熱門 AI 編碼工具（包括 Claude Code、Claude Desktop 和 Codex）的供應商、MCP、提示詞與技能設定管理統一，以單一視覺化介面取代手動且容易出錯的分散設定檔編輯。

2. 背景與定位

Claude Code、Codex、Gemini CLI 等 AI 編碼助手各自將 API 金鑰、模型端點與供應商設定儲存在各自的設定檔與格式中。同時使用多種工具的開發者，或為了成本、延遲或可用性原因而在多個 API 供應商之間切換的使用者，最終只能手動編輯 JSON/TOML 檔案並重新啟動終端機，只為了更換供應商。CC Switch 的誕生就是為了消除這種摩擦：它將供應商預設、MCP 伺服器、提示詞與技能集中儲存在一個以 SQLite 為基礎的儲存庫中，並自動將正確格式推送給每個工具。

與僅交換環境變數或單一設定檔的簡單 shell 腳本「設定檔切換器」相比，CC Switch 的差異在於一次涵蓋八種工具並內建 50 多種供應商預設、提供具系統匣快速切換的原生 GUI、加入具自動容錯移轉與斷路器的本機代理層，並提供跨裝置同步（Dropbox/OneDrive/iCloud/WebDAV），讓供應商設定能隨開發者跨機器使用。

3. 功能分類

🔌 供應商管理 — 在「8 種支援工具、50 多種預設」中提供 50 多種預設；可匯入、拖曳排序，並一鍵切換 Claude Code、Codex、Gemini CLI 等工具的供應商。目的：消除手動編輯每個工具供應商設定檔的需求。
🔄 統一設定同步 — 一個已儲存的設定可同時同步至 Claude Code、Codex 與 Gemini CLI。目的：保持多個 CLI 工具的一致性，避免設定漂移。
🛡️ 代理與容錯移轉 — 本機代理具備請求格式轉換、自動容錯移轉、斷路器與供應商健康檢查功能。目的：即使供應商效能下降或故障，也能維持編碼工作階段持續運作。
🧩 MCP／提示詞／技能管理 — 專屬面板管理 Model Context Protocol 伺服器、提示詞庫與技能，支援跨應用程式同步與深層連結匯入。目的：一次管理擴充功能，而非逐工具管理。
🕘 工作階段與歷史瀏覽 — 瀏覽、搜尋與還原支援的工作階段來源中的對話歷史。目的：在工具或機器之間切換時保持連續性。
📊 用量追蹤 — 儀表板顯示花費、Token 消耗與請求次數，附趨勢圖與詳細日誌。目的：提供 API 成本與使用模式的能見度。
☁️ 雲端同步 — 透過 Dropbox、OneDrive、iCloud 或自訂 WebDAV 伺服器同步設定。目的：在多個裝置上維持相同的供應商／工具設定。

4. 重點特色

八種工具、單一介面 — Claude Code、Claude Desktop、Codex、Gemini CLI、Grok Build、OpenCode、OpenClaw 與 Hermes 皆可從同一個應用程式設定，而非八個獨立的設定檔。
系統匣快速切換 — 可從系統匣選單切換供應商，無需開啟完整視窗；Claude Code 支援免重新啟動的熱切換。
具容錯移轉的本機代理 — 內建代理在供應商之間執行格式轉換，並在供應商不健康時自動容錯移轉，同時具備斷路器保護。
SQLite 單一事實來源 — 供應商、MCP 設定、提示詞與技能儲存在單一資料庫（~/.cc-switch/cc-switch.db）中，具備原子寫入與互斥鎖保護的並行存取，避免設定損毀。
自動備份 — 應用程式會保留最近十份資料庫備份，並在解除安裝前保留最多二十份技能快照，因此設定錯誤皆可復原。
原生、代碼簽署的建置 — Tauri 2 + Rust 產生小巧的原生二進位檔；macOS 建置已由 Apple 代碼簽署並公證。

5. 依角色區分的使用案例

一般開發者 — 使用多種 AI 編碼助手（例如 Claude Code 加上 Codex 或 Gemini CLI）的任何人都可以維護一份供應商清單並即時切換，而非逐工具編輯設定檔。
DevOps／基礎設施導向的工程師 — 代理的容錯移轉與斷路器功能有助於在供應商中斷或限制請求時，維持 AI 輔助工作流程的韌性。
評估多種 LLM 供應商的團隊 — 50 多種預設與一鍵切換讓團隊能輕鬆針對成本、延遲或輸出品質進行 A/B 測試，無需手動重新設定每個 CLI 工具。
跨多台機器工作的開發者 — 雲端同步（Dropbox/OneDrive/iCloud/WebDAV）讓筆電與桌上型電腦之間的供應商與 MCP 設定保持一致。

6. 開始使用

找到所需功能 — 在應用程式內瀏覽內建預設與功能面板（供應商、MCP、提示詞、技能、工作階段、用量），或閱讀儲存庫內的使用者手冊與 README 以了解功能細節。

安裝／整合：

# macOS（Homebrew）
brew install --cask cc-switch

# Linux（Arch，透過 AUR helper）
paru -S cc-switch-bin

Windows 使用者與其他 Linux 發行版可從 Releases 頁面下載 MSI、可攜式 ZIP、DEB 或 RPM 套件。

貢獻：

pnpm install
pnpm dev              # 啟動開發模式並支援熱重載
pnpm typecheck        # TypeScript 驗證
pnpm format:check     # 格式檢查
pnpm test:unit        # 前端單元測試
cargo fmt && cargo clippy && cargo test   # Rust 後端檢查

請先透過 GitHub issues 討論功能提案；提交的 pull request 需先通過型別檢查、格式檢查與單元測試。

7. 專案結構

cc-switch/
├── src/            # React + TypeScript 前端（UI、面板、狀態）
├── src-tauri/      # Rust + Tauri 後端（IPC 指令、代理、SQLite 存取）
├── package.json    # 前端相依套件與 pnpm 腳本
└── README.md       # 功能概覽與安裝說明

前端（React 18、Vite、TailwindCSS、shadcn/ui）透過 IPC 與 Rust/Tauri 後端通訊；後端擁有位於 ~/.cc-switch/cc-switch.db 的 SQLite 資料庫，作為供應商、MCP 伺服器、提示詞與技能的單一事實來源。

8. 相關生態系

CC Switch 與其所管理的 AI 編碼工具整合並並存：Claude Code、Claude Desktop、Codex、Gemini CLI、Grok Build、OpenCode、OpenClaw 與 Hermes，以及用於外部工具伺服器的 Model Context Protocol（MCP）生態系。它依賴 Tauri 框架進行原生桌面打包，並依賴雲端儲存供應商（Dropbox、OneDrive、iCloud、WebDAV）進行跨裝置同步。

9. 授權

✅ 可商業或私人使用、修改與散布軟體（MIT 授權）
✅ 可納入專有專案，無需開源自己的程式碼
❌ 作者不對因使用軟體而產生的損害負責
ℹ️ 在軟體的副本或重要部分中必須保留原始版權聲明與授權文字

10. 常見問題

Q：CC Switch 支援哪些 AI 編碼工具？
A：Claude Code、Claude Desktop、Codex、Gemini CLI、Grok Build、OpenCode、OpenClaw 與 Hermes。

Q：切換供應商後需要重新啟動終端機嗎？
A：大多數工具需要重新啟動 CLI 才能讀取新設定，但 Claude Code 支援免重新啟動的熱切換。

Q：我的設定資料儲存在哪裡？
A：儲存在 ~/.cc-switch/ 下的本機 SQLite 資料庫與 JSON 設定檔中，並具備自動備份輪替。

Q：我可以繼續使用官方的 Claude/Codex 登入，而非第三方供應商嗎？
A：可以 — 新增「官方登入」預設即可回到工具的預設驗證方式。

Q：如何在沒有套件管理器的 Windows 或 Linux 發行版上安裝 CC Switch？
A：從 Releases 頁面下載 MSI、可攜式 ZIP、DEB、RPM 或 AppImage 建置。

11. 快速連結

儲存庫：https://github.com/farion1231/cc-switch
官方網站：https://ccswitch.io
Releases：https://github.com/farion1231/cc-switch/releases
Issues（錯誤回報與功能討論）：https://github.com/farion1231/cc-switch/issues

12. 總結

CC Switch 解決了同時使用多種 AI 編碼助手的開發者所面臨的真實痛點：不再需要手動編輯八種不同工具的設定檔，而是提供一個原生、跨平台的介面來管理供應商、MCP 伺服器、提示詞、技能與用量追蹤，並以具韌性的本機代理與跨裝置同步為後盾。對於定期在 AI 供應商之間切換或使用多種編碼助手、且希望設定可靠、有備份並在所有工作環境中保持一致的開發者與團隊而言，它最具價值。