Claude Tracker
Windows system tray app for real-time Claude AI usage monitoring
Note: Windows may show a SmartScreen warning on first run. Click "More info" → "Run anyway" — this is expected for unsigned apps.
Get instant visibility into your Claude session and weekly usage, overage costs, and receive alerts before hitting rate limits. Windows port of Claude Usage Tracker (macOS).
Features
- Real-time usage monitoring — Session (5-hour) and weekly usage percentages, Opus/Sonnet breakdowns
- Floating widget — Always-on-top compact widget with dock/undock, switchable from the popover
- 5 tray icon styles — Battery, Progress Bar, Percentage, Ring, Compact (Dot)
- Custom icon colors — Status-based (green/orange/red), monochrome, or pick any color
- Multi-profile support — Manage multiple Claude accounts with isolated credentials
- Notifications — Configurable alerts at 75%, 90%, 95% usage thresholds
- API billing tracking — Monitor console spend and prepaid credits
- Claude Code CLI sync — Automatically reads OAuth tokens from Windows Credential Manager
- Auto-start sessions — Detects 0% usage reset and starts a new session automatically
- Auto-update — Built-in update system with delta packages via Velopack
- Global hotkey — Toggle the dashboard with
Ctrl+Shift+C
- Dark/Light theme — Follows system theme or manual override
- DPI-aware — Crisp icons at any display scaling (100%-200%)
Installation
Installer (Recommended)
- Download
Setup.exe from the latest release
- Run the installer — it will create a Start Menu shortcut and handle updates automatically
- Future updates are applied in-app via Settings > About > Check for Updates
Portable
- Download the
ClaudeTracker-*-portable-win-x64.zip from Releases
- Extract to any folder
- Run
ClaudeTracker.exe
Note: The portable version does not support auto-updates.
Build from Source
Requirements:
- .NET 8 SDK or later
- Windows 10 (build 19041) or later
git clone https://github.com/TobiiNT/ClaudeTracker.git
cd ClaudeTracker
dotnet build
dotnet run --project src/ClaudeTracker
Setup
- Launch Claude Tracker — it appears in the system tray
- Right-click the tray icon > Settings
- Go to the Connect tab
- Choose one of the authentication methods below
Authentication Methods
| Method | How to configure |
|---|
| Claude Code CLI (easiest) | If you use Claude Code, Claude Tracker automatically reads its OAuth token from Windows Credential Manager. No manual setup needed. |
| Claude.ai session | In the Connect tab, paste your session token and click Test Connection. Select your organization and save. |
| API Console | Enter your API console session token to track billing and prepaid credits. |
Configuration
Settings are stored in %APPDATA%\ClaudeTracker\settings.json. Logs are written to %APPDATA%\ClaudeTracker\logs\.
| Setting | Default | Description |
|---|
| Refresh interval | 60s | How often usage is fetched (10-300s) |
| Icon style | Battery | Tray icon visualization style |
| Theme | System | Auto, Light, or Dark |
| Notifications | Enabled | Alert at 75%, 90%, 95% |
| Launch at login | Off | Start with Windows via Registry |
| Auto-start session | Off | Auto-start when usage resets to 0% |
Tech Stack