Claude.ai Token Tracker

See your Claude.ai quota usage in the VS Code status bar. Session, weekly and model-specific limits, all without leaving your editor.

⚠️ The Chrome extension is required — this VS Code extension does not work standalone.

This is the readout. The actual quota data comes from the Claude Token Tracker Chrome extension. Without it the status bar will stay empty / show "waiting…" forever.

Setup (in this exact order)

1. Install the Chrome extension first from the Chrome Web Store — this is the data source
2. Install this VS Code extension — this is the readout
3. Open claude.ai in Chrome and send any message
4. Your quota appears in the VS Code status bar within seconds
5. Keep a claude.ai tab open in Chrome to stay fresh. The Chrome extension only sends updates while claude.ai is loaded: on every message, on tab focus, and every 5 minutes when the tab is visible. If you close the tab, the status bar will show Xm old until you reopen claude.ai.

If you skip step 1, this extension cannot work. There is no API key fallback, no manual data entry, no standalone mode. The Chrome extension is what reads your live Claude.ai session — this extension just shows what it found.

Status bar at a glance

• $(pulse) 5h: 25% · 7d: 40% — healthy (under 70%)
• $(warning) 5h: 75% · 7d: 60% — warning (over 70%)
• $(error) 5h: 95% · 7d: 90% — critical (over 90%)

Hover the status bar item for a detailed breakdown of every window. Click it for a full quick-pick list including model-specific weekly caps and your overage balance.

How to save tokens

Click the status bar item and choose "How to save tokens" for practical tips on getting more out of your Claude quota: prompt strategies, model switching, CLI usage and what to do when you are near the limit.

Settings

• claudeTokenTracker.port (default: 7823) — change only if 7823 conflicts with another local service.
• claudeTokenTracker.statusBarShow — session-and-weekly (default) or session-only for a more compact readout.

How it works

The Chrome extension POSTs your quota snapshots to a local port in the 7823-7832 range (a tiny HTTP server this extension runs locally). All data stays on your machine. Nothing is sent to any external server.

Privacy

Zero outbound network calls. Zero analytics. The extension only:

• Listens on 127.0.0.1 on a port in the 7823-7832 range (loopback only, not reachable from the network)
• Reads JSON quota payloads POSTed by the Chrome extension
• Renders them in the VS Code UI

No conversation content, no API keys, no personal data.

Support this extension

Both extensions are free and open source. If they save you time, a coffee helps:

Support on Ko-fi

License

MIT