Claude Quota Tracker

Track your Claude.ai subscription usage directly in VS Code with real-time quota monitoring.

Perfect companion for Claude Code users! Stay on top of your usage while coding with Claude's AI assistance.

Why Use This Extension?

If you're using Claude Code extension for AI-powered coding assistance, this tracker helps you:

• 📊 Monitor your quota consumption in real-time
• ⚠️ Get warnings before hitting usage limits
• 🎯 Optimize your Claude usage throughout the day
• 📈 Track both 5-hour and 7-day usage windows

Features

• Real-time Usage Tracking: Monitor your Claude.ai quota usage directly in VS Code's status bar
• Visual Progress Bar: See your 5-hour and 7-day usage limits at a glance with visual progress bars
• Automatic Chromium Setup: Extension automatically prompts to install Chromium if not available
• Flexible Display Options: Choose between 5-hour or 7-day as primary display period
• Auto-refresh: Configurable auto-refresh intervals (default: 5 minutes)
• Color-coded Warnings: Status bar changes color based on usage thresholds
• Detailed Tooltips: Hover for detailed usage information and reset times
• Manual Refresh: Click the status bar to manually refresh quota data

Installation

1. Install the extension from the VS Code Marketplace
2. If prompted, allow the extension to install Chromium browser (required for fetching quota data)
3. Configure your Claude.ai credentials (see Configuration section below)

Configuration

Getting Your Credentials

To use this extension, you need two values from your Claude.ai account:

1. Session Key

1. Open https://claude.ai in your browser and log in
2. Open Developer Tools (F12 or Right-click → Inspect)
3. Go to the Application tab (Chrome/Edge) or Storage tab (Firefox)
4. Navigate to Cookies → https://claude.ai
5. Find the cookie named sessionKey
6. Copy its Value (starts with sk-ant-sid01-)

2. Organization ID

Option 1

1. Still in Developer Tools, go to the Network tab
2. Visit https://claude.ai/settings/usage
3. Look for a request to usage in the Network tab
4. Click on it and check the Request URL
5. Copy the UUID from the URL (format: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)

Example URL: https://claude.ai/api/organizations/9f3c2a6e-4b7d-4c5f-8f0a-2f5e6c1a9d42/usage Organization ID: 9f3c2a6e-4b7d-4c5f-8f0a-2f5e6c1a9d42

Option 2

1. Copy from Organization ID row in https://claude.ai/settings/account

Setting Up in VS Code

1. Open VS Code Settings (Ctrl+, or Cmd+,)
2. Search for "Claude Quota"
3. Set your Session Key and Organization ID
4. Optionally configure:
   • Usage Period: Choose "5-hour" (default) or "7-day" as primary display with progress bar
   • Refresh Interval: How often to check usage (in milliseconds, default: 300000 / 5 minutes)
   • Warning Threshold: When to show yellow/red warning (default: 80%)

Alternatively, add these to your settings.json:

{
  "claudeQuota.sessionKey": "sk-ant-sid01-YOUR_SESSION_KEY_HERE",
  "claudeQuota.organizationId": "your-org-id-here",
  "claudeQuota.usagePeriod": "5-hour",
  "claudeQuota.refreshInterval": 300000,
  "claudeQuota.warningThreshold": 80
}

Usage

Once configured, the extension will automatically:

• Display your Claude usage in the status bar
• Show a progress bar for your 5-hour window usage
• Display 7-day window percentage
• Auto-refresh at the configured interval
• Change colors based on usage (green → yellow → red)

Status Bar Format: Claude: 5h ████████░░ 83% | 7d 22%

Commands

Access via Command Palette (Ctrl/Cmd + Shift + P):

• Claude Quota: Refresh Usage - Manually refresh quota data
• Claude Quota: Show Details - Show detailed usage information

Requirements

• VS Code 1.75.0 or higher
• Active Claude.ai subscription
• Valid session credentials
• Internet connection
• Chromium browser (automatically installed by extension if not available)

Privacy & Security

• Your credentials are stored locally in VS Code settings
• All requests are made directly to Claude.ai official API
• No data is collected or sent to third parties
• Note: Your session key is sensitive - treat it like a password

Troubleshooting

"Chromium required" error

If you see this error, click on it and choose "Install Now" to automatically install Chromium. Alternatively, run npx playwright install chromium in your terminal.

Chromium fails to launch (containers / minimal servers)

On minimal environments like LXC containers or headless servers, Chromium may download but fail to launch due to missing system libraries. Install the browser with its OS dependencies:

npx playwright install --with-deps chromium

This runs apt-get install for the required libraries (libnss3, libgbm1, libasound2, etc.). Requires root or sudo.

"Session key and organization ID not configured"

Make sure you've set both credentials in Settings → Claude Quota

Quota not updating

• Check your internet connection
• Verify your session key is valid (they can expire)
• Get a new session key from your browser if expired

HTTP 403 errors

Your session key may have expired. Get a fresh session key from browser cookies.

Known Issues

• A tiny browser window (1x1 pixel) positioned off-screen may briefly appear when fetching data (required to bypass Cloudflare protection)
• Session keys expire periodically and need to be updated manually

Release Notes

See CHANGELOG.md for detailed release notes and version history.

Support

For issues or feature requests, please visit the GitHub repository.

Note: This extension is not officially affiliated with Anthropic. It's a community-built tool to help developers track their Claude.ai subscription usage.

Enjoy tracking your Claude usage!