CC Switch 接入 Claude Desktop 教程:用本地路由切換 OpenRouter 與 DeepSeek
介紹如何用 CC Switch 管理 Claude Desktop 的第三方供應商配置,並通過模型映射與本地路由接入 OpenRouter、DeepSeek 等非 Claude 系列模型。
文章目錄 · 24
- 一、它解決了什麼問題?
- 二、什麼時候必須開啟模型映射?
- 三、準備工作
- 四、安裝或升級 CC Switch
- 五、進入 Claude Desktop 面板
- 六、配置示例 A:OpenRouter + Ring 2.6 1T
- 1. 創建 OpenRouter API Key
- 2. 在 CC Switch 中添加 OpenRouter
- 3. 模型映射推薦填法
- 七、配置示例 B:DeepSeek 官方 V4
- 1. 創建 DeepSeek API Key
- 2. 在 CC Switch 中添加 DeepSeek
- 3. 模型映射推薦填法
- 八、開啟本地路由
- 九、啟用供應商並重啟 Claude Desktop
- 十、常見問題
- 1. 想切回 Claude 官方賬號怎麼辦?
- 2. 多個供應商之間怎麼切換?
- 3. Claude Code 也能這樣接嗎?
- 4. 報錯應該怎麼排查?
- 5. CC Switch 必須一直打開嗎?
- 十一、適合怎麼用?
- 十二、總結
- 參考鏈接
CC Switch v3.15.0 開始支持獨立管理 Claude Desktop。它的核心價值不是“多一個殼”,而是把 Claude Desktop 的第三方推理配置、模型映射、本地路由統一放進一個圖形化面板裏,減少手動改配置、填端點、配模型 ID 的麻煩。(如果你還不瞭解 CC Switch 的基本用途與支持的工具,可以先看 《CC Switch 是什麼?一款統一管理 AI 編程工具與模型供應商的控制枱》。)
Claude Desktop 官方本身已經提供第三方推理入口。開啟路徑一般是:Help → Troubleshooting → Enable Developer Mode,然後進入 Developer → Configure third-party inference。問題在於,手動配置對新手不夠友好:需要填寫 Gateway 地址、API Key、認證方式、模型列表等字段,任何一項填錯都可能連接失敗。
CC Switch 的作用,就是把這些步驟集中到一個工具裏完成。尤其是當你想把 Claude Desktop 接到 OpenRouter、DeepSeek 這類非 Claude 系列模型時,CC Switch 的「模型映射」和「本地路由」會很有用。
一、它解決了什麼問題?
Claude Desktop 接第三方供應商時,主要有兩個麻煩:
1. 配置入口比較深:需要先開啟開發者模式,再進入第三方推理配置窗口。 2. 模型名兼容性問題:Claude Desktop 側通常按 Claude 的模型角色理解模型,例如 Sonnet、Opus、Haiku;但第三方平台使用自己的模型 ID,例如 inclusionai/ring-2.6-1t、deepseek-v4-pro、deepseek-v4-flash。
CC Switch 在中間做了一層適配:
Claude Desktop → CC Switch 本地路由 → 第三方供應商這一層主要負責三件事:
- 將 Claude Desktop 的請求轉發到第三方供應商;
- 將 Sonnet / Opus / Haiku 這類模型角色映射為真實模型 ID;
- 自動寫入 Claude Desktop 所需的第三方推理配置。
二、什麼時候必須開啟模型映射?
判斷標準很簡單:
| 供應商類型 | 是否需要模型映射 | 是否需要本地路由 |
|---|---|---|
| Claude 系列模型,例如官方 Claude API 或只提供 Claude 模型的中轉 | 通常不需要 | 通常不需要 |
| 非 Claude 系列模型,例如 OpenRouter 上的 Ring、DeepSeek V4 | 需要 | 需要 |
本文的兩個例子都屬於非 Claude 系列模型,所以都要打開:
- 「需要模型映射」
- 「本地路由」
只要使用非 Claude 系列模型,本地路由就必須保持運行。關閉 CC Switch 或關閉路由開關,Claude Desktop 就會斷開第三方模型連接。
三、準備工作
開始前準備好三樣東西:
1. CC Switch v3.15.0 或更高版本 官網:https://ccswitch.io
2. Claude Desktop 官方下載:https://claude.ai/download
3. 第三方供應商賬號與 API Key 下面任選一種即可:
- OpenRouter:https://openrouter.ai
- DeepSeek Platform:https://platform.deepseek.com
四、安裝或升級 CC Switch
已經安裝過 CC Switch 的用戶,直接走自動更新即可。
全新安裝可以參考下面方式:
## macOS
brew tap farion1231/ccswitch
brew install --cask cc-switchWindows 用戶下載 .msi 安裝包;Linux 用戶按發行版選擇 .deb、.rpm 或 .AppImage。
安裝完成後,打開 CC Switch。如果 App 切換器裏能看到獨立的「Claude Desktop」條目,並且它和「Claude Code」並列,就說明已經是支持 Claude Desktop 管理的新版本。
五、進入 Claude Desktop 面板
在 CC Switch 左側或頂部的 App 切換器中選擇:
Claude Desktop進入後,點擊「添加供應商」(Add Provider),選擇你要接入的平台,然後填寫 API Key 和請求地址。
下面給出兩套常見配置。
六、配置示例 A:OpenRouter + Ring 2.6 1T
OpenRouter 是一個模型聚合平台,可以通過統一入口訪問多個模型。它支持免費模型、按量付費和企業方案,適合用來測試不同模型或臨時切換供應商。
1. 創建 OpenRouter API Key
打開 OpenRouter:
進入 Keys 頁面創建 API Key:
2. 在 CC Switch 中添加 OpenRouter
在「添加供應商」裏選擇 OpenRouter 預設,然後填寫:
| 字段 | 填寫內容 |
|---|---|
| 供應商名稱 | OpenRouter |
| 官網鏈接 | https://openrouter.ai |
| API Key | 粘貼 OpenRouter Key |
| 請求地址 | https://openrouter.ai/api |
| API 格式 | Anthropic Messages(原生) |
| 需要模型映射 | 打開 |
注意:請求地址建議不要在末尾加 /。
3. 模型映射推薦填法
Ring 2.6 1T 不是 Claude 系列模型,所以需要把 Claude Desktop 的角色映射到 OpenRouter 的真實模型 ID。
可以添加三行:
| 模型角色 | 菜單顯示名 | 實際請求模型 | 聲明支持 1M |
|---|---|---|---|
| Sonnet | inclusionai/ring-2.6-1t | inclusionai/ring-2.6-1t | 不勾 |
| Opus | inclusionai/ring-2.6-1t | inclusionai/ring-2.6-1t | 不勾 |
| Haiku | inclusionai/ring-2.6-1t | inclusionai/ring-2.6-1t | 不勾 |
這樣做的含義是:無論你在 Claude Desktop 裏選擇 Sonnet、Opus 還是 Haiku,最後都會請求 OpenRouter 上的 inclusionai/ring-2.6-1t。
七、配置示例 B:DeepSeek 官方 V4
DeepSeek 官方文檔提供了 Anthropic 兼容接口,base URL 為:
https://api.deepseek.com/anthropic這意味著它可以接入部分 Anthropic API 生態工具。DeepSeek 文檔中也給出了 Claude Code 的環境變量配置示例,包括 deepseek-v4-pro[1m]、deepseek-v4-flash 等模型名。
1. 創建 DeepSeek API Key
打開 DeepSeek Platform:
進入 API Keys 頁面創建 Key。DeepSeek 通常需要先充值再調用 API。
2. 在 CC Switch 中添加 DeepSeek
在「添加供應商」裏選擇 DeepSeek 預設,然後填寫:
| 字段 | 填寫內容 |
|---|---|
| 供應商名稱 | DeepSeek |
| 官網鏈接 | https://platform.deepseek.com |
| API Key | 粘貼 DeepSeek Key |
| 請求地址 | https://api.deepseek.com/anthropic |
| API 格式 | Anthropic Messages(原生) |
| 需要模型映射 | 打開 |
注意:這裏用的是 /anthropic,不是 /v1。
3. 模型映射推薦填法
可以按“便宜模型處理日常任務,強模型處理複雜任務”的方式映射:
| 模型角色 | 菜單顯示名 | 實際請求模型 | 聲明支持 1M |
|---|---|---|---|
| Sonnet | deepseek-v4-flash | deepseek-v4-flash | 勾選 |
| Opus | deepseek-v4-pro | deepseek-v4-pro | 勾選 |
| Haiku | deepseek-v4-flash | deepseek-v4-flash | 可選 |
這樣在 Claude Desktop 中選擇 Sonnet 時,會調用更便宜的 deepseek-v4-flash;選擇 Opus 時,會調用更強的 deepseek-v4-pro。
如果你想使用 DeepSeek 文檔中的 1M 寫法,也可以在實際請求模型中嘗試:
deepseek-v4-pro[1m]是否可用以 DeepSeek 官方文檔和 CC Switch 當前版本實際支持為準。
八、開啟本地路由
模型映射開啟後,還必須開啟本地路由。
路徑一般是:
CC Switch → 设置 → 路由需要打開兩項:
1. 路由總開關:打開後狀態應顯示為運行中。 2. Claude 應用路由:勾選 Claude,讓 Claude Desktop 的請求走本地路由。
默認服務地址通常是:
http://127.0.0.1:15721一般不需要修改。
建議同時開啟「在主頁面顯示本地路由開關」,這樣可以在主面板快速確認路由是否運行。
九、啟用供應商並重啟 Claude Desktop
配置完成後,在 Claude Desktop 面板中選中剛添加的供應商,點擊「啟用」(Enable)。
然後重啟 Claude Desktop。
注意,這裏必須是真正退出,不是關閉窗口:
- macOS:使用
Command + Q完全退出; - Windows:右下角托盤找到 Claude 圖標,右鍵退出。
重新打開 Claude Desktop,發送一句測試:
你好,用一句話回覆我。如果能正常回復,再回到 CC Switch 查看代理流量記錄。能看到請求記錄,就說明鏈路已經打通。
十、常見問題
1. 想切回 Claude 官方賬號怎麼辦?
在 CC Switch 的 Claude Desktop 面板裏關閉當前第三方供應商,或者切回官方配置,然後重啟 Claude Desktop 即可。
2. 多個供應商之間怎麼切換?
在 Claude Desktop 面板中選擇另一個供應商,點擊啟用,然後重啟 Claude Desktop。本地路由不用反覆改。
3. Claude Code 也能這樣接嗎?
可以。CC Switch 對 Claude Code 和 Claude Desktop 是分面板管理。區別是 Claude Code 通常更適合命令行開發場景,而 Claude Desktop 更適合日常對話、資料整理和桌面端使用。
DeepSeek 官方文檔也提供了 Claude Code 的環境變量配置方式,例如設置 ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN、ANTHROPIC_MODEL 等。
4. 報錯應該怎麼排查?
優先檢查這幾項:
1. 請求地址末尾是否多了 /; 2. API Key 是否複製完整; 3. API 格式是否選擇了 Anthropic Messages; 4. 「需要模型映射」是否打開; 5. 模型映射裏的真實模型 ID 是否寫對; 6. 本地路由總開關是否運行中; 7. Claude 應用路由是否勾選; 8. Claude Desktop 是否真正退出並重啟。
大多數連接失敗,都出在 API Key、端點地址、模型 ID 或本地路由沒有開啟這幾項。
5. CC Switch 必須一直打開嗎?
如果你使用的是非 Claude 系列模型,並且依賴模型映射,那麼 CC Switch 必須在後台運行。
可以開啟 Lightweight Mode(輕量模式),讓主窗口關閉後只保留托盤進程,本地路由繼續工作。
十一、適合怎麼用?
我的建議是:
- 日常寫作、網頁內容潤色:可以接 OpenRouter 上性價比較高的模型;
- 中文長文處理、代碼輔助、複雜推理:可以嘗試 DeepSeek V4 Pro;
- 低成本測試:優先用便宜模型或免費模型;
- 重要任務:仍然建議回到官方 Claude、OpenAI 或穩定付費模型。
第三方供應商最大的優勢是靈活和便宜,但也要注意穩定性、隱私、延遲和模型能力差異。不要把所有重要工作流都綁定在一個低價供應商上,最好保留備用方案。
十二、總結
CC Switch v3.15.0 的意義在於,它把 Claude Desktop 的第三方模型接入從“手動填配置”變成了“圖形化切換供應商”。
核心流程可以概括為五步:
安裝 CC Switch → 進入 Claude Desktop 面板 → 添加供應商 → 配模型映射 → 開啟本地路由並重啟 Claude Desktop只要理解「模型映射」和「本地路由」這兩個概念,OpenRouter、DeepSeek 這類非 Claude 系列模型就能比較順利地接入 Claude Desktop。
參考鏈接
Share