Skip to main content

​
概述

CC Switch 是一款基於 Tauri 2 構建的桌面應用，可以統一管理 Claude Code、Codex CLI、Gemini CLI、OpenCode、OpenClaw 五款 AI CLI 工具。告別手動編輯配置檔案，通過圖形介面一鍵切換 API 提供商、模型和金鑰。 通過配置 API易 服務，您可以獲得：

🚀 一鍵切換

圖形介面管理所有 CLI 工具配置，告別手動編輯

💰 88 折優惠

選擇 ClaudeCode 分組建立令牌，享受 88% 折扣

📊 用量追蹤

內建 Usage Dashboard，即時檢視花費、請求數和 Token 用量

🔄 智慧容錯

本地代理支援熱切換、自動故障轉移和熔斷保護
專案資訊
  • 🔗 開源地址：github.com/farion1231/cc-switch
  • 📜 許可證：MIT
  • 👤 作者：Jason Young（farion1231）
  • 🏷️ 最新版本：v3.12.0

​
核心功能

​
Provider 管理

  • 內建 50+ 預設提供商（含 AWS Bedrock、NVIDIA NIM 等）
  • 一鍵切換、拖拽排序、匯入匯出配置
  • 系統托盤快速訪問

​
MCP 伺服器管理

  • 統一管理所有 CLI 工具的 MCP 伺服器配置
  • 雙向同步，修改一處自動同步到所有應用

​
更多特性

  • Prompts 管理：Markdown 編輯器 + 跨應用同步
  • Skills 安裝：從 GitHub 倉庫或 ZIP 檔案安裝技能
  • Session 瀏覽器：檢視和恢復對話歷史
  • 雲同步：支援 Dropbox、OneDrive、iCloud、WebDAV
  • Deep Link：ccswitch:// 協議一鍵匯入配置

​
快速開始

​
第一步：安裝 CC Switch

使用 Homebrew 安裝：
或從 GitHub Releases 下載 DMG 安裝包。
系統要求：Windows 10+、macOS 10.15 (Catalina)+、Ubuntu 22.04+ / Debian 11+ / Fedora 34+

​
第二步：獲取 API易 金鑰

  1. 訪問 API易控制台 - 令牌頁面
  2. 點選建立新令牌
  3. 重要：選擇 【ClaudeCode】分組，享受 88% 折扣
  4. 複製生成的金鑰（以 sk- 開頭）
省錢提示：建立令牌時務必選擇【ClaudeCode】分組，可享受 88 折優惠價格，大幅降低使用成本。

​
第三步：在 CC Switch 中配置 API易

  1. 開啟 CC Switch 應用
  2. 進入 Provider 管理頁面，點選新增，選擇「自定義閘道」：
CC Switch Provider 配置介面 - 新增 API易 統一供應商
  1. 按照上圖填寫以下資訊：
    • 名稱：APIYI
    • API 地址：https://api.apiyi.com
    • API Key：貼上上一步獲取的金鑰
    • 啟用的應用：開啟 Claude Code（按需開啟其他工具）
  2. 點選「新增」儲存配置

​
第四步：新增模型

在 Provider 配置中新增以下模型： 標準模型： 推理模型（強制啟用思維鏈）：
模型選擇建議：日常程式設計推薦 claude-sonnet-4-6，複雜架構設計用 claude-opus-4-6，快速問答用 claude-haiku-4-5-20251001。需要深度推理時使用對應的 thinking 版本。

​
第五步：一鍵切換

配置完成後，在 CC Switch 中選擇 API易 作為當前 Provider，所有關聯的 CLI 工具（Claude Code、Codex CLI 等）會自動切換到 API易 配置。

​
使用指南

​
管理多個 CLI 工具

CC Switch 支援同時管理以下 5 款 AI CLI 工具：
  • Claude Code — Anthropic 官方命令列程式設計助手
  • Codex CLI — OpenAI 的命令列程式設計工具
  • Gemini CLI — Google 的命令列 AI 助手
  • OpenCode — 開源命令列程式設計工具
  • OpenClaw — 開源本地 AI Agent
所有工具共享 Provider 配置，切換一次即可全部生效。

​
本地代理功能

CC Switch 內建本地代理伺服器，提供：
  • 熱切換：無需重啟即可切換 Provider
  • 自動故障轉移：當前 Provider 不可用時自動切換備選
  • 熔斷保護：檢測到持續故障時自動停止請求，防止資源浪費

​
配置備份

  • 自動備份系統保留最近 10 個版本
  • 支援匯入/匯出完整配置
  • 雲同步支援 Dropbox、OneDrive、iCloud、WebDAV

​
模型推薦

檢視更多程式設計模型推薦

除了 Claude 系列，API易 還支援 400+ 主流 AI 模型。檢視完整的程式設計模型推薦、效能對比和場景化使用建議。

​
常見問題

支援 Windows 10+、macOS 10.15 (Catalina)+、以及主流 Linux 發行版（Ubuntu 22.04+、Debian 11+、Fedora 34+、Arch Linux）。
在 API易控制台 建立令牌時，部分分組（如 ClaudeCode 分組）享有折扣，具體折扣以控制台實際顯示為準；疊加充值活動贈送後，實際成本更低。
請檢查：
  1. API Key 是否正確（以 sk- 開頭）
  2. Base URL 是否設定為 https://api.apiyi.com
  3. API易 賬戶餘額是否充足
  4. CC Switch 是否已將配置同步到 Claude Code
Thinking（推理）模型會強制啟用思維鏈模式，在回答前進行深度推理分析。適合複雜邏輯推理、架構設計等需要深度思考的場景。標準模型響應更快，適合日常程式設計和簡單任務。
CC Switch 支援匯入功能，可以自動讀取已有的環境變數和配置檔案。安裝後開啟應用，它會自動檢測已安裝的 CLI 工具及其現有配置。
CC Switch 本身完全免費開源（MIT 許可證）。只有 API 呼叫會產生費用，通過 API易 使用 ClaudeCode 分組可享受 88 折優惠。

​
最佳實踐

高效使用建議：
  1. 分組建立令牌：務必選擇【ClaudeCode】分組，享受 88 折
  2. 善用熱切換：在不同任務間快速切換 Provider 和模型
  3. 啟用自動故障轉移：配置多個 Provider 作為備選，確保服務連續性
  4. 定期備份：利用雲同步功能定期備份配置

​
相關資源

Claude Code 配置

檢視 Claude Code 的詳細配置教程

模型推薦

瞭解最新的 AI 模型推薦

API易控制台

管理 API 金鑰和檢視用量

其他程式設計工具

探索 Cursor 等其他程式設計工具