Claude Rotate

claude-rotate

A tiny self-hosted proxy that lets Claude Code ride multiple Claude
Max/Pro subscriptions and switches accounts automatically when one hits its
rate-limit window — with a built-in analytics panel showing quota gauges,
per-device consumption, and cost-equivalent dollars.

One process, one config file, no database. Built for individual developers who
own more than one subscription and are tired of "You've hit your session
limit".

Herd-safe, by test — not by vibes: when your whole fleet slams into a rate
limit at the same instant, exactly *one* rotation decision happens — 100
in-flight requests, 1 switch, and every request recovers with a single retry
onto the new account. Reproducible numbers in
Performance.
Terms-of-Service note. This tool automates switching between accounts
*you personally own and pay for*. Each account's limits are still fully
enforced by Anthropic. Rotating accounts to work past limits is a gray area
under Anthropic's consumer terms — use at your own risk, and do not use
consumer subscriptions to back a shared/commercial service.

Contents:
How it works ·
Performance ·
Quickstart: server ·
Generating tokens ·
Quickstart: devices ·
Networking ·
Analytics panel ·
Configuration ·
Run as a service ·
Troubleshooting ·
Limitations ·
Operations ·
Comparison ·
Security ·
License

How it works

Per request the proxy: authenticates the device (device key → device name),
swaps in the active account's long-lived setup-token, forwards transparently,
reads the exact anthropic-ratelimit-unified-* quota headers off the
response, applies the rotation policy (consume-first; quota 429 → rotate,
burst 429 → pace, all spent → hold), and logs usage per device/model.
Diagram regenerates with python3 screenshots/architecture.py
(needs pip install diagrams +…