# Claude Code 速率限制与额度：5 小时窗口、周限额，用完怎么办

> Claude Code 订阅额度按 5 小时窗口加每周限额计算，官方不公布具体条数。用 /usage 查看剩余额度，撞限后可等自动续跑、开额外用量或用限额重置；API Key 撞的是 429。

- Source: https://www.aifreeapi.com/zh/posts/claude-code-rate-limit
- Language: zh
- Published: 2026-03-17
- Updated: 2026-10-08
- Publisher: AI Free API (https://www.aifreeapi.com)

截至 2026 年 10 月 8 日，Claude Code 有两套互不相干的限制。用 Pro、Max 或 Team 订阅登录时，拦住你的是**订阅用量限制**：一个每 5 小时重置的会话额度，加一个每周重置、所有模型共用的周限额；claude.ai 网页、Claude 桌面端和 Claude Code（终端与 IDE 插件）都从同一份额度里扣（[Anthropic 帮助中心：用量限制如何计算](https://support.claude.com/en/articles/11647753-how-do-usage-and-length-limits-work)）。用 Console API Key 或云厂商接入时，拦住你的是 **API 速率限制**：按组织层级计算的每分钟请求数和 token 数，超了返回 429（[Claude API 速率限制文档](https://platform.claude.com/docs/en/api/rate-limits)）。

订阅额度到底有多少，Anthropic 没有公布条数、token 数或小时数，只公布了套餐之间的倍数。被打断时按这个顺序处理：

1. 在 Claude Code 里运行 `/usage`，看 5 小时和每周两条用量条，以及各自的重置时间。
2. 对照下面的报错原文，确认撞的是哪一种限制。
3. 按类型选继续办法：等重置并让 Claude Code 自动续跑、开启额外用量、使用限额重置、换模型族（只对单模型限额有效）、升级套餐；API 用户则降低并发或提高层级。

## Claude Code 报错原文对照：撞的是哪一种限制

终端里的提示原文是英文，判断类型只看前半句就够了。下表的报错文字与含义来自 [Claude Code 错误参考](https://code.claude.com/docs/en/errors)，示例里的时间只是格式示意：

| 报错原文 | 撞的是什么 | 怎么继续 |
| --- | --- | --- |
| `You've hit your session limit · resets 3:45pm` | 5 小时会话额度用完，所有模型共用 | 等到显示的时间；开额外用量；有限额重置可以用 |
| `You've hit your weekly limit · resets Mon 12:00am` | 周限额用完，所有模型共用 | 换模型没用；等重置、开额外用量或用限额重置 |
| `You've hit your Opus limit` / `You've hit your Sonnet limit` | 只针对这一个模型族的限额 | 用 `/model` 换到另一个模型族就能继续 |
| `You've hit your monthly spend limit · raise it at claude.ai/settings/usage` | 套餐额度用完，额外用量也到了你自己设的月支出上限 | 在设置 > 用量里调高上限，或等窗口重置 |
| `You've hit your individual spend limit` / `org's monthly spend limit` / `team's shared budget` | Team 或 Enterprise 管理员设的支出上限 | 请管理员调高；`/usage-credits` 会向管理员发申请 |
| `API Error: Request rejected (429)` | API Key、Amazon Bedrock 或 Google Cloud 项目的速率限制，不是套餐额度 | `/status` 确认当前凭据；降低并发；提高 API 层级 |
| `API Error: Server is temporarily limiting requests (not your usage limit)` | 服务端短时限流，与你的额度无关 | 稍等重试；持续出现就看 status.claude.com |
| `API Error: Repeated 529 Overloaded errors` | 服务整体过载，不计入你的额度 | 过几分钟再试，或用 `/model` 换模型 |

最容易判断错的是前两行：会话限额和周限额对所有模型生效，用 `/model` 从 Opus 换到 Sonnet 解决不了。只有提示里点名 Opus 或 Sonnet 时，换模型族才有用。529 的完整处理办法见 [Claude 529 overloaded_error 是什么？怎么处理：先看报错来自哪一层](/zh/posts/claude-529-overloaded-error)。

## Claude Code 额度是多少：官方只给倍数，不给条数

Anthropic 的套餐说明只用相对倍数描述额度，没有给出每 5 小时多少条消息、多少 token 或每周多少小时（[Max 套餐说明](https://support.claude.com/en/articles/11049741-what-is-the-max-plan)）。一次请求实际消耗多少，取决于消息长度、附带的文件、对话已经有多长、用的模型和功能。

| 套餐（美国标价） | 每个 5 小时会话的额度 | 周限额 |
| --- | --- | --- |
| Pro（$20/月） | 基准，记作 1 | 有，所有模型共用 |
| Max 5x（$100/月） | Pro 的 5 倍 | 有，倍数未公布 |
| Max 20x（$200/月） | Pro 的 20 倍 | 有，倍数未公布 |
| Team 标准席位 | Pro 的 1.25 倍 | 每个成员单独计算 |
| Team 高级席位 | Pro 的 6.25 倍 | 每个成员单独计算 |

两点容易被误读。第一，5x、20x 说的是**每个会话**的额度，Anthropic 没有说 Max 的周限额也是 Pro 的 5 倍或 20 倍，帮助中心还写明可能用每周、每月上限或按模型、功能等其他方式限制用量。第二，"Pro 每 5 小时约 45 条""每周 40–80 小时 Sonnet"这类具体数字不在 Anthropic 的任何公开文档里，拿它们估算自己还剩多少会出错；`/usage` 里的用量条才是你自己账号的读数。

Free 计划不包含 Claude Code，想先试用再决定的情况见 [Claude Code 免费试用还有吗？2026 年现状、领取条件与下一步怎么选](/zh/posts/claude-code-free-trial)。Pro、Max 之间怎么选，[Claude Max 和 Pro 限额差在哪？5x、20x 升级后仍有周上限](/zh/posts/claude-code-pricing-pro-vs-max) 里有按月花费的比较。

## Claude Code 每周限制是怎么计算的：两个窗口叠加

订阅用户同时受两个窗口约束，任意一个用完都会被拦：

![claude.ai 网页、Claude 桌面端和 Claude Code 共用同一份订阅额度，再分成 5 小时会话额度和周限额两个窗口，各自对应 session limit 与 weekly limit 提示](https://www.aifreeapi.com/posts/zh/claude-code-rate-limit/img/two-windows.webp)

- **5 小时会话额度**：每 5 小时重置一次。终端提示里的 `resets 3:45pm` 就是这个窗口的重置时间。
- **周限额**：覆盖所有模型，每周在一个固定时间重置。这个时间是 Anthropic 分配给账号的，和你哪天开始订阅无关；下一次重置时间显示在 claude.ai 的设置 > 用量（Settings > Usage）里。
- **单模型限额**：在上面两者之外，Opus、Sonnet 还可能单独触发 `You've hit your Opus limit` 这类模型族限额。

所以"每周限制怎么算"的准确答案是：周限额按账号固定的重置时间滚动计算，网页聊天、桌面端和 Claude Code 的用量都计入；具体额度大小不公开，消耗速度主要由模型、上下文长度和工具调用决定。一周里前几天用得很猛，即使每个 5 小时窗口都还有余量，也可能先撞到周限额，这时只能等到周重置时间，或者用额外用量、限额重置继续。

## 2026 年 9 月的额度变化：周限额比促销前高 25%

今年 Claude Code 的周限额变过两次，5 小时额度也在 9 月有一次上调（[Anthropic 帮助中心：5–8 月周限额促销](https://support.claude.com/en/articles/15910845-claude-code-may-august-2026-weekly-limits-promotion)）：

| 时间 | 变化 | 适用范围 |
| --- | --- | --- |
| 2026 年 5 月 13 日 – 9 月 13 日 | Claude Code 周限额临时提高 50%，5 小时额度不变 | Claude Code 的周限额 |
| 2026 年 9 月 14 日起 | Claude Code 周限额永久比促销前高 25% | Pro、Max、Team、按席位计费的 Enterprise；Free 和按用量计费的 Enterprise 不含 |
| 2026 年 9 月 22 日 | Opus 5.5 发布，同时上调 5 小时额度，并给订阅用户发了一次限额重置 | Pro、Max、Team、按席位计费的 Enterprise |

如果你在 9 月中旬后感觉周限额"变少了"，原因是对比对象：促销期是促销前的 1.5 倍，现在是 1.25 倍，1.25 ÷ 1.5 ≈ 0.83，也就是比促销期低约 17%，但仍比促销前高 25%。9 月 22 日 5 小时额度上调了多少，[Opus 5.5 发布公告](https://www.anthropic.com/claude-opus-5-5) 没有给出幅度。

## Claude Code 额度怎么查看：/usage 和设置 > 用量

**在 Claude Code 里**：运行 `/usage`（别名 `/cost`、`/stats`）。Pro、Max、Team、Enterprise 订阅用户能看到 5 小时和每周的用量条、各自的重置时间，以及一份用量拆分（[Claude Code 成本文档](https://code.claude.com/docs/en/costs)）：

- 用量分别来自哪些技能、子代理、插件和 MCP 服务器；
- 长上下文、缓存未命中这类行为占到近期用量 10% 以上时会被单独标出；
- 最耗额度的 `/loop` 或定时任务；
- 按 `d`、`w` 在最近 24 小时和最近 7 天之间切换。

这份拆分只根据**本机**的会话记录估算，不包括其他电脑和 claude.ai 网页上的用量；顶部 Session 区块的美元金额是给 API 用户看的，对订阅计费没有意义。开启额外用量后，`/usage` 还会多出一行本月额外用量支出。

**在网页或桌面端**：claude.ai 的设置 > 用量显示同一份额度的剩余比例、周限额的下次重置时间、可用的限额重置，以及额外用量的开关和月支出上限。

**确认走的是哪种计费**：运行 `/status` 看当前生效的凭据。如果环境里设置了 `ANTHROPIC_API_KEY` 并被批准使用，Claude Code 会改用这把 Key，按 API 计费并受 API 速率限制，而不是用订阅额度（[Claude Code 认证文档](https://code.claude.com/docs/en/authentication)）。想回到订阅，执行 `unset ANTHROPIC_API_KEY` 后再用 `/status` 确认。

## Claude Code 额度用完怎么办：五种官方办法

撞到订阅限额后，Anthropic 提供的继续办法只有下面几种。运行 `/rate-limit-options` 会列出当前可用的选项。

![额度用完后的判断流程：提示点名 Opus 或 Sonnet 时用 /model 换模型族；会话或周限额则在等重置续跑、限额重置、额外用量和升级套餐中选择；429 与 529 不属于套餐额度](https://www.aifreeapi.com/posts/zh/claude-code-rate-limit/img/after-limit-flow.webp)

### 等待重置并让 Claude Code 自动续跑

Claude Code v2.1.234 及以上，用 claude.ai 订阅登录的交互式会话默认开启自动续跑：任务被额度打断后，会话底部显示 `Continuing automatically at 3:45pm · esc to cancel`，到点后 Claude 从中断处接着做，不会重发你的上一条消息（[交互模式文档](https://code.claude.com/docs/en/interactive-mode#wait-for-a-usage-limit-to-reset)）。

使用时注意几点：

- 会话要保持打开；退出 Claude Code 后再恢复，等待不会重新开始。
- 重置时间在 24 小时以外（周限额常见）时，Claude Code 不会自动开始等待，需要在 `/rate-limit-options` 里选 **Wait here, then continue automatically**。
- 续跑后如果马上又撞限，最多自动重来两次，之后停下并提示 `Automatic continue stopped after repeated usage-limit hits`。
- 按 `Esc` 或在 `/rate-limit-options` 里选 **Don't continue automatically** 可取消。
- Claude 桌面端的 Code 标签页里对应的选项是 **Auto-continue when limits reset**。

### 使用限额重置（Reset for free）

Anthropic 会不定期给符合条件的套餐发放限额重置，用一次可以把 5 小时会话额度或周限额恢复满（[什么是限额重置](https://support.claude.com/en/articles/17007452-what-is-a-limit-reset)）。

- 只能在 claude.ai 网页或 Claude 桌面端的设置 > 用量里点 **Reset for free** 使用，Claude Code 终端、IDE 插件和手机端都不能用。
- 用了不能撤回；周限额照常按原定时间再重置一次。
- 没用掉的重置会在页面显示的日期过期；它也不会退还已经扣费的额外用量。
- 9 月 22 日随 Opus 5.5 发放的那次重置，据 Anthropic 员工发帖和应用内显示有效期到 2026 年 10 月 22 日，以设置 > 用量页显示的到期日为准；降级或取消订阅前没用掉就会作废。

发放次数和资格条件没有公开，设置 > 用量里看不到重置按钮，就是当前没有可用的重置。

### 开启额外用量，按 API 价格继续

Pro 和 Max 可以开启额外用量（usage credits），套餐额度用完后按 API 标准价继续计费，与订阅费分开结算（[付费套餐的额外用量](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans)）：

- 在设置 > 用量开启，先充值（Add funds），可选自动续充；月支出上限可以设一个金额，也可以不设上限。每天最多兑换 $2,000。
- 在 Claude Code 里运行 `/usage-credits` 会直接打开这个设置页；用 API Key 登录时没有这个命令。
- 预付折扣包：$45 买 $50 用量，$200 买 $250，$700 买 $1,000。
- 截至 2026 年 10 月 8 日的标准价（每百万 token，输入/输出）：Sonnet 5.5 $2/$10，Opus 5.5 $4/$20，Fable 5.1 $10/$50。
- 支出达到月上限而余额还有剩时，Claude Code 会在终端里提示你调高或取消上限，对应前面表格里的 `monthly spend limit` 报错。

### 撞到 Opus 或 Sonnet 限额时换模型族

只有提示里点名 `Opus limit` 或 `Sonnet limit` 时，用 `/model` 换到另一个模型族才能继续，对话不会丢。Claude Code 里 `opus` 对应 Opus 5.5、`sonnet` 对应 Sonnet 5.5、`haiku` 对应 Haiku 5.5，`opusplan` 用 Opus 5.5 做规划、Sonnet 5.5 执行（[模型配置文档](https://code.claude.com/docs/en/model-config)）。各档模型的能力和价格差异见 [Opus 5.5 和 Fable 5.1 怎么选？Claude 四档模型的价格与能力边界](/zh/posts/claude-sonnet-vs-opus-vs-haiku-vs-fable)。

### 经常撞限：升级套餐

Pro 经常撞 5 小时额度，可以考虑 Max 5x（每个会话是 Pro 的 5 倍）；Max 5x 还不够再考虑 Max 20x。升级只放大套餐倍数，周限额依然存在，是否划算要拿你每月实际花在额外用量上的钱来比，具体算法见 [Claude Max 和 Pro 限额差在哪？5x、20x 升级后仍有周上限](/zh/posts/claude-code-pricing-pro-vs-max)。

### 第三方中转不能解决订阅限额

除了上面这些，Anthropic 没有提供其他越过套餐额度的办法。把 `ANTHROPIC_BASE_URL` 指向其他服务商后，请求根本不走你的订阅，费用、可用模型和限流规则都由那家服务商决定；它换掉的是计费渠道，不会让你的 Pro 或 Max 额度变多。

另外，中国大陆和香港不在 Anthropic 的[支持国家和地区列表](https://www.anthropic.com/supported-countries)里。

## API Key 用户的 429：RPM、ITPM、OTPM 按层级计算

用 Console API Key 运行 Claude Code 时，额度换成了按组织计算的三项每分钟上限：请求数（RPM）、输入 token 数（ITPM）和输出 token 数（OTPM），每个模型类别分开计算。截至 2026 年 10 月 8 日的标准层级（[Claude API 速率限制文档](https://platform.claude.com/docs/en/api/rate-limits)）：

| 模型类别 | Start（RPM / ITPM / OTPM） | Build | Scale |
| --- | --- | --- | --- |
| Opus 5.5、Sonnet 5.5、Haiku 5.5（各自独立） | 1,000 / 2,000,000 / 400,000 | 5,000 / 5,000,000 / 1,000,000 | 10,000 / 10,000,000 / 2,000,000 |
| Fable 5.x | 1,000 / 500,000 / 100,000 | 2,000 / 1,500,000 / 300,000 | 4,000 / 4,000,000 / 800,000 |
| 每月支出上限 | $500 | $1,000 | $200,000 |

读这张表要注意：

- 新组织可能从更低的 Evaluation 层级起步，自己组织的实际上限以 Console 里的 Limits 页为准。
- 当前模型的缓存读取不计入 ITPM，提示缓存命中率越高，同样的 ITPM 能处理的上下文越多。
- 普通 429 会带 `retry-after` 头，按它等待即可；因月支出上限触发的 429（`enforced_spend_limit_reached`）不带这个头，等多久都不会恢复，要提高上限或升级层级。
- 首次用 Console 账号登录 Claude Code 时会自动建一个名为 "Claude Code" 的工作区，它的流量计入组织总速率限制；可以在这个工作区的 Limits 页单独设上限，避免挤占生产服务。

在 Claude Code 里频繁遇到 429 时，先用 `/status` 确认用的是你预期的凭据，再降低并发：调低环境变量 `CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY`、少开并行子代理，脚本化的大批量任务用 `/model` 换小模型。

## Claude Code 额度为什么掉得快：长上下文、缓存失效和子代理

同样一句话，在开了一整天的会话里比在新会话里贵得多。[Claude Code 成本文档](https://code.claude.com/docs/en/costs) 列出的主要原因：

- **长上下文**：每次请求都会重发整段对话，工具调用的结果也会再发一次；会话越长，每个问题消耗越多。
- **缓存失效**：离开超过缓存有效期后的第一条消息要重新处理全部上下文。订阅额度内缓存有效期是 1 小时，开始消耗额外用量后降到 5 分钟，API Key 默认也是 5 分钟。
- **后台任务**：定时任务和 `/loop` 在你没操作时也会按间隔带着完整上下文运行。
- **子代理和 Agent Teams**：每个子代理单独发请求；队友在规划模式下运行时，Agent Teams 的 token 用量约为普通会话的 7 倍。
- **模型选择**：Opus 每一轮的消耗是 Sonnet 的数倍，Sonnet 又高于 Haiku。从 v2.1.280 起，Pro 上 `default` 解析为 Opus 5.5，从没手动选过模型的 Pro 用户其实一直在用 Opus。
- **非交互调用**：`claude -p` 和 Agent SDK 同样从订阅额度里扣。

对应的省额度办法：

1. 换任务时用 `/clear` 开新会话（不耗额度）；同一任务中途用 `/compact` 压缩，但压缩本身也是一次大请求。
2. 日常编码用 `/model sonnet`，只在复杂架构或多步推理时切回 Opus；子代理在配置里指定 `model: haiku`。
3. 简单任务用 `/effort` 调低推理强度。
4. 用 `/mcp` 关掉不用的 MCP 服务器，能用 `gh` 这类命令行工具的就不用 MCP。
5. 定期看 `/usage` 的拆分，哪一项被标出占比超过 10%，就先处理哪一项。

## Claude Code 额度相关问答

### Claude Pro 额度是多少，有多少 token？

Anthropic 没有公布 Pro 每 5 小时或每周有多少 token、多少条消息，只说明了 Max 5x、Max 20x 每个会话分别是 Pro 的 5 倍和 20 倍。同一份额度能用多久，取决于模型、对话长度、附件和工具调用。想知道自己还剩多少，看 `/usage` 或设置 > 用量里的百分比。

### "You've used 90% of your session limit" 是什么意思？

这是 5 小时会话额度的提醒：当前窗口已经用掉约九成，还没被拦。剩下的一成在长会话里可能几轮就用完。可以先把当前任务收尾，或者提前开启额外用量；真正撞限时，提示会变成 `You've hit your session limit`，并附上重置时间。

### Claude Code 的并发限制是多少？

订阅套餐没有公布并发数量。同一账号开多个 Claude Code 会话、跑多个子代理都可以，但它们共用同一份 5 小时和每周额度，并行越多用得越快。用 API Key 时，限制是组织级的 RPM、ITPM、OTPM，同一组织下所有 Key 和工作区共享，并发过高就会收到 429。

### 换成 Sonnet 能解除周限额吗？

不能。会话限额和周限额覆盖所有模型，换模型不会恢复。只有提示是 `You've hit your Opus limit` 或 `You've hit your Sonnet limit` 时，换到另一个模型族才能继续。不过平时用 Sonnet 能让同一份周限额撑得更久。

### Claude 529 overloaded 会扣我的额度吗？

不会。529 表示服务整体过载，Claude Code 已经自动重试过几次，这次失败不计入你的额度。过几分钟再试，或用 `/model` 换个模型（容量按模型分别计算）。持续出现时看 status.claude.com。

### 从 Pro 升级到 Max 后，本周额度会马上重置吗？

公开文档没有写升级会不会立即重置当前的 5 小时或周计数。升级费用按当期剩余天数折算。如果手里还有没用的限额重置，降级或取消订阅前先用掉，否则会作废。