最近在本地折腾 Codex CLI 时，碰到了一个很典型、也很容易让人绕进去的坑：项目始终报错 Chat/Completions API 不支持。

一开始我还以为是 key 配错了，或者网络出了问题。来回排查了半天才弄明白，问题不在代码，而是 Codex 的新协议已经变了。

这篇文章把完整踩坑过程和解决方案整理出来，避免大家再浪费时间。

一、问题背景

Codex 在新版中已经做了重大接口升级。

新版本 Codex 改为使用 Responses API
不再支持 Chat/Completions API

也就是说，接口支持情况已经发生变化：

Codex版本	支持接口
新版本	Responses API
0.80.0及以下	Chat / Completions API

如果你的项目、脚本或历史工具链还在用 ChatCompletion，就会直接报错。

常见报错表现

• 调用失败
• CLI 无法执行任务
• 提示 API 不兼容
• Chat/Completions 不再支持

很多人误以为是 key 问题，其实根本原因是版本不兼容。

二、官方说明核心信息

Codex 官方已经明确说明：

新版 Codex 现在走的是 Responses API 接口
Chat/Completions API 目前还没法用
也就是说，只有 0.80.0 及以下版本 仍然支持

所以，如果你属于下面这些情况：

• 还在用旧脚本
• 用第三方工具
• 用老项目模板
• 想继续用 ChatCompletion

必须降级 Codex CLI。

三、解决方案：安装旧版本 Codex

直接安装官方最后一个支持 Chat/Completions 的版本：

npm install -g @openai/codex@0.80.0

这一步非常关键。

很多人只是执行：

npm install -g @openai/codex

这样默认会安装最新版本，结果就是必然报错。

四、验证是否安装成功

安装完成后，在终端执行：

codex --version

如果输出：

0.80.0

说明安装成功。

至此，Chat/Completions API 就可以正常使用了。

五、为什么要降级而不是升级代码？

理论上有两种方案：

方案	难度	推荐度
把所有代码迁移到 Responses API	高
降级 Codex CLI	极低

现实情况是：

• 很多工具链仍基于 ChatCompletion
• 大量脚本还没适配 Responses API
• 迁移成本高

所以短期最优解就是：锁定 Codex 0.80.0

六、避免再次踩坑

建议直接锁版本，避免自动升级：

npm uninstall -g @openai/codex
npm install -g @openai/codex@0.80.0

同时关闭全局自动升级工具，如 pnpm update / npm update。

七、总结

如果你遇到 Codex 报错，尤其是下面这些情况：

• Chat/Completions 不支持
• CLI 无法执行
• API 不兼容

不要再反复排查代码了，直接记住这一条：

新 Codex → Responses API
旧项目 → 必须用 0.80.0

安装命令

npm install -g @openai/codex@0.80.0
codex --version

按这个方式处理，问题基本可以立刻解决。

如果后续官方全面迁移生态，再考虑升级到 Responses API 也不迟。