在 Mac 上查看 Claude Code 的额度与用量
Claude Code 是唯一一个能告诉你单个会话占了当前五小时窗口多少的客户端。
一览
| 额度 | 会话、每周、按模型家族每周 |
|---|---|
| 账号 | 账号 · 组织,邮箱标签 |
| 运行中 · 完成 | 是 · 是 |
| 读取凭据 | 仅已有登录态 |
能看到什么
一个会话窗口、一个跨所有模型的每周窗口,以及按模型家族分的每周窗口,各有自己的重置时间。套餐标识来自你的订阅,Max 会细分到 5× 或 20× 档。
账号怎么标识
引擎上报的账号与组织,用登录邮箱作标签。两次读取之间如果换了登录,这次读数会被丢弃,而不是把两边混在一起。
运行中与完成
运行中的轮次和完成都能识别。子 agent 的记录不会自己开始或结束一轮。
Agent HUD 读什么
Claude 项目目录下的会话记录,以及配置文件里的档位和账号。它用引擎已有的登录态,不从钥匙串读任何东西;读取本身不发送提示词,也不产生费用。
常见问题
- 为什么我的 Claude Code 没显示额度?
- 用 API key 登录或走第三方网关时,没有套餐额度可读,所以不会出现窗口。引擎已登出时会提示重新登录,原因显示在账号旁边。无论哪种情况,本地活动和 Token 统计都照常工作。
- 会话占比是什么意思?
- 是这个会话在进行中的五小时窗口里占的 Token 份额,乘以这个窗口的使用率。只有 Claude Code 能显示它,其他客户端这一项都是破折号。
最近更新: 2026-09-20 · 这里描述的行为,在 Agent HUD Open 的文档里有完整说明,并附有对应代码。 providers.md