准备令牌和模型

  1. 在 青云TOP API 控制台创建专用令牌。
  2. 选择包含目标 DeepSeek 模型的分组。
  3. 请求 /v1/models，确认模型 ID 与 Anthropic 能力。
curl "https://top.qingyuntop.ai/v1/models" \
  -H "Authorization: Bearer $QINGYUN_TOP_API_KEY"

使用 CC Switch

  1. 打开 CC Switch 的 Claude Code 分支并新增 Provider。
  2. Provider 名称填写 青云TOP API DeepSeek。
  3. 请求地址填写 https://top.qingyuntop.ai/dashboard/。
  4. API Key 填专用令牌。
  5. 主模型、Thinking、Sonnet、Opus、Haiku 映射都使用 /v1/models 返回的准确 ID；不照抄任何示例模型。
  6. 保存、启用并完全重启 Claude Code。

手动配置（Windows/macOS）

如果不使用 CC Switch，使用 Claude Code 当前版本支持的环境变量或 settings.json 配置，保持 Anthropic Base URL 为域名根目录：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://top.qingyuntop.ai/dashboard/",
    "ANTHROPIC_API_KEY": "sk-...",
    "ANTHROPIC_MODEL": "your-anthropic-model"
  }
}

验证

在 Claude Code 发送一条短消息，确认左侧模型名称、返回内容和 青云TOP API 用量记录都符合预期。配置页显示 Provider 已保存，不能代替这一步。

发布前检查

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