# claude-usage

Claude API usage monitor with dual-path authentication.

## Two API Paths

### 1. Web API (Primary) — curl_cffi + sessionKey cookie
- Endpoint: `claude.ai/api/organizations/{org_id}/usage`
- Uses curl_cffi `impersonate="chrome"` to bypass Cloudflare TLS fingerprint (JA3/JA4) detection
- Returns extra_usage, prepaid/credits balance
- sessionKey needs manual refresh from browser devtools

### 2. OAuth API (Fallback) — stdlib urllib + Bearer token
- Endpoint: `api.anthropic.com/api/oauth/usage`
- Standard Python TLS (no fingerprint needed)
- Token auto-refreshes via refresh_token
- No extra_usage/prepaid data

## Setup

1. Install dependency: `pip install curl_cffi` (or use `uv run`)
2. Set `WEB_TOKEN` to your claude.ai sessionKey cookie
3. Set org ID in the API URLs
4. Place OAuth credentials at `~/.claude/.credentials.json`

## Usage

```bash
# Show usage
uv run claude-usage.py

# Mark daily baseline (run at 00:00)
uv run claude-usage.py --mark

# Log snapshot to history
uv run claude-usage.py --log

# Force OAuth API (skip Web API)
uv run claude-usage.py --oauth
```

## Output

```
📊 Token Usage (claude.ai web @ 07:04:49)

Session ░░░░░░░░░░   1% used 🟢 ↻4h55m
Weekly  ███████▊░░  78% used 🟢 ↻1d3h +20%
Sonnet  ▏░░░░░░░░░   2% used 🟢 ↻1d5h

--- 燃燒速率 ---
完美速率: 14.3%/天
當前速率: 13.4%/天（93% ratio）
可以超速 141%喔! 🏎️
```

## Credits

Original: 拍拍 🦅 (Eagle)
Bash reference: 踏踏 🐾 (Tata)