Claude Usage Tracker - Chrome Extension

A Chrome extension that shows your Claude Pro/Max usage limits in real-time. Works on Windows, Linux, and macOS.

Features

• Badge shows usage % - See your 5-hour session usage at a glance
• Color-coded - Green (<50%), Orange (50-80%), Red (>80%)
• Full breakdown in popup:
  • 5-hour session with reset countdown
  • Weekly limit with reset date
  • Sonnet-specific weekly limit
  • Extra usage spending
• Configurable refresh - 1 min, 5 min, 30 min, or 1 hour
• Cross-platform - Works anywhere Chrome runs

Installation

From Source (Developer Mode)

1. Download or clone this repo
2. Open Chrome → chrome://extensions/
3. Enable "Developer mode" (top right)
4. Click "Load unpacked"
5. Select the claude-usage-extension folder

First-Time Setup

1. Click the extension icon
2. Paste your Claude OAuth token
3. Click "Save Token"

Finding Your OAuth Token

macOS (if using Claude Code)

security find-generic-password -s "Claude Code-credentials" -w

Copy the accessToken value from the JSON.

Windows

Open this file in a text editor:

%APPDATA%\Claude\credentials.json

Copy the accessToken value.

Linux

Open this file:

~/.config/claude/credentials.json

Copy the accessToken value.

Alternative: From Browser

1. Go to claude.ai and log in
2. Open DevTools (F12) → Application → Cookies
3. Find and copy a session token (if available)

Requirements

• Chrome browser
• Claude Pro or Max subscription
• Claude Code installed and logged in (to get the OAuth token)

Privacy

• Your token is stored locally in Chrome's extension storage
• Only communicates with api.anthropic.com
• No data sent anywhere else
• Open source - inspect the code yourself

Troubleshooting

"!" on badge

• Token may be invalid or expired
• Click extension → Re-enter Token

Token not working

• Make sure it starts with sk-ant-oat01-
• Try logging out and back into Claude Code to get a fresh token

License

MIT