最近在本地配置和使用 Codex CLI 时，我遇到了一个非常典型、也特别容易误判的问题：
项目一直报错 Chat/Completions API 不支持。刚开始我还以为是 API key 配置错误，或者网络环境异常，反复排查了很久才发现——问题根本不在代码本身，而是 Codex CLI 的新版本接口协议已经发生了变化。
这篇文章会把完整的踩坑过程、报错原因以及解决方法整理清楚，帮助大家快速解决 Codex CLI 报错、API 不兼容等问题，少走弯路。
一、问题背景
Codex 在新版中已经进行了重要的接口升级：
新版本 Codex 改为使用 Responses API
不再支持 Chat/Completions API
也就是说：
| Codex版本 | 支持接口 |
|---|---|
| 新版本 | Responses API |
| 0.80.0及以下 | Chat / Completions API |
如果你的项目、脚本或历史工具链仍然在使用 ChatCompletion，那么运行时就会直接出现报错。
常见报错表现：
- 调用失败
- CLI 无法执行任务
- 提示 API 不兼容
- Chat/Completions 不再支持
很多人会误以为这是 key 失效、环境配置错误或接口权限问题，但本质上其实是 Codex 版本不兼容。
二、官方说明核心信息
Codex 官方已经明确说明：
新版 Codex 现在走的是 Responses API 接口
Chat/Completions API 目前还没法用
也就是说，只有 0.80.0 及以下版本 仍然支持
所以如果你：
- 还在用旧脚本
- 用第三方工具
- 用老项目模板
- 想继续用 ChatCompletion
必须将 Codex CLI 降级到兼容版本。
三、解决方案：安装旧版本 Codex
最直接有效的办法，就是安装官方最后一个支持 Chat/Completions API 的版本：
npm install -g @openai/codex@0.80.0
这一步非常关键，也是解决 Codex CLI 报错的核心操作。
很多人只是执行 npm install -g @openai/codex
默认安装的会是最新版本 → 基本就会触发接口不支持的问题。
四、验证是否安装成功
安装完成后，在终端执行：
codex --version
如果输出：
0.80.0
就说明旧版本安装成功。
到这一步，Chat/Completions API 通常就可以恢复正常使用，Codex CLI 也能重新执行相关任务。
五、为什么要降级而不是升级代码？
理论上其实有两种处理方案：
| 方案 | 难度 | 推荐度 |
|---|---|---|
| 把所有代码迁移到 Responses API | 高 | ⭐⭐ |
| 降级 Codex CLI | 极低 | ⭐⭐⭐⭐⭐ |
现实情况是：
- 很多工具链仍然基于 ChatCompletion
- 大量脚本暂时还没有适配 Responses API
- 整体迁移成本高、改动范围大
因此，从短期排障和快速恢复可用性的角度来看，最优解就是：锁定 Codex 0.80.0
六、避免再次踩坑（重要）
建议直接锁定版本，避免后续自动升级再次导致 Codex API 不兼容：
npm uninstall -g @openai/codex npm install -g @openai/codex@0.80.0
同时尽量关闭或谨慎使用全局自动升级工具（如 pnpm update / npm update）。
七、总结
如果你遇到 Codex 报错：
- Chat/Completions 不支持
- CLI 无法执行
- API 不兼容
那就不要继续盲目排查代码、网络或 key 配置了，直接记住这一条：
新 Codex → Responses API
旧项目 → 必须用 0.80.0
安装命令：
npm install -g @openai/codex@0.80.0 codex --version
通常执行完之后，问题就能立刻解决。
如果后续官方生态全面完成迁移，再考虑把旧项目升级到 Responses API 也完全不迟。
