目录
当你终于在 Claude Code 里进入状态时，突然被这样一句话打断、双手停了下来：
Claude usage limit reached.
Your limit will reset at 3pm (America/New_York).「你已经暂时用完了当前套餐所允许的额度。」这既不是错误也不是 bug，而是 Pro / Max 订阅使用量限制的设计方式。让人头疼的地方在于，为什么这么快就用完、什么时候恢复、在恢复之前能做些什么并不直观。本文将基于官方信息，梳理限制的二层结构（5小时＋每周）、什么在吞噬额度、撞到上限的那一刻该怎么办、如何查看剩余额度，以及 API 这条退路。
先给出3个结论。① 限制分为两层：「滚动的5小时窗口」和「每周窗口」（Max 还另有一个仅针对 Opus 的每周额度）。② 消耗最大的是模型选择——Opus 吃掉额度的速度远快于 Sonnet。 ③ 不能等待时的正确做法是「降到 Sonnet／精简上下文／切换到按量付费的 API」。 需要注意的是，显示的时间和各套餐的具体额度会随版本和时期变化，因此数值请务必在最新的官方界面（/usage 或 Settings → Usage）中确认。
使用量限制是「两层楼高」
— 只要撞到其中一层就会停下
Claude Code 与 Claude 应用（web/desktop）共享同一套餐的额度。
※仪表数值仅为示意。实际剩余量请用 /usage 与 Settings → Usage 确认。
1. 这条提示到底在说什么
典型的提示是这样的（措辞因版本而异，仅作大致参考）：「Claude usage limit reached. Your limit will reset at [时间] ([时区]).」 含义很简单：「你已用完本时段内套餐允许的额度。到 [时间] 后会恢复。」 时区采用的是你的本地设置。
关键在于，这是设计如此，而非故障。 Claude 的 Pro / Max 套餐并非「无限量」——每个时间窗口、每周都有用量上限。而且 Claude Code（CLI）与 Claude 应用（web/desktop）共享同一套餐的额度——官方帮助明确指出「两个工具中的所有活动都计入同一套使用量限制」。所以 「既用了聊天又跑了 Claude Code，两者合起来更快用完」是再正常不过的事。
还有一点要知道：上限有「5小时」和「每周」两种。 如果显示的 reset at 在几小时之后，说明你撞到了5小时窗口；如果在几天之后，那就是撞到了每周窗口。撞到哪一个，决定了你的等待时间和可选对策。下一节来梳理结构。
2. 限制的二层结构——5小时＋每周（＋Opus额度）
2025年8月，Anthropic 在原有的5小时窗口之上，为 Pro / Max 增加了每周使用量上限（起因是重度用户持续不停地运行）。结果，如今的订阅限制变成了两层楼高。
两个窗口各自独立生效
各套餐的区别在于同一结构上的「倍率」：Pro < Max 5x < Max 20x。
※每周的具体小时数会随时间修订。不要把固定数值记死——请读取 Settings → Usage 的实际值。
作为最初（2025年8月）的指引，Anthropic 给出过诸如「Pro：每周约40-80小时的 Sonnet」「Max 20x：每周约240-480小时的 Sonnet ＋约24-40小时的 Opus」这样的粗略估算。不过，此后 Anthropic 基本上已不再公布固定的小时数，限制也被反复修订（即便进入2026年，也有关于5小时窗口上调的报道）。因此请把这些数值当作「当时的估算」，并始终在官方用量界面中确认你当前的额度。本文也有意不去断言具体的现行数值。
3. 什么在吃掉你的额度
「比预想中更快用完」几乎都可归结为以下4点，按影响大小排序。
| 因素 | 为什么吃额度 | 有效对策 |
|---|---|---|
| ① 模型选择（最大因素） | Opus 的消耗远高于 Sonnet/Haiku。文档直言 Opus「会消耗显著更多的额度」。在 Max 上它甚至还有自己的每周额度 | 用 /model 把日常工作放到 Sonnet/Haiku 上；把 Opus 留给难题 |
| ② 上下文大小 | 每一轮都会重新处理整段对话＋附件文件＋工具定义＋历史记录。越大，每轮消耗越多 | /compact、/clear、少附文件、缩小 CLAUDE.md |
| ③ 长时间、连续会话 | 一直挂着、无休止地循环。每周上限正是针对这种模式 | 用 /clear 把工作分段；停掉不必要的自动循环 |
| ④ 子代理／MCP | 并行扇出和 MCP 服务器会增加工具定义和工具调用的流量 | 精简启用的 MCP 服务器。/usage 会显示按 MCP/子代理的明细 |
简而言之，模型越重、上下文越大、运行越长越并行，额度就消融得越快。 反过来说，有意识地把这4点压下去，同一套餐能明显更耐用。 整体优化可参阅 AI 编程的成本优化，具体的省 token 技巧可参阅 Claude Code 的 token 节省。
4. 立刻继续工作的5种办法
撞到上限那一刻的5个对策，按情况划分。 选哪一个，取决于「你能等吗？」和「你撞到的是哪个窗口？」。
撞到上限时
/model 切到 Sonnet/Haiku。如果只是 Opus 额度用光，这样往往能立刻继续。/compact／/clear 降低每轮消耗，让所剩无几的额度更耐用。reset at，趁这段时间做别的工作。有截止期限？D。
5小时窗口等一等就会回来，所以先用 A/B/C 撑过去。如果连每周额度也用光了，D（API）或 E 才是现实的答案。
把 API 切换（D）当作「退路」记在心里很有用。与订阅的时间窗口锁定不同，API 有每分钟的吞吐限制，但绝不会「把你锁住一整周」（用多少付多少）。参见 什么是 AI API。另外，Pro / Max 用户也可以启用「用量额度」，在超出所含额度后按标准 API 费率继续（需要明确同意）。
5. 如何查看剩余额度
只要能看到「还剩多少」，就完全可以避免撞到上限。三种查看方式。
① Claude Code 的 /usage：按模型显示当前5小时窗口的消耗和每周窗口的状态。2026年的一次更新增加了按技能／子代理／插件／MCP 服务器划分的明细。/status 也会呈现你的额度分配情况。② Web/桌面应用：Settings → Usage 显示你的套餐、剩余用量以及每周重置日期。③ API 用户：Console 的 Usage / Limits 页面，以及响应中的 anthropic-ratelimit-* 标头。/cost（供 API key 用户使用）和 /context 可追踪花费与上下文大小。
养成会回报的习惯
在繁重工作前先跑一次 /usage，掌握你的剩余量和重置日期。在每周额度即将告急的那一周，从一开始就围绕 Sonnet 来安排，把 Opus 的余量留到关键时刻。
6. 订阅限制 vs API限制
这两者很容易混淆，但订阅（Pro/Max）限制和 API 限制是完全不同的体系。 弄清区别，关键时刻的切换决策就会很快。
| 方面 | 订阅（Pro / Max） | API（按量付费） |
|---|---|---|
| 限制单位 | 每个时间窗口的总量（5小时＋每周） | 每分钟吞吐量（RPM／每分钟输入＋输出 token） |
| 撞到时 | 锁定直到重置 | 返回 429；等待 retry-after 秒后即可继续（没有每周锁定） |
| 如何提高 | 升级套餐、购买额度 | Tier 1-4 按累计花费自动解锁 |
| 适合谁 | 个人对话、日常编程 | 无法中断的自动化、大批量任务 |
要点在于：订阅按时间把你锁住，而 API 只限制每分钟的流量、没有每周锁定。 所以对于真的无法停下的截止期限工作，切换到 API key 就是标准做法。API 速率限制的细节（429、retry-after、Tier）值得另写一篇，但请把它记作订阅用尽时现实的退路。
7. 预防清单
一份杜绝「关键时刻用光」的运营清单。
① 默认用 Sonnet，只在难点处用 /model 切到 Opus（保留 Opus 的每周额度）。② 频繁使用 /compact／/clear 让上下文保持轻量。③ 繁重工作前用 /usage 确认剩余量和重置日期。④ 停掉不必要的 MCP 和自动循环；只附上需要的文件。⑤ 有截止期限的日子，提前备好按量付费的 API（这样订阅用光也不会卡住）。⑥ 如果长期不够用，可考虑升级套餐，或把那部分工作负载迁移到 API。
总结
Claude Code 的 「Claude usage limit reached」不是错误——而是 Pro/Max 订阅使用量限制的设计方式。限制是两层楼：「滚动的5小时窗口」＋「每周窗口」，而且 Max 还另有仅针对 Opus 的每周额度。 由于 Claude Code 与 Claude 应用共享同一套餐的额度，两者合起来会更快用完。如果 reset at 在几小时之后就是5小时窗口；几天之后则是每周窗口。
消耗最大的是模型选择（Opus 最高），其次是上下文大小、长时间连续运行，以及子代理/MCP。 撞到上限时：A：降低模型 -> B：精简上下文 -> C：等待重置，如果不能等，就 D：切换到按量付费的 API ／ E：增加额度或升级。 用 /usage 和 Settings -> Usage 查看你的剩余量。此外，由于具体数值会随时间修订，别去死记——请在最新的官方界面确认。相关：token 节省与额外费用、Opus/Sonnet/Haiku 价格比较、Claude Code 错误集锦。
FAQ
Q. 「usage limit reached」是 bug 吗？我可是付了钱的。
A. 这是设计如此，不是 bug。 Pro / Max 并非「无限量」——每个5小时窗口、每周都有用量上限。即便你是付费用户，一旦超出该窗口允许的额度，也会被暂时暂停；到显示的 reset at 时间就会恢复。注意 Claude Code 和 Claude 应用共享同一额度，因此两者都用会更快用完。
Q. 什么时候重置？它显示「reset at 3pm」。
A. 那是 5小时窗口的重置时间（你的本地时间）；几个小时就会恢复。如果它显示的是「几天之后」，那就是撞到了每周窗口，你可以在 Settings → Usage 找到下次的每周重置日期。如果连每周额度都用光了，你的选择是等待、切换到按量付费的 API，或者升级。
Q. 为什么我这么快就撞到上限？
A. 最大的因素是模型选择。Opus 吃掉额度的速度远快于 Sonnet，而且在 Max 上它有一个会最先耗尽的独立每周额度。在此之上，大上下文、长时间连续运行，以及大量使用子代理或 MCP 都会推高消耗。仅仅是用 /model 把日常工作降到 Sonnet、用 /compact 精简上下文，就会带来很大不同。
Q. 不等待的话，怎样才能现在就继续？
A. ① 用 /model 降到 Sonnet/Haiku（在只有 Opus 额度用光时有效），② 切换到按量付费的 API key（不受每周锁定），③ 启用用量额度（超出所含额度后按标准 API 费率继续），④ 升级套餐（Pro 到 Max）。对于截止期限工作，提前备好按量付费的 API 是稳妥之选。
Q. 我能查看还剩多少吗？
A. 可以。在 Claude Code 中使用 /usage（按模型显示5小时和每周窗口，外加按 MCP/子代理的明细）和 /status。在 Web/桌面应用中，Settings → Usage 显示你的套餐、剩余用量和每周重置日期。在繁重工作前查看一次，就能避免撞到上限。
