How Much Claude Left?
VerifiedCheck how much Claude Max / Claude Pro subscription quota you have LEFT — not how much you spent. Most usage tools track API billing or token costs. This one...
$ Add to .claude/skills/ About This Skill
# 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 `/usage` command
- Captures and parses the output
- Cleans up tmux session
Usage
```bash 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
- `tmux` installed
- `claude` CLI in PATH
- Active Claude Code authentication (Pro or Max subscription)
- `git` installed (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 `/usage` format — may break if Anthropic changes the output layout
Use Cases
- Check remaining Claude Max or Pro subscription quota before starting a long task
- Monitor weekly usage percentages across Opus, Sonnet, and Haiku models
- Track session-level usage to avoid hitting mid-session rate limits
- Schedule periodic quota checks via cron to get early warnings before exhaustion
- Display quota reset time so developers can plan heavy usage windows
Pros & Cons
Pros
- +Shows remaining quota instead of spend — directly answers the question that matters
- +No API keys or admin access required — uses the existing CLI session
- +Automated tmux-based approach handles all interactive prompts silently
Cons
- -Takes 8-10 seconds per check due to Claude Code CLI startup overhead
- -Output parsing may break if Anthropic changes the /usage command format
- -Only available on claude-code and openclaw platforms
FAQ
What does How Much Claude Left? do?
What platforms support How Much Claude Left??
What are the use cases for How Much Claude Left??
100+ free AI tools
Writing, PDF, image, and developer tools — all in your browser.
Next Step
Use the skill detail page to evaluate fit and install steps. For a direct browser workflow, move into a focused tool route instead of staying in broader support surfaces.