# Claude Code /usage 怎么看？用量监控、周限额与重置排查

> 在 Claude Code 中读懂 /usage 的会话成本、五小时和周用量，分清 /cost、状态栏与第三方监控的数据，并排查重置后仍提示额度不足的原因。

- Source: https://www.aifreeapi.com/zh/posts/claude-code-usage-monitor
- Language: zh
- Published: 2026-09-08
- Updated: 2026-09-12
- Publisher: AI Free API (https://www.aifreeapi.com)

在 Claude Code 的输入框中输入 `/usage`，先找到**套餐用量条的名称、已用百分比和重置时间**，再对照当前报错。能否继续使用，取决于此次请求涉及的所有额度是否允许；五小时额度恢复了，周限额仍可能挡住请求。

截至 2026 年 9 月 8 日，官方命令表把 `/cost` 列为 `/usage` 的别名，`/stats` 也进入同一界面，但默认打开统计页。把三个命令理解成三个互不相关的计费系统，已经不符合当前文档。[Claude Code 命令参考](https://code.claude.com/docs/en/commands)

## 打开 /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，也不是额度重置周期。[官方用量与成本说明](https://code.claude.com/docs/en/costs#using-the-usage-command)

Usage credits 一行出现 `Unlimited` 时，也要先读它所属的区域：对未设月支出上限的 Pro/Max 用户，这表示该处没有设置支出上限，并不代表获得了免费无限额度。[Usage credits 显示规则](https://code.claude.com/docs/en/costs#check-your-usage-credits-spend)

## 五小时和周限额怎么一起读

在 claude.ai 的 **Settings → Usage** 中，可以核对套餐当前五小时时段、每周用量及各自的重置时间；具体有哪些用量条，以你的账户显示为准。按用量计费的 Enterprise 不宜套用个人订阅的整套读法。[官方用量页面说明](https://support.claude.com/en/articles/9797557-usage-limit-best-practices)

看每一条时，连续确认三件事：**这是哪个窗口、百分比表示已用还是剩余、旁边的时间属于哪一条**。不要把五小时和周用量相加，也不要把较早的重置时间当成所有额度恢复的时刻。

下面是为了说明读法而构造的例子，不是真实账户测量：

| 用量条 | 已用 | 显示的重置时间 | 应怎样理解 |
| --- | --- | --- | --- |
| 五小时窗口 | 100% | 今天 16:00 | 这一窗口当前已经用满 |
| 每周总用量 | 100% | 周五 09:00 | 即使今天 16:00 五小时窗口恢复，周额度仍可能阻止继续 |
| 某模型系列 | 65% | 页面所示时间 | 这一条还有空间，不代表能越过已用满的总额度 |

把例子中的周用量改成 72%，结论又不同：16:00 之后，需要重新取得五小时窗口的最新状态，再看是否还有其他限制。72% 只说明该周窗口的已用比例，不能据此承诺还能发多少条消息。

![五小时窗口与每周用量分列的重置时间示意](https://www.aifreeapi.com/posts/zh/claude-code-usage-monitor/img/reset-windows.webp)

报错名称能帮助你缩小范围：`session limit`、`weekly limit` 是跨模型的总限制；`Opus limit` 或 `Sonnet limit` 则指相应模型系列。只有被模型系列限额挡住、且其他适用额度仍允许时，换到该系列之外的模型才可能继续。切换模型不会清除已触发的会话或周总限额。[官方用量限制错误说明](https://code.claude.com/docs/en/errors#youve-hit-your-session-limit)

## 想实时显示用量，状态栏和 usage monitor 应该看什么

只想偶尔确认额度，先用 `/usage`。希望写代码时持续看到进度，可以按照[官方状态栏文档](https://code.claude.com/docs/en/statusline#rate-limit-usage)配置显示。选择现成脚本时，先确认它显示的究竟是套餐用量还是上下文占用。

官方状态栏输入中，这几个字段名称尤其重要：

| 字段 | 含义 |
| --- | --- |
| `rate_limits.five_hour.used_percentage` | 五小时窗口的已用百分比 |
| `rate_limits.seven_day.used_percentage` | 周窗口的已用百分比 |
| 对应窗口下的 `resets_at` | 该窗口重置时刻，单位为 Unix 秒 |
| `context_window.used_percentage` | 当前上下文占用，不能用来判断套餐余额 |

这些额度字段有账户和环境条件，通常要等本次会话收到第一次 API 响应后才出现；各窗口可以单独缺失，过期窗口还会被移除。因此，空值、`null` 或暂时消失应显示为“暂无数据”，不能擅自显示为 0% 已用。[状态栏字段与缺失规则](https://code.claude.com/docs/en/statusline#available-data)

如果你在自己编写状态栏，建议每个窗口至少显示“已用比例 + 重置时间”，并明确时区。JavaScript 的日期构造参数是毫秒，处理 `resets_at` 时需要进行秒到毫秒的转换。若时间被显示成 1970 年附近，先查时间单位，不要据此判断服务端重置异常。

第三方 **Claude Code Usage Monitor** 适合需要独立终端面板或结构化输出的场景。当前项目说明区分了 `official`、`local_estimate`、`experimental` 和 `unknown`：最近从官方状态栏采集的数值，与本地日志推算的额度，可信范围不同。[项目原始 README](https://github.com/Maciek-roboblog/Claude-Code-Usage-Monitor)

如果已经安装该工具，可以在普通终端中导出一次快照，方便核对当前数据来源：

```bash
claude-monitor --once --output json
```

该工具的说明来自其当前 README，未经安装实测。按 README，`--statusline` 可用于接收 Claude Code 的官方额度字段；没有近期可用的采集数据时，工具可能回退到标注过的本地估算。阅读输出时，先检查来源标记和数据时间，再看剩余量或耗尽预测。监控工具里的自定义重置小时，只影响其显示或估算，不能改变订阅的实际重置时刻。

![用量监控中的官方读数、本地估算与暂无数据三种来源示意](https://www.aifreeapi.com/posts/zh/claude-code-usage-monitor/img/monitor-data-sources.webp)

## 重置后仍提示没额度，按这个顺序排查

先留下当前报错原文，然后打开 `/usage` 和网页 Usage。接下来逐项核对，避免只盯着一个已经归零的数字。

1. **确认到底什么归零了。** 如果只是执行 `/clear` 后 Session 成本变成零，套餐额度没有因此恢复。若是某个五小时窗口重置，继续查看周总用量和适用的模型系列用量。
2. **把报错与同名用量条对应起来。** 报错写着 `weekly limit`，就查周窗口；写着模型系列名称，就查那一条。不要因另一条未满就判定系统算错。
3. **检查是否正在显示旧数据。** 当额度请求失败时，当前客户端可能暂时显示最多 60 分钟前获取的用量条，并提示 `Showing last-known usage`。此时可按 `r` 重试；没有近期缓存时会显示接口错误。这个提示只能证明读数可能过时，不能证明额度已经恢复。[用量请求失败时的行为](https://code.claude.com/docs/en/costs#when-the-usage-request-fails)
4. **核对时间与身份。** 记录重置日期、时间和时区，确认网页与 Claude Code 是同一个账户、组织及计费方式。尤其要检查是否因配置了 `ANTHROPIC_API_KEY` 而使用 API 计费；API 用量与 Pro/Max 订阅额度不是同一本账。只需核对配置和身份，不要复制或公开密钥。[Pro/Max 登录与 API Key 说明](https://support.claude.com/en/articles/11145838-use-claude-code-with-your-pro-or-max-plan)
5. **看新的错误是否已变成另一类问题。** API 429、服务端节流、支出上限和余额不足需要按各自错误处理，不能继续用“五小时应该重置了”来解释。[Claude Code 错误参考](https://code.claude.com/docs/en/errors)

如果网页与 CLI 在同一账户下仍不一致，可以整理一份简短记录用于后续排查：客户端版本、平台、登录方式、错误原文、各用量条的名称与读数、重置时刻和观察时间。截图遮住账户及组织敏感信息即可。相比“等了很久还不行”，这组信息能明确是哪个窗口、哪次读取出了问题。

## /limit-reset 能重置周额度吗

目前不能把 `/limit-reset` 当作所有用户都能使用的标准恢复命令。截至 2026 年 9 月 8 日，官方命令参考没有说明它的普遍可用性、适用套餐、最低版本或固定使用次数。

一则 [Reddit 原始用户报告](https://www.reddit.com/r/ClaudeCode/comments/1w5r1hv/this_is_new_limitreset_resets_your_session_limit/)展示的输出包含会话限制已重置、下次可使用时间，以及周限额仍适用的提示。评论中也有人报告命令不可用或没有恢复访问。这能说明有人遇到过该功能，不能推导为每个账号都获得了相同权益。

如果你的客户端确实接受 `/limit-reset`，请读完整返回信息，然后重新查看 `/usage` 的每条用量，而不是只看“reset”一词。报告中的 **session limit reset** 与**周额度重置**是两回事；周额度仍满时，会话重置成功也可能无法继续。命令不可用时，回到当前账户的用量条和重置时间，不需要反复尝试拼写变体。

要判断近期规则变化是否影响你的使用，可以另读[Claude Code 用量限制问题与变化](/zh/posts/claude-code-usage-limit-issues)。当前这次操作能否继续，则以同一账户的最新用量和实际报错为准。