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

添加 Provider

  1. 打开已安装的 CC Switch，确认初始 Provider 页面能正常显示。
  2. 在顶部应用切换栏选择 Claude Code，不要停留在 Claude Desktop。
  1. 点击右上角 +，选择“自定义配置”。
  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，亚太地区填写 https://top.qingyuntop.ai。不要追加 /v1 或 /v1/messages。

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

  1. 没有合并需求时关闭“应用通用配置”，点击“添加”，确认返回 Provider 列表并出现 青云TOP API 卡片。
  2. 点击卡片右侧“启用”，确认显示“使用中”。
  1. 打开“设置 → 通用”，开启“跳过 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，而不是只关闭当前窗口。