重构到一半蹦出“usage limit reached”,没什么比这更打断节奏了。其实只要看得见,Claude Code 的额度是完全可以预判的。本文讲清楚额度窗口的规则、内置的查看方法,以及怎么在 Mac 上让额度一直显示在眼前。
Claude Code 用量限制的规则
在 Claude 订阅套餐下,Claude Code 的用量按时间窗口计算,而不是按 token:
- 当前会话(5 小时窗口)。 从你发出第一条消息开始,计入一个约 5 小时的滚动窗口。窗口重置后,你又有一整个窗口可用。
- 每周额度。 独立的一项限制,统计 7 天内所有模型的用量。
- 特定模型的每周额度。 部分套餐还对特定模型(比如 Opus)单独设了每周额度。
Anthropic 没有公布具体数字,额度也取决于你的套餐:Max 5x 和 Max 20x 的单次会话额度分别是 Pro 的 5 倍和 20 倍。同一账号下的 Claude 聊天也共用这份额度。你也可以在网页版 claude.ai 的 设置 → 用量 里查看。实际要记住的是:有两个时钟,5 小时那个决定你这个下午,每周那个决定你这一周。
如果你用 API key 而不是订阅来跑 Claude Code,就是按 token 付费,不受这些窗口限制;花了多少钱可以在 Anthropic Console 里查。
在 Claude Code 里查看用量
在 Claude Code 里运行:
/usage
它会显示当前会话和每周额度各用了多少、什么时候重置。数据很准,但你得记得去查,而且只有盯着那个终端时才看得到。
在 Mac 上让额度一直可见
Vibe Console 会一直显示 Claude Code 和 Codex 的用量,不用敲任何命令:
- 刘海和工具栏里的圆环。 每个服务商一个圆环,显示当前窗口用了多少。还可以打开一圈更细的第二道弧线显示每周额度(设置项:关闭、内侧或外侧)。
- 悬停查看详情。 卡片会列出当前会话、所有模型的每周额度,以及 Opus、Sonnet 等特定模型的额度,每项都带重置时间。
- 提醒。 额度超过 80% 时发一条 macOS 通知,到 100% 再发一条,每个窗口只提醒一次。额度重置时,刘海卡片和提示音会告诉你可以继续了。不关心的服务商可以静音。
- 菜单栏。 可以选择在菜单栏里显示指定服务商的额度,代替图标。
工作期间用量每分钟刷新一次,点一下圆环可以立即刷新。
数据从哪来
为了显示你的 Claude 用量,Vibe Console 会读取你 Mac 上 Claude Code 的登录信息,向 Anthropic 查询用量,数据和 /usage 显示的一样。macOS 会询问你一次是否允许。登录信息留在你的 Mac 上,只会发给 Anthropic。读取哪些服务商,由你在 设置 → 账号 里决定。详情见我们的 隐私政策。
Codex 用量限制
Codex 套餐同样按一个主 5 小时窗口和一个每周窗口计量。Vibe Console 用同样的方式把它显示在 Claude 旁边,哪个 Agent 还有余量,就把活挪给哪个。
怎么让额度撑得更久
- 结合重置时间看百分比。 窗口只剩一小时、用了 60%,没问题;刚开始十分钟就用了 60%,就有问题了。
- 简单的活用轻量模型。 最大的模型留给规划和难题。
- 保持上下文精简。 长对话及时清空或压缩,让 Agent 只看相关文件,而不是整个仓库。省 token 的 Skill 也有帮助,参见 安装 Agent Skill。
- 围绕窗口安排并行工作。 几个 Agent 同时跑,窗口消耗也会快好几倍。参见 并行运行 Agent。
- 把活分给不同服务商。 Claude 快到上限而 Codex 还有余量时,把审查或小任务交给 Codex。
常见问题
Claude Code 的额度窗口有多长?
会话窗口从你的第一条消息起约 5 小时,另外还有独立的每周额度。具体重置时间可以用 /usage 或圆环的悬停卡片查看。
额度用完了会怎样?
Claude Code 会提示你已达到会话或每周额度上限,以及什么时候重置。对这两种额度来说,换模型没用;但如果是 Opus 这类特定模型的额度用完,换模型就有用。想继续干活,可以等重置、升级套餐,或者运行 /usage-credits 用用量积分继续。
Vibe Console 会改变我的额度吗?
不会。它只负责读取和显示,额度由你的套餐和 Agent 决定。
免费试用 14 天:下载 Vibe Console。
