Claude Usage Bar：Claude 用量菜单栏监控

项目简介

Claude Usage Bar 是一款 macOS 菜单栏应用，用来显示你已使用了 Claude 套餐用量的多少，省去反复刷新用量页面的麻烦。图标常驻屏幕顶部，点开就能看到细节。

主要功能

• 菜单栏图标内嵌迷你条形图，对应 5 小时和 7 天限额
• 弹出面板展示每项限额的用量、重置时间；套餐支持时显示按模型的拆分，以及以美元计的额外用量
• 用量历史图表，范围从最近 1 小时到最近 30 天，悬停可查看精确数值
• 当某项限额超过你设定的百分比时发送通知
• 支持登录时自动启动，刷新间隔可在 5 分钟到 1 小时之间选择
• 在浏览器中用 Claude 账号登录，无需 API key
• 自动更新

安装与使用

1. 从最新发布下载 ClaudeUsageBar.dmg。
2. 打开后把 ClaudeUsageBar 拖入 Applications。
3. 从 Applications 启动。直接从磁盘映像运行也可以，但无法自动更新。

应用未经过 Apple 公证，首次启动会被 macOS 拦截：

• macOS 15 及以上：出现警告后打开 系统设置 → 隐私与安全性，滚动到 安全性，点击 仍要打开，输入密码确认。该按钮在启动被拦截后约一小时内可见。
• macOS 14：在 Applications 中按住 Control 点击应用，选择 打开，再点一次 打开。

这一步只需做一次，之后的更新不会再出现警告。

首次使用：点击菜单栏图标，选择 Sign in with Claude，在浏览器中批准授权，应用会自行完成登录。默认每 30 分钟刷新一次。若浏览器无法把登录结果交回应用，可点击 Paste a code instead 并粘贴页面显示的代码。

在弹出面板的 Settings… 中可设置：

• General：登录时启动、刷新频率
• Notifications：5 小时、7 天和额外用量限额的提醒阈值，或 Off
• Account：当前登录账号、Sign Out
• Updates：版本号、每日更新检查、Check for Updates…

从源码构建可克隆仓库后运行：

make install

这种方式构建的应用不会自动更新，依赖与细节见 CONTRIBUTING.md。

注意事项

数据保存在本机 ~/.config/claude-usage-bar/ 下：credentials.json 保存登录令牌，history.json 保存 30 天的用量历史，两者仅本人可读。

应用只连接以下地址：claude.ai 与 platform.claude.com（登录）、api.anthropic.com（读取用量和账号邮箱）、blimp-labs.github.io（检查更新）以及 GitHub 的发布下载。登录过程中还会在本机 127.0.0.1 监听，用于接收浏览器回传的登录结果。

卸载时先在设置中关闭 Launch at login，在弹出面板点击 Quit，再从 Applications 删除应用。若要同时清除数据与设置：

rm -rf ~/.config/claude-usage-bar
defaults delete com.local.ClaudeUsageBar

项目基于 BSD 2-Clause 许可证开源。

---

本作品整理自 GitHub 开源项目 Blimp-Labs/claude-usage-bar，原作者 @Blimp-Labs，许可证 BSD-2-Clause。中文介绍由 AI 根据项目 README 整理，以原仓库为准。