CC Switch 接入 Claude Desktop 教程：用本地路由切换 OpenRouter 与 DeepSeek
介绍如何用 CC Switch 管理 Claude Desktop 的第三方供应商配置，并通过模型映射与本地路由接入 OpenRouter、DeepSeek 等非 Claude 系列模型。
CC Switch 接入 Claude Desktop 教程：用本地路由切换 OpenRouter 与 DeepSeek
CC Switch v3.15.0 开始支持独立管理 Claude Desktop。它的核心价值不是“多一个壳”，而是把 Claude Desktop 的第三方推理配置、模型映射、本地路由统一放进一个图形化面板里，减少手动改配置、填端点、配模型 ID 的麻烦。
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 在中间做了一层适配：
text 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 的用户，直接走自动更新即可。
全新安装可以参考下面方式：
```bash
macOS
brew tap farion1231/ccswitch brew install --cask cc-switch ```
Windows 用户下载 .msi 安装包；Linux 用户按发行版选择 .deb、.rpm 或 .AppImage。
安装完成后，打开 CC Switch。如果 App 切换器里能看到独立的「Claude Desktop」条目，并且它和「Claude Code」并列，就说明已经是支持 Claude Desktop 管理的新版本。
五、进入 Claude Desktop 面板
在 CC Switch 左侧或顶部的 App 切换器中选择：
text 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 为：
text 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 写法，也可以在实际请求模型中尝试：
text deepseek-v4-pro[1m]
是否可用以 DeepSeek 官方文档和 CC Switch 当前版本实际支持为准。
八、开启本地路由
模型映射开启后，还必须开启本地路由。
路径一般是：
text CC Switch → 设置 → 路由
需要打开两项：
1. 路由总开关：打开后状态应显示为运行中。 2. Claude 应用路由：勾选 Claude，让 Claude Desktop 的请求走本地路由。
默认服务地址通常是：
text http://127.0.0.1:15721
一般不需要修改。
建议同时开启「在主页面显示本地路由开关」，这样可以在主面板快速确认路由是否运行。
九、启用供应商并重启 Claude Desktop
配置完成后，在 Claude Desktop 面板中选中刚添加的供应商，点击「启用」（Enable）。
然后重启 Claude Desktop。
注意，这里必须是真正退出，不是关闭窗口：
- macOS：使用
Command + Q完全退出； - Windows：右下角托盘找到 Claude 图标，右键退出。
重新打开 Claude Desktop，发送一句测试：
text 你好，用一句话回复我。
如果能正常回复，再回到 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 的第三方模型接入从“手动填配置”变成了“图形化切换供应商”。
核心流程可以概括为五步：
text 安装 CC Switch → 进入 Claude Desktop 面板 → 添加供应商 → 配模型映射 → 开启本地路由并重启 Claude Desktop
只要理解「模型映射」和「本地路由」这两个概念，OpenRouter、DeepSeek 这类非 Claude 系列模型就能比较顺利地接入 Claude Desktop。
参考链接
Share
评论