问题描述：

原理：用官方 3P Gateway 把 Claude Desktop 的 Code 页接到 cc-switch，再热切换任意兼容模型

前言：今天中午想把ccswitch的模型放到桌面版，结果就是接不通，有佬说只能cli，但是claude自己告诉我共用底层，所以我摆弄了半天，最后终于知道，底层的确是共用的底层，但是官方文档也写了，桌面版默认只能用官方账号，要换模型只能用cli，但是想要好看有更多功能的桌面版怎么办？

然后我就发现了这篇官方的最新文档，这篇教程就是基于它来的：
Install and configure Claude Cowork with third-party platforms

另外这篇也值得看一眼：
Use Claude Code Desktop

本条解决了这个教程的一个难题，如果有这种需要，建议先看：

【教程】如何安装同一个claude桌面版而不混淆账号 搞七捻三

这个是为了解决我的零一篇教程 中出现的桌面版更改为自由切换模型的cowork/code后切换个人账号麻烦的问题 目前的情况是： 截至 2026-04-23，Claude Desktop 的普通 Windows 安装器不会像很多传统软件那样弹出 Install for all users / Only for me 选择。 所以如果既要有要： 一套 Desktop 3P / Cowor…

---

先罗列桌面版除了嚎堪到底还多了什么

不用想了，AI生成，所以折叠。了解的不用看，不了解的建议看看
纯ai生成部分在这里，其他地方都可以明显看出不少手工痕迹，希望不要乱举报，刚刚找始皇恢复的帖子

点我展开

image830×1206 118 KB
image840×1257 101 KB
image840×1257 101 KB

---

---

前置条件

• 已安装最新版 Claude Desktop。
• Windows 已启用 Virtual Machine Platform。
• cc-switch 正在运行。
• 你已经在 cc-switch 里导入了能用的 Claude provider。
• cc-switch 开启本地代理，地址一般是 http://127.0.0.1:15721。最好确认一下。
• 如果也在用 CLI，建议保留 C:\Users\<用户名>\.claude\settings.json 里的代理配置。

---

这里非常重要：cc-switch 一定要开启本地代理

不是不能自己填写provider，但是：

如果你把 Desktop 的 Gateway base URL 直接填成某个 provider 地址，比如：

http://127.0.0.1:8317/v1

那桌面版只会连这个固定后端，你在 cc-switch 里切换 provider，Desktop 不会跟着切。你好要再跑一边下面的教程才行，来一次还行，天天来谁受得了

而cc-switch能一起热切换，把请求转发给当前选中的 provider。

补充一下：newapi其实也可以，但是效果一样并且配置模型更为繁琐，个人觉得不太适用于个人场景

---

教程

1. 打开claude桌面版 3P 设置界面

按官方文档，点击桌面版左上角三条横线，按照这个路径：

773da0ef-45e4-4100-8cfe-788d139dbcb1176×191 3.61 KB

• Help -> Troubleshooting -> Enable Developer mode
• Developer -> Configure third-party inference

这会打开官方的 3P Setup UI。

8b033484-e44a-4def-8433-44f88fe820c3884×681 54.4 KB

2. 在 Connection 里选择 Gateway

在 Connection 页面，选择：

• Gateway

不要选 Bedrock，不要选 Vertex，不要选 Foundry。

因为我们这里要走本地 cc-switch 统一入口。

当然，如果你要连接到亚马逊/谷歌/微软，可以根据自身情况选择。

3. 填写连接字段

按下面这样填：

• Gateway base URL

  • 填：http://127.0.0.1:15721（具体看你自己的本地代理地址）

• Gateway API key

  • 填：PROXY_MANAGED（基本都是这个）

• Gateway auth scheme

  • 选：bearer

• Gateway extra headers

  • 先留空

• Organization UUID

  • 先留空
  • 这个主要是给部署标识和 telemetry 用，不是鉴权必填

• Credential helper script

  • 先留空
  • 只有你的 token 需要动态刷新时才需要

• Skip login-mode chooser

  • 这个是跳过登录，建议打开
  • 这样启动后直接走 Gateway，不会弹出官方登录分流

• Bootstrap config URL

  • 先留空
  • 这个是做 per-user JSON overlay 的，单机测试不是必需

4. 点击面板左下角，切到 Show as JSON 检查一次

建议切到 Show as JSON，确认配置里至少有这些键：

{ "inferenceProvider": "gateway", "inferenceGatewayBaseUrl": "http://127.0.0.1:15721", "inferenceGatewayApiKey": "PROXY_MANAGED", "inferenceGatewayAuthScheme": "bearer", "inferenceModels": ["sonnet", "haiku", "opus"], //这行待会儿我们手动弄 "isClaudeCodeForDesktopEnabled": true }

这几个键里最重要的是：

• inferenceProvider
• inferenceGatewayBaseUrl
• inferenceGatewayApiKey
• inferenceModels（就是这个需要手动）
• isClaudeCodeForDesktopEnabled

说明一下上面那个为什么要手动，这里我踩坑了：

• inferenceModels 是模型下拉框的候选列表，不弄会无法选择模型，就是说ccswitch中我们选择的claude对应的三个模型会拉不出来。
• sonnet、haiku、opus 在这里更像 Anthropic 风格的 alias，不代表真实上游一定是 Claude。你可以自定义名称，我没有试验过数量，你说不定可以试试，不过ccswitch本身只限定了三个可选项。我个人建议参考ccswitch方便一些。
• isClaudeCodeForDesktopEnabled: true 用来确保 Code 页可见。

那行在面板是无法编辑的，那怎么加上面那行？

方法一：导出 .reg 再改

1. 先在表单里把这些能填的都填好：
   • Gateway base URL = http://127.0.0.1:15721
   • Gateway API key = PROXY_MANAGED
   • Gateway auth scheme = bearer
2. 点右下角 Export
3. 导出 Windows 的 .reg
4. 用记事本打开这个 .reg
5. 在 [HKEY_CURRENT_USER\SOFTWARE\Policies\Claude] 下面加一行：
   提醒一下：这里sonnet等等可以替换成自己喜欢的名字，顺序这里的从左到右对应界面的从上到下，但是ccswitch无法更改别名，个人建议适配

"inferenceModels"="[\"haiku\",\"sonnet\",\"opus\"]"

如果你想先保守测试，只加一个也行：

"inferenceModels"="[\"sonnet\"]"

6. 保存后双击导入，或者用命令：

reg import "C:\path\to\your.reg"

补充：
用命令弄的话里面的路径需要修改成你自己存放 .reg 的地方，比如你导出时存在桌面（里面的文件名记得修改）：

reg import "C:\Users\你的用户名\Desktop\claude-3p.reg"

存在下载文件夹：

reg import "C:\Users\你的用户名\Downloads\claude-3p.reg"

7. 完全退出 Claude Desktop
   托盘里也退出
8. 重新打开，再看模型下拉框

方法二：直接用 PowerShell 写注册表
如果你不想导出文件，直接执行（记得确认内容，别完全复制粘贴）：

New-Item -Path 'HKCU:\SOFTWARE\Policies\Claude' -Force | Out-Null Set-ItemProperty -Path 'HKCU:\SOFTWARE\Policies\Claude' -Name 'inferenceProvider' -Value 'gateway' Set-ItemProperty -Path 'HKCU:\SOFTWARE\Policies\Claude' -Name 'inferenceGatewayBaseUrl' -Value 'http://127.0.0.1:15721' Set-ItemProperty -Path 'HKCU:\SOFTWARE\Policies\Claude' -Name 'inferenceGatewayApiKey' -Value 'PROXY_MANAGED' Set-ItemProperty -Path 'HKCU:\SOFTWARE\Policies\Claude' -Name 'inferenceGatewayAuthScheme' -Value 'bearer' Set-ItemProperty -Path 'HKCU:\SOFTWARE\Policies\Claude' -Name 'inferenceModels' -Value '["sonnet","haiku","opus"]' Set-ItemProperty -Path 'HKCU:\SOFTWARE\Policies\Claude' -Name 'isClaudeCodeForDesktopEnabled' -Value 1 -Type DWord

然后完全退出并重开 Desktop。

确认（可选）：

• C:\Users\user\.cc-switch\logs\cc-switch.log
• C:\Users\user\.cc-switch\cc-switch.db

6. 重启后应该是这样的：

efba087f-efa6-4ca2-957d-cd8fec9790e21356×884 54.5 KB
43f5e28e-cacc-4de1-9288-f354901803281356×884 39.4 KB

---

查本地记录确认是不是真的接通了

方法一：查 cc-switch.log

文件路径：

C:\Users\<用户名>\.cc-switch\logs\cc-switch.log

你要找的是最新的这类行：

[Claude] >>> 请求 URL: ...

如果你看到它在请求你当前 provider 的地址，说明已经真的走到了第三方。

方法二：查 cc-switch.db

文件路径：

C:\Users\<用户名>\.cc-switch\cc-switch.db

重点看表：

proxy_request_logs

你要重点确认这几列：

• data_source = proxy
• provider_id = 当前选中的 provider
• request_model = sonnet/haiku/...
• model = 真实上游模型
• status_code = 200

如果这里是 source=proxy，就说明你不是在看会话导入的假象，而是真的经过了代理。

方法三：查 Claude 会话元数据

文件路径：

C:\Users\<用户名>\.claude\sessions\*.json

看最新那个 session 文件，重点确认：

• entrypoint = claude-desktop-3p

如果是这个值，说明当前是 Desktop 3P 会话，不是普通官方 Desktop Chat。

方法四：查 3P 本地日志

文件路径：

C:\Users\<用户名>\AppData\Roaming\Claude\logs\custom3p-setup.log

这个文件适合排查：

• 3P 模式有没有启用
• 启动时有没有 provider / bootstrap / custom_3p 相关报错

---

可以让 AI 帮你检查哪些文件

你要是不想自己翻日志，可以直接把这些文件路径给 AI，让它帮你判断：

C:\Users\<用户名>\.cc-switch\logs\cc-switch.log C:\Users\<用户名>\.cc-switch\cc-switch.db C:\Users\<用户名>\.claude\sessions\最新那个.json C:\Users\<用户名>\AppData\Roaming\Claude\logs\custom3p-setup.log C:\Users\<用户名>\.claude\settings.json

让 AI 帮你回答这 4 个问题就够了：

• 现在是不是 claude-desktop-3p
• 最新请求是不是 source=proxy
• 当前 provider_id 是谁
• 真实上游 model 是什么

---

怎么退回官方普通模式

感觉需要的人不多所以先折叠

点我展开

image856×988 68.9 KB

---

其实还是在借用a/的agent框架

如果你出现了下面的问题

Caphhh:

佬友, 你有出现过这个workspace的问题吗? 模型是能正常访问的, 就差这个了

PixPin2026-04-2321-25-331517×531 58.3 KB

可以使用91楼佬友 @Caphhh 的修复方案：

Caphhh:

直接安装tailscale, 把ccs的监听地址http://127.0.0.1:15721通过 Tailscale Serve 包成 HTTPS, 在把这个https直接填到reg的Gateway base URL然后在应用这个reg文件就OK了.

网友解答：

---

--【壹】--：

佬友你这个可以配置模型别名吗？claude code desktop的子代理有时候会用haiku、sonnet之类的模型，CCS无法配置模型别名吧？至少CC桌面版是不读settings.json的env模型别名的

---

--【贰】--：

你导出来，右键它用记事本打开在.reg中修改完了之后，直接双击确认就可以导入了，之后这个reg文件删除也没有影响

用命令弄的话里面的路径需要修改成你自己存放 .reg 的地方，比如你导出时存在桌面（里面的文件名记得修改）：

reg import "C:\Users\你的用户名\Desktop\claude-3p.reg"

存在下载文件夹：

reg import "C:\Users\你的用户名\Downloads\claude-3p.reg"

---

--【叁】--：

试了下，用cc-switch没成，cc里是zhipu，然后看日志里是429，关掉路由模式用Claude cli又是好的，奇怪了

---

--【肆】--：

当初安装claude desktop的时候需要登录就没有安装。claude desktop 和claude code cli 有什么区别啊？

---

--【伍】--：

感谢大佬出这么详细的教程，刚刷到另外一个帖子

---

--【陆】--：

claude的这个是不能设置的，只能在底层设置，要么改配置，要么换思考模型
这就是我推荐用ccswitch的原因，你看这里
image1183×803 45.9 KB

另外你可以直接在这里面的配置文件修改思考等级

---

--【柒】--：

你是不是打开了自动故障转移，我没开的时候可以正常使用，但是刚刚开了就不行了，不知道cli里面行不行
要是cc不行的话我打算去折腾下newapi了

---

--【捌】--：

原来已经有人写了，我还是自己查到的，当自用了……

---

--【玖】--： 出離:

1. 在 [HKEY_CURRENT_USER\SOFTWARE\Policies\Claude] 下面加一行：

"inferenceModels"="[\"sonnet\",\"haiku\",\"opus\"]"

可以的，教程这里就可以自己写名字，但是如果要用ccs的话他自己是没有别名的，所以我才在教程里面建议配合一下自己也好认
但是其实你也可以用newapi，要是需要我可以去看看

---

--【拾】--：

应该是能的，好像要开wsl2镜像网络模式。

---

--【拾壹】--：

你可以看一下帖子最上方我折叠的功能介绍，里面详细说了多了什么功能

---

--【拾贰】--：

AI生成的部分我都折叠了，因为有点重要图片又看不清，其他的没有折叠的地方都比较重要而且我手改了不少地方，就没有这样

---

--【拾叁】--：

非常详细的配置教程，对小白很友好，感谢佬的分享！

---

--【拾肆】--：

求教第三方接口的模型如何打开思考 似乎没有选项

---

--【拾伍】--：

可惜可惜
教程就比

Claude Desktop使用自定义API 开发调优

女朋友经常使用Claude Desktop编辑ppt和excel，订阅了一个pro plan，奈何消耗太快，所以研究了下怎么接入第三方api。 官网提供有文档说明，写的有点复杂。 总结起来 正常安装 首次打开，不登陆，左上角菜单按钮(这里有个小坑，没有登录，貌似点击不了，需要通过鼠标选择邮件输入框，键盘tab跳到这里回车打开)–> help → troubleshooting → …

慢了一点
就没人看了

你的写得更加详细一点

---

--【拾陆】--：

佬，单独加的那一行要怎么导入，在哪里双击？能否写的更详细一点？我用命令怎么复制不进去？

---

--【拾柒】--：

刚刚才想着自用呢，看到你的回复暖心了堡堡~
这条帖子还是写了不少时间的，能帮到你就好~

---

--【拾捌】--：

感谢佬，正想着Desktop应该也能用CCS的，这就看到方案了
不过AIGC内容按站内规则好像要以图片形式？

---

--【拾玖】--：

感谢佬友教程，很好奇能不能连接 wsl 啊