Claude Code plugins for rate limit management
npx claudepluginhub willyt3hwhale/cc-limit-guardAutomatically pauses Claude Code when usage exceeds 90% to avoid hitting rate limits
willyt3hwhaleShare bugs, ideas, or general feedback.
A Claude Code plugin that monitors your usage and automatically pauses when approaching rate limits.
| Limit | Threshold | Reset Period |
|---|---|---|
| Session | 90% | Every 5 hours |
| Weekly | 95% | Every 7 days |
In Claude Code, run:
/plugin marketplace add willyt3hwhale/cc-limit-guard
/plugin add rate-limit-guard@cc-limit-guard
git clone https://github.com/willyt3hwhale/cc-limit-guard ~/.claude/plugins/local/cc-limit-guard
Then add an alias to your shell config:
alias claude='claude --plugin-dir ~/.claude/plugins/local/cc-limit-guard'
No manual configuration needed. The plugin automatically finds your credentials in this order:
ANTHROPIC_API_KEY environment variable~/.claude/.credentials.json (written by Claude Code on login)Claude Code-credentials)Just install the plugin and it works.
The plugin runs automatically. You'll see usage info as a system message:
Session: 29% | Weekly: 12%
When either threshold is exceeded, the plugin will:
To temporarily bypass the rate limit guard:
CLAUDE_NO_LIMIT=1 claude
jq installed (brew install jq / apt install jq)The plugin uses a PreToolUse hook that runs before each tool call. It:
api.anthropic.com and reads rate limit headers backMIT