CC Switch - AI CLI 統一管理工具

CC Switch 教程 — 跨平台 AI CLI 管理工具，統一管理 Claude Code、Codex、Gemini CLI 的 Provider 設定、MCP 伺服器與系統提示詞。對接 CoffeeRouter 一鍵填入。

核心特性

🔌 Provider 管理

  • 一鍵切換 — 在 Claude Code、Codex、Gemini 的 API 設定之間一鍵切換，無需手動修改環境變量或設定檔案
  • 多端點支援 — 每個 Provider 可設定多個端點，支援 API Key 管理與延遲測速
  • 4 層模型設定 — 支援 Haiku / Sonnet / Opus / Custom 四級模型粒度設定

🛠️ MCP 伺服器管理

  • 跨應用統一管理 — 單面板管理 Claude / Codex / Gemini 三端的 MCP 伺服器
  • 三種傳輸類型 — 支援 stdio、HTTP、SSE（Server-Sent Events）
  • 自動同步 — 統一匯入匯出 + 雙向同步

💬 Prompts 管理

  • 多預設系統提示詞 — 無限預設、快速切換
  • 跨應用支援 — Claude（CLAUDE.md）、Codex（AGENTS.md）、Gemini（GEMINI.md）
  • Markdown 編輯器 — CodeMirror 6 + 實時預覽

🌐 多平台支援

  • 桌面應用 — Windows、macOS、Linux 原生安裝包
  • Web 版本 — 適用於無頭伺服器 / SSH 遠程環境的瀏覽器訪問方案
  • CLI 版本 — 命令行交互模式與命令模式雙支援

CoffeeRouter 接入方法

CC Switch 支援 ccswitch:// Deep Link 協議，可從 CoffeeRouter 令牌管理頁一鍵匯入 Provider 設定。

設定步驟

  1. 在 CoffeeRouter 令牌管理頁，點擊對應令牌的下拉菜單 在菜單中選擇 CC Switch 選項，系統會自動喚起 CC Switch 應用并彈出設定彈窗。

  2. 在彈窗中完成設定 填入 CC Switch 彈窗

    彈窗各字段說明：

    • 應用：頂部切換應用類型 — Claude / Codex / Gemini，根據需要選擇目標應用
    • 名稱：為該設定填寫一個名稱（例如 My Claude），方便後續在 CC Switch 中識別和切換
    • 主模型（必填）— 預設使用的主力模型
    • Haiku 模型 — 輕量快速模型
    • Sonnet 模型 — 均衡模型
    • Opus 模型 — 最強模型

    所有模型均為下拉選擇，未選擇時顯示「請選擇模型」。

  3. 完成設定 點擊 「打開 CC Switch」 之後，系統會自動喚起 CC Switch 客戶端並顯示確認匯入彈窗：

    CC Switch 確認匯入彈窗

安裝方式

macOS（推薦 Homebrew）

brew tap farion1231/ccswitch
brew install --cask cc-switch

Windows

從 Releases 下載 .msi 安裝包或便攜版 .zip。

Linux

從 Releases 下載 .deb 包或 .AppImage。

ArchLinux 使用者：

paru -S cc-switch-bin

Web 版本（無頭 / SSH 伺服器）

wget https://github.com/farion1231/cc-switch/releases/latest/download/cc-switch-web-linux-x64.tar.gz
tar -xzf cc-switch-web-linux-x64.tar.gz
cd cc-switch-web/
./cc-switch-web

預設端口 17666，通過瀏覽器訪問 http://localhost:17666。

相關鏈接