Claude-Code-Usage-Monitor :帮助开发者实时跟踪Claude AI的令牌消耗,预测何时会耗尽,避免超出限制。
每3秒刷新一次,实时更新无闪烁;支持多种计划(Pro、Max5、Max20等),自动检测最高限制;提供智能预测,提前预警令牌耗尽时间
🔍 功能亮点
- 实时监控:每 3 秒自动刷新,在终端上显示当前会话的 Token 消耗情况
- 可视化进度条:用颜色条直观展示 Token 和时间使用比例
- 燃烧速度 & 预测:基于过去一个小时的消耗速率,预测当前会话 Token 是否会在重置前耗尽 。
- 多种订阅计划支持:支持 Pro、Max ×5、Max ×20 等主流计划,并可通过配置调整。
- 本地运行:完全本地化,不依赖网络认证或服务器 。
🌐 社群反馈
- 有人在 r/ClaudeAI 反映:“工具可预测是否会超出额度,会话结束前提前预警,非常有帮助”
- 在 Hacker News 的帖子中,也有用户表示:“它已经帮我避免了几次会话中途停止的尴尬”
同时,HN 上也有评论指出该项目“用 emoji 写 README 看起来有点不专业”,但作者回应:“如果它能用,就不傻” 。
🛠 实现原理
该工具主要依赖底层的 ccusage
模块,从 Claude Code 项目的日志(通常在 ~/.claude/projects/.../*.jsonl
)中读取详细的 Token 使用信息,然后进行频率分析、燃烧速率计算和预测
⚙️ 安装 & 使用
- 推荐方式是通过 [uv] 工具安装:
uv tool install claude-monitor claude-monitor
- 亦可直接从 GitHub 克隆仓库安装使用
- 支持自定义配置,例如设置计划、重置时区等,通过 JSON 文件调整。
✅ 总结
Claude-Code-Usage-Monitor 是一个开源、终端界面的实时监控工具,设计精巧,适用于 Claude Code 用户用来实时监测 Token 消耗、防止会话中断。功能实用、社区反馈积极,如果你经常使用 Claude 进行长会话或复杂任务,这个项目非常值得一试。需要帮忙安装或配置的话,也可以继续问我哦!
Github:https://github.com/Maciek-roboblog/Claude-Code-Usage-Monitor
油管:https://youtu.be/riBOnwj7r6A