不知道你使用 Claude Code（会员订阅）有没有这样的问题：官方只提供了一个模糊的进度条，不知道每天使用了多少 token，不知道对应的费用是多少，也不知道每天的使用占每周额度的比例，更没有历史记录功能；Weekly 与每 5 小时周期到期后还需要手动触发下一个周期。
为了解决这些问题，我用 Claude Code 开发了个 Claude Code 用量监控工具。
功能
- 5 小时窗口和每周额度的重置倒计时
- 每天已用的 Token 数量与对应费用，按模型（Opus / Haiku）分项显示
- 每天使用量占每周额度的百分比
- 历史使用记录（数据永久保存，展示最近 30 天）
- 每 30 分钟自动采集更新数据，每周额度重置后自动触发新周期
- 同时保持 5 小时会话窗口过期后自动触发新周期
两种使用形式
1、Menu Bar 应用
常驻在 macOS 顶部菜单栏，点一下就能看到当前用量，不用开终端。
2、终端脚本
也可以在终端直接运行脚本 python3 claude_usage.py。
原理
简单说下工具的数据来源。用量数据来自两个地方：
- API 数据：通过读取 macOS 钥匙串中 Claude Code 的 OAuth Token，调用 Anthropic 的 Usage API 获取每周额度和 5 小时窗口的使用百分比
- 本地数据：Claude Code 会在
~/.claude/projects/下记录每次对话的 JSONL 文件，工具扫描这些文件，按模型和日期汇总 Token 数量，再根据各模型的定价算出费用
两个数据源互补：API 告诉你额度用了多少，本地数据告诉你钱花在了哪里。
限制
Weekly 与每 5 小时周期到期后自动触发下一个周期依赖定时任务触发，电脑如果休眠了，定时任务就不会执行。所以如果你要使用这个功能，要么当前设备保持不休眠，要么用一台额外的设备来跑 Menu Bar 应用。
另外因为本地数据只能读取当前设备的 JSONL 文件，如果你在多台设备上使用 Claude Code，费用统计只会包含当前设备的部分。额度百分比不受影响，因为那是从 API 拿的，是账号级别的数据。
