Claude Quota Checker
How much Claude do you have LEFT?
Most tools tell you how much you spent. This one tells you how much you have remaining — the question that actually matters when you're working and worried about hitting limits.
Checks your Claude Max/Pro subscription quota by automating the /usage command via tmux. No API keys needed, no Admin keys, no complex setup.
How It Works
- Creates a temporary tmux session with a scratch git repo
- Launches Claude Code CLI
- Handles the "trust this folder" prompt automatically
- Sends
/usagecommand - Captures and parses the output
- Cleans up tmux session
Usage
bash ./scripts/check-usage.sh
Note: Run from the skill directory, or use the full path based on where you installed this skill. The script auto-detects its own location.
Output
- Plan type: Pro or Max (e.g., "Opus 4.6 — Claude Max")
- Session usage: current session % used
- Weekly usage: all models % and Sonnet-only %
- Reset time: when the weekly quota resets
Error Handling
| Problem | Symptom | Fix |
|---|---|---|
| tmux not installed | command not found: tmux | brew install tmux |
| Claude CLI not in PATH | Session hangs | Install Claude Code CLI, ensure claude is in PATH |
| Auth expired | "Please log in" in output | Run claude manually and re-authenticate |
| Git not installed | Script fails at git init | brew install git |
If the script hangs for >15 seconds, it likely means Claude CLI couldn't start. Kill with: tmux kill-session -t cu-*
Requirements
- macOS or Linux
tmuxinstalledclaudeCLI in PATH- Active Claude Code authentication (Pro or Max subscription)
gitinstalled (for scratch repo)
Performance
~8-10 seconds (bottleneck: Claude Code CLI startup time).
Limitations
- Only checks subscription usage (Pro/Max), not API billing
- Requires a running terminal environment (won't work in sandboxed containers)
- Output parsing depends on Claude Code CLI's
/usageformat — may break if Anthropic changes the output layout