这是协议转换流程：Claude Code 使用 Anthropic Messages，路由器把请求转换为 青云TOP API 支持的协议。配置完成后，必须在 Claude Code 中收到回复，并在 青云TOP API 控制台核对对应请求。

准备

  1. 创建专用 青云TOP API 令牌，并确保分组允许目标模型。
  2. 用 /v1/models 选择一个支持目标协议的模型。
  3. 安装并确认 Claude Code 与本地路由工具版本。
  4. 备份 Claude Code 配置和环境变量。

创建路由 Provider

  1. 在 CC Switch 的 Claude Code 分支点击新增供应商。
  2. 选择自定义 Provider。
  3. 使用 青云TOP API 站点 https://top.qingyuntop.ai/dashboard/、专用令牌和准确模型 ID。
  4. 在路由设置中只启用 Claude Code，避免其他客户端配置被同时修改。
  5. 完全退出并重新打开 CC Switch 和 Claude Code。

验证顺序

  1. 查看 Claude Code 当前环境变量，确认 Base URL 指向本地路由而不是旧地址。
  2. 启动 claude，发送一句短消息。
  3. 检查 Claude Code 是否返回内容。
  4. 查看本地路由日志，确认协议转换和目标模型。
  5. 最后查看 青云TOP API 侧请求/用量记录，确认调用命中了预期分组。

发布前检查

以下检查适用于客户端中选择 OpenAI 兼容 或 Responses 提供商的场景；如果你选择的是 Anthropic、Gemini 等原生协议，请按对应协议的接口和返回结构配置。

  1. 模型 ID：先用目标 API Key 请求 GET https://top.qingyuntop.ai/v1/models，把返回的 data[].id 原样填入客户端。截图、教程和历史配置中的模型名不保证仍可用。
  2. 协议选择：新 OpenAI 集成优先选择 Responses；只有客户端或模型明确要求 Chat Completions 时才选择 Chat。Responses 的返回从 output 读取，Chat 的返回从 choices[].message 读取。
  3. Base URL：通常填写 https://top.qingyuntop.ai/v1，也就是只保留一个 /v1。要求完整接口地址的客户端才追加 /responses 或 /chat/completions，不要重复追加。
  4. 流式与重试：流式响应必须按所选协议解析事件；连接中断后不要盲目重放可能已被服务端接受的生成请求。对 429 和 5xx 使用带抖动的退避，并设置连接、读取和总超时。
  5. 上线前验证：分别验证普通文本、流式文本、工具调用或结构化输出中实际用到的能力，并记录 request id、HTTP 状态、业务状态和完成原因，避免只根据 HTTP 200 判定成功。