Claude Desktop / CC Switch
用 CC Switch 修复 Claude Desktop 第三方 API 失效
这是一页面向本站用户的改写导读。它整理了公开文章里的关键路径，并补上 sub2api 接入时最容易填错的端点和模型映射注意事项。
版权处理说明：本页不是原文镜像，不复制原文长段落，也不把第三方图片重传到本站。下方“原文图片索引”保留每张图对应的查看入口，便于对照操作；如果图片授权明确，再可替换成本地图片版。
什么时候需要看这一页
如果 Claude Desktop 升级后，自定义接口、环境变量或中转代理突然失效，常见原因是新版本对模型 ID、接口路由和权限检查更严格。CC Switch v3.15.0 开始支持 Claude Desktop，可以把供应商、密钥、模型映射和本地路由统一交给 CC Switch 管理。
适合处理的问题
第三方 API 调不通、模型列表不匹配、Claude Desktop 不吃环境变量、升级后旧配置失效。
不建议继续硬改
反复改客户端文件、降级旧版本、到处覆盖环境变量，后续更新时维护成本会继续上升。
配置步骤整理
下面是按原文流程改写后的操作顺序，重点放在 CC Switch 的 Claude Desktop 入口和模型映射。
-
1. 安装 CC Switch 客户端
从 CC Switch 官网或 GitHub Releases 下载对应系统版本。Windows 选安装包或便携版，macOS 选 dmg 或 Homebrew，Linux 按架构下载发行包。
-
2. 在 CC Switch 中选择 Claude Desktop
打开 CC Switch 后进入 Claude Desktop 应用配置，然后点击添加供应商。可以使用预设供应商，也可以按你实际接口类型创建自定义供应商。
-
3. 填入 API Key 并获取模型列表
把密钥填入供应商配置后，先尝试点击获取模型列表。能自动拉到模型时，优先用自动结果；自动失败时，再手动填写显示名称与实际请求模型。
-
4. 确认模型映射和本地路由
模型映射负责把 Claude Desktop 侧的角色请求对应到真实模型 ID。本地路由用于让 Claude Desktop 经过 CC Switch 转发，通常保持开启。
-
5. 完全退出并重启 Claude Desktop
保存供应商后，不要只刷新窗口。请完整退出 Claude Desktop，再重新打开并发送简单消息测试。
本站接入补充
如果你在 CC Switch 里配置的是通用 OpenAI-Compatible 供应商，Base URL 通常填写 https://api.xxxaicode.com/v1。如果你配置的是前面教程里的 Anthropic/Kiro CCS 供应商，请求地址保持 https://api.xxxaicode.com，不要加 /v1，认证字段保持 ANTHROPIC_AUTH_TOKEN。
在 doc.psydo.top 打开本站时，页面脚本会把示例里的 api.xxxaicode.com 自动显示成当前站点对应的 api.psydo.top。
原文图片索引
下面按原文出现顺序列出图片用途。为避免把第三方图片直接搬运到本站，每张图都提供原图查看链接。