在状态栏里
就在 Claude Code 输入框下方：上下文用了多少，本次会话消耗的 token 和费用，以及两项限额距离重置还有多久。只要运行着 Claude Code，就能用。
Claude Usage版本 1.0.0
Claude 用量，随时在眼前
输入框下方的状态栏和桌面上的玻璃质感小组件，显示 5 小时和每周限额、何时重置，以及每次会话花了多少。
Windows 10/11 · macOS 13 或更高版本 · 一个压缩包，含两个安装程序
- 免费
- 本地运行
- GitLab 源代码
两种方式，随时掌握
在你的桌面上
一张小巧的悬浮卡片，用绿、橙、红显示两项限额，并标出当前窗口已经过去多久。如果按现在的速度会在重置前用完，它会告诉你大约什么时候。
- 还很充裕
- 接近上限
- 快用完了
点滴细节，贴心省事
位置由你定
随意拖动，可置顶于其他窗口之上，也可收起到托盘或菜单栏。
随 Claude Code 一起打开
随第一个会话启动；如果愿意，也可以开机登录时启动。
托盘里的圆环
托盘或菜单栏图标会随 5 小时用量填充并变色。
说你的语言
支持 12 种语言，自动跟随系统，也可在菜单中切换。
需要安静时就安静
动画可以在菜单中关闭。
自己保存历史
Claude Code 会在一段时间后删除旧的会话日志。小组件从第一次运行起就自己记账，历史不会丢。
花费与模型
打开统计视图，一览全貌：按日、周、月统计会话若按 API 价格计费的花费，以及各模型的占比。
截图：Windows 版小组件，使用演示数据。 macOS 版小组件功能相同。它在安装时于你的 Mac 上编译，因此这里没有它的截图。
每次会话，逐条列明
每次 Claude Code 会话各占一行：标题、项目、时间、token 和费用，最新的在最上面。花钱多的一眼就能看出来。
一分钟装好
一个压缩包里有两个安装程序，运行适合你系统的那个即可。
Windows 10 和 11你的系统
- 下载压缩包，解压后打开 claude-usage 文件夹。
- 双击 install.cmd，或在 PowerShell 中运行：
powershell -ExecutionPolicy Bypass -File install.ps1 - 重启 Claude Code。状态栏会出现在输入框下方，小组件随第一个会话打开。限额在第一次回复后填入。
macOS 13 及更高版本你的系统
- 仅需一次：安装 Xcode Command Line Tools。小组件会在安装时于你的 Mac 上编译。
xcode-select --install - 解压下载的文件，然后在终端中进入 claude-usage 文件夹运行：
bash install.sh - 重启 Claude Code。状态栏会出现在输入框下方，小组件随第一个会话打开。限额在第一次回复后填入。
只装你需要的
只想要状态栏？可以不装小组件。已经装好了？可以在小组件菜单里关闭状态栏，或让小组件不随 Claude Code 启动：另一部分照常工作。
Windows
powershell -ExecutionPolicy Bypass -File install.ps1 -NoWidgetmacOS
bash install.sh --no-widget想手动打开小组件：在 Windows 的“开始”菜单或 macOS 的“应用程序”中找到 Claude Usage。如果它被隐藏了，点击托盘或菜单栏图标即可。
更新或卸载
更新
小组件每天向本站询问一次是否有新版本。有的话，刷新按钮上会出现一个圆点，菜单里也会出现更新项。请求只带版本号和系统，你可以在菜单中关闭这项检查。
- 从本页下载新的压缩包。
- 再运行一次安装程序，历史和设置都会保留。
卸载
移除 mod、小组件及其快捷方式。
Windows
powershell -ExecutionPolicy Bypass -File install.ps1 -UninstallmacOS
bash install.sh --uninstall加上 -KeepHistory（Windows）或 --keep-history（macOS）可保留历史记录。
一切都在本地
限额来自状态栏写在你电脑上的文件，花费历史读取自 Claude Code 自己的会话日志。不上传任何内容，没有账号，也无需登录。更新检查是小组件唯一会发出的请求。
你需要准备
- Windows 10 或 11，或 macOS 13 及更高版本
- 支持 mod 的 Claude Code（已在 2.1.296 上测试）。mod API 尚处于早期访问阶段，不同版本之间可能有变化。
- Pro 或 Max 订阅：限额来自你的账号。
- 花费历史需要 Node.js。没有它，限额依然可以显示。
- macOS 上需要 Xcode Command Line Tools：小组件会在安装时于你的 Mac 上编译。
这些数字怎么看
- 限额是 Claude 随每次回复给出的百分比，所以你在任何会话里使用 Claude Code 时都会刷新。
- 费用是相同 token 按 API 价格计算的金额。订阅并不按这种方式计费，它显示的是你从订阅中获得了多少价值。
- 历史读取自 Claude Code 本地的会话日志。小组件从第一次运行起自己记账；更早的时期为估算值，颜色会更淡。
用完之前，先知道。
免费、开源、安静：你不看它，它就待在角落里。
Windows 10/11 · macOS 13 或更高版本 · 一个压缩包，含两个安装程序