Codex Responses API 报错解决方法(Chat/Completions 不支持)

最近在本地折腾 Codex CLI 时，碰到了一个特别典型、也很容易让人绕进去的坑：
项目始终报错

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

一、问题背景

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

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

也就是说：

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

常见报错表现：

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

很多人误以为是 key 问题，其实是

二、官方说明核心信息

Codex 官方已经明确说明：

新版 Codex 现在走的是 Responses API 接口
Chat/Completions API 目前还没法用
也就是说，只有

0.80.0 及以下版本

仍然支持

所以如果你：

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

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

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

npm install -g @openai/codex@0.80.0

这一步非常关键。

很多人只是 npm install -g @openai/codex
默认会装最新版本 → 必然报错。

四、验证是否安装成功

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

codex --version

如果输出：

0.80.0

说明安装成功。

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

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

理论上有两种方案：

现实情况是：

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

所以短期最优解就是：

六、避免再次踩坑（重要）

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

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 也不迟。