跳转到主要内容

Codex exceeded retry limit 429、401 与 Stream Disconnected 排查

Codex 报 exceeded retry limit, last status: 429 时,这不是套餐用完的提示;先查并行会话、中转和状态页,再决定等待还是停。

LaoZhang AI Team发布于更新于 25 分钟阅读
文章目录
Codex 401、429 与 stream disconnected 报错的排查路线总览图

Codex 里冒出这样一行,任务随即停下:

■ exceeded retry limit, last status: 429 Too Many Requests, request id: …

字面意思是"超过重试上限,最后一次状态:429 请求过多"。但在当前的 Codex 客户端里(截至 2026 年 10 月 15 日的 openai/codex 源码和 rust-v0.162.1 版本),它的含义要窄得多:服务器或中间的代理返回了 429,而 Codex 没能从响应里认出"套餐用量用完""套餐不含 Codex""API 余额或支出上限"这几种原因。真正用完套餐时,Codex 显示的是 You’ve hit your usage limit…,通常附带恢复时间;API 余额或支出上限显示的是 Quota exceeded. Check your plan and billing details.。

所以看到这条裸报错,先别急着买额度、删登录文件或改重试配置。按三件事分流:

  1. 报错前面有没有前缀,例如 Error running remote compact task: 或 Automatic approval review failed:。前缀说明失败的是哪一个请求。
  2. Codex 走的是 ChatGPT 登录、API key,还是 CC Switch、CLIProxyAPI 这类中转或代理。
  3. 出错时是不是同时开着几个会话或子代理,OpenAI 状态页上当时有没有 Codex 事件。

401 Unauthorized 和 stream disconnected before completion 常与 429 出现在同一段时间,但含义不同,后面各有一节。

exceeded retry limit 429 是什么意思:不是套餐用完的提示

Codex 收到 HTTP 429 后,会先读响应体里的 error.type 和 error.code,再决定显示哪一句。当前源码里的对应关系如下(openai/codex 的 api_bridge.rs 中 429 分支,提示文字定义在 protocol/src/error.rs):

你看到的报错Codex 认出的原因实际含义下一步
You’ve hit your usage limit…,可能带 Try again at …、升级或购买 credits 的链接usage_limit_reachedChatGPT 套餐的 Codex 用量用完等到提示的时间,或按提示购买 credits
To use Codex with your ChatGPT plan, upgrade to Plus…usage_not_included当前套餐不含 Codex升级套餐,或改用 API key 登录
Quota exceeded. Check your plan and billing details.insufficient_quota、credit_balance_exhausted、组织或项目支出上限、organization_usage_limit_exceededAPI 余额、支出上限或组织用量上限去 OpenAI Platform 查账单,重试不会恢复
exceeded retry limit, last status: 429 Too Many Requests以上都不是临时限流、并发过多、服务端异常,或中转把别的错误包装成了 429按下文的四种情况判断

这张表能说明的是 Codex 怎么归类,不是服务器内部的真实原因。读它时有两个限制:

  • 裸 429 不证明你的额度还有剩余,只说明这次响应里没有"套餐用完"的标记。中转或代理可以把上游任何错误包成自己的 429,这时 Codex 读到的已经是代理的说法。
  • 旧版本客户端的判断可能不同,以后的版本也可能再改。用的是很旧的 Codex 时,先升级再判断。

套餐用完的那一支,查剩余额度和重置时间分别见 ChatGPT Pro Codex 额度怎么查、ChatGPT Plus 的 Codex 额度:5 小时估算、周限制与 credits,以及 Codex 每周限额什么时候重置。

先做三项只读检查

在改动任何东西之前,先花一两分钟留下这三样证据。它们决定你属于哪一支,也是之后提交报告要用的材料。

第一,抄下完整报错,包括行首的前缀、末尾的 request id,以及失败时间和时区。CLI 用户顺手记下版本:

bash
codex --version
codex login status

第二条只确认当前的登录方式。不要把输出里的账户标识、token 或 key 贴进公开 issue。

第二,确认请求实际发到哪里:是 ChatGPT 登录、API key,还是配置了自定义 provider 或 base_url。只看当前生效的 model_provider、openai_base_url 或 model_providers.<id>,不要粘贴含凭据的完整配置。

第三,看当时的负载和用量:

  • 在 CLI 会话里运行 /status,它显示对话 ID、上下文用量和速率限制;ChatGPT 登录时 /usage 会打开用量与账单设置(Codex 斜杠命令文档)。
  • 数一下出错时同时在跑的会话、桌面 App 里的对话和子代理。
  • 打开 OpenAI 状态页的历史事件,看失败时间附近有没有 Codex 相关事件。

如果失败发生在启动或发送之前、报的是 401,先看登录路线;收到明确 429,看上表;输出了一部分才断开,按流中断处理。

先确认是哪条账户与 provider 路线

同一个 Codex 界面背后,可能是完全不同的计费方式、凭据和限流规则。看错了账户或控制台,"还有额度"也说明不了任何事。

当前路线应查看的证据常见误判
ChatGPT 登录的 Codexcodex login status、/status、同账户的新会话能否复现拿 Platform API 余额解释套餐用量
OpenAI API keyAPI 错误响应内容、组织与项目、账单和速率限制、响应头拿 ChatGPT Plus/Pro 的状态证明 API 一定可用
自定义 provider 或网关生效的 provider 与 base_url、网关日志、上游 request ID、该服务的账户状态默认所有 401、429 都是 OpenAI 返回的
中转、代理、号池工具(CC Switch、CLIProxyAPI 等)代理自己的日志或管理页、代理版本、代理里的账户状态以为 Codex 看到的 429 就是 OpenAI 的 429

API key 登录的 Codex 按 API 价格计费,不受 ChatGPT 套餐的 5 小时和周限制约束(Codex 定价与用量说明)。反过来,套餐页面上的剩余用量也解释不了 API key 路线的 429。

Codex 429 怎么解决:先看是谁返回的,再决定是否等待

裸 429 的常见来源可以分成四种。按你在三项检查里看到的证据对号入座,一次只验证一个假设。

同时开了多个会话或子代理

2026 年 8 月下旬以来,GitHub 上反复有 ChatGPT 登录的 Pro、Plus 用户报告:单个会话一切正常,同时跑几个会话,或一个会话里派出几个子代理,就开始批量报这条 429,而用量表显示还剩不少。

  • openai/codex issue #41702(Pro,仍开放):跨会话同时跑四五个子代理就触发,影响整个账户。
  • issue #42685(已作为重复关闭):同时超过两三个流就失败,子代理也算在内,约从 8 月 29 日开始。报告者转述,OpenAI 支持回复称子代理请求计入速率限制,且没有公开的按套餐并发上限。
  • 2026 年 10 月 14 日又集中出现一批:#54017 在桌面 App 开第三个对话时失败,周用量表显示 57%;#54010 在 WSL 上开三个会话,剩余 69%;#53978 剩余约 70%。截至 10 月 15 日没有维护者回复。

这些是用户报告。OpenAI 没有确认存在并发上限,更没有公布具体数字,所以不要把"两个""三个"当成规则。可以做的对照测试是:

  1. 关掉其他会话,只留一个,发一个短请求。
  2. 单流成功、一并行就失败时,减少同时运行的子代理。在 config.toml 里调低 agents.max_concurrent_threads_per_session,它限制一个会话里同时打开的子代理线程数,不含主线程(Codex 配置参考)。
  3. 记下"几个流时开始失败",放进之后的报告。

调低这个值只是客户端自己的上限,不保证上游有对应的容量;它是隔离原因的办法,不是官方修复。

状态页有 Codex 事件,或单个会话也失败

只开一个会话、发短请求也报 429 时,服务端问题的可能性更大。OpenAI 状态页 2026 年 10 月 13 日记录了"GPT-6.1 Sol Codex and Work mode"性能下降,10 月 14 日记录了"Codex and ChatGPT Work"性能下降,两次都已恢复;10 月 6 日有多起涉及 Codex 的错误率升高事件。这些事件的说明里都没有提到 429,所以它和 10 月 14 日那批报告只是时间吻合,不能当作已确认的原因。

同一句报错过去也出现过服务端原因:2026 年 1 月,OpenAI 维护者关闭 issue #9135 时说底层问题已处理,之后再出现类似情况属于新问题,需要用 /feedback 附日志重新报告;6 月 3 日也出现过一批相同报错的 issue,两天内关闭。

这种情况的动作是等事件结束,再用一个短请求验证。没有官方给出的恢复时间,不要按固定分钟数反复重跑大任务。

经中转、代理或 CC Switch 使用 Codex

中间多了一层,429 就可能是代理自己的。两个公开案例:CLIProxyAPI 的一个 issue(2026 年 7 月 15 日)里,上游 OpenAI/Cloudflare 返回的是 520,代理管理页却记成了 429;CC Switch 的一个 issue(2026 年 6 月 28 日)里,反复出现的 429 背后是 tool_call_id 转换导致的 400 错误。

所以先看代理自己的日志或管理页,找到同一时间上游真正返回的状态码,再决定是升级代理、修正转换配置,还是处理上游账户。换网络节点有时能避开某个出口的问题,但它解释不了根因,也不适用于直连 OpenAI 的用户。自定义 provider 和 Base URL 怎么配,见 Codex 自定义 API 配置:Key、Base URL 与 Provider 怎么选。

用 API key 登录 Codex

API key 路线的余额和支出上限类 429,在当前客户端会显示 Quota exceeded…。剩下的裸 429 多半与 Platform 的速率限制有关:看响应头里的限流信息,降低并发,再做有限次数的重试。API 429 的几种类型和处理方式见 OpenAI API 429 错误怎么解决:限流、余额与支出上限排查。

什么时候不必再重试

同时满足这三条,继续点重试就没有意义了:只开一个会话、发短请求仍然失败;状态页没有正在进行的 Codex 事件;不经过中转,或代理日志显示上游确实返回了 429。这时运行 /feedback 提交报告并附上日志,按最后一节整理证据。

带前缀的 429 变体:remote compact、自动审批与 account warmup

报错前面的前缀说明是哪个请求被拒,处理方式也随之不同。

报错原文失败的是什么怎么处理
Error running remote compact task: exceeded retry limit, last status: 429 Too Many Requests旧版 Codex 的服务端上下文压缩升级客户端。OpenAI 维护者 2026 年 6 月 29 日在 issue #15468 中说,压缩已改为在本地用普通对话的同一接口完成,"remote compaction" 错误因此消失;之后仍有压缩问题就用 /feedback 新开报告
Automatic approval review failed: exceeded retry limit, last status: 429 Too Many Requests 加上 The action was not executed…自动审批审查(codex-auto-review)这个请求被 429,不是主对话这次操作没有执行,需要重新发起。issue #53324 报告普通用量仍可用时也会出现,仍开放,没有官方解决方法
Codex account warmup failed. Reauthenticate the account and try again. (http_status:429)第三方号池代理(如 opencodex 一类项目)里的账户预热这句话不在 openai/codex 里,是代理输出的。在代理里重新认证该账户、查看代理日志

自动审批那一行,如果想确认是不是审查请求单独被限流,可以临时关闭自动审批做一次对照。关闭后,哪些操作需要你确认会跟着改变,测完恢复原设置;它不是修复办法。

如果看到的是 Selected model is at capacity. Please try a different model.,那不是 429:这是服务器报告模型过载时 Codex 给出的提示,会话日志里记为 server_overloaded,排查见Codex Selected model is at capacity 怎么解决:不是额度用完。

401:先证明谁拒绝了哪种凭据

401 表示某一条路线拒绝了认证,原因要看错误响应内容和当前路线。OpenAI Platform API 的错误文档把 401 分成无效认证、错误的 API key、缺少组织成员资格、IP 白名单不匹配等几种(OpenAI API 错误码文档),所以不是一律"重新登录"。

ChatGPT 登录路线

先看 codex login status 是否和预期的账户、登录方式一致。账户明显不对或登录已失效,才走官方登录流程重新认证。codex logout 会清除本地保存的凭据,属于改变状态的操作;在没记下当前方式、没确认有无受管身份或工作区约束之前,不要把它当第一步(Codex 认证文档)。

重新认证成功的标准,不是登录页打开了,而是原账户、原 provider 上的一个短请求能完成。只有换账户才成功,说明绕开了原路线,原问题并没有修好。

API key 路线

核对实际进程用的 key 属于哪个组织和项目,不要在 shell history 或 issue 里打印 key。错误明确是 invalid_api_key、组织成员资格或 IP 白名单时,修正对应条件后再发一次短请求。稳定的 401 不该退避重试,凭据和权限没变,重发不会成功。看到 Incorrect API key provided 时,具体查法见 Codex 报 401 Incorrect API key provided:先看 URL 和 key 文本。

自定义 provider 路线

401 可能是网关自己返回的,也可能是网关转发了上游的拒绝。用网关的 request ID 对齐同一时刻的日志,确认失败发生在客户端到网关、网关认证,还是最终的模型服务。不要拿一个 provider 的 key 去测另一个 base_url。

Stream disconnected:先判断响应走到哪一步

stream disconnected before completion 只说明响应流没有完整结束,可能发生在客户端、代理或 TLS 检查、公司网络、网关、上游服务,也可能是电脑睡眠或切换网络打断了长连接。错误文字本身不能告诉你是哪一处。

做一次小范围对照就够了:

  1. 用同一账户、同一 provider、同一个短请求新建会话;
  2. 记录是完全没有输出、输出一部分后中断,还是返回了明确的 HTTP 状态;
  3. 组织策略允许的话,在不上传敏感内容的前提下,换一条可信网络做同样的测试;
  4. 把失败时间和 provider 或网关日志对齐;
  5. 只在某个客户端或版本上复现时,记下版本差异,然后停止反复换变量。

用只读基线、短请求、响应形态和有限对照定位 Codex 401、429、流中断与重试耗尽的最小测试图

换一条网络就成功,只说明网络路径值得继续查,不说明必须关掉 VPN、防火墙或证书检查;受管设备上的安全策略不应为了排障而绕过。两条网络在同一时刻、同一 provider 上都失败,更该去看上游状态、账户和 request ID。

输出到一半才断开时,先看能否安全续接,或者把任务拆小再发;不要直接调大 stream_idle_timeout_ms(默认 300000 毫秒)。timeout 只改变客户端等多久,修不好稳定的 401、错误的 base_url、耗尽的余额,也修不好被网关主动关闭的连接。

为什么提高重试次数通常不是第一步:429 不在自动重试范围

如果你打算"改一行配置、把重试次数调大",先看这一行改的是什么:request_max_retries 和 stream_max_retries 对不带 Retry-After 的 429 不起作用;服务器带了 Retry-After 时,stream_max_retries 才决定 Codex 再试几次。ChatGPT 登录用户遇到的裸 429,调大这两个数字没有用。

在当前的 Codex 源码里,向模型 provider 发 HTTP 请求的重试设置是 retry_429: false、retry_5xx: true、retry_transport: true(model-provider-info 源码)。也就是说,在发请求这一层,5xx 和网络错误会自动重试,429 不会。request_max_retries 默认 4、stream_max_retries 默认 5、上限都是 100,调大它们会让 5xx 和断流多试几次;对 429,只有服务器给了 Retry-After 时 stream_max_retries 才起作用。

到了对话这一层,这条裸 429 只有在服务器给了 Retry-After 时,Codex 才会按这个时间等待后重试整轮,次数等于 stream_max_retries(默认 5 次,连同第一次共 6 次请求);没有 Retry-After 就直接结束。issue #42685 的报告者在 CLI 日志里没有找到 Retry-After 或 x-ratelimit 响应头。所以报错里的"retry"不保证 Codex 真的试了好几次。有人在 issue #30471 里请 OpenAI 让 Codex 重试 429 或改清楚这句提示,截至 2026 年 10 月 15 日没有维护者回复。

调大重试次数还有副作用:让一个注定失败的任务拖得更久,在多层网关里放大请求量,把第一条有用的错误埋进更多重试日志里。只有在确认是短暂的传输失败、上游允许重试、并且有明确的总时间上限时,才值得调整;改完仍用一个短请求验证,原错误照旧出现就恢复默认值。自己调用 API 时重试和换备用模型怎么取舍,见 大模型 API 该重试还是切备用模型?先过这五道门。

实测 Codex 429 重试:不带 Retry-After 只发 1 次请求

实际运行了什么:2026 年 10 月 15 日,在 ChatGPT 桌面 App 自带的 Codex CLI 0.162.0-alpha.17.2 上,用一个单独的临时 CODEX_HOME,在 model_providers 里加一个自定义 provider,base_url 指向本机一个很小的 Python 测试服务。这个服务对每个 POST /v1/responses 固定返回某个状态码、JSON 响应体和 x-request-id,并记下收到的每个请求。每个场景单独运行一次 codex exec --skip-git-repo-check "say hi" < /dev/null,用服务端日志数请求次数。

没有运行什么:ChatGPT 登录路线,也就是没有接触 OpenAI 的真实响应,OpenAI 发给 Codex 的 429 带不带 Retry-After 仍然不清楚(issue #42685 的报告者在日志里没有看到);用 API key 调用真实 API;任何中转、代理或 CC Switch;桌面 App 界面和 IDE 插件;Codex 能认出的"套餐用完""额度不足"响应体;连接中途断开。只测了这一个客户端版本。

测试服务返回配置服务端收到的请求用时Codex 最后输出
429,响应体 code 为 rate_limit_exceeded,不带 Retry-After默认1 次约 0.3 秒exceeded retry limit, last status: 429 Too Many Requests, request id: req_mock_429_test
同上request_max_retries = 10、stream_max_retries = 101 次约 0.15 秒同一行
429 + Retry-After: 3默认6 次,每次间隔 3 秒约 15 秒,屏幕显示 Reconnecting... 1/5 到 5/5同一行 429
429 + Retry-After: 3stream_max_retries = 23 次,间隔 3 秒约 6 秒,显示 Reconnecting... 1/2、2/2同一行 429
503默认30 次约 24 秒unexpected status 503 Service Unavailable: server overloaded, url: …/v1/responses, request id: …
500默认30 次约 25 秒We’re currently experiencing high demand, which may cause temporary errors.

这几组结果说明三件事:

  1. 服务器不带 Retry-After 时,exceeded retry limit, last status: 429 是在只发了 1 次请求、不到 1 秒内出现的。报错里的"retry limit"不代表 Codex 重试过;把两个重试配置调到 10,仍然只有 1 次请求。
  2. 服务器带了 Retry-After 时,Codex 按给出的秒数等待,再重试整轮,次数等于 stream_max_retries,全部用完后打印的还是同一行 429。在这个版本里,没有任何 Reconnecting... 计数、立刻报出这行 429,符合不带 Retry-After 的情况;反过来,出现计数不一定是 Retry-After,5xx 和断流重试时也会显示它。
  3. 真正的 5xx 会被重试很多次:每轮最多 5 次带退避的 HTTP 尝试,共 6 轮,30 次请求。用完后报的是另一句话,503 是 unexpected status 503 …,500 是 "high demand" 那句提示,都不是 exceeded retry limit。看到 last status: 429,说明 Codex 收到的就是 429 状态码,它可能来自 OpenAI,也可能来自中间的代理。

这组测试测的是客户端拿到某种响应后怎么做,不是 OpenAI 服务器的行为。走的是自定义 provider,不等于 ChatGPT 登录路线:它回答不了 ChatGPT 登录时 OpenAI 返回了什么、有没有并发上限,也回答不了中转会怎么包装错误。对排查的用处在于:遇到这条裸 429,调大重试配置换不来更多尝试,该做的仍是前面几节的分流,即减少并行、看状态页、查代理日志。

想在脚本里自己复现,codex exec 要关掉标准输入(命令末尾的 < /dev/null),否则它会显示 Reading additional input from stdin... 一直等着,看起来像卡在网络上。

一份可以直接用于升级处理的证据包

问题在新会话里持续、用量页面和报错互相矛盾、单会话短请求稳定失败,或只在特定版本和 provider 组合下失败时,停止猜测,在 Codex 里运行 /feedback:它会打开反馈窗口,可以选择附上日志。同时整理这些信息:

从账户与 provider 路线、401 和 429 判断、stream 对照到脱敏升级材料的 Codex 故障证据清单

此图早于 2026 年 10 月更新,以正文为准。

  • Codex 版本、CLI、桌面 App 或 IDE 插件、操作系统;
  • 登录方式和 provider 名称,base_url 只保留主机和必要路径;是否经过中转或代理;
  • 完整报错原文,包括前缀和 request id;
  • 首次和最近一次失败的时间及时区;
  • 失败发生在发送前、首字节前,还是部分输出之后;
  • 出错时同时运行的会话和子代理数量,单流是否成功;
  • /status 显示的剩余限额,状态页当时有无事件;
  • 做过的一次对照测试和结果;
  • 脱敏后的最小日志片段。

不要附 API key、token、完整认证文件、未脱敏的环境变量或业务源码。证据包的目的,是让支持人员能把 request ID、时间和路线对上,不是上传整台机器的状态。

最后的恢复验收也要回到原路线:原账户、原 provider、原客户端上的一个短请求能完整结束,而且最初那条报错不再出现。换网络、换模型或换账户后成功,只说明找到了临时绕行,原路径是否恢复还要单独验证。

Codex 429 的几个相关问题

Codex 报 exceeded retry limit 429 要等多久?

没有固定答案。套餐用完时,You’ve hit your usage limit… 会给出恢复时间;裸 429 没有。由并行任务引起的,减少并行后通常马上就能验证;由服务端事件引起的,要等状态页显示恢复。OpenAI 没有公布裸 429 的恢复时间,按固定分钟数等待没有依据。

换成 API key 登录能避开 Codex 的 429 吗?

可以换到另一套规则,但不是免费的绕行。API key 登录后按 API 价格计费,受 Platform 的速率限制和账单约束,套餐用量不再适用。它适合本来就打算按量付费的场景;只为躲开一次临时 429,先按上面的四种情况排查更划算。

Codex 429 是我自己的问题吗?

不一定。同时开了多个会话或子代理、经过中转,这两种和你的用法有关,可以自己调整;单会话短请求也失败、状态页有事件时,多半是服务端的问题,等待并用 /feedback 报告即可。

参考来源18

本文引用的外部页面,按正文出现顺序排列。最后更新于 2026年10月15日。

  1. 1.openai/codex 的 api_bridge.rs 中 429 分支github.com/openai/codex/blob/rust-v0.162.1/codex-rs/codex-api/src/api_bridge.rs
  2. 2.protocol/src/error.rsgithub.com/openai/codex/blob/rust-v0.162.1/codex-rs/protocol/src/error.rs
  3. 3.Codex 斜杠命令文档learn.chatgpt.com/codex/reference/slash-commands
  4. 4.OpenAI 状态页的历史事件status.openai.com/history
  5. 5.Codex 定价与用量说明learn.chatgpt.com/docs/pricing
  6. 6.openai/codex issue #41702github.com/openai/codex/issues/41702
  7. 7.issue #42685github.com/openai/codex/issues/42685
  8. 8.#54017github.com/openai/codex/issues/54017
  9. 9.#54010github.com/openai/codex/issues/54010
  10. 10.#53978github.com/openai/codex/issues/53978
  11. 11.Codex 配置参考learn.chatgpt.com/docs/config-file/config-reference
  12. 12.issue #9135github.com/openai/codex/issues/9135
  13. 13.issue #15468github.com/openai/codex/issues/15468
  14. 14.issue #53324github.com/openai/codex/issues/53324
  15. 15.OpenAI API 错误码文档developers.openai.com/api/docs/guides/error-codes
  16. 16.Codex 认证文档learn.chatgpt.com/docs/auth
  17. 17.model-provider-info 源码github.com/openai/codex/blob/rust-v0.162.1/codex-rs/model-provider-info/src/lib.rs
  18. 18.issue #30471github.com/openai/codex/issues/30471