第三方模型不支持Claude Code/Codex？OpenAI Chat Completions与Responses API兼容性全解析

当选择第三方模型接入 Claude Code 或 Codex 这类编程工具时，如果不进行严格的预先测试，很可能会直接遇到连接失败、工具无法识别模型的情况。

Image

原因在于这些编程工具对模型的 API 接口格式有非常明确的硬性要求，目前主要涉及以下几类 API 规范：

Image

以 Codex 的支持情况为例，早期格式采用 Chat Completions，后期则演变为 Responses。上图展示的后两种格式都属于 OpenAI 的 API 风格。

OpenAI 目前有两种主流的文本生成 API 端点：

  • /chat/completions
  • /responses

/chat/completions 与 /responses 的核心区别，在于定位不同。/responses 是 /chat/completions 的全面演进版，专门为构建 Agent 类应用而设计，提供了更丰富的状态管理与工具调用支持。

Responses API 在 2025 年 3 月伴随着 GPT‑4.1 的发布正式推出。Chat Completions 接口仍然得到官方维护，OpenAI 建议新项目直接使用 Responses，老项目可以逐步迁移，但这种迁移并非强制，也没有设定截止日期。

当前 Codex v0.141.0 只承认 /responses 格式，这就导致那些仅提供 /chat/completions 格式的第三方模型完全无法被 Codex 接入。

在配置 Codex 的 API 时，必须指向一个兼容 /responses 格式的端点。

Image

通过在 CC switch 中接入火山引擎的模型，我们可以实际测试 Codex 是否能正常运转。

Image

结果显示 Codex 无法正确识别当前正在使用的模型，而实际调用中的模型是 ark‑code‑altest。

Claude Code 则完全不支持 OpenAI 的 API 格式，它所使用的是 /messages 接口。幸运的是，火山引擎的 API 同时兼容这两种格式：

火山 BaseURL： https://ark.cn-beijing.volces.com/api/coding/v3（支持 /responses） 或 https://ark.cn-beijing.volces.com/api/coding（支持 /messages）

Image

全文完。