Codex Responses API 报错解决方法（Chat/Completions 不支持）

Codex Responses API 报错解决方法（Chat/Completions 不支持）

SEO关键词：OpenAI Codex、Responses API、Chat Completions 报错、codex版本降级、@openai/codex 安装教程、codex无法使用解决

在这里插入图片描述

最近在本地折腾 Codex CLI 的时候踩了一个很典型的坑： 项目一直报错 Chat/Completions API 不支持，最开始以为是 key 或网络问题，排查半天才发现——根本不是代码问题，而是 Codex 新协议变了。

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

一、问题背景

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 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 就可以正常使用了。

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

理论上有两种方案：

现实情况是：

• 很多工具链仍基于 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 也不迟。