macOS 工具，追踪 Claude Code（会员订阅）的用量：配额、Token 消耗与费用估算、每日使用情况等。
- 5 小时窗口和每周额度的重置倒计时
- 每天已用的 Token 数量与对应费用，按模型（Opus / Haiku）分项显示
- 每天使用量占每周额度的百分比
- 历史使用记录（数据永久保存，展示最近 30 天）
- 每 30 分钟自动更新采集数据，每周额度重置后自动触发新周期
- 同时保持 5 小时会话窗口过期后自动触发新周期
- macOS（通过 Keychain 读取 OAuth token）
- Claude Code 已登录（
claudeCLI） - Python 3 + requests + rumps
常驻 macOS 菜单栏，实时显示 Claude 用量。
☁ 68.0% ← 标题：Session 用量
─────────────────────────────────────────
All models 57.0% 3d 22h left
Session 68.0% 3h 7m left
Extra usage 69.6% $696/$1000
─────────────────────────────────────────
Today $11.29 · 9.0% quota
13.9M in / 5K out
Cost Detail ▸
│ Opus 4.6: $11.29 = (251×$5 + 5K×$25 + 13.2M×$0.50(cr) + 732K×$6.25(cw)) /M
─────────────────────────────────────────
Local Daily ▸ ← 本机每日费用 30 天
Quota Daily ▸ ← 每日配额% 30 天
Weekly ▸ ← 周期用量 8 周
─────────────────────────────────────────
Updated 11:52 CST
Usage Settings ← 打开 claude.ai 用量设置
─────────────────────────────────────────
Quit
- 点击图标：显示缓存数据，同时后台调 API 采集，完成后实时更新菜单
- 每 30 分钟：自动调 API 采集更新（每天 6:00 开始，对齐整点 :00/:30）
git clone https://github.com/DeppWang/Claude-Code-Usage-Tracker.git
cd Claude-Code-Usage-Tracker
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
# 启动菜单栏应用
python3 claude_usage_app.py注意：首次运行后数据从零开始积累。Quota Daily、Local Daily、Weekly 等历史数据需要运行一段时间后才会出现。Quota Daily 的第一天因无前一天快照做差值计算，不会显示。
如果启动后菜单栏应用没有出现，先检查是否被遮挡，再检查是否使用的「framework build 的 Python」
# 菜单栏应用需要 framework build 的 Python，先验证：
python3 -c "import sysconfig; print(sysconfig.get_config_var('PYTHONFRAMEWORK'))"
# 输出应为 Python。如果为空，菜单栏图标将不会出现
# 如果用 pyenv，需加 --enable-framework 重新安装（只需一次）：
# env PYTHON_CONFIGURE_OPTS="--enable-framework" pyenv install $(pyenv version-name) --force也可以在终端直接运行脚本查看用量：
# 查看用量报告（自动采集最新数据后展示）
python3 claude_usage.pyCLI 输出示例
Claude Code Usage — 2026-02-12 11:52 (CST)
Usage
All models ....... 57.0% (resets at 2026-02-16 09:59 CST, 3d 22h left)
Current session .. 68.0% (resets at 2026-02-12 14:59 CST, 3h 7m left)
Extra usage ...... 69.6% ($696 / $1000 monthly)
Local Device Today's Usage
Tokens: 13,907,060 in / 5,109 out
Cost: $11.29
Opus 4.6: $11.29 = (251×$5 + 5K×$25 + 13.2M×$0.50(cr) + 732K×$6.25(cw)) /M
Daily: 9.0% of weekly quota
Local Device Daily Usage (last 30 days)
2026-02-12 (Thu) $11.29 13.9M in / 5K out
2026-02-11 (Wed) $21.66 28.1M in / 21K out
Quota Daily Usage (% of weekly quota, last 30 days)
2026-02-12 (Thu) 9.0% ██░░░░░░░░░░░░░░░░░░
Weekly Usage
02-09 09:59 ~ 02-16 09:59 57.0% ███████████░░░░░░░░░ (extra: $696 / $1000)
菜单栏应用内置 30 分钟定时器，不需要 launchd，如只使用脚本又想要自动触发新周期需使用 launchd 独立定时采集：
cp com.user.claude-usage-collector.plist ~/Library/LaunchAgents/
launchctl load ~/Library/LaunchAgents/com.user.claude-usage-collector.plist| 区域 | 数据来源 | 说明 |
|---|---|---|
| Usage | API 快照 | 7 天配额、5 小时会话、Extra Usage 的实时用量 |
| Today | 本地 JSONL | 本机当天的 Token 数、费用及按模型的计算公式 |
| Local Daily | local_usage.json | 本机最近 30 天每天的费用和 Token 汇总 |
| Quota Daily | 快照差值 | 每天消耗的配额百分比（API 数据，跨设备准确） |
| Weekly | weekly_usage.json | 每个 7 天周期的配额使用率和 Extra Usage |
每 30 分钟定时器触发时，保存数据并自动发送 claude --print --model haiku -p "hi"：
- 保持 5 小时会话窗口不过期
- 若恰好处于 7 天周期重置后，该请求同时触发新周期
仅定时器触发，点击菜单和 CLI 不会发送该请求。
简单说下工具的数据来源。用量数据来自两个地方：
- API 数据：通过读取 macOS 钥匙串中 Claude Code 的 OAuth Token，调用 Anthropic 的 Usage API 获取每周额度和 5 小时窗口的使用百分比。
- 本地数据：Claude Code 会在
~/.claude/projects/下记录每次对话的 JSONL 文件，工具扫描这些文件，按模型和日期汇总 Token 数量，再根据各模型的定价算出费用。
两个数据源互补：API 告诉你额度用了多少，本地数据告诉你钱花在了哪里。
- 数据源：
GET https://api.anthropic.com/api/oauth/usage - 认证：从 macOS Keychain 读取 OAuth token
- 返回
seven_day（7 天配额）、five_hour（5 小时会话）、extra_usage（超额用量）
通过相邻天快照的 seven_day.utilization 差值计算每天消耗的配额百分比：
- 按 CST 日期分组，每天取最后一个快照
- 同一 cycle 内：
daily_pct[D] = snapshot[D].util - snapshot[D-1].util - 跨 cycle 边界（
resets_at变化，5 分钟容差）：daily_pct[D] = snapshot[D].util
扫描 ~/.claude/projects/*/*.jsonl 中的 assistant 消息，按模型定价计算：
| 模型 | Input | Output | Cache Read | Cache Write |
|---|---|---|---|---|
| Opus 4.6/4.5 | $5/M | $25/M | $0.50/M | $6.25/M |
| Sonnet 4.5 | $3/M | $15/M | $0.30/M | $3.75/M |
| Haiku 4.5 | $1/M | $5/M | $0.10/M | $1.25/M |
Cache Read = Input × 0.1，Cache Write = Input × 1.25
菜单栏应用和 CLI 共享 ~/.claude-usage/：
| 文件 | 内容 |
|---|---|
snapshots.json |
API 原始快照（utilization、resets_at 等） |
daily_usage.json |
每天的配额使用百分比 |
local_usage.json |
本机每天的 Token/费用/模型明细 |
weekly_usage.json |
每个 7 天周期的起止时间和使用率 |
Weekly 与每 5 小时周期到期后自动触发下一个周期依赖定时任务触发，电脑如果休眠了，定时任务就不会执行。所以如果你要使用这个功能，要么当前设备保持不休眠，要么用一台额外的设备来跑 Menu Bar 应用。
另外因为本地数据只能读取当前设备的 JSONL 文件，如果你在多台设备上使用 Claude Code，费用统计只会包含当前设备的部分。额度百分比不受影响，因为那是从 API 拿的，是账号级别的数据。