CC-Switch 添加供應商完整教程:以 API易 爲例的 4 步配置指南

安裝好 CC-Switch 後，下一步就是添加自己的 API 供應商。很多新手卡在這一步:不知道該填什麼、填在哪裏、怎麼生效。本文以 API易 apiyi.com 爲例，手把手教你完成 CC-Switch 供應商的添加、切換、測速和恢復官方登錄的全流程操作。

核心價值: 讀完本文，你將掌握 CC-Switch 供應商管理的完整操作，3 分鐘完成從添加到生效的全部配置。

CC-Switch 添加供應商前的準備工作

在開始配置前，你需要準備以下內容:

必備條件清單

API易 賬號註冊

如果你還沒有 API易 賬號，先完成註冊:

1. 訪問 API易 官網 apiyi.com
2. 點擊註冊，完成賬號創建
3. 進入控制檯，獲取 API Key
4. 記錄以下信息:
   • API Key: sk- 開頭的密鑰字符串
   • Base URL: https://api.apiyi.com

🚀 新用戶福利: API易 apiyi.com 註冊即送免費測試額度，支持 Claude、GPT、Gemini 等主流模型，可以先測試再決定是否充值。

檢查環境變量衝突

重要: 如果你之前在系統環境變量中設置過 API Key，可能會覆蓋 CC-Switch 的配置。

檢查並清理衝突的環境變量:

macOS/Linux:

# 檢查是否存在衝突變量
echo $ANTHROPIC_API_KEY
echo $ANTHROPIC_AUTH_TOKEN
echo $OPENAI_API_KEY

# 如果有值，需要從 ~/.zshrc 或 ~/.bashrc 中刪除

Windows:

• 打開「系統屬性 → 高級 → 環境變量」
• 檢查並刪除 ANTHROPIC_API_KEY、OPENAI_API_KEY 等變量

CC-Switch 添加供應商操作步驟

第一步: 打開添加供應商界面

1. 啓動 CC-Switch 應用
2. 在主界面找到 「Add Provider」 按鈕 （通常在供應商列表上方）
3. 點擊按鈕，彈出供應商配置窗口

第二步: 選擇配置方式

CC-Switch 提供兩種添加方式:

由於 API易 是第三方供應商，我們選擇 「Custom」 自定義配置。

第三步: 填寫供應商配置信息

這是最關鍵的一步，需要準確填寫以下字段:

基礎信息

Claude Code 配置 （如果使用）

CC-Switch 支持爲 Claude Code 配置以下字段:

模型映射配置 （可選）

如果需要指定默認模型，可以配置:

完整配置示例

以下是添加 API易 作爲供應商的完整配置:

# 基礎信息
Name: API易
Base URL: https://api.apiyi.com

# Claude Code 配置
ANTHROPIC_AUTH_TOKEN: sk-your-apiyi-key
ANTHROPIC_BASE_URL: https://api.apiyi.com

# 模型配置 （可選）
ANTHROPIC_MODEL: claude-sonnet-4-20250514

{
  "name": "API易"，
  "baseUrl": "https://api.apiyi.com"，
  "claude": {
    "ANTHROPIC_AUTH_TOKEN": "sk-your-apiyi-key"，
    "ANTHROPIC_API_KEY": "sk-your-apiyi-key"，
    "ANTHROPIC_BASE_URL": "https://api.apiyi.com"，
    "ANTHROPIC_MODEL": "claude-sonnet-4-20250514"，
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-20250514"，
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-20250514"
  }，
  "codex": {
    "OPENAI_API_KEY": "sk-your-apiyi-key"，
    "OPENAI_BASE_URL": "https://api.apiyi.com/v1"
  }，
  "gemini": {
    "GEMINI_API_KEY": "sk-your-apiyi-key"，
    "GOOGLE_GEMINI_BASE_URL": "https://api.apiyi.com/v1"
  }
}

第四步: 保存配置

1. 檢查所有必填字段是否完整
2. 點擊 「Save」 或 「確認」 按鈕
3. CC-Switch 會驗證配置格式
4. 保存成功後，新供應商出現在列表中

💡 配置提示: API易 apiyi.com 提供的接口完全兼容 OpenAI 和 Anthropic 格式，所以 Base URL 填寫 https://api.apiyi.com 即可，無需添加 /v1 後綴 （CC-Switch 會自動處理）。

CC-Switch 切換供應商的 3 種方法

添加完成後，需要切換到新供應商才能生效。CC-Switch 提供 3 種切換方式:

方法一: 主界面切換 （推薦新手）

這是最直觀的方式:

1. 在 CC-Switch 主界面的供應商列表中
2. 找到剛添加的 「API易」
3. 點擊該供應商右側的 「Enable」 或 「啓用」 按鈕
4. 狀態變爲 Active 表示切換成功

┌─────────────────────────────────────────────────┐
│              CC-Switch 供應商列表                │
├─────────────────────────────────────────────────┤
│  ○ Official Login          [Enable]             │
│  ● API易 （Active）          [Disable] [Test]    │  ← 當前激活
│  ○ OpenRouter              [Enable]             │
└─────────────────────────────────────────────────┘

方法二: 系統托盤切換 （推薦熟練用戶）

更快捷的方式，無需打開主窗口:

1. 在系統托盤找到 CC-Switch 圖標 （Windows 右下角 / macOS 菜單欄）
2. 點擊圖標，展開菜單
3. 直接點擊 「API易」 供應商名稱
4. 立即生效，無需額外確認

優勢: 這種方式切換最快，適合頻繁切換供應商的場景。

方法三: 配合應用選擇

如果你同時使用多個 CLI 工具，可以爲不同應用設置不同供應商:

在 CC-Switch 中，每個應用可以獨立配置供應商。

CC-Switch 供應商生效方式

重要: 切換供應商後，配置不會立即在 CLI 工具中生效，需要重啓對應應用。

生效操作步驟

驗證配置生效

重啓後，可以通過以下方式驗證:

方法一: 直接對話測試

claude
# 輸入簡單問題，如果正常回復說明配置成功
> Hello， 請用中文回覆

方法二: 使用 CC-Switch 測速功能

1. 點擊供應商旁邊的 「Test」 按鈕
2. 查看延遲和狀態
3. 顯示綠色 ✓ 表示連接正常

方法三: 檢查配置文件

# Claude Code 配置文件
cat ~/.claude/settings.json

# 應該看到類似內容:
# "apiBaseUrl": "https://api.apiyi.com"

🎯 驗證建議: 通過 API易 apiyi.com 控制檯可以查看 API 調用記錄，如果有新的請求記錄，說明配置已生效。

CC-Switch 恢復官方登錄

如果需要切回官方服務，CC-Switch 提供一鍵恢復功能。

恢復 Claude Code 官方登錄

1. 在 CC-Switch 供應商列表中找到 「Official Login」 預設
2. 點擊 「Enable」 切換到官方模式
3. 重啓終端，運行 claude
4. 按照 Claude Code 的官方登錄流程操作 （OAuth 認證）

恢復 Codex 官方登錄

1. 選擇 「Official Login」 預設 （Codex 版）
2. 點擊啓用
3. 重啓後運行 codex
4. 按提示完成 OpenAI 官方認證

恢復 Gemini CLI 官方登錄

1. 選擇 「Google Official」 預設
2. 點擊啓用
3. 重啓後運行 gemini
4. 按提示完成 Google OAuth 流程

恢復流程總結

注意: 恢復官方登錄後，CC-Switch 會自動備份你的自定義配置。下次切換回第三方供應商時，之前的配置仍然保留。

CC-Switch 供應商管理進階技巧

技巧一: 供應商測速對比

添加多個供應商後，可以批量測速選擇最快的:

1. 依次點擊每個供應商的 「Test」 按鈕
2. 記錄各供應商的延遲數值
3. 選擇延遲最低的作爲主用供應商

參考標準:

技巧二: 供應商複製

如果需要創建類似配置的供應商:

1. 選中已有供應商
2. 點擊 「Duplicate」 或右鍵選擇「複製」
3. 修改名稱和部分配置
4. 保存爲新供應商

技巧三: 配置備份與同步

CC-Switch 支持配置雲同步:

1. 打開 Settings → Storage
2. 選擇雲同步文件夾 （如 Dropbox、OneDrive）
3. 所有供應商配置自動同步

這樣可以在多臺設備間共享相同的供應商配置。

技巧四: 共享供應商配置

v3.9.0+ 支持「共享供應商」功能:

• 一個供應商配置可以同時應用到 Claude/Codex/Gemini
• 適合使用 API易 等支持多協議的網關
• 在添加供應商時勾選「Sync to all apps」

CC-Switch 添加供應商常見問題

API易 供應商配置速查表

爲方便快速配置，這裏整理 API易 的完整參數:

總結

通過本教程，你已經學會了 CC-Switch 供應商管理的完整流程:

1. 添加供應商: 點擊 Add Provider → 選擇 Custom → 填寫配置 → 保存
2. 切換供應商: 主界面點擊 Enable 或系統托盤直接點擊供應商名稱
3. 生效方式: 重啓終端或對應的 CLI 客戶端
4. 恢復官方: 選擇 Official Login 預設 → 重啓 → 完成 OAuth 流程

CC-Switch + API易 的組合讓 API 管理變得簡單:

• CC-Switch: 可視化管理，一鍵切換
• API易 apiyi.com: 統一接口，價格優惠，多模型支持

現在就訪問 API易 apiyi.com 獲取 API Key，在 CC-Switch 中添加供應商，開始享受高效的 AI 編程體驗吧！

📝 作者: APIYI 技術團隊 | API易 apiyi.com – 讓 AI API 調用更簡單