ClaudeUsageTray is a Windows system tray application designed to monitor Claude Code usage in real-time. It provides accurate session and weekly usage percentages directly from Anthropic's backend, ensuring you stay informed about your quota without relying on external services or telemetry.
Key Features:
Real-time monitoring of Claude Code usage via the claude -p "/usage" command.
Color-coded gauge in the tray indicating current session usage (green <60%, amber 60-85%, red >85%).
Tooltip and menu display showing 7-day usage percentage and reset times for both windows.
Toast notifications at 50/75/90/100% of session usage, resetting with a new session window.
Automatic refresh every 60 seconds or manual refresh via the tray menu.
Target Audience and Benefits:
Ideal for developers using Claude Code who need precise, real-time tracking of their usage. The application offers timely notifications to help manage quotas effectively while maintaining a clean, unobtrusive interface.
ClaudeUsageTray is available via Windows Package Manager, making deployment straightforward with the winget command line.
README
Claude Usage Monitor
Windows systray app showing your real Claude Code usage — no external
services, no telemetry, no guessed token limits.
What it does
Runs claude -p "/usage" (the same slash command you'd type interactively)
and parses the real session/weekly percentages Claude Code reports straight
from Anthropic's backend — the actual account quota, not a locally
estimated approximation.
Shows a color-coded ring gauge in the tray for the current 5-hour session:
green (<60%), amber (60-85%), red (>85%).
Tooltip and menu also show the current 7-day usage percentage, plus both
windows' reset times.
Fires a toast notification at 50/75/90/100% of session usage, resetting
once Claude Code reports a new session window.
Refreshes every 60 seconds, or on demand via "Refresh now" in the tray menu.
Requires the claude CLI to be installed and authenticated on the machine
running this app (it shells out to it — there is no other local source for
the real quota numbers).
Build
go build -ldflags "-H=windowsgui" -o claude-monitor.exe .
The -H=windowsgui flag suppresses the console window when launching the
exe directly.
Run at login (optional)
Create a shortcut to claude-monitor.exe in shell:startup.