Claude Desktop 接入

Claude Desktop 是 Anthropic 的桌面应用，包含 Chat、Cowork 和 Code 等功能。后台的 导入到 CCS 不能直接导入 Desktop，要在 CC Switch 里手动添加一次；不用 CC Switch 时，在应用内配置 Gateway。

推荐：用 CC Switch 配置

还没装 CC Switch 时，先按 CC Switch 安装装好。

打开 CC Switch，点击顶部的 Claude Desktop 图标，再点击右上角橙色 +。必须选 Claude Desktop，选成 Claude Code 配置不会写进 Desktop。
保持顶部选中 Claude 供应商，点击 自定义配置，再点击右下角添加。
在 编辑供应商 里填写四项，其它保持默认，点击保存：

完整 URL 开关保持关闭。两个地址都不加 /v1，末尾不加 /，不用填模型名。

查看 CC Switch 截图

从 Claude 下载页安装 Claude Desktop。首次打开先不要登录或创建 Anthropic 账号。

Mac 从系统菜单栏、Windows 从登录页左上角菜单进入：

在 Connection 中填写：

向下找到 Models（有左侧导航时直接点 Models），关闭 Model discovery，在 Model list 里手动添加模型。以 claude-opus-5-5 为例：

字段	填写
Model ID	`claude-opus-5-5`；换成当前 Key 分组可用的完整模型 ID
Display name	`Claude Sonnet 4.6`，只用于显示，留空会自动生成
Tier alias	`sonnet`
Default for tier	开启
Offer 1M-context variant	保持关闭

Model ID 必须和 UseGoodAI 的模型 ID 完全一致，不能只填 sonnet 或显示名称；模型 ID 看模型价格。

加更多模型时每个单独添加一条，Tier alias 按系列选：Sonnet 填 sonnet，Opus 填 opus，Haiku 填 haiku。同一系列只把一个模型设为 Default for tier。列表第一条是默认模型，最常用的放第一条。

回到 Connection → Gateway credentials，点击 Test connection，看到绿色成功提示。
点击 Apply Changes（旧版叫 Apply locally），按提示重启 Claude Desktop，在登录页选择使用第三方配置进入。
新建对话，在模型选择器里选刚配置的模型，发送 测试。

遇到的问题	处理方法
找不到第三方推理入口	回到登录页，按 Help → Troubleshooting → Enable Developer Mode 开启后再进 Developer 菜单
应用配置后仍显示普通登录页	彻底退出并重新打开，选择第三方配置入口
Test connection 提示模型不存在或不可用	回到 Models → Model list，核对 Model ID 完整拼写，换成 Key 分组支持的 Claude 模型后重新测试
模型选择器为空	在 Model list 添加完整模型 ID，应用配置后重新打开
`401 Unauthorized`	重新复制 API Key；Gateway 方式确认 auth scheme 是 `Bearer`
请求地址错误	地址只填 `https://api.usegoodai.com`，不加 `/v1`

其他报错看报错与踩坑。