开始前完成通用备份，并在 青云TOP API 模型列表中确认目标模型支持 Anthropic Messages 协议。

添加 Provider

  1. 打开已安装的 CC Switch，确认初始 Provider 页面能正常显示。
  2. 在顶部应用切换栏选择 Claude Code，不要停留在 Claude Desktop。
CC Switch 顶部已选择 Claude Code 应用分支
  1. 点击右上角 +，选择“自定义配置”。
CC Switch 添加新供应商页面中的自定义配置入口
  1. 在 青云TOP API 创建适用于 Anthropic Messages 的专用令牌并复制；不要使用账号访问令牌。

![青云TOP API API 密钥页面中的创建 API 密钥按钮](https://docs.qingyuntop.ai/images/青云TOP API-api-key-create.png) 在创建表单中填写名称并选择能访问目标 Anthropic 模型的分组；下面截图中的 auto 仅展示表单位置，实际分组以当前模型列表和账户权限为准。 ![青云TOP API 创建 API 密钥表单中的名称与分组设置](https://docs.qingyuntop.ai/images/青云TOP API-api-key-form.png)

  1. 名称填写 青云TOP API，API Key 填写模型令牌；请求地址填写 https://top.qingyuntop.ai/dashboard/，亚太地区填写 https://top.qingyuntop.ai/dashboard/。不要追加 /v1 或 /v1/messages。

!CC Switch 中 青云TOP API Provider 的名称、官网、已打码 API Key 和请求地址配置 API Key 会显示为圆点；确认截图或录屏中没有展开明文。继续向下检查请求地址： !CC Switch 中 青云TOP API Claude API 请求地址为 https://top.qingyuntop.ai/dashboard/

  1. 没有合并需求时关闭“应用通用配置”，点击“添加”，确认返回 Provider 列表并出现 青云TOP API 卡片。
  2. 点击卡片右侧“启用”，确认显示“使用中”。
CC Switch 中 青云TOP API Provider 已被选中
  1. 打开“设置 → 通用”，开启“跳过 Claude Code 初次安装确认”。
CC Switch 已开启跳过 Claude Code 初次安装确认
  1. 完全退出并重新打开终端；下面以 Ghostty 为例启动 Claude Code。

在 Ghostty 中启动

claude --version
claude

下面是在 Ghostty 中实际启动 Claude Code 后的界面。顶部应显示 Claude Code 版本、当前模型和工作目录；不应再跳转到官方登录页。 !在 Ghostty 中启动由 CC Switch 配置的 Claude Code 在 Claude Code 输入框发送一条短消息，并在 青云TOP API 控制台日志中核对模型、状态和请求时间。若需要固定模型，在 Claude Code 配置中使用 青云TOP API 实际返回的 Anthropic 模型 ID，不要照抄截图中的示例模型。

独立接口检查

curl "https://top.qingyuntop.ai/v1/messages" \
  -H "Authorization: Bearer $QINGYUN_TOP_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"model":"your-anthropic-model","max_tokens":16,"messages":[{"role":"user","content":"ping"}]}'

排错

  • 仍出现官方登录：核对“跳过初次安装确认”、Provider 启用状态和 ANTHROPIC_BASE_URL 的实际来源。
  • CC Switch 自检失败：某些令牌分组可能限制第三方探测；不能据此断定 Claude Code 对话失败。
  • 对话使用错误模型：核对令牌可见模型与 CC Switch 的主模型/快速模型映射。
  • 切换后无变化：完全退出 Claude Code，而不是只关闭当前窗口。

发布前检查

以下检查适用于客户端中选择 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 判定成功。