Claude Usage Meter

Your real Claude usage in the status bar — and when the number stops being current, it says so instead of pretending.

⟳ 21% (resets in 2h 11m) · 24% (resets in 4d 4h) · Fable 12%

The rolling 5-hour session window, then the rolling 7-day window, each with its reset countdown — then Fable, Anthropic's weekly sub-cap on Max/Premium plans, shown by name when your account has one. Every percentage is read straight from Anthropic's own usage endpoint, not estimated locally.

Unofficial. This is an independent, community-built extension. It is not made by, endorsed by, or affiliated with Anthropic. "Claude" is Anthropic's trademark and is used here only to describe what the extension reads.

Screenshots

All three images below are real captures — the maintainer's own usage at one point in time, not a live reading of yours.

What makes this one different

• A stale reading says so. Past its age limit or a throttle, the bar shows the reading's age (12m old) instead of a frozen number pretending to be current.
• It never shows a number it did not get. A failed request renders —, never 0%. No demo mode, no simulated data.
• One reading per machine. Every open editor window shares a single request and a single backoff instead of polling separately.
• The one derived figure is off by default, and always labelled est. — every other number here is one Anthropic reported.
• It reads only a Claude Code OAuth token — sent to exactly one host, never logged or persisted. See Authentication.
• Ships a terminal status line too, for zero extra requests, reusing the same snapshot.

Install

Search Claude Usage Meter in the Extensions view, or:

code --install-extension shivakrishnakokkula.claude-usage-meter

Also on Open VSX, so Cursor, Windsurf and VSCodium can install it too. Whichever editor you use, it reads a Claude Code sign-in — not that editor's own AI sign-in.

Settings

In your terminal

Installs a matching Claude Code status line: run Claude Usage Meter: Install Claude Code Status Line from the Command Palette. It reads the same shared snapshot the status bar already maintains, so it costs zero extra API requests.

Commands

• Show Details — full breakdown, plus network diagnostics
• Refresh Now
• Open Official Usage Page
• Send Feedback
• Install Claude Code Status Line

Authentication

Reads the OAuth token Claude Code already stores locally (an environment variable, its credentials file, or — on macOS — its keychain item). Sent as a bearer header to api.anthropic.com and nowhere else: no telemetry, no analytics, no update check of its own. The token is never logged, never written to the output channel, and never persisted by this extension — it is only ever read, never written or refreshed.

Feedback

Use the Send Feedback command, or the Q & A tab of this listing — this repository is private, so there is no public issue tracker.

Licence

MIT.