查询 Claude 用量,看看还剩多少额度。

Claude Code、claude.ai 和 Claude 应用共用同一套方案限额。这里介绍 Claude Code 用量查询的入口,教你查看剩余额度,并说明5小时限额和每周限额的计算方式。

在 Claude Code 中输入 /usage,即可查看方案用量条。在 claude.ai 或 Claude 应用中,打开 Settings > Usage,可以查看当前 5 小时会话额度和每周额度已用了多少,以及距离会话额度重置还有多久。claude.ai、Claude Code 和 Claude 桌面应用的用量都计入同一套限额。

最后更新:

Cowork Island

macOS 14 或更高版本。
Apple 芯片和 Intel 处理器。
免费版无需账户。

免费下载

在哪里查看 Claude 用量。

有四个查询入口。前三个都是内置功能,无需配置。

Claude 用量查询入口,依据 Anthropic 文档整理(核查日期:2026年10月18日)
入口打开方式显示内容
终端中的 Claude Code输入 /usage。/cost 和 /stats 也会打开同一个页面。方案用量条和活动统计。Pro、Max、Team 和 Enterprise 方案还会显示计入限额的用量明细。
claude.ai 或 Claude 应用Settings > Usage当前 5 小时会话的用量进度条、距离重置的剩余时间,以及每周限额的用量进度条。
Claude 桌面应用的 Code 标签页消息输入框附近的用量圆环对于有用量限额的方案,显示当前周期的方案用量。Anthropic 不同页面标注的圆环位置略有差异,可以在消息输入框周围找找。
自行配置的状态行在 ~/.claude/settings.json 中添加一条简短命令(见下文)使用 Pro 和 Max 方案时,会话收到首次回复后,显示 5 小时和 7 天额度的已用百分比。

/usage 中的用量明细是估算值。Anthropic 表示,它根据这台电脑上的会话历史计算,因此不包含其他设备和 claude.ai 上的用量。方案用量条则涵盖整个账户。

Settings > Usage 适用于 Pro、Max、Team 和按席位计费的 Enterprise 方案。按用量计费的 Enterprise 方案没有固定用量限额,而是按实际消耗计费,Settings > Usage 也会显示这部分信息。

5小时限额和每周限额如何计算。

Anthropic 帮助中心用一句话说明:“付费方案有两类用量限额:每五小时重置一次的会话限额,以及每周重置一次的每周限额。”

  • claude.ai 上的聊天、Claude Code 会话和 Claude 桌面应用都计入同一限额。长时间运行编程会话后,留给聊天的额度就会减少;反过来也一样。
  • Settings > Usage 会显示所有模型合计的每周用量条。如果你的方案包含 Fable,还会单独显示它的每周用量条。
  • 对于 Max 方案,Anthropic 表示,每周限额会在分配给你账户的固定时间重置,每周一次。
  • 接近任何一项限额时,Claude Code 都会显示警告消息。

请查看 Anthropic 向你显示的重置时间。Settings > Usage 会显示当前会话距离重置还有多久。Claude Code 因达到限额而停止时,提示消息会写明重置时间,例如:

You've hit your session limit · resets 3:45pm

在 Claude Code 的状态行中显示用量。

状态行位于 Claude Code 底部。它会运行你指定的一条简短命令,并显示命令输出的内容。Claude Code 通过名为 rate_limits 的字段,将你的 5 小时和 7 天用量传给这条命令,让状态行在你工作时显示这些数据。它在你的 Mac 上运行,不消耗 API token。

开始前,请确认三件事:

  • 你使用 claude.ai 的 Pro 或 Max 订阅登录。Anthropic 文档只列出了这两种方案支持这些字段;使用 API 密钥登录时,不会收到这些字段。
  • Claude 在会话中首次回复后,才会传入这些字段。在此之前,状态行显示 5h: -% · 7d: -%。某项限额重置后,对应数值也会暂时消失,显示为 -%,直到收到下一次回复。
  • 这条命令使用 jq,一个读取 JSON 的小工具。在 Terminal 中输入 jq --version。如果提示找不到,请先安装。

将下面的 statusLine 键添加到 ~/.claude/settings.json,这是你主文件夹中的设置文件。请把它加入文件已有的顶层对象,不要粘贴覆盖整个文件,并且只保留一个 statusLine 键。文件必须保持严格的 JSON 格式,不能有注释或末尾逗号。

{ "statusLine": { "type": "command", "command": "jq -r '\"5h: \\(.rate_limits.five_hour.used_percentage // \"-\")% · 7d: \\(.rate_limits.seven_day.used_percentage // \"-\")%\"'" } }

状态行显示的是已用比例,不是剩余比例。5h: 42.5% · 7d: 10% 表示 5 小时会话额度还剩 57.5%,每周额度还剩 90%。每条状态行只属于一个会话,也只会显示在该会话的终端中。

如果不想编辑文件,可以在 Claude Code 中输入 /statusline,后面写上你想显示的内容,Claude Code 会帮你配置。

达到限额后会怎样。

只要保持会话打开,当前版本的 Claude Code 就能自行继续任务。按 Anthropic 的说法,Claude Code 会“在保持打开的会话中等待,并在限额重置后自行继续任务”。使用 claude.ai 订阅登录的交互式会话默认开启此功能,由 autoContinueAtUsageLimit 设置控制。如果距离重置超过一天,例如达到每周限额时可能出现的情况,它不会自动开始等待。此时可以通过 /rate-limit-options 选择等待。

如果等不了,Pro 和 Max 方案可以在 Settings > Usage 中开启 usage credits,超出限额后继续使用,按用量付费。使用 Pro 和 Max 时,在 Claude Code 中输入 /usage-credits,就会打开 claude.ai 上的对应页面。

为什么有篇帮助文章让你用 /status。

Anthropic 有篇介绍如何通过 Pro 或 Max 方案使用 Claude Code 的帮助文章写道:“使用 /status 命令查看剩余额度。”但当前 Claude Code 文档对 /status 的说明不同:它会打开 Status 标签页,显示版本、模型、账户和连接情况;方案限额则在 /usage 中。

这两处资料的说法不一致。如果 /status 没有显示限额,请使用 /usage。

也有无需配置的选择。

Cowork Island 是一款适用于 macOS 14 或更高版本的应用,它把受支持工具中的 AI 智能体会话汇集在刘海下方的面板中,显示每个会话的状态,让你看清哪些会话「需要你处理」。出现这种情况时,小岛默认会自动展开,除非该会话所在的终端或应用已经在前台。

同一个面板还会显示你自己的 Claude 和 Codex 方案用量条:其中的 5 小时和每周限额由 Anthropic 和 OpenAI 设定,并非本应用的限额。这些数据从你 Mac 上的文件读取,不调用 API,也不读取凭据。对于 Claude,请自行选择开启首次打开应用时提供的「从 Claude Code 的状态行读取用量」。它会在 Claude Code 的状态行中添加一条命令,并串接你已有的状态行命令,因此上面配置的状态行可以保留。Claude Code 仅在使用 Pro 和 Max 方案且会话运行期间发送这些数值。Codex 的限额来自它在这台 Mac 上保存的会话文件,无需开启任何选项。

免费版在面板顶部显示一行用量摘要,一次显示一张会话卡片;Pro 增加按账户显示的详细用量条和重置时间,显示你的所有会话,并让你能跳转回这些会话。7 天 Pro 试用会自动开始,每台 Mac 仅限一次,无需填写支付信息。查看方案,或阅读如何安装和设置 Cowork Island。

免费下载

资料来源。

把下载链接发给自己,稍后使用。