Claude Code Usage Monitor

VSCode extension that shows your Claude Code usage limits live in the status bar — both the 5-hour and 7-day rolling windows.

🟢 5h ████░░░░ 42%  |  🟡 7d ██████░░ 68%

What it does

The extension reads your locally stored Claude Code OAuth token and calls the Anthropic API every 5 minutes (configurable) to fetch your current utilisation for both quota windows. The result is shown as a progress bar in the VSCode status bar at the bottom right.

• 5-hour window — short-term rolling limit (resets 5 h after your first message)
• 7-day window — weekly rolling limit (resets 7 days after your first message)

Colour coding:

Click the status bar item → pick display mode (5h only, 7d only, both)
Hover → detailed tooltip with exact percentages and reset countdown

Requirements

Where credentials are stored

Installation

Option A — from a .vsix file (recommended)

If you already have a built .vsix file:

code --install-extension claude-usage-monitor-1.0.0.vsix

Or via the VSCode UI: Extensions → ··· → Install from VSIX…

Option B — build from source (requires Node.js ≥ 20)

git clone <this-repo>
cd claude-usage
npm install
npm run compile
npx @vscode/vsce package --no-yarn
code --install-extension claude-usage-monitor-1.0.0.vsix

Option C — manual folder install (Node.js 16 / no vsce)

1. Install dependencies and compile:

   npm install
   npm run compile
   

2. Copy the extension folder into VSCode's extensions directory:

   # Windows (PowerShell)
   Copy-Item -Recurse . "$env:USERPROFILE\.vscode\extensions\local.claude-usage-monitor-1.0.0"
   
   # macOS / Linux
   cp -r . ~/.vscode/extensions/local.claude-usage-monitor-1.0.0
   

3. Restart VSCode completely (close all windows, then reopen).

Configuration

Open Settings (Ctrl+,) and search for claudeUsage.

Commands

Open the Command Palette (Ctrl+Shift+P) and type:

Troubleshooting

Status bar shows "No token — run claude auth login"
→ Claude Code CLI is not authenticated. Run claude auth login in a terminal.

Status bar shows "Auth error — re-login to Claude Code"
→ The stored token has expired. Run claude auth login again.

Status bar shows "Rate limited — retrying in Xm"
→ The Anthropic usage API has a rate limit. The extension backs off automatically (5 min → 10 min → 20 min → max 60 min) and retries on its own. No action needed.

Status bar shows "Fetch failed"
→ Network error or temporary API issue. The extension will retry on the next interval.

Extension does not appear after install
→ Make sure VSCode was fully restarted (all windows closed). Check Help → Toggle Developer Tools → Console for any loading errors.