在 Claude Code 的输入框中输入 /usage,先找到套餐用量条的名称、已用百分比和重置时间,再对照当前报错。能否继续使用,取决于此次请求涉及的所有额度是否允许;五小时额度恢复了,周限额仍可能挡住请求。
截至 2026 年 9 月 8 日,官方命令表把 /cost 列为 /usage 的别名,/stats 也进入同一界面,但默认打开统计页。把三个命令理解成三个互不相关的计费系统,已经不符合当前文档。Claude Code 命令参考
打开 /usage 后,先找你真正要看的数字
/usage 是 Claude Code 内的斜杠命令。在对话输入框开头输入并执行,不是在 zsh、Bash 或 PowerShell 中单独运行。实际可用命令和显示内容受客户端版本、平台、套餐及登录方式影响。
如果目的是判断“还能不能继续写代码”,按下面的顺序读:
| 看到的区域 | 它回答什么 | 应该怎样使用 |
|---|---|---|
| 套餐用量条:当前时段、每周、特定模型等 | 哪个额度窗口已用了多少、何时重置 | 对照当前报错,找到真正阻止请求的那一条 |
| Session 中的成本和 token | 这次会话产生了多少 token、估算成本是多少 | 用于了解任务消耗;Pro/Max 用户不能把这个美元数直接当作额外账单 |
| 本机用量归因和活动统计 | 最近在这台机器上的用量主要花在哪里 | 用于解释任务消耗,不能据此推算整个账户还剩多少额度 |
| Usage credits | 启用后,本月额外使用的支出及适用支出上限 | 与订阅内的五小时、周额度分开读 |
Session 成本是本地估算值。当前版本中,/clear 会让新会话的成本重新从零计,但不会补回套餐额度;这一成本清零行为从 v2.1.211 起生效。用量归因里的 d / w 指最近 24 小时 / 7 天的本机历史,不包含其他设备或 claude.ai,也不是额度重置周期。官方用量与成本说明
Usage credits 一行出现 Unlimited 时,也要先读它所属的区域:对未设月支出上限的 Pro/Max 用户,这表示该处没有设置支出上限,并不代表获得了免费无限额度。Usage credits 显示规则
五小时和周限额怎么一起读
在 claude.ai 的 Settings → Usage 中,可以核对套餐当前五小时时段、每周用量及各自的重置时间;具体有哪些用量条,以你的账户显示为准。按用量计费的 Enterprise 不宜套用个人订阅的整套读法。官方用量页面说明
看每一条时,连续确认三件事:这是哪个窗口、百分比表示已用还是剩余、旁边的时间属于哪一条。不要把五小时和周用量相加,也不要把较早的重置时间当成所有额度恢复的时刻。
下面是为了说明读法而构造的例子,不是真实账户测量:
| 用量条 | 已用 | 显示的重置时间 | 应怎样理解 |
|---|---|---|---|
| 五小时窗口 | 100% | 今天 16:00 | 这一窗口当前已经用满 |
| 每周总用量 | 100% | 周五 09:00 | 即使今天 16:00 五小时窗口恢复,周额度仍可能阻止继续 |
| 某模型系列 | 65% | 页面所示时间 | 这一条还有空间,不代表能越过已用满的总额度 |
把例子中的周用量改成 72%,结论又不同:16:00 之后,需要重新取得五小时窗口的最新状态,再看是否还有其他限制。72% 只说明该周窗口的已用比例,不能据此承诺还能发多少条消息。

报错名称能帮助你缩小范围:session limit、weekly limit 是跨模型的总限制;Opus limit 或 Sonnet limit 则指相应模型系列。只有被模型系列限额挡住、且其他适用额度仍允许时,换到该系列之外的模型才可能继续。切换模型不会清除已触发的会话或周总限额。官方用量限制错误说明
想实时显示用量,状态栏和 usage monitor 应该看什么
只想偶尔确认额度,先用 /usage。希望写代码时持续看到进度,可以按照官方状态栏文档配置显示。选择现成脚本时,先确认它显示的究竟是套餐用量还是上下文占用。
官方状态栏输入中,这几个字段名称尤其重要:
| 字段 | 含义 |
|---|---|
rate_limits.five_hour.used_percentage | 五小时窗口的已用百分比 |
rate_limits.seven_day.used_percentage | 周窗口的已用百分比 |
对应窗口下的 resets_at | 该窗口重置时刻,单位为 Unix 秒 |
context_window.used_percentage | 当前上下文占用,不能用来判断套餐余额 |
这些额度字段有账户和环境条件,通常要等本次会话收到第一次 API 响应后才出现;各窗口可以单独缺失,过期窗口还会被移除。因此,空值、null 或暂时消失应显示为“暂无数据”,不能擅自显示为 0% 已用。状态栏字段与缺失规则
如果你在自己编写状态栏,建议每个窗口至少显示“已用比例 + 重置时间”,并明确时区。JavaScript 的日期构造参数是毫秒,处理 resets_at 时需要进行秒到毫秒的转换。若时间被显示成 1970 年附近,先查时间单位,不要据此判断服务端重置异常。
第三方 Claude Code Usage Monitor 适合需要独立终端面板或结构化输出的场景。当前项目说明区分了 official、local_estimate、experimental 和 unknown:新鲜的官方状态栏采集值,与本地日志推算的额度,可信范围不同。项目原始 README
如果已经安装该工具,可以在普通终端中导出一次快照,方便核对当前数据来源:
bashclaude-monitor --once --output json
本文没有安装或实测该工具。按当前 README,--statusline 可用于接收 Claude Code 的官方额度字段;没有可用的新鲜采集数据时,工具可能回退到标注过的本地估算。阅读输出时,先检查来源标记和数据时间,再看剩余量或耗尽预测。监控工具里的自定义重置小时,只影响其显示或估算,不能改变订阅的实际重置时刻。

重置后仍提示没额度,按这个顺序排查
先留下当前报错原文,然后打开 /usage 和网页 Usage。接下来逐项核对,避免只盯着一个已经归零的数字。
- 确认到底什么归零了。 如果只是执行
/clear后 Session 成本变成零,套餐额度没有因此恢复。若是某个五小时窗口重置,继续查看周总用量和适用的模型系列用量。 - 把报错与同名用量条对应起来。 报错写着
weekly limit,就查周窗口;写着模型系列名称,就查那一条。不要因另一条未满就判定系统算错。 - 检查是否正在显示旧数据。 当额度请求失败时,当前客户端可能暂时显示最多 60 分钟前获取的用量条,并提示
Showing last-known usage。此时可按r重试;没有近期缓存时会显示接口错误。这个提示只能证明读数可能过时,不能证明额度已经恢复。用量请求失败时的行为 - 核对时间与身份。 记录重置日期、时间和时区,确认网页与 Claude Code 是同一个账户、组织及计费方式。尤其要检查是否因配置了
ANTHROPIC_API_KEY而使用 API 计费;API 用量与 Pro/Max 订阅额度不是同一本账。只需核对配置和身份,不要复制或公开密钥。Pro/Max 登录与 API Key 说明 - 看新的错误是否已变成另一类问题。 API 429、服务端节流、支出上限和余额不足需要按各自错误处理,不能继续用“五小时应该重置了”来解释。Claude Code 错误参考
如果网页与 CLI 在同一账户下仍不一致,可以整理一份简短记录用于后续排查:客户端版本、平台、登录方式、错误原文、各用量条的名称与读数、重置时刻和观察时间。截图遮住账户及组织敏感信息即可。相比“等了很久还不行”,这组信息能明确是哪个窗口、哪次读取出了问题。
/limit-reset 能重置周额度吗
目前不能把 /limit-reset 当作所有用户都能使用的标准恢复命令。截至本文核对日期,官方命令参考没有说明它的普遍可用性、适用套餐、最低版本或固定使用次数。
一则 Reddit 原始用户报告展示的输出包含会话限制已重置、下次可使用时间,以及周限额仍适用的提示。评论中也有人报告命令不可用或没有恢复访问。这能说明有人遇到过该功能,不能推导为每个账号都获得了相同权益。
如果你的客户端确实接受 /limit-reset,请读完整返回信息,然后重新查看 /usage 的每条用量,而不是只看“reset”一词。报告中的 session limit reset 与周额度重置是两回事;周额度仍满时,会话重置成功也可能无法继续。命令不可用时,回到当前账户的用量条和重置时间,不需要反复尝试拼写变体。
要判断近期规则变化是否影响你的使用,可以另读Claude Code 用量限制问题与变化。当前这次操作能否继续,则以同一账户的最新用量和实际报错为准。



