claude-rotate: Ein Proxy für mehrere Claude-Max-Konten

TL;DR

claude-rotate ist ein MIT-lizenzierter, selbst gehosteter Proxy für eine Person, die mehrere bezahlte Claude-Abos besitzt und Claude Code auf mehreren Geräten nutzt. Clients senden Anfragen an einen privaten Endpunkt. Der Proxy authentifiziert das Gerät, setzt den Token des aktiven Kontos ein, liest Anthropics Telemetrie für das Fünf-Stunden- und Wochenkontingent und wechselt bei erschöpftem Fenster. Consume-first bevorzugt das nutzbare Wochenkontingent mit dem frühesten Reset. Das Repository nennt 101 Offline-Checks und einen gemockten Stresstest, in dem 100 parallele Requests genau einen Wechsel auslösten. Das Design nutzt bewusst einen Prozess und JSON-Dateien statt Datenbank. Es zentralisiert jedoch langlebige Bearer-Credentials, fügt Claude Code eine inoffizielle Schicht hinzu, verliert beim Kontowechsel Prompt-Cache-Wiederverwendung und liegt laut Maintainer in einer Grauzone der Bedingungen. Nutze nur eigene Konten, halte den Endpunkt privat und verwende für geteilte oder kommerzielle Workloads Anthropics Usage Credits, API-Abrechnung, Team oder Enterprise.

claude-rotate setzt einen privaten Endpunkt vor mehrere Claude-Max- oder Pro-Konten, die dir bereits gehören, und verschiebt Claude-Code-Traffic, sobald das aktive Konto kein nutzbares Kontingent mehr hat. Damit entfallen Logout, Browser-Login und Terminal-Neustart auf Laptops, Workstations und persönlichen Agent-Pods. Das Open-Source-Repository von claude-rotate steht unter MIT und bleibt bewusst klein: ein Python-Proxy-Prozess, eine Konfigurationsdatei, JSON-State und Audit-Logs, keine Datenbank.

Das ist kein Trick für unbegrenzte Claude-Nutzung. Für jedes Konto gelten weiterhin die von Anthropic gesetzten Limits. Das Tool entscheidet nur, welches bezahlte Konto den nächsten Request bedient. Gleichzeitig bündelt es langlebige Credentials an einem Ort und automatisiert ein Verhalten, das Anthropic für gepoolte Consumer-Abos nicht ausdrücklich freigegeben hat. Das Repository selbst nennt die Terms-Lage eine Grauzone. Lies vor dem Setup den Risikoabschnitt.

Dieser Guide beantwortet die konkrete Suchfrage hinter der Fehlermeldung: mehrere Claude-Max-Konten auf mehreren Claude-Code-Geräten ohne manuelles Umschalten nutzen. Für die Produktwahl gibt es unseren getrennten Kostenvergleich Claude Code versus OpenCode. Für ein Gateway, das einer Firma statt einer Person dient, beginne mit dem Vergleich produktiver LLM-Gateways.

Schnelles Urteil: Wann passt claude-rotate?

Situation	Passende Wahl	Warum
Eine Person besitzt mehrere bezahlte Claude-Konten und arbeitet auf mehreren privaten Geräten	claude-rotate prüfen	Ein privater Endpunkt ersetzt manuelle Logins und zeigt das Kontingent der ganzen Fleet.
Ein bezahltes Konto erreicht nur gelegentlich sein Limit	Warten, Modell wechseln oder Usage Credits aktivieren	Ein Proxy schafft Betriebs- und Security-Arbeit, aber kein neues Kontingent.
Mehrere Beschäftigte oder Kunden brauchen geteilte Kapazität	Team, Enterprise oder API-Abrechnung nutzen	Consumer-Credentials sind die falsche Grenze für Identität, Governance und Abrechnung.
Du brauchst Budgets pro Nutzer, SSO, Audit-Export oder Vertragssupport	Produktives Gateway und Commercial-Plan	claude-rotate bietet Device-Analytics, aber keine Enterprise-Control-Plane.

Warum drei Claude-Max-Abos trotzdem eine Session stoppen können

Getrennte Abos werden nicht zu einem gemeinsamen Pool. Jedes Login hat eigene Kontingente und Reset-Zeitpunkte. Anthropics aktuelle Dokumentation zum Max-Plan sagt, dass das Session-Limit alle fünf Stunden zurückgesetzt wird. Das Wochenlimit wird zu einem festen, dem Konto zugeordneten Zeitpunkt erneuert. Weitere Wochen-, Monats-, Modell- oder Feature-Limits können gelten. Eine aktive Fleet aus KI-Agenten kann daher das aktuell auf allen Geräten angemeldete Konto leeren, während auf einem anderen bezahlten Konto Kontingent verfällt.

Manuelles Rotieren funktioniert, ist aber operativ mühsam. Du unterbrichst den Task, meldest dich ab, schließt Browser-OAuth für ein anderes Konto ab, prüfst die Identität und wiederholst das auf jedem Gerät. Bei entfernten Macs, persönlichen CI-Jobs und langen Loops kostet die Unterbrechung oft mehr Aufmerksamkeit als der Login selbst.

So funktioniert claude-rotate

Jeder Claude-Code-Client zeigt mit ANTHROPIC_BASE_URL auf den Proxy und authentifiziert sich mit einem eigenen internen Device-Key.
Der Proxy ersetzt diesen Key durch den Setup-Token des aktiven bezahlten Kontos und leitet den Request an Anthropic weiter.
Er liest die anthropic-ratelimit-unified-*-Header aus den Responses und speichert die beobachtete Nutzung im Fünf-Stunden- und Wochenfenster.
Ist das aktive Kontingent erschöpft, wählt genau eine synchronisierte Entscheidung das nächste nutzbare Konto. Ein kurzes Burst-Limit wartet dagegen auf demselben Konto und schützt so den warmen Cache.
Das Panel aggregiert Audit-Daten nach Gerät, Modell und Konto. Der API-Preisäquivalent ist eine Schätzung, nicht Anthropics interne Abo-Abrechnung.

Anthropic dokumentiert die beiden Bausteine der Verbindung. Der Claude-Code-Guide zur Authentifizierung beschreibt ANTHROPIC_BASE_URL für einen eigenen Endpunkt und claude setup-token für einen langlebigen Subscription-OAuth-Token in Skripten oder CI. Multi-Account-Pooling wird dort weder dokumentiert noch freigegeben. Dieser Unterschied zählt.

Consume-first schützt bezahltes Kontingent vor dem Verfall

Round robin wirkt fair, ignoriert aber den Reset. Angenommen, Konto A hat noch 15 Prozent und wird heute Nacht erneuert. Konto B hat 70 Prozent und wird erst in sechs Tagen erneuert. Der nächste Request an B kann den Rest von A ungenutzt verfallen lassen. Die Standardstrategie consume-first bevorzugt das nutzbare Wochenfenster mit dem frühesten Reset. Sie verbraucht also zuerst das vergänglichste Kontingent.

Der Proxy trennt zudem Quota-Erschöpfung von einem kurzen Burst-Limit. Eine Quota-Ablehnung kann einen Kontowechsel rechtfertigen. Ein 429 pro Minute mit retry-after sollte auf demselben Konto pausieren und erneut versuchen. Sonst verschiebt die Rotation nur den Burst und verliert die Prompt-Cache-Lokalität. Schwellenwerte, Cooldown und Hysterese reduzieren Ping-Pong vor einer harten Ablehnung.

Was die 101 Checks beweisen und was nicht

Der Test-Runner im Repository nennt derzeit 101 Offline-Checks für Rotationslogik, Analytics, HTTP-Proxy-Verhalten und Stressszenarien. Die veröffentlichten Ergebnisse mit gemocktem Upstream umfassen 300 bediente parallele Requests, 50 byte-identisch übertragene SSE-Streams und einen Quota-Ausfall mit 100 Requests in flight, der genau einen Kontowechsel auslöste. Ein Lock serialisiert die Failover-Entscheidung, damit die Fleet nicht alle Konten zugleich weiterschaltet.

Diese Claims sind nützlich, weil Code und Testbefehl öffentlich sind. Sie sind kein Produktionsbenchmark für Verfügbarkeit. Der Upstream ist gemockt, der Test misst Proxy-Overhead statt Anthropic-Latenz und das Design unterstützt nur einen Prozess. Führe python3 tests/run_all.py auf dem Commit aus, den du deployen willst, und prüfe den Code für Authentifizierung, Streaming, Header und Logs.

Minimales privates Setup

git clone https://github.com/doxaras/claude-rotate.git
cd claude-rotate
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
./setup.sh
./setup.sh add-account max-1
./setup.sh add-account max-2
./setup.sh add-device macbook
python3 rotator.py

Führe claude setup-token für jedes bezahlte Konto getrennt aus, wenn das Setup-Skript danach fragt. Prüfe die Repository-Anleitung auf genau dem installierten Commit. Nutze auf jedem Gerät den Endpunkt und den Device-Key aus add-device:

export ANTHROPIC_BASE_URL=http://dein-privater-host:8484
export CLAUDE_CODE_OAUTH_TOKEN=der-device-key
claude

Prüfe /rotate/status, bevor du wertvolle Arbeit startest. Sende dann auf jedem Gerät einen kleinen Request und kontrolliere, ob sich die erwarteten Device- und Account-Gauges bewegen. Stelle Port 8484 nie offen ins Internet.

Security-Checkliste für Tailscale und Credentials

Binde den Proxy an seine Tailscale-Adresse oder an 127.0.0.1 hinter Tailscale Serve. Plain HTTP in öffentlichen oder geteilten Netzen legt Device-Keys und Prompts offen.
Erstelle einen Device-Key pro Maschine oder Pod. So bleibt ein kompromittierter Client einzeln widerrufbar.
Behandle jeden Setup-Token als langlebiges Bearer-Credential. Halte Token-Dateien auf Modus 0600, aus unkontrollierten Backups und aus Git.
Schütze das Live-Panel. Es zeigt Gerätenamen, Modelle, Verbrauch und Account-Status.
Bewahre Logs nur so lange wie nötig auf. Audit-JSON kann auch ohne Prompt-Bodies operative Metadaten enthalten.
Pinne einen geprüften Commit, führe die Offline-Suite aus, beobachte Upstream-Änderungen und definiere den Rollback auf direkte Claude-Code-Nutzung.

Ein Self-hosted Proxy verändert den Trust-Pfad. Deine Prompts erreichen weiterhin Anthropic, aber jetzt sieht auch der Proxy-Host Credentials und Traffic. Wird diese Schicht Teil eines kundenorientierten KI-Produkts, hilft unser Service für KI-Produktentwicklung beim Design eines unterstützten Gateways samt Identity, Observability und Failure Boundaries.

Die Terms-Grenze ist eine Produktentscheidung

Der Maintainer von claude-rotate bezeichnet die automatisierte Rotation zwischen Consumer-Abos als Grauzone und warnt vor Consumer-Plänen für geteilte oder kommerzielle Services. Anthropics Seite zu Recht und Compliance für Claude Code verweist auf die jeweils geltenden Consumer oder Commercial Terms und behandelt Drittanbieter-Integrationen getrennt. Die Dokumentation eines eigenen Base-URLs oder Setup-Tokens ist keine Freigabe für jedes Routing-Muster.

Nutze nur Abos, die dir selbst gehören, teile keine Credentials mit anderen Personen und lies vor dem Deployment die aktuellen Bedingungen. Für Beschäftigte, Kunden-Workloads, autonome Rund-um-die-Uhr-Jobs oder Systeme, die Zugang weiterverkaufen, brauchst du einen dafür vorgesehenen Kontotyp und Abrechnungsweg. Wenn die Auslegung geschäftlich relevant ist, hole eine schriftliche Antwort von Anthropic oder Rechtsberatung ein.

Sicherere Alternativen, wenn das Limit das eigentliche Problem ist

Laut Anthropics Dokumentation zu Usage Credits können Pro- und Max-Nutzer nach dem inkludierten Limit zu Standard-API-Preisen weiterarbeiten, wenn Credits aktiviert sind. Das ist der einfachste offizielle Overflow-Pfad für eine Person. Du kannst außerdem Kontext verkleinern, Arbeit in begrenzte Sessions teilen, für passende Aufgaben ein günstigeres Modell wählen oder auf den angezeigten Reset warten.

Option	Betriebsaufwand	Am besten für	Wichtigster Trade-off
Warten oder Nutzung reduzieren	Niedrig	Gelegentliche Limits	Arbeit pausiert oder Modellqualität ändert sich.
Usage Credits	Niedrig	Unplanbarer persönlicher Overflow	Variable Ausgaben zu API-Preisen.
claude-rotate	Mittel	Ein Owner, mehrere bezahlte Konten und private Geräte	Terms-Unsicherheit, Secrets und Proxy-Betrieb.
Direkte API plus produktives Gateway	Hoch	Teams, Produkte und kontrollierte Automation	Nutzungsabhängige Kosten und Plattformarbeit.
Team oder Enterprise	Mittel	Verwaltete Nutzer und Organisationskontrollen	Vertrag, Seats und Nutzungskosten müssen geprüft werden.

Fazit

claude-rotate löst ein enges persönliches Infrastrukturproblem gut: mehrere bereits bezahlte Konten, mehrere kontrollierte Geräte und ein Owner, der quota-bewussten Failover plus Transparenz braucht. Consume-first und serialisierter Failover sind durchdachter als blindes Round robin. Die öffentliche Stress-Suite liefert konkrete, reproduzierbare Evidenz.

Die scharfen Kanten sind ebenso konkret. Der Proxy wird zum Credential-Vault, Prompt-Cache reist nicht zwischen Konten, ein Prozess bleibt eine einzelne betriebliche Abhängigkeit, API-Kostenschätzungen sind nicht die Quota-Wahrheit und automatisiertes Consumer-Pooling hat keine ausdrückliche Provider-Freigabe. Halte das Deployment privat und persönlich. Für ein Business-System kaufst du die unterstützte kommerzielle Grenze und behandelst das Gateway als Produktionsinfrastruktur.

Häufige Fragen

Was ist claude-rotate?

claude-rotate ist ein MIT-lizenzierter Self-hosted Proxy für einen Owner mit mehreren bezahlten Claude-Abos. Claude-Code-Clients verbinden sich mit einem privaten Endpunkt, der anhand beobachteter Quota-Telemetrie ein Konto auswählt und Nutzung pro Gerät erfasst.

Gibt claude-rotate unbegrenzte Claude-Max-Nutzung?

Nein. Für jedes Konto gelten weiterhin die von Anthropic gesetzten Session-, Wochen-, Modell- und sonstigen Limits. Der Proxy nutzt nur ein anderes berechtigtes bezahltes Konto, wenn das aktive Konto nicht mehr nutzbar ist.

Kann ich claude-rotate für mein Team oder SaaS nutzen?

Das Repository warnt vor Consumer-Abos für geteilte oder kommerzielle Services. Nutze Team, Enterprise oder API-Abrechnung mit passendem Produktions-Gateway und prüfe aktuelle Provider-Bedingungen.

Warum consume-first statt Round robin?

Consume-first bevorzugt nutzbares Wochenkontingent mit dem frühesten Reset. Das senkt das Risiko, dass bezahltes Kontingent verfällt. Cooldown und Hysterese vermeiden unnötige Wechsel.

Entspricht der API-Preisäquivalent dem Claude-Max-Kontingent?

Nein. Er schätzt den API-Listenpreis der erfassten Token. Anthropics Abo-Quota ist ein getrenntes Provider-System. Für Routing-Entscheidungen zählt die zurückgegebene Quota-Telemetrie.