CC Switch 接入 Claude Desktop 教程：用本地路由切換 OpenRouter 與 DeepSeek
介紹如何用 CC Switch 管理 Claude Desktop 的第三方供應商配置，並通過模型映射與本地路由接入 OpenRouter、DeepSeek 等非 Claude 系列模型。
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