Claude Code 供應商切換：5 分鐘上手 CC Switch

本教學以 CC Switch v4.0.26（2026 年 11 月）為準。後續版本的按鈕標籤可能會變更；設定方式則維持不變。

在不同供應商之間切換 Claude Code，通常得編輯 ~/.claude/settings.json：基本 URL、API 金鑰，有時還要設定模型。只有一個供應商時還算好管理；但有兩、三個供應商時，就會變成一項小型維護工作——而且出錯時不容易察覺，因為 shell 中過期的 ANTHROPIC_* 環境變數，可能會覆蓋你剛編輯的檔案。

CC Switch 將切換操作變成一張可點選的卡片。內建的 AiHubMix 預設設定會自動填入端點，你只要貼上 API 金鑰即可。Claude Code 通常會自動重新載入變更，不必重新啟動。本教學會帶你完成整個設定流程，接著說明 CC Switch 寫入的內容、環境變數的陷阱，以及何時使用直接模式就足夠。

如果你只想看簡短版：安裝 CC Switch、建立 AIHubMix 金鑰、在 Claude Code 下選擇 AiHubMix 預設設定、貼上金鑰、在供應商設定中新增 ANTHROPIC_MODEL=claude-sonnet-5-5、點選 切換，然後執行 claude -p "1+1, output only the answer" --model claude-sonnet-5-5。本文其餘部分會詳細說明這些步驟。

CC Switch 是什麼

CC Switch 是一款開源桌面應用程式（MIT 授權，使用 Tauri + Rust + React），可管理 Claude Code、Codex、Gemini CLI、OpenCode 及其他程式開發工具的供應商設定。內建 90 多種供應商預設設定，也支援自訂供應商。

它不只是切換金鑰的工具：

• 直接模式會改寫用戶端設定檔中的金鑰欄位，讓用戶端直接連線至供應商。
• 路由模式會在 127.0.0.1:15721 啟動本機閘道，提供 API 格式轉換、故障切換、健康檢查及請求記錄。
• 彙整模式會將多個供應商的模型放進同一份 /model 清單。

程式碼儲存庫與使用手冊位於 github.com/farion1231/cc-switch。官方下載來源只有 ccswitch.io 和 GitHub Releases 頁面；任何要求付款或提供帳戶憑證的網站都不是官方來源。

開始之前

你需要準備三樣東西：

• 已安裝且可從終端機執行的 Claude Code。執行 claude --version 確認。如果尚未安裝，請使用官方安裝程式：curl -fsSL https://claude.ai/install.sh | bash；或者使用 Node.js 22 以上版本執行 npm i -g @anthropic-ai/claude-code。
• AIHubMix 帳戶與 API 金鑰。在 AIHubMix 控制台建立金鑰。金鑰通常以 sk- 開頭。
• CC Switch 安裝程式。請從 ccswitch.io 或 GitHub Releases 下載。

步驟 1：安裝 CC Switch

首次啟動時，CC Switch 會將現有的 Claude Code 設定匯入為名為 default 的供應商，並新增官方供應商。你的原始設定不會遺失，隨時都能切換回去。

如果尚未安裝 Claude Code，可在 CC Switch 的 應用程式頁面安裝或升級。

步驟 2：建立 AIHubMix API 金鑰

開啟 AIHubMix API 金鑰頁面，建立金鑰並複製。

文件中的佔位文字 AIHUBMIX_API_KEY 並非有效金鑰。若直接照貼，請求會因 401 invalid key: AIHUBMIX_API_KEY 而失敗。

步驟 3：將 AIHubMix 新增至 Claude Code

1. 在左側側邊欄選取 Claude Code。
2. 點選右上角的 + 按鈕。
3. 搜尋 AiHubMix，或在第三方平台類別中尋找。
4. 名稱與端點會自動填入：https://aihubmix.com。在 API 金鑰欄位貼上你的金鑰。
5. 點選 新增。

預設設定會儲存兩個環境變數：

{
  "env": {
    "ANTHROPIC_API_KEY": "sk-your-key",
    "ANTHROPIC_BASE_URL": "https://aihubmix.com"
  }
}

預設設定不會指定模型。AIHubMix 的指南將 ANTHROPIC_MODEL 列為核心變數，因此請在切換前，將它新增至同一個 env 區塊：

{
  "env": {
    "ANTHROPIC_API_KEY": "sk-your-key",
    "ANTHROPIC_BASE_URL": "https://aihubmix.com",
    "ANTHROPIC_MODEL": "claude-sonnet-5-5"
  }
}

若未指定模型，Claude Code 會傳送自己的預設模型 ID，而該 ID 可能不在 AIHubMix 提供的模型之列。

有兩個細節值得留意。

不要在基本 URL 後面加上 /v1。Claude Code 使用 Anthropic Messages 協定，並會自行組成請求路徑。正確的網址是 https://aihubmix.com；https://aihubmix.com/v1 則是其他用戶端使用的 OpenAI 相容基本 URL，而 Claude Code 會在後面再加上自己的 /v1/messages。

預設設定使用 ANTHROPIC_API_KEY，而 AIHubMix 自家的 Claude Code 指南使用 ANTHROPIC_AUTH_TOKEN。AIHubMix 兩者皆接受：ANTHROPIC_AUTH_TOKEN 會傳送 Bearer 標頭，ANTHROPIC_API_KEY 則會傳送 x-api-key。擇一使用即可，不要用不同值填入兩者。AIHubMix 的設定細節、模型 ID 和錯誤參考資料，請參閱 AIHubMix Claude Code 文件。

如果找不到預設設定——例如使用較舊版本，或已刪除該卡片——請選擇自訂設定，並貼上上述 JSON。供應商卡片的端點管理工具可以測試延遲；如果 aihubmix.com 無法解析，預設設定也提供 https://api.aihubmix.com 作為替代端點。

步驟 4：切換並驗證

在直接分頁中，點選 AiHubMix 卡片上的切換。設定寫入完成後，按鈕會變成使用中。

Claude Code 會自動重新載入設定，通常不需要重新啟動。如果目前工作階段仍使用舊供應商，請先結束工作階段再重新啟動。

驗證整個請求流程：

claude -p "1+1, output only the answer" --model claude-sonnet-5-5

如果回應為 2，表示請求已送達 AIHubMix。在互動式工作階段中，/status 的 Anthropic base URL 一行應顯示 https://aihubmix.com。

若要快速切換，請使用系統匣：在 CC Switch 圖示上按右鍵，開啟 Claude Code 子選單，再點選供應商。子選單標題會顯示目前使用的供應商與配額摘要。

若要切回官方供應商，請切換至 Claude Official、重新啟動 Claude Code，並完成登入流程。

切換時實際變更了什麼

在直接模式中，CC Switch 只會替換 ~/.claude/settings.json 中的連線與相容性欄位：ANTHROPIC_*、AWS_*、CLAUDE_CODE_USE_BEDROCK 等協定選擇器、model、apiKeyHelper，以及少數供應商專用的相容性選項，例如 CLAUDE_CODE_DISABLE_ARTIFACT 和上下文視窗。

permissions、hooks、enabledPlugins、statusLine、MCP 設定、註解及你新增的其他內容都會保留。完整清單請參閱設定檔參考。

首次改寫某個工具的設定時，CC Switch 會將原始設定備份至 ~/.cc-switch/backups/live-first-write/。若 JSON 格式錯誤，程式會拒絕寫入、指出行與欄的位置，並保持原檔不變。

陷阱：過期的 ANTHROPIC_* 環境變數

這就是最容易讓人誤以為 CC Switch 沒有作用的問題。

如果你先前依照手動設定指南，在 ~/.zshrc 或 ~/.bash_profile 中加入 export ANTHROPIC_BASE_URL=... 或 export ANTHROPIC_AUTH_TOKEN=...，這些變數可能會覆蓋 CC Switch 寫入的值。你把卡片切換至 AIHubMix，請求卻仍送往舊端點。

CC Switch 會偵測到衝突。視窗頂端會出現黃色橫幅，提示環境變數可能覆蓋設定；詳細資訊會列出變數名稱、值和來源。刪除選取項目會移除這些變數，並在移除前將備份寫入 ~/.cc-switch/backups/env-backup-<timestamp>.json。

若要手動檢查：

grep -n "ANTHROPIC" ~/.zshrc ~/.bash_profile 2>/dev/null

將舊的環境變數匯出指令註解掉，接著執行 source ~/.zshrc，或開啟新的終端機。AIHubMix 自家的文件建議，若由 CC Switch 管理設定，應移除全域的 ANTHROPIC_* 變數。完整的衝突處理流程請參閱環境變數參考。

模型別名與切換

設定 ANTHROPIC_MODEL 後，Claude Code 預設會使用 Sonnet 5.5。如果希望 /model 別名（opus、sonnet、haiku、fable）對應至 AIHubMix 的模型 ID，仍需設定映射。請在 env 中新增以下項目：

完整的供應商設定如下：

{
  "env": {
    "ANTHROPIC_API_KEY": "sk-your-key",
    "ANTHROPIC_BASE_URL": "https://aihubmix.com",
    "ANTHROPIC_MODEL": "claude-sonnet-5-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-5-5",
    "ANTHROPIC_DEFAULT_FABLE_MODEL": "claude-fable-5-1"
  }
}

模型選擇優先順序由高至低：/model <name> → claude --model <name> → ANTHROPIC_MODEL → settings.json 中的 model 欄位。請從 AIHubMix 模型清單複製模型 ID；ID 區分大小寫。

何時使用路由或彙整模式

對 AIHubMix 而言，直接模式是最適合的預設選擇。其端點已支援 Anthropic Messages，因此不需要進行協定轉換。

若要使用故障切換佇列，或需要讓 Claude Code 連線至 OpenAI 格式的供應商，請使用路由模式。路由模式會將 Claude Code 指向 http://127.0.0.1:15721，在設定中以 PROXY_MANAGED 取代金鑰，再由 CC Switch 注入真正的金鑰。應用程式必須保持執行；關閉 CC Switch 時，會寫回直接模式設定。官方 Claude 訂閱不會透過路由模式連線；使用直接模式即可。

如果你想在同一個 /model 清單中使用多家供應商的模型，請使用聚合。預設供應商會處理未加前綴的請求；其他供應商的模型則會加上 ccs- 前綴。聚合不會進行故障轉移。此功能僅適用於 Claude Code 和 Codex，且不支援 Claude 官方訂閱。ccs- 模型清單需要 Claude Code 2.1.243 或更新版本。Claude Code 會立即載入模型清單的變更；Codex 則需要完整重新啟動。

CC Switch 還能管理哪些項目

• 用量：儀表板會整合路由請求記錄與本機工作階段記錄。即使沒有使用路由，也能掃描工作階段；費用會依記錄中記載的模型計算，而路由請求則會另外記錄。
• MCP：提供統一的 MCP 伺服器管理面板，並同步至你選擇的應用程式。
• Skills：在同一處探索、安裝及移除技能。
• 工作階段：搜尋、檢視、匯出及繼續本機工作階段。
• 專案：將專案的供應商、MCP 伺服器、技能及記憶檔案儲存為快照，然後依專案切換整組設定。

資料儲存在 ~/.cc-switch/，核心是 SQLite 資料庫。預設會自動備份並保留最近 10 份，也支援 WebDAV 或 S3 相容同步。資料庫和匯出的備份都包含供應商設定（包括金鑰），請將其視為機密資料。

疑難排解

以下錯誤訊息摘錄自 AIHubMix 的 Claude Code 說明文件。

若遇到的不是錯誤訊息：

• 登入畫面或 Not logged in：檢查 /status；前往 Settings → App config → Claude Code，啟用略過 Claude Code 首次執行確認；重新啟動；確認已填入金鑰。
• 切換沒有作用：可能是殘留的 shell 變數或快取的工作階段；開啟新的終端機或重新啟動 Claude Code。
• 卡片的連線測試通過，但請求失敗：測試只會確認是否連得上，不會檢查金鑰或模型；請執行端到端命令 claude -p。
• 想切回官方供應商：切換至 Claude Official，重新啟動 Claude Code，並再次登入。

如果在 macOS 上找不到 claude 命令，官方安裝程式通常會將它安裝在 ~/.local/bin/claude。將 export PATH="$HOME/.local/bin:$PATH" 加入 shell 設定檔，然後開啟新的終端機。

檢查清單

• [ ] 從 ccswitch.io 或 GitHub Releases 安裝 CC Switch。
• [ ] 在 AIHubMix 控制台建立 API 金鑰。
• [ ] 在 Claude Code → + → AiHubMix → 貼上金鑰 → 新增。
• [ ] 在供應商 JSON 中加入 ANTHROPIC_MODEL=claude-sonnet-5-5。
• [ ] 點選切換，並確認卡片顯示使用中。
• [ ] 從 shell 設定檔移除過期的 ANTHROPIC_* 匯出設定。
• [ ] 執行 claude -p "1+1, output only the answer" --model claude-sonnet-5-5，並確認結果為 2。

如果最後一個命令回傳 2，代表供應商切換已完成。接下來只要加入你想要的模型別名，並決定是否需要路由或聚合；對大多數 AIHubMix 使用者來說，直接模式就足夠了。

常見問題

CC Switch 免費嗎？
是的。它採用 MIT 開源授權。你只需支付所使用 API 的供應商費用。

切換會刪除我的 hooks、MCP 伺服器或外掛程式嗎？
不會。直接切換只會替換端點、金鑰、模型及少數限定於供應商的選項。hooks、權限、MCP 伺服器、外掛程式和狀態列設定都會保留在檔案中。

CC Switch 會上傳我的 API 金鑰嗎？
供應商設定會儲存在本機的 ~/.cc-switch/cc-switch.db。如果啟用 WebDAV 或 S3 同步，設定會同步到由你控制的儲存空間。資料庫和備份都包含金鑰，請將其視為機密資料。

我需要讓 CC Switch 一直保持執行嗎？
使用直接模式時不需要。路由和聚合則需要應用程式保持執行；結束 CC Switch 後，用戶端會回到直接模式。

我可以同時使用 Claude Official 和 AIHubMix 嗎？
直接模式一次只能啟用一個供應商。聚合可以將多家供應商的模型放進同一份清單，但不支援 Claude 官方訂閱；若要使用該訂閱，請切回直接模式。

可以在 Windows 上使用嗎？
可以。CC Switch 支援 Windows 10 及更新版本，提供 .msi 安裝程式或可攜式版本。Linux 需要 glibc 2.35+ 和 WebKitGTK 4.1。

為什麼供應商卡片顯示連線正常，但 Claude Code 還是無法使用？
卡片的連線檢查只會測試端點是否可連線，不會驗證 API 金鑰或模型。請使用端到端命令 claude -p 測試完整流程。

來源

• CC Switch 儲存庫
• CC Switch 使用手冊：新增供應商
• CC Switch 使用手冊：切換供應商
• CC Switch 使用手冊：設定檔
• AIHubMix 說明文件：Claude Code