Codex 原生面向 OpenAI Responses API。只有 青云TOP API 模型列表中明确兼容 Responses API 的 DeepSeek 模型才能使用本教程。

创建专用令牌

  1. 打开 青云TOP API 控制台的 API 令牌页面。
  2. 创建一个只供 Codex 使用的令牌。
  3. 选择包含目标 DeepSeek 模型的分组。
  4. 保存并复制令牌。

在 CC Switch 中配置

  1. 打开 CC Switch，在顶部选择 Codex。
  2. 点击右上角 +，选择 自定义 Provider。
  3. 名称填写 青云TOP API DeepSeek。
  4. API Key 填写刚创建的令牌。
  5. API 请求地址填写 https://top.qingyuntop.ai/v1；亚太地区填写 https://top.qingyuntop.ai/v1。
  6. 默认模型填写 青云TOP API 模型列表返回的完整 DeepSeek 模型 ID。
  7. 点击 添加，返回列表后点击 启用。
  8. 完全退出并重新打开 Codex CLI。

验证

在终端运行：

codex

发送一条简短消息，确认 Codex 收到正常回复。随后在 青云TOP API 控制台日志中检查模型 ID、请求时间和状态。

不使用 CC Switch 时，可按照 Codex CLI 手工填写相同 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 判定成功。