主题
用量监控工具
实时看 Claude Code / Codex 的 token 消耗 + 成本预测 + 限速预警。Max 订阅用户必备（防止突然爆额度）。
为什么需要
2026 年 3 月 Claude Code v2.1.89 发布后，Max 20x 套餐有用户 70 分钟内就用完了。监控工具能提前预警 + 找出烧 token 的元凶。
推荐工具速览
| 工具 | 类型 | 推荐度 |
|---|---|---|
| ccusage | 历史分析（CLI） | ⭐⭐⭐⭐⭐ |
| Claude-Code-Usage-Monitor | 实时监控 + ML 预测 | ⭐⭐⭐⭐⭐ |
| ccmonitor | 滚动窗口 + watch 模式 | ⭐⭐⭐⭐ |
| ccflare | Web UI dashboard | ⭐⭐⭐⭐ |
| claude-doctor | 诊断 + 健康检查 | ⭐⭐⭐ |
ccusage（历史分析，最常用）
安装
bash
# 零安装直接跑（推荐）
npx ccusage
# 或全局装
npm install -g ccusage用法
bash
# 今天用量
ccusage daily
# 本月汇总
ccusage monthly
# 按会话统计
ccusage session
# 5 小时计费窗口（Max 套餐对应）
ccusage blocks输出示例
$ ccusage daily
Daily Usage — 2026-05-12
Model Sessions Input Output Cache R Cost
─────────────────────────────────────────────────────────────────────────
claude-opus-4-7 12 24.4k 364.4k 174.1M $104.67
claude-haiku-4-5-20251001 47 53.6k 2.4k 0 $0.10
─────────────────────────────────────────────────────────────────────────
Total 59 $104.77
Top 3 Sessions by Cost:
1. /Users/mini/Project/myapp 2h 04m $89.32
2. /Users/mini/Project/feature 45m $12.18
3. /Users/mini/scratch 10m $3.27重点功能
| 功能 | 命令 |
|---|---|
| 按模型分组 | ccusage daily --by-model |
| 按目录分组 | ccusage daily --by-cwd |
| 导出 JSON | ccusage daily --json |
| 指定日期 | ccusage daily --date 2026-05-10 |
| 实时监视 | ccusage live |
Claude-Code-Usage-Monitor（实时监控）
Maciek-roboblog/Claude-Code-Usage-Monitor
安装
bash
# pipx（推荐）
pipx install claude-monitor
# 或 pip
pip install --user claude-monitor启动
bash
claude-monitor
# 或简写
cmonitor
ccmonitor
ccm显示内容
╭─ Claude Code Live Monitor ─────────────────────────────╮
│ │
│ Current Session: │
│ Model: claude-opus-4-7 │
│ Started: 14:23 (1h 47m ago) │
│ Tokens: 2.3M / 1M billing window │
│ │
│ 5h Rolling Window: ████████████░░░░░ 72% used │
│ ETA to limit: 45 min │
│ │
│ Predicted exhaustion: 18:32 (Max 20x plan) │
│ ⚠️ Switch to Haiku to extend │
╰─────────────────────────────────────────────────────────╯特性
- ML 预测：基于当前消耗速度预测何时爆额度
- 多套餐识别：自动识别 Pro / Max 5x / Max 20x 限额
- 多窗口提示：5 小时 / 周 / 月窗口同时显示
- 限速预警：接近限额自动提醒切模型
ccmonitor（最简单）
零安装直接跑
bash
npx ccmonitor特点
- 滚动窗口监控（5h / 7d）
- 内置 watch 模式（自动刷新）
- 颜色编码进度条
- 准确成本计算
用法
bash
npx ccmonitor # 默认 5 小时窗口
npx ccmonitor --watch # watch 模式
npx ccmonitor --json # JSON 输出ccflare（Web Dashboard）
如果你想要浏览器图表 + 交互筛选：
bash
npm install -g ccflare
ccflare start
# 浏览器打开 http://localhost:8765功能：
- 折线图：token 消耗趋势
- 饼图：按模型成本占比
- 热力图：按时段使用
- 交互筛选（项目 / 模型 / 日期）
适合长期使用者复盘。
监控数据从哪来
所有这些工具都读 Claude Code 本地的 JSONL 日志：
~/.claude/projects/<encoded-path>/<session-uuid>.jsonl每次 Claude Code 调用 API 都会写一行 JSON 记录，包含：
- 时间戳
- 模型名
- 输入/输出 token 数
- cache_read / cache_creation
- 成本（按官方价计算）
完全本地，不上传任何东西。
实战工作流：每日复盘
bash
# 早上看昨天用了什么
ccusage daily --date yesterday
# 看哪个项目烧钱
ccusage daily --by-cwd
# 看每个模型的命中率
ccusage daily --by-model | grep cache发现某个项目突然花了很多 → 检查 CLAUDE.md 是不是膨胀 / context 是否爆了。
实战工作流：Max 用户防限速
bash
# 启动时挂着 claude-monitor
tmux new-session -d -s monitor 'claude-monitor'
# 工作中用 statusline 看实时
# （详见 statusline 章节）接近限额时 monitor 弹通知 → 立刻 /model claude-haiku-4-5-20251001 切便宜模型续命。
集成到 CI
可以把 ccusage 接到 CI 跑每周报告：
yaml
# .github/workflows/usage-report.yml
on:
schedule:
- cron: '0 9 * * 1' # 每周一 9 点
jobs:
report:
runs-on: ubuntu-latest
steps:
- run: |
npx ccusage weekly --json > usage.json
# 用 jq 提取数据
# 发送到 Slack / 飞书跟 statusline 配合
| 工具 | 角色 |
|---|---|
| statusline（CCometixLine 等） | 实时一行展示 |
| claude-monitor | 详细面板 |
| ccusage | 历史分析 |
| ccflare | 长期 dashboard |
四个互补，按需启用。
选哪个的决策
你的需求？
├─ 偶尔想看用了多少 → ccusage daily（零安装）
├─ Max 套餐怕爆额度 → claude-monitor 长期开
├─ 团队/老板看报告 → ccflare（图表漂亮）
├─ 一直挂着看 → CCometixLine statusline + claude-monitor
└─ 调试 Claude 慢 → claude-doctor 健康检查中转 Provider 的对应工具
如果你用 Shuro 等中转：
| 中转 | 工具 |
|---|---|
| Shuro | 控制台「日志」+「价格」页（new-api 自带） |
| 通用 | 上面 ccusage 系列都通用（读本地 JSONL） |
中转 Provider 也会按你这边的 JSONL 计算，数字基本一致（除非 Provider 加价倍率特殊）。