Claude Meter
A VS Code extension that shows your Claude subscription usage directly in the status bar — no browser required.
Features
- 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%
- Hover tooltip — ASCII progress bars, exact reset times, and
+X% vs 1h ago trend deltas per window
- Detail panel — click the status bar item for a full breakdown with 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
Status Bar
$(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%
$(pulse) Today:1.2M Week:8.5M ← enterprise / admin key
Token Support
| 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.
Setup
Claude Code users (automatic)
Install the extension and open any workspace. The extension reads your token from ~/.claude/.credentials.json automatically.
Manual token
- Open the Command Palette (
Ctrl+Shift+P / Cmd+Shift+P)
- Run Claude Meter: Enter Token
- Paste your OAuth bearer token
Enterprise / Admin key
- Open VS Code Settings (
Ctrl+,)
- Search for
claudeMeter.manualToken
- Paste your admin key (
sk-ant-admin-...)
Commands
| 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 |
Settings
| Setting |
Default |
Description |
claudeMeter.refreshIntervalMinutes |
5 |
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.notifyAtThreshold |
0.9 |
Notify when any window hits this fraction (set to 1.0 to silence) |
Requirements
- 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
Links
| |
