地主家也没余粮啊——Claude Code即将开始限流。对于高强度用户来说,这确实是个值得关注的信号。好在已有开发者推出了配套的用量监控工具,可以实时追踪API使用情况,帮你用量超标前及时踩刹车。
这次要介绍的就是Claude Code Usage Monitor的安装与使用方法,操作起来并不复杂。
使用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并至少发送两条消息——这一步不能省略,否则监控器无法获取到数据。
接下来安装监控器本身:
# 从PyPI直接安装 uv tool install claude-monitor # 运行监视器 claude-monitor
使用pip安装
如果你更习惯传统方式,走pip路线也可以:
# 直接安装 pip install claude-monitor # 如果提示命令未找到,需要添加到PATH echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc source ~/.bashrc # 运行监视器 claude-monitor
基础使用指南
查看帮助信息
claude-monitor --help
指定计划类型
Claude Code目前提供Pro、Max5和Max20三种计划,对应的额度各不相同:
# Pro计划 claude-monitor --plan pro # Max5计划 claude-monitor --plan max5 # Max20计划 claude-monitor --plan max20
时区和时间格式设置
默认时区可能不是你所在的时区,手动指定一下更顺手:
# 设置时区 claude-monitor --timezone America/New_York # 设置时间格式 claude-monitor --time-format 24h
刷新率配置
数据刷新率与显示刷新率是两个概念,前者决定多久拉取一次新数据,后者决定界面更新的流畅度:
# 设置数据刷新率(1-60秒) claude-monitor --refresh-rate 5 # 设置显示刷新率(0.1-20赫兹) claude-monitor --refresh-per-second 1.0
主题设置
深色、浅色或自适应,看个人喜好:
# 深色主题 claude-monitor --theme dark # 浅色主题 claude-monitor --theme light # 自动检测 claude-monitor --theme auto
自定义重置时间
额度的每日重置时间可以自行设定,比如你想让它在上午9点刷新:
# 设置每日重置时间为上午9点 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 America/New_York
后续运行自动恢复设置
claude-monitor --plan pro
清除保存的配置
如果配置有误或想重置,可以一键清除:
claude-monitor --clear
运行界面预览
配置完成后,启动成功后看到的界面大致是这个样子:

界面中会清晰显示当前用量——比如0.3%已使用,预计还能发送338条消息。下方的"Time to Reset"则表明剩余时间,Claude会话将在4小时40分钟后重置,届时所有使用限制都会刷新。
这个月底新的限制政策就要正式落地,提前搭配这样一款监控工具,心里有数总比措手不及要好。
