wtf is claude-code-meter?

Claude Code Meter is a Windows tool that shows how much of your Claude Code usage plan you have used, right in the taskbar next to the clock. It displays three numbers: how much of your rolling five hour session window you have used, how much of your seven day weekly window you have used, and a calculated month to date figure that is scaled to match your plan. The tool gets these numbers directly from the same source Claude Code itself uses. Every so often it sends a tiny request, using only about one token, through the OAuth login token that Claude Code already stores on your computer, and reads the usage percentages that come back in the response. Because your Claude plan has no built in monthly limit, only the five hour and weekly windows, the meter works out a monthly estimate on its own. It does this by looking at how many tokens you have used in the current week from your local usage logs, figuring out what one hundred percent of your weekly limit represents in tokens, and then showing the month on that same scale. It saves its best estimate over time to make this calculation more accurate, and it can also reconstruct a history of previous weeks using the same method. The meter only reflects usage on the computer where it is installed and for the account signed in through Claude Code. It does not see activity from Claude on the web, other computers, or from an API key alone, since API only setups do not receive the same usage information. To use it, you need Windows 10 or 11 and an active Claude subscription. You can either download a ready to run executable file with no other requirements, or install it as a Python package if you have Python 3.9 or newer. Once running, it can display as a bar embedded in the taskbar, an icon in the system tray, or a small floating panel, and settings such as how often it checks usage can be adjusted through a configuration file. The project is released under the MIT license.