Home

ClaudeMeter

Real-time Claude AI usage monitor for Windows

ClaudeMeter is an ultra-lightweight system tray app that monitors your Claude Pro/Max subscription usage in real time. Built in Rust, it uses under 10 MB RAM and runs as a single portable .exe with zero dependencies.

Quick Links

• Installation — download, setup, first run
• Configuration — all settings explained
• Troubleshooting — common issues and fixes
• Building from Source — compile it yourself
• Contributing — translations, bug reports, PRs

How It Works

1. You install Claude Code and log in (one-time)
2. ClaudeMeter reads the OAuth token from ~/.claude/.credentials.json
3. It polls api.anthropic.com/api/oauth/usage every 2 minutes
4. Usage data is displayed in the system tray icon, tooltip, and dashboard popup

Features at a Glance

Feature	Details
System tray icon	Dynamic % with color coding (green/yellow/red)
Icon styles	Number, Ring (circular), or Bar (vertical fill)
Dashboard popup	Animated progress bars, 24h usage chart
Notifications	Configurable thresholds (50%, 75%, 90%)
Mini widget	Floating always-on-top PiP window
Themes	Dark, Light, Auto (follows Windows)
Languages	15 languages
Data export	CSV export, SQLite history (30 days)
Auto-update	Checks GitHub Releases on startup
Smart polling	Idle detection, exponential backoff

System Requirements

• Windows 10 or 11 (x86_64)
• Claude Code installed and logged in
• No other dependencies