[开源推荐] usage：Claude Code / Codex 额度监控菜单栏工具

[aqua5230]

项目地址

https://github.com/aqua5230/usage

类别

Python

项目标题

把 Claude Code / Codex 额度钉在 macOS 菜单栏的用量监控工具

项目描述

一个开源（AGPL-3.0）的 macOS 菜单栏应用，把 Claude Code 和 Codex 的 5 小时 / 周额度实时显示在屏幕右上角，绿转红一眼看清，并按烧额速度预估几点撞墙，避免写代码写到一半才发现额度用完。所有数字都来自本机文件，完全不调用 Anthropic / OpenAI API。

亮点

1. 零 Token 消耗、不碰密钥：不调用任何 LLM API、不读 Keychain，Claude Code 侧靠状态栏 hook 写本地 JSON，Codex 侧直接解析 ~/.codex/sessions 的会话日志；
2. 按当前烧额速度预估几点撞 5 小时 / 周限额；
3. 离线 HTML 深度报告：token 趋势、项目排行、成本估算、年度回顾热力图；
4. 菜单栏一键「省 token 模式」，长对话实测输出省约 40%。

一行安装：brew install --cask aqua5230/usage/usage