Claude Code Desktop 接入CC Switch 中开启本地代理

🏠个人主页：尘觉主页

文章目录

[Claude Desktop 接入 CC Switch：开启本地代理并配置 3P Gateway 教程](#Claude Desktop 接入 CC Switch：开启本地代理并配置 3P Gateway 教程)
- 摘要
- 适用场景
- 准备工作
- [1. 在 CC Switch 中开启本地代理](#1. 在 CC Switch 中开启本地代理)
- [2. 打开 Claude Desktop 的 3P 设置](#2. 打开 Claude Desktop 的 3P 设置)
- [3. 配置 Gateway 连接](#3. 配置 Gateway 连接)
- [4. 重启 Claude Desktop 并验证](#4. 重启 Claude Desktop 并验证)
- 常见问题
- - [1. 为什么不能直接填写 provider 的地址？](#1. 为什么不能直接填写 provider 的地址？)
  - [2. Gateway API key 为什么填 PROXY_MANAGED？](#2. Gateway API key 为什么填 PROXY_MANAGED？)
  - [3. 配置后没有生效怎么办？](#3. 配置后没有生效怎么办？)
- 总结

Claude Desktop 接入 CC Switch：开启本地代理并配置 3P Gateway 教程

摘要

Claude Desktop 默认不能像 Claude Code 那样直接被 CC Switch 接管配置。如果想让 Claude Desktop 也走 CC Switch，并且在 CC Switch 中切换 provider 时自动跟随切换，就需要借助 Claude Desktop 官方提供的 3P Gateway 功能。

本文记录完整配置过程：先在 CC Switch 中开启本地代理，再到 Claude Desktop 的第三方推理配置中填写 Gateway 地址，最后重启验证即可。

适用场景

如果你遇到下面这些需求，这篇教程就比较适合你：

想让 Claude Desktop 使用 CC Switch 管理的模型服务；
想在 CC Switch 中切换 provider 后，Claude Desktop 也同步切换；
想通过 CC Switch 本地代理连接 OpenRouter 等第三方模型服务；
不想在 Claude Desktop 里反复手动修改不同 provider 的接口地址。

准备工作

开始之前，请先确保你已经安装并配置好：

Claude Desktop；
CC Switch；
可用的 provider，例如 OpenRouter；
CC Switch 中已经配置好对应模型或服务。

这里的核心思路是：Claude Desktop 不直接连接某个 provider，而是连接 CC Switch 的本地代理地址。

这样一来，Claude Desktop 的请求会先进入 CC Switch，再由 CC Switch 根据当前选择的 provider 转发出去。

1. 在 CC Switch 中开启本地代理

打开 CC Switch 的设置页面，找到 本地代理 开关并开启。

开启后，CC Switch 会显示一个本地代理地址，一般类似下面这样：

text 复制代码

http://127.0.0.1:15721

示例截图：

把这个地址复制下来，后面配置 Claude Desktop 时需要用到。

需要注意的是，这里一定要使用 CC Switch 的本地代理地址，不要直接填写某一个 provider 的接口地址。

原因很简单：如果你直接填写 provider 地址，Claude Desktop 就绕过了 CC Switch。之后你在 CC Switch 中切换 provider 时，Claude Desktop 并不会跟着切换。

2. 打开 Claude Desktop 的 3P 设置

接下来打开 Claude Desktop。

按照下面路径进入第三方推理配置：

点击左上角菜单，也就是三条横线图标；
进入 Help -> Troubleshooting -> Enable Developer mode；
启用开发者模式后，再进入 Developer -> Configure third-party inference。

示例截图：

完成后，会打开 Claude Desktop 官方的 3P 配置面板。

3. 配置 Gateway 连接

在 3P 配置面板的 Connection 页面中，选择 Gateway。

然后按下面内容填写：

配置项	填写内容
Gateway base URL	`http://127.0.0.1:15721`
Gateway API key	`PROXY_MANAGED`
Gateway auth scheme	`bearer`
Skip login-mode chooser	建议开启
其他字段	留空即可