Claude Desktop 与 Claude Code 是两个独立应用分支。本页不修改 Claude Desktop 的官方账号登录流程。
添加 Provider
- 在 CC Switch 顶部选择
Claude Desktop。如果入口不可见，到“设置 → 通用 → 应用可见性”恢复显示。 - 首次进入没有 Provider 时，可从 Claude Code 导入已有 青云TOP API Provider，也可点击
+手动添加。 - 导入后逐个检查名称、接口地址、令牌来源和模型映射；相同 ID 不一定会覆盖，无法识别映射的项可能被跳过。
- 手动添加时选择“自定义配置”，名称填写
青云TOP API，API Key 填模型令牌，请求地址填https://top.qingyuntop.ai/dashboard/；亚太地区使用https://top.qingyuntop.ai/dashboard/。不要追加/v1/messages。
- 开启“需要模型映射”，API 格式选择
Anthropic Messages（原生）。
配置模型映射
点击“获取模型列表”，分别为 Sonnet、Opus、Fable、Haiku 选择 青云TOP API 模型列表中的准确 ID。下面使用已验证支持 Anthropic Messages 的 claude-haiku-4-5-20251001 演示四个角色；你的账户应以当前模型列表为准。只有模型明确支持 1M 上下文时才勾选 1M。 !CC Switch 中 Claude Desktop 的 青云TOP API Anthropic Messages 模型映射 模型映射只改变角色到模型 ID 的对应关系，不会把不支持 Anthropic Messages 的模型转换为 Anthropic 模型。 点击“添加”后 青云TOP API 卡片会显示“需要路由”。开启左上角路由开关，确认出现“路由服务已启动”和本地监听地址；下面截图中的其他 Provider 已遮挡。 !CC Switch 已为 青云TOP API Claude Desktop Provider 启动本地路由服务 完全退出并重启 Claude Desktop，发送一条短消息，再到 青云TOP API 日志核对请求。关闭 Claude Desktop 后不再使用该路由时，也要关闭 CC Switch 左上角路由开关。
完成配置
部分版本会显示供应商“测试”入口。保存配置后仍需完全退出并重新打开 Claude Desktop，在对话页发送一条短消息，再到 青云TOP API 日志核对请求。 对话页出现账号登录或官方服务提示时，不要覆盖官方 OAuth 文件；先确认 CC Switch 是否仍接管、Provider 是否启用、应用是否真正退出重启。
发布前检查
以下检查适用于客户端中选择 OpenAI 兼容 或 Responses 提供商的场景；如果你选择的是 Anthropic、Gemini 等原生协议，请按对应协议的接口和返回结构配置。
- 模型 ID：先用目标 API Key 请求
GET https://top.qingyuntop.ai/v1/models，把返回的data[].id原样填入客户端。截图、教程和历史配置中的模型名不保证仍可用。 - 协议选择：新 OpenAI 集成优先选择 Responses；只有客户端或模型明确要求 Chat Completions 时才选择 Chat。Responses 的返回从
output读取，Chat 的返回从choices[].message读取。 - Base URL：通常填写
https://top.qingyuntop.ai/v1，也就是只保留一个/v1。要求完整接口地址的客户端才追加/responses或/chat/completions，不要重复追加。 - 流式与重试：流式响应必须按所选协议解析事件；连接中断后不要盲目重放可能已被服务端接受的生成请求。对 429 和 5xx 使用带抖动的退避，并设置连接、读取和总超时。
- 上线前验证：分别验证普通文本、流式文本、工具调用或结构化输出中实际用到的能力，并记录
request id、HTTP 状态、业务状态和完成原因，避免只根据 HTTP 200 判定成功。