CC Switch 設定教學：anthropic_base_url 設定與 Claude Code/Codex/DeepSeek 多模型切換

如果你同時使用 Claude Code、Codex、Gemini CLI 等多個 AI 程式設計工具，手動管理它們的設定檔簡直是一場噩夢。CC Switch 用統一的桌面介面解決這個問題——Provider 一鍵切換、MCP 集中管理、Skills 統一安裝，還有本機代理自動容錯。

一、為什麼要用 CC Switch？

2026 年的 AI 程式設計工具生態已經百花齊放：

• Claude Code — Anthropic 出品，終端機 AI Agent
• OpenAI Codex — OpenAI 的終端機程式設計助手
• Gemini CLI — Google 的命令列 AI 編碼工具
• OpenCode / OpenClaw — 開源替代方案

每個工具都有自己的一套設定體系：不同的 Provider 格式、不同的 MCP 設定路徑、不同的 Skills 安裝方式。當你只想在 DeepSeek V4 和 Claude Opus 之間切換一下模型，你可能需要：

1. 開啟 .env 檔案修改 ANTHROPIC_BASE_URL
2. 重新設定 ANTHROPIC_AUTH_TOKEN
3. 重新啟動 Claude Code
4. 如果設定寫錯了，排查 JSON/TOML 格式錯誤

CC Switch 把這些散落的設定集中到一個跨平台桌面應用程式中，用圖形介面統一管理，一鍵切換。

CC Switch 解決了什麼痛點？

痛點	手動管理	CC Switch
Provider 設定	編輯 .env / JSON 檔案	介面一鍵切換
多模型切換	逐個修改環境變數	托盤選單快速切換
MCP Server 管理	每個工具單獨設定	統一面板，雙向同步
Skills 安裝	手動 clone / 複製檔案	一鍵安裝，集中管理
設定檔備份	自己找檔案備份	一鍵匯入 / 匯出
代理與容錯	手動改設定	本機代理自動切換
多帳號管理	容易搞混	分組管理，清晰直觀

二、安裝 CC Switch

CC Switch 是開源專案，支援 macOS、Windows、Linux。

從 GitHub 下載

# 訪問專案首頁
# https://github.com/farion1231/cc-switch

# macOS 使用者：下載 .dmg 檔案
# Windows 使用者：下載 .exe 安裝包
# Linux 使用者：下載 .AppImage 或 .deb 包

安裝後首次啟動

開啟 CC Switch，你會看到主介面包含以下幾個核心模組：

• Providers — API 提供商設定
• MCP — Model Context Protocol 伺服器管理
• Prompts — 提示詞檔案（CLAUDE.md、AGENTS.md 等）
• Skills — Agent 技能包管理
• Sessions — 工作階段歷史
• Proxy — 本機代理設定

三、設定 Provider：一鍵管理多模型

這是 CC Switch 最核心的功能。它內建了 50+ Provider 預設，涵蓋主流 AI 模型提供商和第三方中繼服務。

3.1 新增 DeepSeek V4 Provider

以我們之前文章設定的 DeepSeek V4 為例，在 CC Switch 中操作：

1. 點擊左側 Providers 面板
2. 點擊 + 新增 Provider
3. 填寫設定：

名稱: DeepSeek V4 Pro
Base URL: https://api.deepseek.com/anthropic
API Key: «redacted:sk-…»
模型: deepseek-v4-pro[1m]

4. 點擊儲存

同樣的方式，你可以新增更多 Provider：

名稱: Claude Opus (官方)
Base URL: https://api.anthropic.com
API Key: «redacted:sk-…»
模型: claude-opus-2026

名稱: DeepSeek V4 Flash
Base URL: https://api.deepseek.com/anthropic
API Key: «redacted:sk-…»
模型: deepseek-v4-flash

3.2 一鍵切換 Provider

設定好之後，切換變得異常簡單：

• 方式一： 在 CC Switch 主介面拖曳排序，把要用的 Provider 拖到第一位
• 方式二： 點擊系統托盤圖示，從彈出選單選擇目標 Provider
• 方式三： 使用快捷鍵快速切換（可在設定中自訂）

切換後，CC Switch 會自動更新 Claude Code / Codex / Gemini CLI 的設定檔，無需手動編輯。

3.3 同步 Provider 到多個工具

如果你同時使用 Claude Code 和 OpenClaw，CC Switch 可以把同一個 Provider 同步到兩個工具的設定中：

1. 選中目標 Provider
2. 點擊 Sync to Apps
3. 勾選需要同步的工具（Claude Code、Codex、Gemini CLI、OpenClaw）
4. 點擊確認

這樣，當你新增一個中繼服務 API，所有工具都會自動更新。

四、本機代理與自動容錯

CC Switch 不只是寫設定檔——它還提供本機代理模式，這是它最獨特的功能。

4.1 什麼是本機代理？

啟用本機代理後，所有 AI 程式設計工具的請求先經過 CC Switch 的本機代理，再由代理轉發到實際的模型服務。這意味著：

• 熱切換： 執行時切換 Provider，無需重新啟動工具
• 格式轉換： 自動處理不同 API 格式的差異
• 自動容錯： 主 Provider 不可用時自動切換到備用
• 熔斷機制： 偵測到服務異常時自動暫停，避免無效請求
• 健康檢查： 定時偵測各 Provider 的可用性

4.2 設定本機代理

1. 進入 Proxy 面板
2. 啟用本機代理（預設連接埠 8080）
3. 設定 Provider 優先順序佇列：
   第1優先順序: DeepSeek V4 Pro（日常使用）
   第2優先順序: Claude Opus（複雜任務）
   第3優先順序: DeepSeek V4 Flash（輕量任務）
4. 開啟自動容錯

設定完成後，Claude Code 只需要指向本機代理：

# 使用 CC Switch 本機代理
export ANTHROPIC_BASE_URL=http://localhost:8080
export ANTHROPIC_AUTH_TOKEN=placeholder-token

# 啟動 Claude Code
claude

所有請求都會透過代理路由，你不需要再關心後端用的是哪個 Provider。

4.3 實際應用場景

場景 1：成本最佳化

日常開發用便宜的 DeepSeek V4，遇到複雜架構問題自動切換到 Claude Opus：

# CC Switch 路由規則範例
rules:
  - condition: "token_cost < 50000"
    provider: "deepseek-v4-flash"
  - condition: "token_cost >= 50000"
    provider: "deepseek-v4-pro"
  - condition: "requires_complex_reasoning"
    provider: "claude-opus"

場景 2：服務不可用

DeepSeek API 偶爾會遇到高峰期延遲，CC Switch 會自動偵測並切換到備用 Provider，你的程式設計工作流程不會中斷。

五、MCP 統一管理

Model Context Protocol (MCP) 是 AI Agent 連接外部工具的標準協定。不同的 AI 程式設計工具有各自的 MCP 設定路徑：

• Claude Code: ~/.claude/mcp.json
• Codex: ~/.codex/mcp.json
• Gemini CLI: 不同路徑

CC Switch 提供統一的 MCP 面板：

5.1 新增 MCP Server

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/project"],
      "disabled": false
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp-your-token"
      }
    },
    "sequential-thinking": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-sequential-thinking"]
    }
  }
}

在 CC Switch 的 MCP 面板中直接編輯這個設定，選擇需要同步的工具，一鍵分發。

5.2 雙向同步

修改 CC Switch 中的 MCP 設定後，可以選擇：

• 推送到工具：更新各工具的 MCP 設定檔
• 從工具拉取：讀取各工具現有的 MCP 設定並合併

這對於已經在多個工具中設定了 MCP 的使用者特別有用。

六、Skills 一鍵安裝

Claude Code 的 Skills 系統讓它能執行專業任務（程式碼審查、資料庫遷移、Docker 操作等）。但 Skills 的安裝和管理分散在各個工具的目錄中。

6.1 從 GitHub 安裝 Skills

CC Switch 支援從 GitHub 儲存庫一鍵安裝 Skills：

1. 進入 Skills 面板
2. 點擊 Install from GitHub
3. 輸入儲存庫位址，如：
   https://github.com/anthropics/skills
   https://github.com/community/awesome-claude-skills
4. 選擇安裝方式：
   - Symbolic Link（符號連結，來源儲存庫更新自動同步）
   - Copy（複製檔案，獨立副本）
5. 選擇目標工具

6.2 常用 Skills 推薦

以下是開發者最常用的幾個 Skills：

Skill	功能	適用場景
GitHub PR Review	自動審查 Pull Request	程式碼審查
Database Migration	產生和執行資料庫遷移	後端開發
Docker Compose	管理 Docker 容器	DevOps
Git Best Practices	智慧 Git 工作流程建議	版本控制
API Testing	自動化 API 測試	介面開發

6.3 Skills 備份與復原

1. 進入 Skills 面板
2. 點擊 Export（匯出所有已安裝 Skills 清單）
3. 儲存為 JSON 檔案
4. 換電腦或重裝時，點擊 Import 即可復原

七、Prompts 統一管理

AI 程式設計工具都有自己的專案手冊檔案：

• CLAUDE.md — Claude Code 的專案規範
• AGENTS.md — OpenClaw 的 Agent 指令
• GEMINI.md — Gemini CLI 的提示詞

CC Switch 的 Prompts 面板支援：

• Markdown 編輯器：直接編輯提示詞檔案
• 跨工具同步：一次編輯，同步到所有工具的對應檔案
• 版本管理：檢視修改歷史，隨時復原

實戰：建立團隊統一的 CLAUDE.md

# CLAUDE.md

## 編碼規範
- Python 3.12+，使用型別註解
- 所有函式必須有 docstring
- 使用 pytest 編寫測試，覆蓋率 > 80%
- 遵循 PEP 8，使用 ruff 格式化

## 架構約束
- Controller 層不直接操作資料庫，必須透過 Service 層
- 資料庫遷移使用 Alembic
- 所有 API 端點必須有速率限制

## 安全要求
- 禁止在日誌中記錄敏感資訊（金鑰、token、密碼）
- 使用者輸入必須經過驗證和清理
- SQL 查詢必須使用參數化

在 CC Switch 中編輯後，點擊 Sync to All Apps，這個規範會自動同步到 Claude Code、OpenClaw 等所有工具的專案目錄中。

八、與其他方案的對比

特性	CC Switch	手動設定	Claude Code 原生
Provider 管理	✅ 圖形介面，一鍵切換	❌ 編輯設定檔	⚠️ 環境變數
多工具同步	✅ 統一分發	❌ 逐個設定	❌ 不支援
本機代理	✅ 自動容錯	❌ 需要自建	❌ 不支援
MCP 管理	✅ 集中面板	❌ 分散在各處	⚠️ 僅自身
Skills 安裝	✅ 一鍵安裝	❌ 手動 clone	⚠️ 需命令列
跨平台	✅ Mac/Win/Linux	✅	⚠️ 僅終端機
開源	✅ MIT	-	❌ 閉源

九、進階技巧

9.1 團隊共享設定

CC Switch 支援匯出和匯入設定，適合團隊協作：

# 匯出設定
# 在 CC Switch 中點擊 Settings → Export Configuration
# 產生 cc-switch-config.json

# 團隊成員匯入
# Settings → Import Configuration → 選擇檔案

9.2 快捷鍵自訂

在 CC Switch 設定中可以自訂快捷鍵：

Ctrl+Shift+1 → 切換到 Provider 1（DeepSeek V4 Pro）
Ctrl+Shift+2 → 切換到 Provider 2（Claude Opus）
Ctrl+Shift+3 → 切換到 Provider 3（DeepSeek V4 Flash）

9.3 配合 CC Switch 的 Claude Code 工作流程

推薦的環境變數設定：

# ~/.zshrc
# 使用 CC Switch 本機代理
export ANTHROPIC_BASE_URL=http://localhost:8080
export ANTHROPIC_AUTH_TOKEN=cc-switch-proxy
export ANTHROPIC_MODEL=auto

# 如果需要直連（不使用代理）
# export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
# export ANTHROPIC_AUTH_TOKEN=«redacted:sk-…»|# export ANTHROPIC_MODEL=deepseek-v4-pro[1m]

十、總結

CC Switch 解決了 AI 程式設計工具生態中最實際的痛點——設定管理。

對於個人開發者： - ✅ 50+ Provider 預設，開箱即用 - ✅ 一鍵切換多模型，告別手動編輯設定 - ✅ 本機代理自動容錯，工作流程不中斷 - ✅ MCP/Skills 集中管理，減少維護成本

對於團隊： - ✅ 設定匯出/匯入，快速統一團隊規範 - ✅ 多帳號管理，清晰區分不同專案和環境 - ✅ Prompts 同步，確保所有 Agent 遵循同一套規範

如果你已經在使用 Claude Code 搭配 DeepSeek V4（參考我們上一篇終端機 AI 程式設計教學），CC Switch 會讓你管理多個模型和 Provider 變得輕鬆很多。

---

參考連結：

• CC Switch GitHub 儲存庫
• CC Switch 官方網站
• Claude Code 官方文件
• Anthropic Agent Skills 儲存庫
• Dashen-Tech: Claude Code + DeepSeek V4 實戰教學

常見問題（FAQ）

如何設定 anthropic_base_url？

CC Switch 自動處理 ANTHROPIC_BASE_URL 的設定。只需在 Providers 面板中新增你的 Provider（如 DeepSeek V4、第三方中繼），CC Switch 就會自動將正確的 anthropic_base_url 寫入 Claude Code 的 .env 檔案——無需手動編輯。

# 不用 CC Switch：需要手動設定
export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic

# 用 CC Switch：點擊切換即可，設定自動更新
# 同時自動管理 ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_MODEL

CC Switch 支援 Windows 嗎？

支援！CC Switch 支援 Windows（.exe 安裝包）、macOS（.dmg）和 Linux（.AppImage / .deb）。三個平台的功能和介面完全一致。

CC Switch 能管理多個 Claude Code 設定嗎？

可以。CC Switch 支援多帳號管理，你可以按專案或環境（如工作/個人）分組管理 Provider，快速切換且不會產生設定衝突。

API Provider 掛了怎麼辦？

在 CC Switch 中啟用本機代理並設定優先順序佇列。當主 Provider 不可用時，CC Switch 自動切換到備用 Provider——你的 Claude Code 工作階段不會中斷。

CC Switch 免費嗎？

是的，CC Switch 完全開源，使用 MIT 授權條款。你可以在 GitHub 免費下載。

---