Claude Usage Tray

A tiny Windows tray icon that shows how much of your Claude usage limit is left.

Download · How it works · Privacy & security · FAQ

Note

Unofficial community project, not affiliated with or endorsed by Anthropic. It reads the same undocumented endpoint as Claude Code's /usage command, which may change without notice.

Features

• Glanceable — the icon is the number: percent of your 5-hour session left, in green, orange or red.
• Session and week — hover to see both limits and when they reset.
• Zero setup — uses your existing Claude Code sign-in. No API key, no config.
• Lightweight — 220 KB, refreshes every 2 minutes, optionally starts with Windows.
• Private — talks to api.anthropic.com only. No telemetry.

Install

1. Sign in to Claude Code with your Claude subscription.

2. Download one file from the latest release:

   File	Size	Requires
   ClaudeUsageTray-standalone.exe	~50 MB	Nothing
   ClaudeUsageTray.exe	~220 KB	.NET 10 Desktop Runtime

3. Move it somewhere permanent, e.g. %LOCALAPPDATA%\Programs\ClaudeUsageTray\, and run it.

4. Click Yes when asked to show the icon on the taskbar.

Usage

Icon	Meaning
🟩 83	More than 50% of your session left
🟧 34	20–50% left
🟥 7	Less than 20% left
⬜ ?	Loading, signed out or offline — a grey number is the last known value

Hover for details:

Claude usage
Session: 83% left (resets 17:50)
Week: 44% left (resets Sat 16:59)

Right-click for Refresh · Show on taskbar · Start with Windows · Exit.

How it works

flowchart LR
    A[".credentials.json<br/>written by Claude Code"] -- "read token" --> B["Claude Usage Tray"]
    B -- "GET /api/oauth/usage<br/>HTTPS, every 2 min" --> C["api.anthropic.com"]
    C -- "session and weekly utilization" --> B
    B --> D["Tray icon and tooltip"]

Loading

Every two minutes the app reads the OAuth access token Claude Code keeps on disk, asks the usage endpoint how much of each limit you've used, and shows what's left of the 5-hour session.

The app never refreshes the token itself: that would rotate it and sign Claude Code out. Claude Code refreshes it while you use it, and the tray picks up the new token automatically.

Privacy & security

Reads	Your access token from %USERPROFILE%\.claude\.credentials.json (read-only)
Sends	That token, over HTTPS, to api.anthropic.com — nowhere else
Writes	Only when you toggle them: a Run entry for Start with Windows, and Windows' own Show on taskbar setting — both under HKEY_CURRENT_USER
Never	Stores, logs or refreshes your token · Sends telemetry

Found a vulnerability? Please follow SECURITY.md. Never paste tokens into issues.

FAQ

I don't see the icon

Windows 11 hides new tray icons under ^ next to the clock. Right-click the icon there and choose Show on taskbar, or turn it on in Settings → Personalization → Taskbar → Other system tray icons.

The icon shows a grey ?

The token is missing or has expired. Open Claude Code and run any prompt so it refreshes the token; the icon recovers on its next refresh.

Windows SmartScreen blocks the download

Releases aren't code-signed yet. Choose More info → Run anyway, or build from source. Each release lists a SHA-256 digest per file, which you can compare with:

Get-FileHash .\ClaudeUsageTray.exe

Does it work with an API key, or on macOS / Linux?

No. It needs a Claude subscription signed in through Claude Code, and it's Windows-only.

How do I uninstall it?

Right-click the icon, untick Start with Windows, choose Exit, then delete the exe.

Build from source

Requires the .NET 10 SDK.

git clone https://github.com/Rovey/claude-usage-tray
cd claude-usage-tray
dotnet test
dotnet publish src/ClaudeUsageTray -c Release -o publish

Contributing

Issues and pull requests are welcome — see CONTRIBUTING.md.

License

MIT © 2026 Rovey