grzegorz-raczek-unit8/claude-quota

来源：https://github.com/grzegorz-raczek-unit8/claude-quota

claude-quota

菜单栏仪表，显示您的 Claude Code 配额——每个账户一个条形图，效果如下：

菜单栏截图

(针对深色菜单栏绘制——白色轮廓)

• 每个条形图显示一个账户的5小时窗口使用率，颜色为绿色/橙色（≥70%）/红色（≥90%）。
• 当5小时窗口的配额用尽时，条形图不再显示百分比，而是显示重置倒计时（如 4:28）。
• 当周限额用尽时，条形图变为黑色并显示周重置倒计时（如 2D）——这是更严格的限制，无论5小时窗口显示什么。
• 下拉菜单中内联显示每个账户的详细数据：5小时窗口和周窗口、您的套餐报告的分模型窗口、额外使用额度以及重置时间。
• 每5分钟刷新一次（遵循 SwiftBar 文件名约定），并提供一个手动“立即刷新”选项。

快速安装

curl -fsSL https://raw.githubusercontent.com/grzegorz-raczek-unit8/claude-quota/main/install.sh | bash

需要 macOS 和 Homebrew (https://brew.sh)。当 macOS 在首次刷新时弹出钥匙串权限对话框，请点击始终允许。

工作原理

该插件从 macOS 钥匙串中读取您的 Claude Code OAuth 令牌（只读——不会刷新或重写令牌，因此不会导致您退出登录），并查询与 Claude Code 的 /usage 屏幕相同的使用量端点。无需密码，无需爬取，无需第三方服务。

注意： 该端点是 Claude Code 内部使用的且未记录，因此未来 Claude Code 的更新可能需要在此处进行小幅调整。

通过代码仓库安装

git clone https://github.com/grzegorz-raczek-unit8/claude-quota.git
cd claude-quota
./install.sh

如果尚未安装 SwiftBar (https://github.com/swiftbar/SwiftBar)，上述任一安装路径都会通过 Homebrew 进行安装。如果某个账户显示 ⚠，说明其令牌因长期未使用而过期——运行一次 claude CLI 命令，小部件将在下一个刷新周期自动恢复。

账户

默认情况下，插件会自动发现账户：每个包含 Claude Code 钥匙串条目的 ~/.claude / ~/.claude-* 配置目录都会获得一个条形图，并以目录后缀作为标签（例如 ~/.claude-work → W）。如果只自动发现一个账户，则不显示字母标签——仅显示条形图。

若要固定或重命名账户（例如您使用多个 CLAUDE_CONFIG_DIR），请创建 ~/.config/claude-quota/accounts，每行使用一个 路径 [标签] 格式（标签为单个单词）：

~/.claude-work Work
~/.claude-priv Priv

若要隐藏某个账户的菜单栏仪表（下拉菜单中的详细数据仍然保留），请在该账户行下方的下拉菜单中选择从菜单栏隐藏——或编辑 ~/.config/claude-quota/hidden（每行一个标签）。

多个账户通过 CLAUDE_CONFIG_DIR 实现时，您的 shell rc 文件中的配置示例如下：

claude()      { CLAUDE_CONFIG_DIR="$HOME/.claude-work" command claude "$@"; }
claude-priv() { CLAUDE_CONFIG_DIR="$HOME/.claude-priv" command claude "$@"; }

卸载

从您的 SwiftBar 插件文件夹（默认为 ~/.swiftbar）中删除 claude-quota.5m.py 文件。