跳轉到主要內容

Documentation Index

Fetch the complete documentation index at: https://docs.aihubmix.com/llms.txt

Use this file to discover all available pages before exploring further.

CC Switch 是一款免費的桌面應用程式,專為管理與切換 AI 程式設計工具的設定而生。搭配 AIHubMix,您無需手動修改設定檔、環境變數或 API 設定,即可在 Claude Code、Codex、Gemini CLI、OpenCode 與 OpenClaw 之間切換。對於需要同時使用多個模型與 CLI 工作流程的開發者來說,CC Switch 大幅降低了設定負擔 — 讓上手、切換以及在不同工具間的日常使用都變得統一而輕鬆。
Image

​
1. 什麼是 CC Switch?

CC Switch(專案:github.com/farion1231/cc-switch)是由 Jason Young(farion1231) 開發的開源跨平台桌面應用程式。它作為 AI 程式設計 CLI 工具的統一管理器。 如果您使用多個 AI 程式設計工具,可能對這些痛點不陌生:
  • 切換供應商意謂著每次都得手動編輯 ~/.claude/settings.json 或重設環境變數
  • 設定無法跟著您跨機器使用 — 每台新裝置都得重新開始
  • WSL 與 Windows 各自需要不同的設定,維護成本日積月累
CC Switch 就是為了解決這些問題而設計的。它是一款輕量級應用程式,常駐在您系統的工具列。只需點幾下就能切換工具或供應商 — 無需編寫程式碼或編輯設定檔。基於 Tauri 2 + Rust 打造,安裝程式體積小,可在 Windows、macOS 與 Linux 上執行,並透過持續駐留的系統工具列項目讓多供應商管理變得快速直覺。 支援的 5 種 CLI 工具:
CLI(指令列介面)工具是您透過文字指令而非圖形介面操作的程式 — 常見於開發環境。CC Switch 可在一處管理下列所有工具的設定。
工具開發者描述
Claude CodeAnthropic由 Claude 驅動的 AI 程式設計助理 — 直接在終端機聊天、撰寫程式碼與除錯
CodexOpenAIOpenAI 的程式碼產生工具,支援多語言自動補全與生成
Gemini CLIGoogleGoogle Gemini 模型的指令列介面,適合 Google 生態系的開發者
OpenCode開源一款連接多個 AI 模型的開源 AI 程式設計 CLI
OpenClaw開源一款支援彈性供應商切換的開源 AI CLI

​
2. 核心功能

​
2.1 供應商管理

CC Switch 內建 50+ 個預設設定,涵蓋主要 AI API 供應商 — Anthropic、OpenRouter、AIHubMix、AWS Bedrock 等。您可以:
  • 為每個 CLI 工具建立多個供應商設定
  • 拖曳排序,將最常用的供應商置頂
  • 一鍵切換目前的供應商,無需重新啟動 CLI
  • 使用共用設定片段在切換供應商時保留外掛資料與自訂設定 — 切換新的 API 不必失去您原有的所有設定

​
2.2 統一 MCP 伺服器管理

如果您在多個 CLI 工具中執行 MCP(Model Context Protocol)伺服器,CC Switch 提供統一的管理面板與跨應用程式設定同步。不再需要在每個工具的設定檔中重複輸入相同項目。

​
2.3 技能安裝

CC Switch 支援透過 symlink 從 GitHub 儲存庫或 ZIP 檔案安裝技能套件 — 易於團隊分享且方便版本控管。

​
2.4 使用儀表板

內建的儀表板可追蹤:
  • 每日與每週的 API 花費
  • 請求次數與 token 使用量
  • 隨時間變化的趨勢視覺化
如果您連接了多個供應商,這能讓您清楚看到每個供應商實際的花費。

​
2.5 雲端同步

將您的設定同步到:
  • Dropbox
  • OneDrive
  • iCloud(macOS)
  • WebDAV(自架)
不必再手動跨裝置匯出與匯入設定。

​
3. 安裝

​
3.1 Windows

選項 1:Winget(推薦) 
winget install --id=farion1231.CC-Switch -e
選項 2:手動安裝 從 GitHub Releases 頁面下載最新的 .msi 安裝程式或可攜式 .zip。解壓縮後執行。 需求: Windows 10 或更新版本

​
3.2 macOS

選項 1:Homebrew(推薦) 
brew tap farion1231/ccswitch
brew install --cask cc-switch
選項 2:手動安裝 從 Releases 頁面下載已公證的 .dmg,掛載後將 CC Switch 拖曳至「應用程式」資料夾。 需求: macOS 12(Monterey)或更新版本

​
3.3 Linux

依您的發行版選擇合適的套件格式: 
# Debian / Ubuntu
sudo dpkg -i cc-switch_x.x.x_amd64.deb

# Fedora / RHEL
sudo rpm -i cc-switch-x.x.x.x86_64.rpm

# Universal (AppImage)
chmod +x cc-switch_x.x.x_amd64.AppImage
./cc-switch_x.x.x_amd64.AppImage

# Arch Linux (AUR)
paru -S cc-switch-bin
需求: Ubuntu 22.04+ / Debian 11+ / Fedora 34+

​
3.4 WSL 整合(Windows 使用者)

CC Switch 提供專屬的 WSL 支援。在 Windows 端安裝後,即可直接管理執行於 WSL 內的 Claude Code 與其他 CLI 工具 — 無需在 WSL 內另外安裝。 設定完成後,CC Switch 會透過本機 proxy 在 WSL 與 Windows 之間架接網路請求,實現無縫的統一管理。

​
4. 將 Claude Code 連接到 AIHubMix

​
為什麼選擇 AIHubMix?

AIHubMix 由註冊於美國的 AIHubMix, LLC 營運 — 一個獲得官方授權、合規的模型聚合平台,與 Microsoft Azure、AWS、GCP、阿里雲、百度雲及其他主要推論供應商建立合作關係。所有服務皆執行於 Google Cloud 美國叢集基礎架構上,為全球開發者與企業提供高並行、穩定可靠的 AI 模型 API。 對於 Claude Code 使用者來說,透過 AIHubMix 路由能顯著降低成本,同時保有像 OpenRouter 等平台所提供的彈性。

​
4.1 新增 AIHubMix 為供應商

開啟 CC Switch 並切換到 Claude Code 的供應商管理頁面:
  1. 點擊右上角的 「+ 新增供應商」 Image
  2. 從預設清單中選擇 「AiHubMix」,並點擊連結取得您的 API key Image
  3. 將金鑰貼入 「API Key」 欄位 Image
  4. 複製您要使用的模型 ID(例如 claude-opus-4-7),然後點擊 「新增」 儲存 Image
  5. 回到主畫面,從供應商清單中選擇 「AiHubMix」,並點擊 「啟用」 Image

​
4.2 驗證連接

在終端機中執行 Claude Code 並發送一個簡單的提示。正常回應即代表您已成功透過 AIHubMix 連接。 Image
提示: 在 Claude Code 中,輸入 /status 可檢視目前啟用的模型 ID,或輸入 /models 切換到其他已設定的模型。

​
5. 搭配 VSCode 使用

Claude Code 提供官方 VSCode 擴充功能,CC Switch 與其完全相容。

​
5.1 安裝 Claude Code 擴充功能

在 VSCode 擴充功能市集中搜尋 「Claude Code」 並安裝。

​
5.2 搭配 CC Switch 使用

Image

​
5.3 多個工作區

如果您同時開啟多個 VSCode 工作區,它們都共用相同的 CC Switch 設定。切換供應商一次,即在所有地方生效。

​
6. 其他 CLI 工具 + AIHubMix

CC Switch 不僅適用於 Claude Code,還完整支援其他四個主流 AI 程式設計 CLI 工具。

​
6.1 Codex + AIHubMix

Codex CLI 使用者可在 CC Switch 中獨立管理其供應商設定並連接到 AIHubMix。完整的 Codex 設定指南請參見: → https://docs.aihubmix.com/en/api/Codex-CLI Image
範例: 在 CC Switch 中設定您的 AIHubMix API key,即可在 Codex 中直接使用 deepseek-v4-flash — 或其他任何受支援的模型。
Image

​
6.2 Gemini CLI + AIHubMix

Google Gemini CLI 的設定通常分散在多個地方。CC Switch 將其全部彙整到單一介面,並可快速在多個 Google 帳號或 Gemini API key 之間切換 — 對於頻繁切換專案的團隊特別實用。 安裝 Gemini CLI 請確認已安裝 Node.js ≥ 18。如未安裝: 
brew install node
接著全域安裝 Gemini CLI: 
npm install -g @google/gemini-cli
設定
  1. 開啟 CC Switch 並點擊 新增供應商
  2. 手動新增 AiHubMix
  3. API Key: 您的 sk- 開頭金鑰(可至 aihubmix.com/token 取得)
  4. Base URL: https://aihubmix.com/gemini
Image Image

​
6.3 OpenCode + AIHubMix

OpenCode 是一款支援多供應商的開源 AI 程式設計 CLI。CC Switch 內建 OpenCode 支援,可直接管理其設定檔 — 無需手動編輯 TOML 或 JSON。 完整設定指南請參見:https://docs.aihubmix.com/en/api/Opencode 設定
  1. 開啟 CC Switch 並點擊 新增供應商
  2. 選擇 AiHubMix
  3. API Key: 您的 sk- 開頭金鑰(可至 aihubmix.com/token 取得)
Image Image 然後在終端機中執行: 
opencode
Image

​
6.4 OpenClaw + AIHubMix

OpenClaw 是一款相容於 OpenAI API 的開源 CLI,適合需要自訂模型路由的進階使用者。完整設定指南:https://docs.aihubmix.com/en/api/OpenClaw CC Switch 與 OpenClaw 如何協作:
  1. 在 CC Switch 中為 OpenClaw 建立專屬的供應商群組
  2. 將 AIHubMix、OpenRouter 或其他聚合平台設為 OpenClaw 的上游
  3. 利用 CC Switch 的熱切換在上游間即時跳轉
當您想比較不同供應商的回應品質時,這特別實用 — 在 CC Switch 中切換,OpenClaw 端完全無需變動。

​
7. CC Switch vs. Claude Code Router

Claude Code Router 是另一款常被提及的工具。以下是兩者的比較:
CC SwitchClaude Code Router
類型桌面 GUI 應用程式CLI / 設定工具
支援工具5 種(Claude Code、Codex、Gemini、OpenCode、OpenClaw)主要支援 Claude Code
供應商預設50+手動設定
本機 proxy內建,熱切換 + 容錯切換手動設定
MCP 管理統一介面不支援
WSL 支援專屬支援有限
雲端同步Dropbox / iCloud / WebDAV不支援
使用儀表板內建不提供
學習曲線低(GUI)中(設定檔)
適合對象多工具使用者、注重效率的開發者輕量需求、CLI 純粹主義者
結論: 如果您只使用 Claude Code 並偏好指令列,Claude Code Router 就夠用。如果您跨多個 AI 程式設計工具工作,或希望有視覺化、集中式的管理介面,CC Switch 是更強的選擇。

​
8. FAQ

Q:CC Switch 是免費的嗎? 是的,完全免費。它採用 MIT 授權並在 GitHub 上開源。任何 API 費用都取決於您所連接的供應商。 Q:如何讓 CC Switch 在 WSL 中運作? CC Switch 執行於 Windows 端,並透過本機 proxy 架接 WSL 的請求。將 WSL 的 proxy 設定指向 CC Switch 的本機監聽連接埠 — 確切的連接埠可在 CC Switch 的 proxy 設定頁面中找到。 Q:切換供應商後,Claude Code 需要重新啟動嗎? 不需要。熱切換會立即生效。您目前的終端機工作階段會持續執行而不中斷。 Q:我的資料儲存在哪裡? 本機資料庫位於 ~/.cc-switch/cc-switch.db,設定檔位於 ~/.cc-switch/settings.json。CC Switch 會自動保留最新的 10 個備份。 Q:我可以透過連結與團隊分享供應商設定嗎? 可以。CC Switch 支援 Deep Links(ccswitch:// 通訊協定),團隊成員只需點擊單一 URL 即可匯入共用的供應商設定 — 適合在團隊中標準化 API 存取。 Q:CC Switch 是否支援 AWS Bedrock? 支援 — 內建 Bedrock 預設,並支援 Cross-Region Inference,是企業使用者透過 Bedrock 存取 Claude 的可靠選擇。

​
結語

CC Switch 將過去散落於數十個設定檔的 AI 程式設計工具管理,整合到單一輕量級桌面應用程式中。無論您深耕 Claude Code,或在 Codex、Gemini CLI 等工具間切換,它都能讓您的工作流程保持整潔。 最新發布的 v3.12.0 穩定可用。前往 github.com/farion1231/cc-switch 取得完整文件與發布說明。 Image 最後更新:2026 年 4 月 28 日