今天就来教你怎么装个Claude Code用量监视器，实时查看使用额度、还带预测和警告!
Claude Code Usage Monitor
一款用于监控Claude AI TOKEN使用的额度实时终端监控工具，具有高级分析、基于机器学习的预测和丰富的用户界面。跟踪您的令牌消耗、燃烧速度、成本分析，并获得关于会话限制的智能预测。
主要功能
v3.0.0 主要更新
-
🔮 基于机器学习的预测 - P90 百分位计算和智能会话限制检测
-
🔄 实时监控 - 可配置刷新率（0.1-20 Hz）及智能显示更新
-
📊 高级丰富 UI - 美观的颜色编码进度条、表格和布局，符合 WCAG 对比度标准
-
🤖 智能自动检测 - 自动计划切换与自定义限制发现
-
📋 增强计划支持 - 更新限制：Pro (44k), Max5 (88k), Max20 (220k), Custom (基于 P90)
-
⚠️ 高级预警系统 - 多级警报，包含成本与时间预测
-
💼 专业架构 - 模块化设计，符合单一职责原则 (SRP)
-
🎨 智能主题 - 科学配色方案，自动检测终端背景
-
⏰ 高级调度 - 自动检测系统时区及时间格式偏好
-
📈 成本分析 - 模型特定定价，缓存令牌计算
-
🔧 Pydantic 验证 - 类型安全配置，自动验证
-
📝 全面日志记录 - 可选文件日志记录，支持可配置级别
-
🧪 广泛测试 - 100+ 测试用例，实现全面覆盖
-
🎯 错误报告 - 可选 Sentry 集成，用于生产环境监控
-
⚡ 性能优化 - 高级缓存和高效数据处理
默认自定义方案
自定义计划 现在是默认选项，专为 5 小时的 Claude Code 会话设计。它监控三个关键指标：
-
令牌使用 - 跟踪您的令牌消耗
-
消息使用 - 监控消息数量
-
成本使用 - 长时间会话最重要的指标
定制计划会根据您过去192小时（8天）的所有会话分析您的使用模式，并根据您的实际使用情况计算个性化限制。这确保了准确预测和针对您特定工作流程的警告。
安装使用流程
先搞定uv安装
uv是个新潮的Python包管理器，装起来贼快。还没装过？一行命令直接搞定：
# Linux/macOS
curl -LsSf https://astral.sh/uv/install.sh | sh
# Windows
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
装完记得重启终端，Claude Code得先跑起来，来两条消息热个身。
装监控面板，直接敲：
uv tool install claude-monitor
claude-monitor
pip也有办法
不想折腾uv？pip也能搞：
pip install claude-monitor
# 如果提示找不到命令，手动加PATH
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
claude-monitor
怎么用？
想看帮助，敲：
claude-monitor --help
选套餐：
claude-monitor --plan pro
claude-monitor --plan max5
claude-monitor --plan max20
换时区、调时间格式：
claude-monitor --timezone Asia/Shanghai
claude-monitor --time-format 24h
刷新频率自己定：
claude-monitor --refresh-rate 5
claude-monitor --refresh-per-second 1.0
主题想深想浅随你挑：
claude-monitor --theme dark
claude-monitor --theme light
claude-monitor --theme auto
每天几点重置自己说了算：
claude-monitor --reset-hour 9
claude-monitor --reset-hour 0
实时盯着用量：
claude-monitor --view realtime
看日统计、月统计：
claude-monitor --view daily
claude-monitor --view monthly
配置一次，省心到底
第一次运行可以把配置都带上：
claude-monitor --plan pro --theme dark --timezone Asia/Shanghai
以后直接跑，就自动记住你的偏好。要清空配置，来句：
claude-monitor --clear
总结
上来就是一目了然：用量百分比、还能发多少消息、多久重置、剩余时间全都有。再也不用担心突然断粮，撸Claude撸到飞起。
月底新规要上了，早点装好工具，省得临时抱佛脚。用量监控面板，码农的续命神器，建议人手一个。
项目地址：https://github.com/Maciek-roboblog/Claude-Code-Usage-Monitor