Claude Usage Barometer
一款小巧、电量条样式的菜单栏仪表，用于查看你的 Claude 用量。直接在 macOS 菜单栏中，实时看着你的 5 小时与 7 天窗口逐渐耗尽。
你的 Claude 用量上限，始终一目了然
Claude Usage Barometer 是一款面向 SwiftBar（或 xbar）的免费开源插件，常驻于你的 macOS 菜单栏。它显示两条电量条样式的进度条——一条对应 Claude 滚动的 5 小时窗口，一条对应 7 天窗口——让你一眼就能看清还剩多少额度。它由纯 Bash 编写、零构建步骤，从 macOS Keychain 本地读取你的 Claude Code 令牌，绝不会把你的数据发送到任何地方。
在你撞上之前，用量上限始终是隐形的
Claude 采用滚动用量窗口，但桌面上没有任何东西会提示你距离上限还有多近——直到工作在任务中途戛然而止。
没有原生指示器
5 小时和 7 天窗口都没有内置仪表，因此用量上限可能在会话中途毫无预警地到来。
上下文切换的代价
查看用量意味着要离开手头的工作、翻找仪表盘——每当你想知道还剩多少时，都要付出这份摩擦成本。
猝不及防的中断
意外撞上用量上限会打断心流，让你正要交付的工作戛然停摆。一个一眼可见的仪表能避免这种意外。
为你的 Claude 额度装上一块电量计
菜单栏中的两条进度条、一个详细的下拉面板，外加无需点击便能讲清状况的颜色。
填满的部分表示还剩多少，空出的部分表示已用多少。随着你消耗 5 小时与 7 天额度，每条进度条都会逐渐耗尽。
已用至 69% 为绿色，70% 起转为琥珀色，90% 起变为红色——菜单栏上的进度条会跟随更吃紧的那个窗口。
点击即可查看每个窗口的剩余百分比、精确的重置倒计时，以及上次更新时间。
它会从这台 Mac 的 Keychain 中读取 Claude Code 的 OAuth 令牌。无需账号、无需服务器，任何数据都不会离开你的机器。
小巧的仪表，用心的细节
一款菜单栏工具该有的一切，不该有的一概没有。
5 小时与 7 天双仪表
两个滚动窗口一目了然，下拉面板中附有剩余百分比与重置倒计时。
颜色分级的状态
随着你逼近上限，颜色从绿到琥珀再到红，无需打开任何东西，状态便一目了然。
对速率限制友好
缓存上一次有效的读数，并将 API 调用间隔至少节流到 3 分钟，从容应对短暂的 429。
感知更新
每天检查一次 GitHub，当有更新的版本发布时，会在下拉面板中显示「有可用更新」的链接。
可调刷新频率
在下拉面板中选择 1、3 或 5 分钟的刷新间隔，在实时性与 API 调用之间取得平衡。
零构建，纯 Bash
易于阅读、审计与调整。天然私密，并以 MIT 许可证发布。
在终端中一行搞定
安装脚本会通过 Homebrew 添加 jq 和 SwiftBar，放入插件并启动它。首次运行时，请在 Keychain 提示中选择「始终允许」。
curl -fsSL https://raw.githubusercontent.com/taka-avantgarde/claude-usage-barometer/main/install.sh | bash需要 macOS 12+、Homebrew，以及在这台 Mac 上已登录的 Claude Code。
常见问题
Claude Usage Barometer 是免费的吗？
是的。它以 MIT 许可证开源，可免费使用。它只需要你 Mac 上已有的 Claude Code 会话。
运行它需要什么？
macOS 12 或更高版本、SwiftBar（或 xbar）、jq 与 curl，以及在同一台 Mac 上已登录的 Claude Code。一行安装脚本会为你配置好 jq 和 SwiftBar。
我的 Claude 令牌安全吗？
安全。该插件从你的 macOS Keychain 本地读取 Claude Code 的 OAuth 令牌，并且只用它来获取你自己的用量。它由纯 Bash 编写，不向任何第三方发送数据，也没有遥测。
这些颜色代表什么意思？
已用低于 70% 时进度条为绿色，70% 至 89% 为琥珀色，90% 至 100% 为红色。菜单栏的颜色会跟随两个窗口中更接近上限的那一个。
它除了支持 SwiftBar，也支持 xbar 吗？
是的。它可作为 SwiftBar 或 xbar 插件运行。我们推荐 SwiftBar，一行安装脚本配置的也正是它。