最近有用户在本机部署 Codex CLI 时遇到了一个非常典型的兼容性问题：项目持续报错 Chat/Completions API 不支持。起初误以为是 API Key 配置或网络连接故障，排查了许久才发现——问题根本不在代码，而在于 Codex 新协议已经变更。
本文将完整梳理踩坑过程与解决方案，希望能帮助大家节省排查时间。
一、问题背景
Codex 新版进行了重大接口升级：
| Codex 版本 | 支持的接口 |
|---|---|
| 新版本 | Responses API |
| 0.80.0 及以下 | Chat / Completions API |
如果你的项目、脚本或旧工具链仍然调用 ChatCompletion，就会直接触发报错。
常见报错表现：
API 调用失败
CLI 无法执行任务
提示接口不兼容
Chat/Completions 不再受支持
很多人误以为是密钥问题，实际原因是版本不兼容。
二、官方说明核心信息
Codex 官方已明确声明：
因此如果你：
仍在运行旧脚本
正使用第三方工具
基于老项目模板开发
希望继续使用 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 无法执行、接口不兼容，完全无需再排查代码，直接记住这一条：
安装命令：
npm install -g @openai/codex@0.80.0
codex --version问题基本可以立刻解决。
未来若官方全面迁移生态，再考虑升级到 Responses API 也不迟。
