报错排查

Codex CLI 提示 You've hit your usage limit / Upgrade to Pro 怎么办

Codex CLI 报 You've hit your usage limit. Upgrade to Pro…try again at 11:39 AM,是 5 小时或每周用量窗口用完了。实测发现这句提示写死在 Codex CLI 里:即使你用的是第三方端点,它也会让你去 chatgpt.com 升级 Pro,照做没有用。附 401 Reconnecting 1/5 的区分方法。

核实于 2026-11-03 · 更新于 2026-11-03
报错原文
ERROR: You've hit your usage limit. Upgrade to Pro (https://chatgpt.com/explore/pro), visit https://chatgpt.com/settings/usage to purchase more credits or try again at 11:39 AM.
一句话结论

当前计划的 5 小时或每周用量窗口用完了,等到提示里 try again at 后面的时间就会恢复。提示里「升级 Pro、去 chatgpt.com 买额度」这几句是 Codex CLI 写死的文案,用第三方端点时不适用,应该去你实际订阅的服务那里查额度、升级。

实测环境:Codex CLI 0.166.0,Linux,2026-11-03。用本地假端点(Responses 协议)返回 usage_limit_reached 和 401,记录 Codex 的提示与重试行为。

这句提示是怎么来的

服务端用量用完时返回的是 429 加一段 JSON,错误类型为 usage_limit_reached,里面带有原因和重置时间,例如:

{"error": {"type": "usage_limit_reached",
           "message": "You've reached the 5h usage limit for your plan. Limits reset in 2h 13m. ...",
           "resets_at": 1793677157}}

实测 Codex CLI 0.166.0 收到后不会显示服务端的原文,而是换成自己内置的一句:

  • 服务端带了重置时间(resets_at)时,结尾显示 try again at 11:39 AM,换算成你本地的时间。
  • 没带重置时间时,结尾显示 try again later。

不管你连的是哪家,「Upgrade to Pro」和两个 chatgpt.com 链接都会出现。这句提示里只有时间是有用信息。

另外实测它不重试,第一次失败就直接报错退出,不会像网络错误那样反复重连。

怎么处理

你的情况 该做什么
用 ChatGPT 官方账号登录 Codex 按提示操作有效:等到重置时间,或在 chatgpt.com 升级、购买额度
用第三方端点(config.toml 里配了 model_provider) 不要去 chatgpt.com。到你订阅的服务的控制台看 5 小时和每周额度,在那里续费或升级
赶时间,不想等 看服务方有没有日卡、周卡这类短期套餐,用来临时补充额度

以 Code2AI Codex 站为例,Plus 套餐对标官方 ChatGPT Plus,Pro 5x、Pro 20x 对标官方对应档位,用量窗口同样分 5 小时和每周两种。当前价格见套餐页(2026-11-03:Plus $29/30 天,Pro 5x $129,Pro 20x $249,另有 $4.30 的日卡和 $38 起的周卡)。

先确认撞的是哪一边的限额

同一台电脑上,Codex 可能同时有两套凭据:ChatGPT 官方登录态(~/.codex/auth.json)和你配置的第三方 provider。撞到的是哪一边,处理方式完全不同。先查当前生效的配置:

grep -n "model_provider" ~/.codex/config.toml   # 没有这一行,用的就是官方登录态
codex doctor                                    # 查看当前的配置、鉴权与运行状态
  • config.toml 里没有 model_provider,或者它指向 openai:撞的是官方账号的限额,按官方提示处理。
  • 指向你自己定义的 provider:撞的是那家服务的限额,去它的控制台查。

如果你用 codex exec -c model_provider=... 这类命令行参数临时指定 provider,它会覆盖 config.toml 里的设置,排查时别忘了把命令行参数也算上。

5 小时窗口和每周窗口怎么区分

Codex 的限制和 Claude Code 一样有两层:

  • 5 小时窗口:短时间内用得太猛会先撞到它,一般等一两个小时就能恢复一部分。
  • 每周窗口:一周累计用量的上限。撞到这个,try again at 显示的时间可能在几天之后。

如果 try again at 的时间离现在超过 5 小时,基本就是每周窗口用完了,只能等或者升级。

别和 401 混淆:Reconnecting 1/5

另一种常见报错长这样:

ERROR: Reconnecting... 1/5
ERROR: Reconnecting... 2/5
...
ERROR: unexpected status 401 Unauthorized: <服务端给出的原因>, url: https://…/v1/responses

实测 401 时 Codex 会重连 5 次(约 7 秒)再报错,最后一行会把服务端的原因原样显示出来。这是 Key 的问题,不是用量问题:

  • Key 填错、复制时多了空格或换行
  • Key 已禁用、订阅已到期
  • config.toml 里 env_key 指向的环境变量在当前终端里不存在

先看最后一行冒号后面的原因,比猜快得多。

常见问题

我明明刚买的套餐,为什么一用就提示 usage limit?

先确认 Codex 实际连的是哪个端点。如果 ~/.codex/config.toml 里的 model_provider 没有指向你买的服务,Codex 用的还是官方账号的登录态,撞的是官方账号的限额。用 codex doctor 可以看到当前的配置和鉴权状态。

提示里的 11:39 AM 是哪个时区?

是本机时区。Codex 把服务端给的重置时间戳换算成本地时间再显示。

能不能让 Codex 自动等到恢复再继续?

不能。实测用量类错误不会自动重试,到时间后需要手动重新发起。长任务建议拆成几段,避免跑到一半撞上限。