Claude Code usage at a glance, right in the VS Code status bar:
Status bar: live 5-hour and 7-day (weekly) rate-limit utilization, e.g. 5h 42% · 7d 63%, with warning/error coloring as you approach the limits. A refresh button next to it lets you update on demand without opening the dashboard.
Hover it for a quick card: today / 7-day / month-to-date cost and tokens, your top model, and a 7-day sparkline — all before you even click.
Daily stacked bar chart of the last 7 days, with cost
Per-model breakdown table with cost and request counts
6-month token trend line chart
Status bar hover
Full dashboard (click the status bar item)
How it works
Rate limits come from the same endpoint Claude Code's /usage command uses (api.anthropic.com/api/oauth/usage), authenticated with your existing Claude Code OAuth token (macOS Keychain, or ~/.claude/.credentials.json). These numbers are account-wide. No other data leaves your machine.
Token counts are parsed from Claude Code's local transcripts (~/.claude/projects/**/*.jsonl) — fully offline, with caching so refreshes only re-read changed files. These cover this machine only; usage from other devices or claude.ai is not included.
Requirements
Claude Code installed and signed in (claude → /login) with a Pro/Max subscription.
VS Code 1.85+.
Development
npm install
npm run compile
Then press F5 in VS Code to launch an Extension Development Host.
Package with (clears out any old .vsix first):
npm run package
Settings
Setting
Default
Description
claudeUsageStats.pollIntervalMinutes
5
How often to refresh limit data
claudeUsageStats.claudeDataDir
~/.claude
Claude Code data directory
claudeUsageStats.warnThreshold
80
% at which status bar turns warning color
claudeUsageStats.dangerThreshold
95
% at which status bar turns error color
claudeUsageStats.highUsageThreshold
90
5-hour utilization % at/above which polling speeds up
claudeUsageStats.highUsagePollIntervalSeconds
30
Poll interval while 5-hour utilization is at/above highUsageThreshold
Caveats
The usage endpoint is unofficial; if Anthropic changes it, limit display degrades gracefully (token stats keep working).
Transcript retention follows Claude Code's cleanupPeriodDays (default 30 days), so 7-day history is normally complete.
