Claude-Code-Usage-Monitor: Helps developers track Claude AI’s token consumption in real time, predict when it will run out, and avoid exceeding limits.
Refreshes every 3 seconds, real-time updates without flashing; supports multiple plans (Pro, Max5, Max20, etc.) to automatically detect the maximum limit; provides intelligent prediction to warn of token exhaustion time in advance
Function highlights
- real-time monitoring: Automatically refreshes every 3 seconds to display the Token consumption of the current session on the terminal
- Visualize progress bar: Use color bars to visually display Token and time usage ratio
- combustion rate prediction: Based on the consumption rate over the past hour, predict whether the current session Token will be exhausted before being reset.
- Multiple subscription plan support: Supports mainstream plans such as Pro, Max ×5, and Max ×20, and can be adjusted through configuration.
- run locally: Fully localized and does not rely on network authentication or servers.
Community feedback
- someone is r/ClaudeAI Reaction: “The tool can predict whether the limit will be exceeded, and it is very helpful to warn in advance before the session ends.”
- In a post on Hacker News, some users also said: “It has helped me avoid the embarrassment of stopping in the middle of a conversation several times.”
At the same time, a comment on HN pointed out that the project “seems a bit unprofessional to write README in emoji,” but the author responded: “If it works, it won’t be stupid.”
🛠Implementation principle
This tool relies mainly on the underlying ccusage Module, from the logs of Claude Code projects (usually in the ~/.claude/projects/.../*. jsonl), and then perform frequency analysis, combustion rate calculation and prediction
ˇ Install and use️
- The recommended method is to install it through the [uv] tool:
uv tool install claude-monitor claude-monitor - You can also install and use it directly from the GitHub clone repository
- Support custom configurations, such as setting plans, resetting time zones, etc., adjusted through JSON files.
Summary
Claude-Code-Usage-Monitor It is an open source, terminal-interface real-time monitoring tool. It is exquisitely designed and suitable for Claude Code users to monitor Token consumption in real time and prevent session interruption. With practical functions and positive community feedback, this project is well worth a try if you often use Claude for long sessions or complex tasks. If you need help with installation or configuration, you can continue to ask me!
Github：https://github.com/Maciek-roboblog/Claude-Code-Usage-Monitor
Oil tubing: