Both windows at once
The five hour session and the seven day allowance, each with a live countdown to the moment it resets.
See your Claude Code limits
before they stop you.
Claude Tracker sits in your macOS menu bar and turns your live session and weekly usage into a pizza you are steadily eating through. It checks once every sixty seconds.
Reads the same usage figures Claude Code reports in /usage
At a glance
One slice fills for every twenty percent you spend.
The icon lives in your menu bar and fills as you work, with the exact figure beside it. By the time the pizza is whole, so is your session limit.
You should never have to guess whether you have twenty minutes of Claude Code left, or four hours. Now it is on screen, all the time.
What it does
Four things, and nothing else.
Your token stays put
Read from the macOS Keychain and sent only to Anthropic. No account, no telemetry, nothing in between.
Quietly current
A check every sixty seconds in the background. The countdown keeps ticking between checks, so nothing looks frozen.
Honest when it breaks
If a check fails it keeps your last reading and marks it stale, rather than showing you a confident zero.
How it works
Three steps, once a minute.
-
01
It reads your Keychain
Claude Code keeps its OAuth token under
Claude Code-credentials. macOS asks your permission the first time and stays quiet after that. -
02
It asks Anthropic for your usage
One request, straight from your Mac, to the same endpoint Claude Code uses for its own usage display.
-
03
It repaints the menu bar
The icon, the percentage and any open panel update together. Then it waits a minute and does it again.
One thing worth knowing. The usage figures come from an endpoint Anthropic has not documented or published. It could change shape, or stop answering, with no notice.
The app is built expecting exactly that. If a response comes back in a form it does not recognise, it keeps showing your last good reading and flags it as stale instead of inventing a number.
Questions
The things people ask first.
Does my token ever leave my Mac?
Only to Anthropic. The app reads the token from your Keychain and sends it as a bearer token on one request to the usage endpoint. There is no server of ours in the path, no analytics, and nothing is written anywhere but your own machine.
Which limits does it track?
The rolling five hour session window and the seven day allowance. Both are shown with the percentage used and a countdown to the moment they reset.
Is this an official Anthropic app?
No. It is an independent project and it is not affiliated with or endorsed by Anthropic. It reads a usage endpoint that Claude Code itself calls, which Anthropic has never published.
What happens when the endpoint changes?
The parser treats every field as optional and checks two places for each figure. If a response arrives that it cannot read, it keeps your last good reading, marks the panel stale, and tells you why rather than showing a zero.
Do I need Claude Code installed?
Yes. The app has no login of its own. It borrows the credentials Claude Code already stored when you signed in, so if you have never signed in there is nothing for it to read.
Does it run on Windows or Linux?
Not today. The credential read uses the macOS Keychain and the icon is drawn as a macOS template image, so both would need replacing first.