Claude Code 第一次因为用量提示停下来,通常是在最糟糕的时刻:重构进行到一半,agent 的上下文里还装着计划,而现在只能等待。第二次发生时,你就会开始想:这个限制到底是怎么运作的,我离它还有多远,有没有办法提前看到它的到来。
本指南解释 Claude Code 用量限制的形态,但不会假装知道确切的数字。Anthropic 按套餐设定配额,并且已经调整过:任何引用具体数字的文章都只是一张快照。保持不变的是模型:窗口、重置,以及让你避免麻烦的习惯。
用量窗口如何运作
当你通过 Claude 订阅使用 Claude Code 时,用量是按窗口计算的,而不是按月度额度。实际中你会遇到两种:
- 5 小时窗口。从你的第一个请求开始,大约 5 小时后重置。它用于限制短时间内的集中使用:即使整周的用量没问题,一个忙碌的上午也可能把它用满。
- 每周窗口。它为更长时间内的总用量设置上限。即使 5 小时窗口还有余量,只要本周额度用完,你也会被停下。
- 按模型区分的每周限制。有些套餐为最大的模型单独设置了每周额度,所以切换模型可能会改变你消耗的窗口。
每个窗口能容纳多少,取决于你的套餐、使用的模型和上下文长度。上下文里装着大文件的长会话,每条消息的成本比短小、专注的会话更高。当前的具体数字以 Anthropic 的页面为准;其他一切,包括本文,都只应被看作对形态的描述。
为什么 agent 工作流更快触及限制
聊天和 agent 是两种不同的工作负载。agent 会在你的一个提示词里读取文件、运行命令、读取输出,然后再来一遍。有几个因素会放大这一点:
- 并行会话。在三个 worktree 里运行三个 agent,会以三倍速度消耗一个账号。
- 长上下文。从早上开始的会话会在每一轮都带着历史记录,直到被压缩。
- 子 agent。委派出去的工作依然计入同一个账号。
- 重试循环。卡在失败测试上的 agent 可能在毫无进展的情况下耗尽一个窗口。
这并不意味着你应该停止并行运行 agent。它意味着用量变成了一个运维问题,就像磁盘空间或 CI 时长一样,值得有一个仪表盘。并行 agent 指南介绍了什么时候并行值得额外的消耗。
不靠猜测地追踪用量
Claude Code 本身可以在会话中告诉你用量和限制。对一个会话来说这很好用。但当你有多个会话、多个 worktree 或多个账号时就不太行了,因为信息被困在各个终端里,它的状态视图也只是单个会话的快照。
Nethür 走的是另一条路:它读取每个 agent 保存在磁盘上的本地用量状态(Claude Code 在 ~/.claude,Codex 在 ~/.codex,Gemini CLI、OpenCode 等也有对应位置),并显示在状态栏中。没有额外的 API 调用,也没有额外的认证。用量弹出面板列出每个被追踪的提供商,包括套餐、各窗口的进度条和下一次重置时间,并按最紧的限制排在前面;一旦某个窗口超过 80%,就会出现提醒。
因为它读取的是 agent 写下的内容,所以显示不会比 agent 自己的记录更新。它在 agent 记录用量时更新,而不是每次按键时。显示了哪些窗口和提供商,详见用量追踪文档。
围绕重置做计划
一旦窗口可见,你就可以据此做计划。5 小时窗口是你能塑造的那个,因为它从你第一次使用时开始。如果你当天的第一个请求在上午 11 点,窗口会在下午三四点重置,而那可能正是你想处理最繁重工作的时候。
- 窗口预热。你选好时间,Nethür 会向最便宜的模型发送一个极小的请求,提前开启每个 Claude 和 Codex 账号的 5 小时窗口,让它在你真正需要时重置。
- 停止阈值。为 5 小时窗口和每周窗口分别设置一个百分比。当某个聊天所用的账号超过阈值时,Nethür 会暂停这个聊天,为最重要的工作保留余量。
- 在重置时恢复。触及限制时,聊天可以在最近一次重置时自动恢复,而不用等你注意到。
多个账号和提供商
很多开发者拥有不止一个订阅:个人和工作的 Claude 套餐,或者一个 Claude 套餐加一个 Codex 套餐。通过退出再登录来切换既慢,又会打断正在运行的会话。Nethür 将每个账号分开保存,点一下就能切换当前账号;新会话使用新账号,已经在运行的会话会一直使用启动时的账号,直到重新启动。其工作方式见账号热切换,同样适用于 Claude Code。
你还可以为订阅设置优先级。当某个提供商的账号都触及限制时,聊天会带着完整对话切换到下一个提供商。如果全部耗尽,它会在最近一次重置时自动恢复。请只使用你有权使用的账号,也就是你自己的个人和工作套餐,并遵守各提供商的条款。
应对限制的几种方式对比
| 方式 | 可见性 | 触及限制前 | 触及限制时 |
|---|---|---|---|
| 等提示出现 | 在停下之前毫无可见性 | 无 | 等待重置,然后重建上下文 |
| 在每个会话里查看 | 一次一个会话 | 手动查看 | 通过退出再登录切换账号 |
| 状态行或追踪脚本 | 一个账号、一台机器 | 屏幕上的一个数字 | 依然手动 |
| Nethür | 所有被追踪的提供商和账号集中在一个弹出面板 | 提醒、停止阈值、窗口预热 | 账号热切换、提供商故障转移、在重置时恢复 |
需要避免的陷阱
- 相信旧数字。套餐限制会变。查看你当前的套餐,而不是上个季度的论坛帖子。
- 忽略每周窗口。如果本周额度已用完,新的 5 小时窗口也帮不上忙。两个都要关注。
- 让卡住的 agent 一直运行。在同一个失败上循环的 agent 会白白消耗用量。停下它,读一读错误,再给它一个更好的提示词。
- 从不压缩。长会话每一轮的成本更高。任务变化时,开一个新会话或进行压缩。
- 把成本估算当成账单。任何来自本地状态的成本数字都只是估算,以提供商控制台为准。
关于团队
在团队中,限制应该属于个人,而不是一把共享的密钥。在 Nethür 中,每个成员都用自己的订阅登录,所以用量、限制和故障转移都按账号计算,一个人忙碌的一天不会让别人停下来。Nethür 不转售模型访问;它只是让你看到自己的账号在做什么。当有人接手队友的会话时,会话会保留原来的提供商和账号,因此它消耗的是谁的用量一目了然。其余内容见团队指南。
一个简单的习惯
在开始繁重任务之前查看用量,而不是之后。在你了解自己的工作消耗窗口有多快之前,只运行两个 agent,而不是五个。在你最高效的时段之前预热窗口,设置一个为紧急工作留出余量的停止阈值,并为第一个账号耗尽的日子准备好第二个账号或提供商。一旦你能看到限制,它就不再是意外。



