usage
章节
macOS 与 Windows · 开源 · AGPL-3.0

把 Claude Code、Codex、Antigravity 和 Grok
的用量钉在 menu bar。

一个迷你的 macOS menu bar 小工具(Windows 则常驻在系统托盘),在屏幕角落显示你的 AI 额度还剩多少⁠——像电池百分比一样直观好懂。

首次打开被 macOS 拦截?

usage 在 macOS 菜单栏上运行,MacBook 上开着额度面板
可分享的 HTML 报告⁠——默认隐藏项目名称
本地优先⁠——Claude Code 与 Codex 直接读你磁盘上的文件
无遥测、无账号、不上传

为烧 token 的开发者打造。

别再凭感觉猜还剩多少额度了。

5 小时与 7 天额度一览

Claude Code 的 5 小时和 7 天百分比同时显示在 menu bar。点开可看完整 popover、各项目用量与花费。

01

Claude Code、Codex、Antigravity、Grok 一个 app 搞定

Anthropic、OpenAI、Google 与 xAI 的额度并排显示。Codex 从 ~/.codex/sessions/ 自动检测,无需配置;Antigravity 则使用它自己的 CLI 已保存的登录身份。

02

一键 HTML 报告

今日、本周、本月或全部⁠——生成可分享的 HTML 报告,内含 token / 花费趋势、项目排行与模型分布。默认隐藏项目名称,安全分享给客户。

HTML 用量报告
03

16 款视觉面板主题

黑客帝国数字雨、Windows 95、复古报纸、午夜水族馆、世界杯 FIFA 转播、蝴蝶蓝图⁠——挑个喜欢的氛围。

Claude Code 小帮手

写代码时,帮你盯着额度和对话

撞墙前先提醒你

上下文用到 70% 时,状态栏提醒你 /clear 或 /compact。数字 50% 变黄、80% 变红;缓存没命中,也会告诉你原因。

省 token 模式

让 Claude Code 和 Codex 回答更短、更通俗,长对话也不会越讲越长。代码、命令、错误消息一个字都不缩。Codex 需先在 /hooks 中信任它。

新手模式

Claude 回答完,输入框上方会挑出最多 3 个术语,各配一句通俗解释。标为已懂的术语,之后用小测验复习。会使用少量 Claude 额度。

额度感知模式

额度快用完时,Claude 开始大任务前会先说还剩多少、几点重置,让你选先做小的还是等重置。Claude Code、Codex、Antigravity 都看,不额外调用模型。

数据从哪来

数字怎么算出来的

天生本地优先

Claude Code 和 Codex 的数字,读的是你电脑上本来就有的记录;只装 Claude Desktop 也能看到 Claude 额度。Antigravity 例外,会用它 CLI 的登录身份向 Google 查询。对外连接都列在 SECURITY.md。

Grok CLI 也算进来

读取 Grok CLI 自己的本地 log,算出周额度百分比。每次的 token 用量也会计入今日花费和各项目总计,跟 Claude Code、Codex 一样。

进度管家

让你的 CLI 也接得回上次

网页版、桌面 App 关掉再打开,对话自动就在那,什么都不用做;CLI 的记录其实也留着,但不会自动接上,得自己打指令去找。进度管家把这一步变成自动⁠——开新对话就直接接回你上次做到哪,不用重讲、也不用记指令。现在还会每天帮本机记录做一次健检,发现 token 浪费时开场白会多一行提醒;说「看」,AI 就会解释发现了什么、该怎么改。读取本机记录。

usage 品牌横幅:水墨猫与红色圆相,标语「Pick up where you left off.」
自动接回上次进度
每日健检,主动提醒 token 浪费
读取本机记录
在 CLAUDE CODE 中

你的额度,就在 Claude Code 中

在 macOS 和 Windows 的 Claude Code 中查看额度、对话和后台任务,包括 Agent 工具启动的子代理及其状态。等待你确认权限或提供 MCP 输入的对话会标为黄色。启用面板后,终端宽度 ≥144 列时会自动在右侧打开;较窄时输入 /usage-dash。 其他 Claude 对话完成或开始等待你时,会弹出通知。

Claude Code 侧边面板显示额度、对话和后台任务
不用离开对话就能查看额度
等待你的对话标为黄色
后台任务与子代理

挑一个你喜欢的面板。

16 款内建主题。随时从 popover 工具栏切换。

10 秒内安装完成。

四种方式都免费、都 AGPL-3.0。

直接

下载 .app

从 GitHub Releases 拉最新的 usage.app.zip⁠——解压、拖到 /Applications。

→ 打开 Releases 页面
WINDOWS

系统托盘

从 GitHub Releases 拉最新的 usage-windows.zip⁠——解压后运行 usage.exe。 也可在任务栏显示额度标签,右键点击它会打开系统托盘菜单。

→ 打开 Releases 页面
跨平台

uvx(零安装)

只有终端界面,没有菜单栏或系统托盘。Linux 也能跑,uv 会自备 Python。

uvx usage-cli

首次打开被 macOS 拦截?打开“系统设置”→“隐私与安全性”,向下滚动,点击“仍要打开”。macOS 14 及更早版本,改为右键点击 usage.app →“打开”。Windows 弹出“Windows 已保护你的电脑”?点击“更多信息”→“仍要运行”。 Claude Code 用户安装后,请在菜单中点击“设置状态栏”并重启 Claude Code,额度才会显示。