A VS Code extension that shows your Claude subscription usage directly in the status bar — no browser required.
- Status bar display — live Daily and Weekly usage percentages at a glance
- Trend arrows —
↑/↓appear next to percentages when usage is rising or falling vs. an hour ago - Countdown to reset — shows time remaining (e.g.
Daily:26%↑·3h Weekly:20%→·5d) - Color-coded alerts — orange at ≥80%, red background at ≥100%
- Burn rate / pacing — tooltip shows your consumption rate (~X%/hr) and projected time to exhaustion, with a warning when you're on pace to exceed before reset
- Cooldown timer — when usage hits 100%, the status bar switches to a live countdown (
Claude: Resets in 47m) that updates every minute without extra API calls - Reset notification — get a desktop notification when a previously exhausted window drops back below 100%, so you know you can resume
- Hover tooltip — ASCII progress bars, exact reset times, trend deltas, and burn rate per window
- Detail panel — click the status bar item for a full breakdown with pacing gauges, bar charts, short-term sparklines (last 2 hours), and a 30-day daily history chart
- Persistent history — usage data survives VS Code reloads; daily peak values are stored for up to 3 months
- Model breakdown — optional Opus/Sonnet sub-bars in the tooltip
- Enterprise support — admin API keys (
sk-ant-admin-...) show token counts (Today/Week) with daily history - Auto token detection — reads your Claude Code credentials automatically, no setup needed
$(pulse) Daily:26%·3h Weekly:20%·5d ← normal (white)
$(pulse) Daily:26%↑·3h Weekly:20%→·5d ← with trend arrows (after 1h of data)
$(alert) Daily:81%↑·45m Weekly:20%·5d ← high usage ≥80%
$(warning) Daily:103%·now Weekly:95%·2d ← over limit ≥100%
$(clock) Claude: Resets in 47m ← cooldown countdown at 100%
$(pulse) Today:1.2M Week:8.5M ← enterprise / admin key
| Token type | Source | What you see |
|---|---|---|
| OAuth (auto) | ~/.claude/.credentials.json |
Daily % · Weekly % |
| OAuth (manual) | VS Code setting | Daily % · Weekly % |
Admin key (sk-ant-admin-...) |
VS Code setting | Token counts (Today / Week) |
Claude Code users are detected automatically — no configuration needed.
Install the extension and open any workspace. The extension reads your token from ~/.claude/.credentials.json automatically.
- Open the Command Palette (
Ctrl+Shift+P/Cmd+Shift+P) - Run Claude Meter: Enter Token
- Paste your OAuth bearer token
- Open VS Code Settings (
Ctrl+,) - Search for
claudeMeter.manualToken - Paste your admin key (
sk-ant-admin-...)
| Command | Description |
|---|---|
Claude Meter: Refresh Now |
Force an immediate data refresh |
Claude Meter: Show Details |
Open the detail panel |
Claude Meter: Enter Token |
Paste a token manually (saved to settings) |
Claude Meter: Clear Cached Token |
Remove the manually saved token |
| Setting | Default | Description |
|---|---|---|
claudeMeter.refreshIntervalMinutes |
10 |
How often to poll the API (1–60 min) |
claudeMeter.manualToken |
"" |
Override the auto-detected token |
claudeMeter.statusBarPosition |
"right" |
"left" or "right" side of the status bar |
claudeMeter.statusBarPriority |
100 |
Position within the chosen side (higher = further left) |
claudeMeter.showModelBreakdown |
false |
Show Opus/Sonnet sub-bars in the tooltip |
claudeMeter.displayMode |
"used" |
"used" shows percent consumed, "remaining" shows percent available |
claudeMeter.notifyAtThreshold |
0.9 |
Notify when any window hits this fraction (set to 1.0 to silence) |
claudeMeter.notifyOnReset |
true |
Show a notification when a previously exhausted usage window resets |
- VS Code 1.94 or later
- An active Claude subscription (Pro, Max, Teams, or Enterprise)
- Claude Code installed and authenticated, or a manually entered token