I built a free menu bar app for macOS that shows your Claude usage (5h + weekly + per-model)
I got tired of running /usage in Claude Code every time I wondered how much of my 5-hour window was left, so I built a small menu bar app for it.
It shows the percentage used on the rolling 5-hour window, on the weekly window, and on each per-model quota the API reports. Clicking it opens a popover with a progress bar and a live countdown to every reset.
Requirements — please read before downloading:
- macOS 14 or later.
- Claude Code (the CLI) installed and logged in. This is the important one. ClaudeTray has no account of its own — it reads the OAuth token that Claude Code writes to your keychain. Install it, run claude, then /login. Installing alone does nothing; the login is what writes the token.
- The Claude desktop app is not a substitute. It only stores an Electron encryption key in the keychain, which isn't usable here.
- You don't have to actually use Claude Code afterwards — it just refreshes the token when it runs. If you never launch it, the keychain token eventually expires; in that case claude setup-token gives you one valid for a year that you can paste into the app.
- Tested on a Max subscription. I have no way to test other plans, so I genuinely don't know how it behaves on Pro or free.
A few things worth being upfront about:
- It uses an undocumented endpoint — the same one /usage hits. It can break without warning. The app is written to fail loudly rather than silently show 0%: it keeps the last valid data on screen and tells you exactly what failed (401, 429, unexpected schema, network).
- No ANTHROPIC_API_KEY anywhere. This reads subscription usage, not API billing.
- One outbound connection, to api.anthropic.com. No telemetry, no analytics, no third-party dependencies — Apple frameworks only. The token is never logged and never cached in memory.
- Polling is rate-limit aware: 90s while the 5-hour window is active, 7 min otherwise, exponential backoff on failure, and it pauses entirely while your Mac sleeps. You can also pin it to a fixed interval.
- Signed with a Developer ID and notarized by Apple, so no Gatekeeper warnings.
- Free, MIT licensed, all source is on GitHub.
Available in English, French, German, Spanish and Italian — it follows your macOS language by default, and you can force one from the settings.
Other settings: which windows to display, used vs remaining, colour of the numbers, spacing, notifications at 80% and 95%, and launch at login.
Download + source: https://github.com/ClawClawOne/ClaudeTray
Happy to take bug reports or feature requests in the issues. If it's useful to you there's a Buy Me a Coffee link on the repo, but the app is free and stays free either way ;-)
Not affiliated with Anthropic.