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

> https://router.one/zh/codex-usage-limit 的 Markdown 镜像，供 AI 助手与爬虫使用。Router One 是 OpenAI 兼容的统一 LLM API 网关。
> 最后更新：2026-10-19

Codex 打印以「You’ve hit your usage limit」开头的提示，表示用 ChatGPT 登录的会话已经用到了套餐的用量上限。按 openai/codex 源码（rust-v0.163.0，2026-10-19 核对），服务端返回 HTTP 429、且错误类型为 usage_limit_reached 时，Codex 就显示这句话，不会重试这个请求；服务端给了重置时间，提示末尾会按你电脑的本地时间写出来，没给就只写稍后再试。上限来自你的 ChatGPT 套餐，所以你可以等额度重置、在套餐允许时加购用量，或者让本地会话换一种计费方式。把 Router One 配成 model provider 的 Codex 会话，请求用你的 Router One Key 发往 https://api.router.one/v1，不经过 ChatGPT 登录，由 Router One 计费，不占用 ChatGPT 套餐。Router One 在中国大陆可直连，不需要 VPN，钱包可以用支付宝充值。

## 这条提示是什么意思

这句话是 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 打印的内容 | 出现的情况 | 怎么办 |
| --- | --- | --- |
| `You’ve hit your usage limit. Upgrade to Plus to continue using Codex (https://chatgpt.com/explore/plus), or try again at …` | 429 报告的套餐类型为 Free 或 Go | 等额度重置，或者按提示升级套餐 |
| `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 …` | 套餐类型为 Plus | 等重置、加购 credits，或者升级 |
| `You’ve hit your usage limit. Visit https://chatgpt.com/settings/usage to purchase more credits or try again at …` | 套餐类型为 Pro | 等重置，或者加购 credits |
| `You’ve hit your usage limit. To get more access now, send a request to your admin or try again at …` | 套餐类型为 Team、Business 或部分 Enterprise | 找工作区管理员申请，或者等重置 |
| `You’ve hit your usage limit. Try again at …`，或末尾为 `Try again later.` | 其他 Enterprise、Edu 套餐类型，或者 429 没有带套餐类型、带的类型 Codex 不认识 | 等额度重置 |
| `You’ve hit your usage limit for <limit name>. Switch to another model now, or try again at …` | 服务端点名了通用 Codex 额度以外的某个用量上限 | 用 /model 换一个模型，或者等重置 |
| `You’ve hit your usage limit.` 后面接服务端附带的一段说明，再写何时再试 | 服务端附带了自己的说明 | 照说明办，或者等重置 |
| `Your workspace is out of credits. Add credits to continue.`；成员看到的是 `Your workspace is out of credits. Ask your workspace owner to refill in order to continue.` | 服务端报告工作区的 credits 用完了 | 所有者充值 credits；成员找所有者 |
| `You hit your spend cap set in your workspace. Increase your spend cap to continue.`；成员看到的是 `You hit your spend cap set by the owner of your workspace. Ask an owner to increase your spend cap to continue.` | 服务端报告到了工作区设置的消费上限 | 所有者调高上限；成员找所有者 |

- 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 不会用到它。

`terminal`

```bash
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。下面就是一键安装写入的完整文件：

`~/.codex/config.toml`

```toml
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 自己的测试用例：

| Codex 打印的内容 | 含义 |
| --- | --- |
| `To use Codex with your ChatGPT plan, upgrade to Plus: https://chatgpt.com/explore/plus.` | 429 表示这个套餐不包含 Codex 用量（error.type 为 usage_not_included） |
| `Quota exceeded. Check your plan and billing details.` | API 配额或支出限额用完了，比如 OpenAI API Key 的 insufficient_quota（https://router.one/zh/openai-insufficient-quota） |
| `exceeded retry limit, last status: 429 Too Many Requests` | Codex 已停止重试的限流 429（https://router.one/zh/codex-exceeded-retry-limit） |
| `Selected model is at capacity. Please try a different model.` | 服务端返回了 server_is_overloaded 错误码（https://router.one/zh/codex-model-at-capacity） |
| `The '…' model is not supported when using Codex with a ChatGPT account` | 服务端的回复：你的 ChatGPT 登录用不了这个模型（https://router.one/zh/codex-model-not-supported） |

## 常见问题

### 「You’ve hit your usage limit」是 Router One 的报错吗？

不是。按 openai/codex 源码（rust-v0.163.0，2026-10-19 核对），这是 Codex 对错误类型为 usage_limit_reached 的 429 给出的提示，说的是用 ChatGPT 登录的会话用到了 ChatGPT 套餐的上限。把 Router One 配成 model provider 的 Codex 会话，请求用你的 Router One Key 发往 https://api.router.one/v1，不经过 ChatGPT 登录，由 Router One 计费；如果你以为这个会话走的是 Router One，检查 ~/.codex/config.toml 顶层的 model_provider 那一行。

### Codex 的用量上限什么时候重置？

服务端给了重置时间时，就是提示末尾写的时间，按你电脑的本地时间显示；没给时提示只写稍后再试（按 openai/codex 源码，rust-v0.163.0，2026-10-19 核对）。OpenAI 的 Codex 定价页（2026-10-19 核对）写明，当前上限和重置时间在用量面板（https://chatgpt.com/codex/settings/usage）里，Codex CLI 会话中可以用 /status 查看；账号里有已获得的重置次数、且会话走 ChatGPT 登录时，可以用 /usage 兑换。

### 我没怎么用 Codex，为什么也到了上限？

按 OpenAI 的 Codex 定价页（2026-10-19 核对），ChatGPT Work 与 Codex 共用用量：在 ChatGPT 里使用 ChatGPT Work 的用量，与 Codex 采用同样的定价、credits 和用量上限；其他 agent 类功能开始计费后也共用这份上限，目前包括 Plus 和 Pro 上的 ChatGPT for Excel。本地消息和云端会话共用套餐额度；同一页还写明，模型选择、上下文、推理、工具调用、检索和缓存都会影响用量。

### Codex 为什么不等到重置再自动重试？

按 openai/codex 源码（rust-v0.163.0，2026-10-19 核对），Codex 把用量上限当作最终结果：收到这种 429 时直接结束这一轮并显示提示，不重试，不管响应里有没有写要等多久。重置之前再试也只会撞上同一个上限。限流类的 429 不一样，Codex 什么时候会重试它们，见 Codex 429 报错页（https://router.one/zh/codex-exceeded-retry-limit）。

### Codex 额度用完了，改用 OpenAI API Key 或自定义 model provider 还能继续用吗？

本地会话可以，因为它们的计费方式不同。按 OpenAI 的 Codex 定价页（2026-10-19 核对），所有用户都可以用 API Key 额外运行本地会话，按 API 标准价计费。带 env_key 的自定义 model provider（比如 Router One）会用自己的 Key 把会话的请求发往该 provider：经 Router One 时按 token 从你的 Router One 钱包扣费；订了 Router One 套餐时，档位列出的模型先扣该档位的额度。Codex cloud 必须用 ChatGPT 登录，所以云端任务仍受 ChatGPT 套餐上限约束。

### 要用 Router One，必须在 Codex 里退出 ChatGPT 登录吗？

不用。按 Codex 认证文档（2026-10-19 核对），带 env_key 的自定义 model provider 使用该环境变量里的 API Key，所以保存的 ChatGPT 登录可以留着给 Codex cloud，以及仍用内置 OpenAI provider 的会话。Router One 这个 provider 不要打开 requires_openai_auth：按同一份文档，它为 true 时 Codex 会忽略 env_key。

### 在中国大陆能用这套配置吗？

能。网关在中国大陆可直连、无需 VPN，配置和在其他地区完全一样：同一份 config.toml，同一个 ROUTER_ONE_API_KEY 变量。钱包可以用支付宝、银行卡或稳定币充值。

## 相关页面

- Codex 429 报错（exceeded retry limit）：https://router.one/zh/codex-exceeded-retry-limit
- Codex 模型满载报错：https://router.one/zh/codex-model-at-capacity
- Codex 模型不支持报错排查：https://router.one/zh/codex-model-not-supported
- Codex CLI 中国大陆接入：https://router.one/zh/codex-china
- 不用 ChatGPT Plus 也能用 Codex CLI：https://router.one/zh/blog/codex-cli-without-chatgpt-plus
- insufficient_quota 修复：https://router.one/zh/openai-insufficient-quota
- 错误码速查：https://router.one/zh/llm-api-error-codes
- CLI 配置指南：https://router.one/zh/docs/guides/cli-setup
- OpenAI Codex 定价页（英文）：https://developers.openai.com/codex/pricing
- 本页规范地址：https://router.one/zh/codex-usage-limit
- 模型与每模型 token 价格：https://router.one/zh/models （markdown：https://router.one/zh/models.md ）
- 定价：https://router.one/zh/pricing
- API 文档（markdown）：https://router.one/zh/docs.md
- 公司事实（markdown）：https://router.one/zh/facts/company.md