Codex App 可以在兼容版本中复用 Codex CLI 的配置。请先完成 CC Switch 配置 Codex，并确认 Codex CLI 已能正常回复。

直接使用现有配置

  1. 在 CC Switch 的 Codex 分支启用 青云TOP API Provider。
  2. 在终端运行 codex，确认能够正常对话。
  3. 完全退出 Codex App；只关闭窗口可能不会结束后台进程。
  4. 重新打开 Codex App。
  5. 新建对话并发送一条简短消息。
  6. 在 青云TOP API 控制台日志中核对相同时间和模型的请求。

首次启动仍显示登录页

如果应用提供 使用 API Key 或 其他方式登录：

  1. 选择 API Key 登录方式。
  2. 填写 青云TOP API 客户端专用 API 令牌。
  3. 继续进入应用并发送测试消息。

如果当前版本只提供 OpenAI 账号登录，或者没有读取自定义 Provider，则不要修改 OAuth 文件、系统代理或应用程序资源来绕过登录。继续使用 Codex CLI，并等待客户端版本正式支持自定义 Provider。

切换 Provider 后没有生效

  1. 退出 Codex App。
  2. 在 CC Switch 中重新确认 青云TOP API 显示为 使用中。
  3. 检查 Codex CLI 是否仍可正常回复。
  4. 再次打开 Codex App。

发布前检查

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