# Codex 额度用完了怎么办

> Codex 额度用完了怎么办？了解五小时与每周额度的区别、如何查询重置时间，以及加购 credits、升级订阅和本地 API 按量付费各适合谁。附独立配置示例与费用计算，区分订阅限额、API 限流和余额不足，避免充错账户或配置后仍走原计费路径。

- Canonical HTML: https://omniakey.com/zh/blog/codex-usage-limit-reached
- Markdown: https://omniakey.com/zh/blog/codex-usage-limit-reached.md
- Published: 2026-09-27 (updated 2026-09-27)
- Author: Kiki, COO at OmniaKey
- Language: zh
- Category: Cost control
- Reading time: 9 min
- All posts: https://omniakey.com/blog/llms.txt

---

**Codex 额度用完、出现“usage limit reached”提示时，先查看当前额度和重置时间，再决定是否付费。** 如果用的是 ChatGPT 订阅额度，可以等待对应额度恢复、在账户支持时加购 credits，或评估升级套餐。本地工作还可以使用单独计费的 API Key。

先分清原因很关键：订阅额度用尽、API 请求过快、API 余额不足，需要不同的处理办法。填入一把 Key 不会给原订阅补额度，也不会增加 Codex cloud 的使用权益。

> **核对日期：2026 年 9 月 27 日。** 本文依据当前 OpenAI 官方文档和 OmniaKey 公开目录整理，未进行付费账户耗尽或付费切换实测。费用示例是算术演示；具体限额和恢复时间以本人账户界面为准。

## 先判断是哪一种额度或限制

先看登录方式，再看完整报错。通过 ChatGPT 登录时出现的订阅提示，要去对应账户和工作区查；API 报错则要去实际提供请求的 API 项目或网关查。

|遇到的情况|先查什么|对应处理|
|-|-|-|
|ChatGPT 登录后提示用量上限|剩余额度与界面上的恢复时间|等待重置、按账户条件加购或比较套餐|
|API 429 提示请求过快|错误码、请求或 Token 速率、`Retry-After`|降低并发并遵守服务端重试时间|
|API 余额耗尽或支出上限|实际供应商的余额和限额|补充相应余额或由限额负责人调整|
|401、找不到模型或无权限|Key、供应商、完整模型 ID、权限|修正配置或访问权限，订阅重置解决不了这类问题|

**不能只看 HTTP 429 就认定“被限流”。** OpenAI 的[错误文档](https://developers.openai.com/api/docs/guides/error-codes)也会对 `credit_balance_exhausted`、`project_spend_limit_exceeded` 等返回 429，较宽泛的错误类型仍可能是 `insufficient_quota`。这类余额或支出问题不会因为重复请求而恢复。不同网关的错误命名也可能不同，要看实际返回内容。

确实是速率限制时，优先遵守 `Retry-After`；没有该提示时，采用有次数上限、带随机延迟的指数退避。OpenAI 提醒，失败请求也可能计入每分钟限额，连续猛点重试反而妨碍恢复。

## Codex 额度怎么查看？什么时候重置？

使用 ChatGPT 订阅时，打开对应账户和工作区的 [Codex 用量面板](https://chatgpt.com/codex/settings/usage)。在正在运行的 Codex CLI 会话里，也可以输入：

```text
/status
```

[官方价格与额度说明](https://learn.chatgpt.com/docs/pricing)列出了这两个查询入口。要确认 CLI 保存的登录方式，可以运行：

```bash
codex login status
```

如果配置了自定义供应商，还要核对当前生效的 `model_provider`、模型和 API 地址。本机保存着 ChatGPT 登录信息，不等于这次请求一定从订阅扣费。API 请求究竟记到哪里，应再看对应供应商的用量记录。

### 五小时额度与周额度有什么区别？

OpenAI 公布的是**每五小时本地消息数量的估算范围**，并说明可能另外适用周限额。本地消息与云端任务会共享套餐用量。它不是“每天固定能发多少条”：模型、任务难度、累计上下文、推理和工具调用都会影响消耗。

分别查看界面中各项额度的恢复时间。五小时窗口恢复，不代表另一项周额度也恢复。本文核对的官方资料没有给出“所有用户都在周一零点重置”的统一规则。

因此，搜“Codex 周额度重置时间”时，最有用的是本人账户周额度旁的时间，而不是别人截图里的倒计时。同样发十条消息，短问答和连续修改大型项目也可能消耗得完全不同。

## Codex 额度用完时怎么选？

先确定是否必须马上继续，以及任务是否依赖云端功能。

|方案|适合的情况|决定前看什么|
|-|-|-|
|等待重置|可以等到界面显示的恢复时间|耗尽的是短窗口、周额度还是两者|
|加购 ChatGPT credits|想继续当前工作方式且账户支持购买|本账户显示的购买条件与消耗规则|
|升级订阅|经常高强度使用且需要更高套餐的功能|持续月费、包含用量及工作区要求|
|本地改用 API|希望用兼容的本地客户端按量调用模型|API 单价、限流、功能支持与独立预算|

OpenAI 当前说明，Plus 和 Pro 用户达到使用上限后可以购买额外 credits；采用 flexible pricing 的符合条件的 Business、Edu、Enterprise 工作区也可购买工作区 credits。是否适用、怎么买，应以自己的账户选项为准。

同一份官方文档还说明：**如果在一个正在执行的 turn 中达到限额，该 turn 可以继续，但受公平使用限制约束。** 这不代表可以无限发起新任务。如果任务尚在运行，先查看并保存代码改动，再考虑重启客户端或切换计费方式。

偶尔多用一点，加购可能最省配置时间；长期持续超额，可以比较更大套餐；希望给本地任务单独算账，则适合评估 API。没有一种选择对所有人的总成本都最低。

## Codex 订阅和 API Key 到底有什么区别？

[OpenAI 鉴权文档](https://learn.chatgpt.com/docs/auth)区分了两条路径：通过 ChatGPT 登录获得订阅访问，通过 API Key 登录按使用量计费。CLI 和 IDE 扩展的本地工作支持这两种方式。**Codex cloud 仍要求 ChatGPT 登录。**

把三本账分开看：

- **ChatGPT 订阅与额外 credits：** 遵循对应 ChatGPT 账户或工作区的规则。
- **OpenAI 直连 API：** 计入这把 Key 所属的 API 组织与项目。
- **OmniaKey 自定义供应商：** 支持的请求按 OmniaKey 当前单价计入对应 Key 和余额。

有 Plus 不代表单独配置的 API 免费；充值 OmniaKey 不会重置 ChatGPT 额度。OmniaKey Key 应填入自己的 provider 配置，不能当成 OpenAI 直连 Key 使用。

如果还在比较工具工作方式，可以看 [Claude Code 与 Codex 对比](https://omniakey.com/zh/blog/claude-code-vs-codex)。本文只解决达到限额后的选择，不展开全部套餐和产品功能。

### 用独立配置在本地接入 OmniaKey

先用 `codex --version` 检查版本。**Codex CLI 0.134.0 及以上**的命名 profile 使用独立文件。保留现有主配置，将下面内容新建或谨慎合并到 `~/.codex/omniakey.config.toml`：

```toml
model = "gpt-6-sol"
model_provider = "omniakey"

[model_providers.omniakey]
name = "OmniaKey"
base_url = "https://api.omniakey.com/v1"
env_key = "OMNIAKEY_API_KEY"
wire_api = "responses"
requires_openai_auth = false
```

在启动它的本地终端中设置 `OMNIAKEY_API_KEY`，值使用自己的 OmniaKey Key，然后启动一个小任务：

```bash
codex --profile omniakey
```

[当前 profile 文档](https://learn.chatgpt.com/docs/config-file/config-advanced)明确说明，从 0.134.0 开始，`--profile` 不再读取主 `config.toml` 里的旧式 `[profiles.name]`。旧版 CLI 应先更新，或遵循对应版本的配置说明。

这个示例通过选择不同供应商切换请求路径，不要求删除已有 ChatGPT 凭据。启动后确认模型为 `gpt-6-sol`、供应商为 OmniaKey，并在 OmniaKey 用量页确认该次调用，再开始大型任务。工作区规则、项目配置和命令行覆盖项也可能影响最终设置。

这条环境变量 Key 路径不要配合 `requires_openai_auth = true`：官方说明该设置会让 Codex 忽略 `env_key`。完整步骤见 [Codex CLI 接入文档](https://docs.omniakey.com/cn/guides/codex-cli)，可用模型以[当前模型目录](https://omniakey.com/zh/models)为准。

## 改用 API 后，一笔费用怎么算？

把每次请求里的实际 Token 都算进去，不能把用户发的一条消息直接当作一次 API 调用。Agent 读文件、调用工具、重试和继续推理时，可能发起多轮请求并重复发送上下文。

OpenAI 的 [GPT-6 Sol 模型页](https://developers.openai.com/api/docs/models/gpt-6-sol)于 2026 年 10 月 30 日核验，列出**每百万输入 Token $2，每百万输出 Token $10**。假设使用 100,000 个未命中缓存的输入 Token，以及 10,000 个应计费输出 Token：

```text
(100,000 / 1,000,000 × $2)
+ (10,000 / 1,000,000 × $10)
= $0.30 USD
```

这是按 OpenAI 官方价目计算的一组 Token 成本，不是完成一次编程任务的实测账单，也不是 OpenAI 订阅价格。缓存读取另有单价；更多计费 Token、重试和适用的工具费用需要另计。[GPT-6 Sol 模型页](https://omniakey.com/zh/gpt-6-sol)展示当前 OmniaKey 价格。

比较 API 与 ChatGPT 额外 credits 时，应观察完成相同任务的实际总费用，不要把订阅消息估算强行换算为固定 Token 包。先设小预算，再看验收通过的修改和返工时间。

模型选择可以参考 [GPT-6 Sol 与 Luna 对比](https://omniakey.com/zh/blog/gpt-6-sol-vs-luna)并核对当前价格。每 Token 便宜，不保证困难任务所需的尝试次数也少。

## 常见问题

### 重启 Codex 能恢复额度吗？

重启本身不会补回服务端额度。先看账户面板；如果界面显示已恢复而客户端状态似乎没更新，先确认账户并刷新状态，再改动付费设置。

### Codex 周额度用完了还能继续吗？

查看本账户是否支持额外 credits。兼容的本地工作也可以另走 API 计费。两种选择都不意味着周额度被重置，API Key 也不会增加 cloud 权益。

### 为什么没问几次额度就没了？

可见消息数不等于实际工作量。长上下文、工具结果、推理和 Agent 多轮执行都会消耗资源。官方还说明，速度配置和图片生成可能加快额度消耗。先缩小任务范围、提供相关文件，再评估是否换更小模型。

### 已经设置 API Key，为什么仍提示限制？

先检查会话实际选择的 provider、profile、环境变量和更高优先级的覆盖项。再看完整错误：API 本身也可能触发速率、余额、项目或组织上限。如果报的是模型不可用，则看 [Codex 兼容性排查指南](https://omniakey.com/zh/blog/gpt-5-6-codex-compatibility-kit)，不要把所有问题都归因于订阅额度。

### API 是不是就能无限使用 Codex？

不是。API 按量付费，仍受供应商限流、可用余额、模型权限和适用工作区规则约束。它给本地工作提供独立计费路径，不承诺无限容量或全部 ChatGPT 功能。

## 核对来源

- [OpenAI：价格、用量限制、额外 credits 与用量面板](https://learn.chatgpt.com/docs/pricing)
- [OpenAI：登录与自定义供应商鉴权](https://learn.chatgpt.com/docs/auth)
- [OpenAI：profile 与高级配置](https://learn.chatgpt.com/docs/config-file/config-advanced)
- [OpenAI API：错误码](https://developers.openai.com/api/docs/guides/error-codes)
- [OpenAI API：限流与重试](https://developers.openai.com/api/docs/guides/rate-limits)
- [OpenAI API：GPT-6 Sol 模型与价格](https://developers.openai.com/api/docs/models/gpt-6-sol)