Codex 提示「You’ve hit your usage limit」：用量上限的含义、重置与解决

这条提示是什么意思

这句话是 Codex 自己对某一类 429 的说法。按 openai/codex 源码（rust-v0.163.0，2026-10-19 核对），Codex 先读 429 响应 JSON 里的 error 对象；error.type 为 usage_limit_reached 时，它用响应体里的套餐类型和重置时间，加上响应头里的附加信息，拼出这条提示，而不是打印通用的 exceeded retry limit, last status: 429 Too Many Requests（其他几种 429 提示见本页最后一节）。在 Codex 的终端界面里，这一行显示为红色，开头是 ■。OpenAI 的 Codex 定价页（2026-10-19 核对）写明：能发多少消息取决于所用模型、任务的规模和复杂度，以及在本地还是云端运行，另外还可能有每周上限；如果在一轮任务进行中用到上限，agent 仍可以在这一轮里继续工作，但要受合理使用限制约束。

各种提示分别要你做什么

按 openai/codex 源码（rust-v0.163.0，2026-10-19 核对），提示的后半句取决于 429 报告的套餐类型，以及服务端额外发来的信息。以「You’ve hit your usage limit」开头的提示，末尾都会写何时再试（见下一节）；工作区 credits 和消费上限的提示不写：

• Codex 按这个顺序选提示：先看服务端有没有点名某个用量上限，再看工作区 credits 或消费上限的状态，然后是服务端附带的说明，最后才按套餐类型。
• 表里 Free 或 Go 那一行，是 Codex 为这种套餐类型准备的提示。OpenAI 的 Codex 定价页（2026-10-19 核对）里，套餐卡片从 Plus 起才列出 CLI 里的 Codex。Free 和 Go 两张卡片只列了桌面应用，并注明视开放进度而定。

你还可能看到的其他说法

按同一份源码，终端界面可能会把工作区提示换成它自己的说法显示给工作区所有者，例如 Usage limit reached. You've reached your usage limit. Increase your limits to continue using codex.，也可能给工作区成员弹出通知所有者、申请调高上限的选项。快到上限之前，它可能会提醒，例如 Heads up, you have less than 25% of your 5h limit left. Run /status for a breakdown.，也可能提议换成更省 credits 的模型。本页引用的是 Codex CLI 在 rust-v0.163.0 里的原文；其他版本和其他 Codex 应用的措辞可能不同。

什么时候重置、在哪里查

按 openai/codex 源码（rust-v0.163.0，2026-10-19 核对），Codex 会把服务端给的重置时间换成你电脑的本地时间：重置在今天的，只写时间，例如 3:15 PM；在其他日子的，连日期一起写，例如 Oct 20th, 2026 3:15 PM。没有重置时间时，提示只写稍后再试。想知道还剩多少：

• OpenAI 的 Codex 定价页（2026-10-19 核对）写明，当前上限和重置时间在用量面板 https://chatgpt.com/codex/settings/usage 里，Codex CLI 会话进行中可以用 /status 查看剩余额度。
• Codex CLI 命令文档（2026-10-19 核对）介绍了 /usage：查看 ChatGPT 账号的 token 用量，也可以兑换已获得的重置次数；按源码，兑换重置需要用 ChatGPT 登录，而没有打开 requires_openai_auth 的自定义 provider 用不到这个登录。
• 在自定义 model provider 上，/status 会显示 provider 和本次会话的 token 用量。ChatGPT 套餐的上限属于 ChatGPT 登录；按源码，只有 provider 需要 OpenAI 认证时，/status 才会给出 chatgpt.com 的用量链接。

继续用的办法：等、加购，或者换计费方式

上限会一直有效到重置；账号里有已获得的重置次数时，也可以在 /usage 里兑换。提示让你换一个模型时，用 /model 换一个。除此之外只有三种选择——等、给 OpenAI 多付一些，或者让本地会话走另一种计费方式：

• 等到提示里写的重置时间。
• 加购用量。按 OpenAI 的 Codex 定价页（2026-10-19 核对），Plus 和 Pro 用户用到上限后可以加购 credits，不必升级套餐；采用弹性计费的 Business、Edu 和 Enterprise 套餐可以加购工作区 credits。
• 本地会话改用 OpenAI API Key。同一页写明，所有用户都可以用 API Key 额外运行本地会话，按 API 标准价计费；按 Codex 认证文档（2026-10-19 核对），用 API Key 登录时按 API 价格计费，不用套餐里包含的 credits。
• 改用自定义 model provider，比如 Router One：它通过 env_key 从环境变量读取自己的 Key。按 Codex 认证文档，env_key 使用该变量里那个 provider 专用的 API Key，所以会话的请求带着这把 Key 发往该 provider，不占用你的 ChatGPT 套餐。
• Codex cloud 仍走套餐：按 Codex 认证文档，它必须用 ChatGPT 登录。

用一键命令把 Codex 接到 Router One

带上你的 Router One Key 运行一键命令。它会在缺少 Codex CLI 时先安装，备份已有的 config.toml，写入下一节那份配置（provider 为 router，env_key = ROUTER_ONE_API_KEY），把 Key 写进 shell 配置文件，再发一个测试请求验证连通。Windows 用 PowerShell 那一行，它会把 Key 存成用户环境变量。ChatGPT 登录可以保留：用 env_key 的自定义 provider 不会用到它。

curl -fsSL https://router.one/install/codex.sh | bash -s -- sk-your-api-key
# Windows PowerShell：
$env:ROUTER_ONE_API_KEY = "sk-your-api-key"; irm https://router.one/install/codex.ps1 | iex

一键命令写入的 config.toml

顶层的 model = "gpt-5.6-sol" 和 model_provider = "router" 两行写在第一个表头之前，块里保留 wire_api = "responses" 和 env_key = "ROUTER_ONE_API_KEY"。这个 provider 不要打开 requires_openai_auth：按 Codex 认证文档（2026-10-19 核对），它为 true 时 Codex 走 OpenAI 认证，并忽略 env_key。下面就是一键安装写入的完整文件：

model = "gpt-5.6-sol"
model_provider = "router"
model_reasoning_effort = "high"
model_verbosity = "high"
web_search = "live"

[model_providers.router]
base_url = "https://api.router.one/v1"
env_key = "ROUTER_ONE_API_KEY"
env_key_instructions = "Create an API key at https://router.one/dashboard/api-keys and set the ROUTER_ONE_API_KEY environment variable."
name = "Router One"
wire_api = "responses"

经 Router One 时怎么计费

不订 Router One 套餐时，每个请求按所指定模型的公示 token 单价从你的 Router One 钱包扣费（单价见 /models），网关发往模型的每个请求及其 token 数和费用都记在控制台 → 日志里。订了 Router One 的 Pro、Max 或 Ultra 套餐时，套餐档位列出的模型先扣该档位的额度，超出额度的调用按公示单价从钱包扣费：截至 2026-10-19 的套餐接口，一键安装写入的 gpt-5.6-sol 在这三个套餐的「高级模型」档（各套餐额度见 /pricing）。Router One 对每把 Key 和每个账户的请求数与 token 数限额是平台默认值，可以发邮件到 support@router.one 申请调高；Router One 自己的错误码见错误码速查（https://router.one/zh/llm-api-error-codes）。

看起来相似、但不是这个用量上限的提示

按 openai/codex 源码（rust-v0.163.0，2026-10-19 核对），下面几种提示看着相近，意思不同；最后一种是服务端的回复，见于 Codex 自己的测试用例：

常见问题