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 自动等到恢复再继续?
不能。实测用量类错误不会自动重试,到时间后需要手动重新发起。长任务建议拆成几段,避免跑到一半撞上限。