一句话答案
Codex 提示 You've hit your usage limit,意思是你登录用的 ChatGPT 套餐,在当前周期里的 Codex 用量已经用完。Plus 按每 5 小时一个窗口计算,另外还可能有每周上限。报错末尾会写明什么时候可以继续用。
想马上接着干活,有四条路:
- 等重置:等到报错里写的时间。
- 买 credits:OpenAI 允许 Plus 和 Pro 用户在用完额度后购买 credits 继续用,不用升级套餐。
- 改用 API Key 登录:按 API 标准价计费,不再占用套餐额度。
- 把 Codex 接到按量付费的网关,比如 TeamoRouter:只要在
~/.codex/config.toml里加一段 provider 配置。
如果 /status 或用量页面显示还有额度,Codex 却照样拦你,这种情况也不少见,下文单独说。
报错长什么样
完整报错(来自 openai/codex#38354):
You've hit your usage limit. Upgrade your plan or add credits to continue, or try again at 20 Aug 2026, 16:29.
末尾的日期时间就是额度重置的时间。下面几个 issue 里的报告,Codex CLI 和桌面 App 都有。
Codex 用量上限怎么算
OpenAI 在 Codex 价格页 里是这样说明的:
- 5 小时窗口 + 每周上限。 Plus 和 Standard Business 按每 5 小时计算用量,另外还可能有每周上限。Pro 目前没有 5 小时限制。
- 额度是估算值,不是固定条数。 以 Plus 为例,OpenAI 估算每 5 小时的本地消息数:GPT-6.1 Sol 约 15–160 条,GPT-6 Astra 约 5–45 条,GPT-6 Luna 约 350–3,000 条。每条消息用多少,取决于模型、上下文大小、推理强度、工具调用和缓存。
- 本地和云端共用一份额度。 云端任务比本地消息更耗额度。
- Fast 模式和生图更快用完。 Fast 模式按 2.5 倍消耗套餐额度;带生图的回合,平均比不带生图的同类回合快 3–5 倍用完额度。
- 进行中的回合可以做完。 如果在一个回合进行中触到上限,Codex 会让这个回合继续跑完(受公平使用限制约束)。
所以在大仓库里连着跑几个长会话,再挂一堆 MCP 服务器、配一个很长的 AGENTS.md,5 小时的额度可能比 OpenAI 的估算用得快很多。
/status 显示还有额度,却被拦
GitHub 上有两个还没关闭的 issue,都是显示有余量、Codex 却拒绝请求:
- #36344:用量页面和
/status都显示每周额度还剩 43%,但每个新回合都被拒,要等到 6 天后。 - #38354:Plus 账号显示每周额度剩 100%、credits 为 0,照样报 usage limit。另一位评论者 Plus 过期后续费,显示还剩 59% 也被拦。他们退出重新登录都没解决。
遇到这种情况:
- 在 CLI 里运行
/status,和 用量页面 对照。 - 退出后重新登录(先
codex logout,再codex login)。#38354 的评论里提到一个类似的案例这样恢复了,但 #38354 里的几位没用。 - 还是不行,就带上会话(thread)ID 或反馈 ID 向 OpenAI 反馈,两个 issue 里都有人这样做。账号的用量状态只有 OpenAI 能修正。
- 等 OpenAI 处理的同时,可以改用 API Key 登录,或接按量付费的服务(下文第 4、5 条),这两种都不占套餐额度。
继续写代码的几种办法
1. 等额度重置
报错末尾的时间就是可以继续用的时间。当前用量看 /status 或用量页面。
2. 买 credits(Plus 和 Pro)
OpenAI 说,Plus 和 Pro 用户用完额度后可以购买 credits 继续用,不需要升级套餐;Business、Edu、Enterprise 的弹性计费方案可以买 workspace credits。credits 按价格页上的 token 费率扣,Fast 模式按 2 倍扣 credits。
3. 让额度撑得更久
价格页上 OpenAI 自己给的建议:
- prompt 写准确,去掉任务用不到的上下文。
- 只附上相关的文件。
AGENTS.md写短一点;大项目可以在子目录里放更小的AGENTS.md。- 用不到的 MCP 服务器先关掉,每个 MCP 服务器都会给每条消息加上下文。
- 小模型够用时就用小模型。
4. 改用 API Key 登录
任何套餐都可以用 API Key 额外跑本地会话,费用按 API 标准价走你的 OpenAI Platform 账号(见 Codex 登录说明):
printenv OPENAI_API_KEY | codex login --with-api-key
OpenAI 提到,用 API Key 登录支持本地 Codex 工作流,但依赖 ChatGPT workspace 或云端服务的部分功能会受限或不可用。另外你需要一个有余额的 OpenAI Platform 账号。
5. 接按量付费的服务
Codex 可以把请求发到你在 ~/.codex/config.toml 里定义的 OpenAI 兼容服务。TeamoRouter 就是一个:从预充的余额里按实际用量扣费,不占套餐额度,也就没有重置时间要等。
用 TeamoRouter 接 Codex
TeamoRouter 是一个 API 网关,一个 Key 可以调 GPT、Claude、Gemini、DeepSeek 等模型。Codex 走它的 OpenAI Responses 接口。
- 在 TeamoRouter 控制台 创建 API Key,Key 以
sk-teamo-开头。 - 充值,最低 $5。 充值弹窗支持银行卡;也可以点 「USDT支付」,用 USDT、USDC 或 ETH,从币安、OKX 等交易所 App 转账——收银台会按金额显示可用网络(BEP20 从 $5 起就能用)。不用装钱包插件,这一单 60 分钟内有效。步骤见 用 USDT 充值。
- 在
~/.codex/config.toml里加上 provider:
model_provider = "teamorouter"
model = "gpt-6-sol"
model_reasoning_effort = "high"
[model_providers.teamorouter]
name = "TeamoRouter"
base_url = "https://api.teamorouter.com/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"
- 设置 Key(macOS 默认 zsh;Linux 改成
~/.bashrc):
echo 'export OPENAI_API_KEY="你的 TeamoRouter API Key"' >> ~/.zshrc
source ~/.zshrc
codex
Windows 的命令见 安装与配置 Codex。model 能填哪些模型 ID,调 GET /v1/models 查。
等套餐额度重置后想切回去,把 model_provider = "teamorouter" 这一行删掉即可,Codex 会回到内置的 OpenAI provider 和你的 ChatGPT 登录。
在 TeamoRouter 上开 Fast 模式按标价的 2 倍计费。同一个 Key 也能给 Claude Code 用,见 安装与配置 Claude Code。
常见问题
要等多久? 等到报错末尾写的时间。Plus 按 5 小时窗口算,还可能叠加每周上限,所以可能不止等 5 小时。
升级到 Pro 就没有限制了吗? 按 OpenAI 价格页的说法,Pro 目前没有 5 小时限制,但仍有用量上限,升级前先看清套餐说明。
换成自定义 provider,原来的配置还能用吗?
本地使用没问题。只改 provider 配置和 Key,项目、AGENTS.md、MCP 服务器都不用动。依赖 ChatGPT workspace 或 OpenAI 云端的功能,继续用 ChatGPT 登录。
通过 TeamoRouter 用 Codex,需要 OpenAI 账号吗?
不需要。Codex 从 OPENAI_API_KEY 读 TeamoRouter 的 Key,请求发给 TeamoRouter。