如何查看 Claude Code 用量（剩余额度）：/usage、状态栏和 claude.ai

要点

在 Claude Code 里运行 /usage。在 Pro、Max、Team 或 Enterprise 套餐上，它会显示 5 小时会话限制和每周限制的用量条及重置时间，并列出用量花在了哪里。在 API 计费下，它显示会话的 token 数和估算费用。

另外两个地方也能看到同样的套餐限制：

claude.ai → Settings → Usage，也包括你的聊天用量。
自定义状态栏，可以在每个会话底部显示 5h: 42% 7d: 18%。

问题

Claude Code 默认不会在你工作时显示剩余额度。最先出现的信号往往是 85% 的警告，或者干脆就是限制提示。到那时，一个长任务已经做了一半。

还有好几个看起来相似的数字：以美元计的会话费用、加载动画旁的 token 数、5 小时窗口的百分比、一周的百分比。它们衡量的东西不同，对订阅用户来说只有其中一部分有意义。

方法 1：用 `/usage` 查看 Claude Code 用量

/usage

显示内容取决于你的登录方式。来自 Anthropic 的费用页面：

订阅用户（Pro、Max、Team、Enterprise）：

会话窗口和每周窗口的套餐用量条，以及各自的重置时间。
按技能、子代理、插件和各个 MCP 服务器归类的近期用量明细，以百分比表示。
建议，每行一条，针对占近期用量 10% 或以上的项目。像 25% Trim ~/code/api/CLAUDE.md · 49k tokens per request 这样的一行，表示这一项涉及多少用量，而不是修改后能省多少。
循环，列出最近运行过的最重的 /loop 或定时任务。
如果开启了用量额度，会有用量额度一行。

按 d 或 w 可以在最近 24 小时和最近 7 天之间切换明细。明细根据这台机器上的会话历史计算，所以不包括其他电脑或 claude.ai 上的用量。套餐用量条来自 Anthropic，包含全部用量。

当底部出现 f to fix 2 of 3 这样的提示时，按 f 会让 Claude Code 执行它能处理的建议。这需要 Claude Code v2.1.305 或更高版本。

API 计费：

Session 区块显示总费用、API 时长和实际时长、代码改动以及按模型统计的 token。美元金额由 Claude Code 按标价在本地计算。真实账单请看 Claude Console 的 Usage 页面。用 /clear 开始新会话时，这些合计会归零。

当 `/usage` 提示被限流时

像 rate limited until 3:14am 这样的提示，表示 Claude Code 在那之前无法再次获取你的套餐限制。这不是你的用量限制。请求失败时，/usage 会显示这台机器过去一小时内最后加载的用量条，并附上 Showing last-known usage 说明。过了显示的时间后按 r 获取最新数据。

方法 2：在状态栏显示 Claude Code 限制

想要一个始终可见的数字，就把 rate_limits 字段加到自定义状态栏中。Claude Code 通过 stdin 把 JSON 传给你的脚本。对 Pro 和 Max 订阅用户，在第一次 API 响应之后，其中包含：

rate_limits.five_hour.used_percentage 和 rate_limits.five_hour.resets_at
rate_limits.seven_day.used_percentage 和 rate_limits.seven_day.resets_at

used_percentage 取值 0 到 100。resets_at 是 Unix 纪元秒。

一个根据 Anthropic 示例改写的最小脚本：

#!/bin/bash
input=$(cat)

MODEL=$(echo "$input" | jq -r '.model.display_name')
FIVE_H=$(echo "$input" | jq -r '.rate_limits.five_hour.used_percentage // empty')
WEEK=$(echo "$input" | jq -r '.rate_limits.seven_day.used_percentage // empty')

LIMITS=""
[ -n "$FIVE_H" ] && LIMITS="5h: $(printf '%.0f' "$FIVE_H")%"
[ -n "$WEEK" ] && LIMITS="${LIMITS:+$LIMITS }7d: $(printf '%.0f' "$WEEK")%"

echo "[$MODEL] $LIMITS"

把它保存为 ~/.claude/statusline.sh，用 chmod +x 设为可执行，然后在 ~/.claude/settings.json 的 statusLine 中指向它：

{
  "statusLine": {
    "type": "command",
    "command": "~/.claude/statusline.sh"
  }
}

jq 调用中的 // empty 让脚本在字段缺失时保持安静，例如在 API 计费下或第一次响应之前。

方法 3：在 claude.ai 上查看用量

在 claude.ai 打开 Settings → Usage。它显示整个账号（包括聊天）的当前会话和每周限制。在手机上查看，或者想看某次聊天用了多少时，就看这里。

方法 4：在 Console 中查看 API 支出

按量付费时，Claude Console 的 Usage 页面是权威记录。第一次用 Console 账号认证 Claude Code 时，会创建一个名为 “Claude Code” 的工作区，把它的支出和你其他的 API 使用分开。

这些数字的含义

数字	位置	衡量什么
会话用量条	`/usage`、状态栏、claude.ai	5 小时窗口已用的比例
每周用量条	`/usage`、状态栏、claude.ai	每周限制已用的比例
`Total cost`	`/usage` 的 Session 区块	本次会话按标价估算的 API 费用
加载动画旁的 token 数	回合进行中	当前回合已产生的输出
归类百分比	`/usage` 明细	在这台机器近期用量中所占比例

加载动画旁的数字，例如 (10m 27s · ↓ 5.5k tokens)，只统计输出。你的提示和对话历史不会让它增加，所以它几乎说明不了一个回合用了窗口的多少。

跨代理和跨电脑查看用量

/usage 只覆盖一台机器视角下的一个 Claude 账号。如果你还用 Codex 或 Gemini，或者有不止一个 Claude 账号，每个都有各自的查看位置。

如果你想在手机上看到每个账号还剩多少，Happier 是一款开源应用，可以在手机、桌面或网页上跨设备运行和编排 Claude Code、Codex 等代理。

它的配额表是这样工作的：

三种服务有配额表： Claude 订阅、Codex 订阅（openai-codex）和 Gemini。API 密钥类服务以及 Happier 运行的其他代理没有配额表。
仪表显示剩余量。 30% left · resets in 2h 10m 表示该窗口还有 30% 可用。
过时的数据会被标出。 每个账号会显示上次更新时间，把旧数据标为过时，并提供立即刷新配额（Refresh quota now）。
配额表和你连接的账号放在一起，位于设置（Settings）→ 已连接服务（Connected services），并在会话中显示在账号旁边。

已连接服务和已连接服务配额（Connected services quotas）在 Happier 0.2.17 中都是实验性功能，默认关闭。在设置（Settings）→ 功能（Features）中把两者都打开。设置方法见如何在手机上使用 Happier。Happier 在 GitHub 上，可以在这里下载，还有 Discord。

如何查看 Claude Code 用量（剩余额度）：/usage、状态栏和 claude.ai

如何查看 Claude Code 用量（剩余额度）：/usage、状态栏和 claude.ai

要点

问题

方法 1：用 `/usage` 查看 Claude Code 用量

当 `/usage` 提示被限流时

方法 2：在状态栏显示 Claude Code 限制

方法 3：在 claude.ai 上查看用量

方法 4：在 Console 中查看 API 支出

这些数字的含义

跨代理和跨电脑查看用量

故障排查

在 Pro 套餐上 `/usage` 显示的是美元费用

状态栏里限制什么都不显示

明细和 claude.ai 对不上

常见问题

怎么查看 Claude Code 还剩多少用量？

`/status` 能显示用量吗？

能按项目查看 Claude Code 用量吗？

为什么长会话用量这么大？

相关指南