claude-wait-rate

claude-wait-rate

What is Claude Wait Rate?

A Claude Code plugin that automatically retries rate-limited API requests. When Claude hits a 429, 502, 503, or 504 error, it waits and retries — so your sessions and sub-agents never stop due to transient failures.

Quickstart

# 1. Register the plugin repository (one-time)
claude plugin marketplace add SirHall/claude-wait-rate

# 2. Install the plugin
claude plugin install claude-wait-rate

Then inside Claude Code:

/wait-rate-install

Restart Claude Code. Done — rate limits are now handled automatically.

---

How It Works

The plugin installs a fetch interceptor via NODE_OPTIONS --import that wraps all outgoing API requests:

• 429 (Rate Limited): Respects the Retry-After header if present, otherwise exponential backoff
• 502/503/504 (Server Error): Exponential backoff starting at 60s, doubling up to 480s
• Network errors: Same exponential backoff
• 401/403/400/etc: Passed through immediately (no retry)

When retrying, you'll see messages like:

⏳ Rate limited (429). Waiting 60.0s (attempt 1, elapsed 0.0s)
⏳ Rate limited (429). Waiting 120.0s (attempt 2, elapsed 60.0s)

Commands

Command	Description
/wait-rate-install	Configure the interceptor and update settings
/wait-rate-uninstall	Remove the interceptor from settings
/wait-rate-status	Check whether the interceptor is active and show config

Configuration

Config is stored at ~/.claude-wait-rate/config.json:

Setting	Default	Description
upstream	https://api.anthropic.com	Upstream API endpoint. Auto-detected from existing ANTHROPIC_BASE_URL during install.
baseInterval	60	Base retry wait in seconds
maxInterval	480	Maximum wait between retries in seconds
maxTimeout	null	Maximum total retry time. null = retry indefinitely.
retryableStatuses	[429, 502, 503, 504]	HTTP status codes that trigger a retry

Uninstalling

From inside Claude Code:

/wait-rate-uninstall

Then restart Claude Code.

If Claude Code won't start, run the repair script directly from your terminal:

bash ~/.claude/plugins/installed/claude-wait-rate/scripts/repair.sh

To also remove the plugin:

claude plugin uninstall claude-wait-rate

Development

git clone [email protected]:SirHall/claude-wait-rate.git
cd claude-wait-rate
claude --plugin-dir .

License

MIT