quota-tracker

Quota Tracker

Monitor your Claude Code quota in real time by intercepting Anthropic API rate limit headers.

When to Use

• "How much quota do I have left?"
• "Am I close to the rate limit?"
• "When does my quota reset?"
• Before starting expensive tasks

How It Works

A credential proxy sits between Claude Code and the Anthropic API. It reads anthropic-ratelimit-unified-* headers from every API response and writes quota state to a JSON file.

Quick Check

# Read current quota state
cat quota-state.json

Output includes:

• anthropic-ratelimit-unified-5h-utilization — % of 5-hour window used
• anthropic-ratelimit-unified-7d-utilization — % of 7-day window used
• anthropic-ratelimit-unified-5h-reset — when the 5h window resets (epoch)
• anthropic-ratelimit-unified-7d-reset — when the 7d window resets (epoch)
• anthropic-ratelimit-unified-status — "allowed" or "rejected"

Setup

1. Start the credential proxy

npx tsx "$SKILL_DIR/scripts/credential-proxy.ts"

This starts on port 7846 and reads OAuth credentials from macOS keychain.

2. Route Claude Code through the proxy

ANTHROPIC_BASE_URL=http://localhost:7846 claude ...

Or add to your voice agent's launchd plist:

<key>ANTHROPIC_BASE_URL</key>
<string>http://localhost:7846</string>

3. Read quota state

python3 "$SKILL_DIR/scripts/read-quota.py"           # human readable
python3 "$SKILL_DIR/scripts/read-quota.py" --json     # machine readable
python3 "$SKILL_DIR/scripts/read-quota.py" --gate     # exit 1 if exhausted OR not routed

Requirements

• macOS (reads OAuth from keychain)
• Claude Code logged in (subscription or API key)
• Node.js with tsx