Agent HUD

Agent HUD · 指南

怎么查 Claude Code 还剩多少额度

Claude Code 同时按多个窗口计量,所以真正有用的问题是:哪个窗口最接近满,以及它什么时候回来。

有哪些窗口

一个五小时的会话窗口、一个跨所有模型的每周窗口,以及每个模型家族各自的每周窗口。每个都带自己的重置时间,任何一个都可能是先把你拦下的那个。

在哪看

  • 会话里的 /usage。权威答案,逐个窗口给出已用和重置时间。它是你主动问才有的一张快照,而且只在一个会话里。
  • Anthropic 账号页。套餐级别的活动,在浏览器里,不是实时的。
  • 你自己的状态栏。Claude Code 会把当前额度交给它,所以你可以写一行,把会话和每周的百分比连同重置时间打出来,管的是那个终端。
  • 屏幕上的监控。不用敲命令就能一直看到这些窗口,也是唯一能在窗口空掉之前而不是之后知道的办法。

Agent HUD 显示什么

窗口在灵动岛周围:每个有读数的窗口占一段光晕,悬停展开面板,逐个显示百分比和重置时间。

百分比是已用的比例,沿用 /usage 的习惯。没有读数的窗口显示破折号而不是 0,额度绝不会从 Token 数量去估。

它读的是你 Mac 上已有的会话和登录态。不用 API key,不用账号,读取不发送提示词,也不计费。

什么时候提醒你

已用 70% 为警告,90% 为危险。四件事各提醒一次:越过 90%、用尽归零、预计撑不到重置、以及一次确认的重置。

窗口用完了怎么办

  • 等重置。倒计时会告诉你还要多久。
  • 换轻一点的模型。重型家族有自己的每周窗口。
  • 把活交给别的 agent。它们的额度是分开的。
  • 如果天天都是同一个窗口,那就该升级了。

常见问题

百分比是已用还是剩余?
已用,沿用 Claude Code 自己的习惯。显示 90% 的窗口还剩 10%。
为什么我的 Claude Code 没显示额度?
用 API key 登录或走第三方网关时没有套餐额度可读,所以不会出现窗口,原因会显示在账号旁边。本地活动和 Token 统计照常工作。
读取额度会花钱吗?
不会。那是通过你 Mac 上已装好的引擎发起的一次元数据请求,不发送提示词,也不计费。
人不在 Mac 前面能看吗?
用 Agent HUD Remote,它把一台 Mac 的用量同步到免费的 iPhone、小组件与 Apple Watch 应用。

指南

最近更新: 2026-09-20 · 这里描述的行为,在 Agent HUD Open 的文档里有完整说明,并附有对应代码。 github.com/jazzenchen/agent-hud-open