OpenAI Codex 报错速查：API、ChatGPT 和 Codex 常见报错原文、原因和修复（2026）
把 OpenAI API、ChatGPT 和 Codex 的常见报错放在一张表里：报错原文、一句话原因、结论依据，以及完整修复文章的链接。
buffer关于作者约 4 分钟阅读
这一页把我们写过完整文章的 OpenAI Codex 报错整理在一起，覆盖 OpenAI API、ChatGPT 和 Codex 三类。先在表里找到和你屏幕上一样的报错原文，看一眼常见原因，再点进完整文章看怎么修。“依据”一列写明结论从哪来：“实测”表示完整文章里有我们自己跑出来的输出，其他行依据的是 OpenAI 官方文档、Codex 源码或 GitHub issue。
OpenAI API 报错
这些报错来自 API 本身或官方 SDK。完整的 HTTP 状态码列表见 OpenAI 的错误码文档。
| 报错原文 | 常见原因 | 依据 | 完整文章 |
|---|---|---|---|
401 Incorrect API key provided: sk-... | key 填错了、已被删除、属于别的组织或项目，或者环境变量里还留着旧 key。 | 实测 | 401 报错怎么修 |
Missing bearer authentication in header | 请求里没有 Authorization: Bearer 请求头，key 根本没发到 OpenAI。 | 实测 | 几种错误 key 的实测结果 |
APIConnectionError，里面有 Illegal header value b'Bearer sk-... ' | key 末尾多了空格或换行，Python SDK 直接拒绝发送。 | 实测 | 检查 key 里的隐藏字符 |
OpenAIError: Missing credentials | SDK 没读到任何 key，通常是当前终端或进程里没设置 OPENAI_API_KEY。 | 实测 | key 是从哪里读的 |
403 Country, region, or territory not supported（unsupported_country_region_territory） | 发请求的机器所在地不在 OpenAI 支持名单里。中国大陆、香港和澳门都不在名单上。换 key、重试都没用。 | 官方文档和社区反馈 | 403 报错怎么办 |
429 Rate limit reached for requests | 每分钟请求数或 token 数超过了限额。等一等，按退避方式重试就行。 | 官方文档；SDK 重试用本地模拟服务验证过 | OpenAI API 的 429 |
429，错误码是 insufficient_quota（或 credit_balance_exhausted） | 余额用完了，或者碰到了消费上限。重试没用，要充值或调高上限。 | 官方文档；SDK 重试用本地模拟服务验证过 | 限流和额度不足的区别 |
如果 key 刚被推到 GitHub 或贴到公开的地方，紧接着就开始报 401，可能是 OpenAI 主动停用了它。OpenAI 说过，在公开网络上发现的 key 会被立刻停用。先按API key 泄露后的处理步骤走一遍，再新建 key。
ChatGPT 报错
| 报错原文 | 常见原因 | 依据 | 完整文章 |
|---|---|---|---|
Payment was not approved | 发卡行拒绝了这笔扣款，或者 3D Secure 验证没完成。OpenAI 说它通常拿不到拒付原因，直接问银行最快。人在中国大陆或香港时，因为不在支持名单里，付款也可能被拒，这种情况没有官方解决办法。 | OpenAI 帮助中心 | 官方排查顺序 |
Codex 报错（CLI、App 和 VS Code 插件）
| 报错原文 | 常见原因 | 依据 | 完整文章 |
|---|---|---|---|
Selected model is at capacity. Please try a different model. | OpenAI 这个模型的算力不够（server_is_overloaded），和你的额度无关。等几分钟或换个模型。 | Codex 源码和维护者的说明 | at capacity 是什么意思 |
You've hit your usage limit | ChatGPT 套餐里这段时间的 Codex 额度用完了。运行 /status 可以看什么时候重置。 | Codex 源码 | Codex 的几种 429 提示 |
Quota exceeded. Check your plan and billing details. | 账单问题：余额用完或碰到了消费上限，重试没用。 | Codex 源码 | Codex 的几种 429 提示 |
exceeded retry limit, last status: 429 Too Many Requests | 普通限流，Codex 自己已经重试过了。等一会儿，少开几个并行会话。 | Codex 源码 | Codex 的几种 429 提示 |
To use Codex with your ChatGPT plan, upgrade to Plus | 你的套餐不包含 Codex。 | Codex 源码 | Codex 的几种 429 提示 |
Codex could not start its user interface | Codex VS Code 插件 26.1021.22027 版本的 bug，大多数人回退到 26.1007.21434 就好了。 | GitHub issue；我们对比了两个版本的安装包 | 怎么回退插件 |
Token exchange failed: token endpoint returned status 403 Forbidden | Codex 登录换 token 这一步没走代理，请求从不支持的地区直连出去。Codex 只读环境变量里的代理，SOCKS 要写 socks5://。 | GitHub issue；我们用 codex-cli 0.165.0 实测 | 怎么修 403 |
Token exchange failed: error sending request for url | 请求没连出去：代理端口过期（包括 ~/.codex/.env 里的）、证书设置错误或在远程机器上登录。 | GitHub issue；我们复现了过期端口的情况 | 逐项排查 |
表里没有的 OpenAI Codex 报错
如果报错里出现 Claude、Anthropic 或 529，那就不是 OpenAI 的报错，去看我们的Claude Code 报错速查。如果几种 OpenAI 报错同时出现，先去 status.openai.com 看有没有故障，再考虑改设置。