Claude Usage Tracker (Unofficial)
Unofficial. This extension is not made by or affiliated with Anthropic.
"Claude" is a trademark of Anthropic; the name is used here descriptively only.
Shows your Claude Code usage live in the status bar — the 5-hour limit and the
weekly limit — with the exact same numbers as the /usage command.
Claude 9% · 17%
Click the status bar item for a details panel with progress bars and reset timers.
Features
- Status bar with 5-hour and weekly percentage (click = details).
- Turns yellow/red as you approach your limit.
- Tooltip with bars, reset timers and extra-usage credits.
- Details panel (webview) with progress bars.
- Warnings at 80% / 90% / 95% (configurable).
- Keeps showing the last known value when offline or when the token has expired.
How it works
The extension reads your local OAuth token (from ~/.claude/.credentials.json, or
the macOS Keychain) and calls the same endpoint Claude Code uses internally:
GET https://api.anthropic.com/api/oauth/usage
The response contains the exact percentages and reset times — so nothing is
estimated, these are the real, server-side values.
Requirements
- An active Claude subscription (Pro or Max).
- Claude Code installed and signed in on this machine (it provides the token).
Settings
| Setting |
Default |
Meaning |
claudeUsage.pollIntervalSeconds |
300 |
Fetch interval in seconds. |
claudeUsage.statusBarMetric |
both |
both / fiveHour / sevenDay. |
claudeUsage.warnThresholds |
[80,90,95] |
Warning thresholds. |
claudeUsage.credentialsPath |
"" |
Path to .credentials.json (empty = auto). |
claudeUsage.showExtraUsage |
true |
Show extra-usage credits. |
Privacy
Your token stays local. A single HTTPS request goes to api.anthropic.com
(Anthropic itself) to fetch your own usage — nothing else is sent, there is no
telemetry, and there are no external dependencies.
Limitations
- Works only with a Claude subscription signed in through Claude Code.
- If the token expires while Claude Code hasn't run for a while, the status bar
shows
Claude: auth — start a claude session briefly to refresh the token.
- The endpoint used is not officially documented and may change at Anthropic's discretion.
Development
npm install
npm run compile
# then press F5 for an Extension Development Host
License
MIT — see the bundled LICENSE file.
