Claude Code Nutzungslimit erreicht: „You've hit your session limit“ – Limit einsehen, Reset und was hilft (früher „Claude usage limit reached“)

Du kommst in Claude Code endlich in den Flow, und dann bremst dich das hier abrupt aus:

You've hit your session limit · resets 3:45pm

Heißt: Du hast vorerst aufgebraucht, was dein aktueller Tarif erlaubt. Das ist kein Fehler und kein Bug: So funktionieren die Nutzungslimits von Abos (Pro / Max und ähnliche). Die offizielle Fehlerreferenz nennt vier Varianten, je nachdem, welches Kontingent aufgebraucht ist (die Uhrzeiten sind Beispiele):

You've hit your session limit · resets 3:45pm
You've hit your weekly limit · resets Mon 12:00am
You've hit your Opus limit · resets 3:45pm
You've hit your Sonnet limit · resets 3:45pm

Ältere Versionen formulierten es als Claude usage limit reached. Your limit will reset at 3pm (America/Santiago). (Abschnitt 1 zeigt, wie sich der Text verändert hat). Das Frustrierende ist, dass nicht offensichtlich ist, welches Kontingent du getroffen hast, wann es zurückkommt und was du bis dahin tun kannst. Dieser Artikel erklärt, was die vier Meldungen bedeuten, die zweistufige Limitstruktur (5 Stunden + wöchentlich), was den Verbrauch treibt, was im Moment des Limits zu tun ist, wie du den Rest prüfst und welcher API-Notausgang bleibt — auf Basis der offiziellen Dokumentation.

Drei Erkenntnisse vorab. (1) session limit ist das rollierende 5-Stunden-Fenster, weekly limit das Wochenfenster; beide gelten für alle Modelle, ein Modellwechsel bringt den Zugang also nicht zurück. (2) Opus limit / Sonnet limit gelten nur für diese Modellfamilie: Wechselst du mit /model zu einem Modell außerhalb der Familie, kannst du weiterarbeiten. (3) Wenn du warten kannst, setzt Claude Code ab v2.1.234 deine Aufgabe nach dem Reset automatisch fort. Wenn nicht, steig auf Nutzungs-Credits oder die nutzungsbasierte API um. Die tarifabhängigen Mengen ändern sich im Lauf der Zeit, prüfe die Zahlen also immer in der offiziellen Live-Ansicht (/usage oder Settings → Usage).

Du willst nur dein Nutzungslimit einsehen? In Claude Code zeigt der Befehl /usage, wie viel von jedem Kontingent verbraucht ist und wann es jeweils zurückgesetzt wird; auf claude.ai und in der Desktop-App zeigt Settings → Usage deinen Tarif, die verbleibende Nutzung und das wöchentliche Reset-Datum (Details in Abschnitt 5). Wochenlimit erreicht („You've hit your weekly limit“)? Dann kann der Reset Tage entfernt sein, und ein Modellwechsel hilft nicht — was dann bleibt, steht in Abschnitt 4.

1. Was die Meldung bedeutet — session, weekly, Opus, Sonnet

Die heutige Meldung hat die Form „You've hit your [X] limit · resets [Uhrzeit]“ („du hast dein [X]-Limit erreicht · Reset um [Uhrzeit]“) und nennt das aufgebrauchte Kontingent beim Namen. Laut offizieller Dokumentation blockiert Claude Code weitere Anfragen bis zur angezeigten Reset-Zeit. Die Uhrzeit ist deine Ortszeit, und Meldungen im offiziellen Repository zeigen oft die Zeitzone in Klammern, etwa resets 4:20am (Europe/Rome).

Der entscheidende Punkt: Das ist so vorgesehen, keine Fehlfunktion. Die Pro-/Max-Tarife von Claude sind nicht „unbegrenzt“ — es gibt eine Obergrenze pro Zeitfenster und pro Woche. Und Claude Code (CLI) und die Claude-Apps (Web/Desktop) teilen sich dasselbe Tarif-Kontingent — die offizielle Hilfe stellt klar, dass „alle Aktivitäten in beiden Tools auf dieselben Nutzungslimits angerechnet werden“. Es ist also völlig normal, dass „ich habe gechattet UND Claude Code laufen lassen, und zusammen war es schneller leer.“

In derselben Situation erscheinen zwei weitere Zeilen. Beide betreffen dieselben Kontingente wie die vier Meldungen oben.

• Usage limit reached · continuing automatically at 3:45pm · esc to cancel — Claude Code wartet darauf, die unterbrochene Aufgabe nach dem Reset fortzusetzen (ab v2.1.234; siehe Abschnitt 4)
• You've used 85% of your session limit · resets 3:45pm — eine Warnung, bevor das Fenster aufgebraucht ist

Die folgenden Meldungen bedeuten dagegen nicht, dass dein 5-Stunden- oder Wochenkontingent aufgebraucht ist — die Lösung ist also eine andere.

• API Error: Server is temporarily limiting requests (not your usage limit) — eine kurze Drosselung auf Serverseite, unabhängig von deinem Tarif. Kurz warten und erneut versuchen (ab v2.1.199 wird automatisch wiederholt, bevor die Meldung erscheint)
• You've hit your monthly spend limit · raise it at claude.ai/settings/usage — die Nutzungs-Credits, die Nutzung über deinen Tarif hinaus bezahlen, haben ein monatliches Ausgabenlimit erreicht. Erhöhe das Limit oder warte auf den Reset des Tariffensters, falls die Meldung einen nennt (bei Team / Enterprise steht dort individual spend limit, org's monthly spend limit usw.)
• Usage credits required for 1M context — eine Berechtigungsprüfung für das Kontextfenster mit 1 Mio. Tokens, kein aufgebrauchtes Kontingent. Wechsle mit /model zurück zu einem Modell ohne das Suffix [1m]
• Request rejected (429) — ein Ratenlimit eines API-Schlüssels oder Cloud-Anbieters (siehe Abschnitt 6)

2. Das zweistufige Limit — 5 Stunden + wöchentlich (+ Limits pro Modell)

Im August 2025 führte Anthropic zusätzlich zum bestehenden 5-Stunden-Fenster wöchentliche Nutzungslimits für Pro / Max ein (ausgelöst durch Vielnutzer, die es ununterbrochen laufen ließen). Dadurch ist das heutige Abo-Limit zweistöckig. Laut offizieller Dokumentation zählt die Nutzung gleichzeitig gegen das Sitzungs- und das Wochenkontingent, sodass ein einzelner Schub intensiver Aktivität, etwa ein großer, parallel aufgefächerter Workflow, das Wochenkontingent aufbrauchen kann, bevor das Sitzungsfenster zurückgesetzt wird.

Die Ausnahme ist Ultra für 200 $ (am 31. Oktober 2026 von Max 20x umbenannt). Laut Anthropics Hilfeartikel „What is the Ultra plan?“ haben verifizierte Ultra-Konten kein 5-Stunden-Fenster, sondern nur das Wochenlimit (das Zehnfache von Pro) und das Wochenlimit für Fable. Die Verifizierung nimmt Anthropic automatisch anhand des Konto- und Zahlungsverlaufs vor; bis sie abgeschlossen ist, gilt ein vorübergehendes 5-Stunden-Limit. Zeigt Settings → Usage keinen Balken „Current session“, ist das Konto verifiziert, und die Meldung session limit erscheint nicht. Max für 100 $ bietet beim 5-Stunden- wie beim Wochenlimit das Fünffache von Pro (siehe „What is the Max plan?“; beide am 31. Oktober geprüft).

Als ursprüngliche Orientierung (August 2025) nannte Anthropic grobe Schätzungen wie „Pro: ~40-80 Stunden Sonnet pro Woche“ und „Max 20x (heute Ultra): ~240-480 Stunden Sonnet + ~24-40 Stunden Opus pro Woche“. Allerdings hat Anthropic seitdem weitgehend aufgehört, feste Stundenangaben zu veröffentlichen, und die Limits wurden mehrfach überarbeitet (selbst 2026 wurde von Erhöhungen des 5-Stunden-Fensters berichtet). Betrachte diese Zahlen daher als „Schätzungen von damals“ und prüfe dein aktuelles Kontingent immer in der offiziellen Nutzungsansicht. Dieser Artikel verzichtet bewusst darauf, konkrete aktuelle Werte zu behaupten.

3. Was dein Kontingent aufbraucht

„Es war schneller leer als erwartet“ lässt sich fast immer auf diese vier Punkte zurückführen, geordnet nach Auswirkung.

Kurz: Je schwerer das Modell, je größer der Kontext, je länger und paralleler der Lauf, desto schneller schmilzt das Kontingent. Umgekehrt lässt das bewusste Absenken dieser vier denselben Tarif spürbar länger reichen. Zur Gesamtoptimierung siehe Kostenoptimierung beim KI-Coding, und für konkrete Tipps zum Token-Sparen siehe Claude Code Token sparen.

4. Fünf Wege, um jetzt weiterzuarbeiten

Fünf Schritte für den Moment, in dem du das Limit triffst, je nach Situation. Welchen du wählst, hängt davon ab, „welches Kontingent du getroffen hast“ (session / weekly / Opus / Sonnet in der Meldung) und ob du warten kannst. Tippst du in Claude Code /rate-limit-options, bekommst du die Optionen in einem Menü: warten und automatisch fortsetzen, Nutzungs-Credits hinzufügen oder den Tarif upgraden (der Befehl erscheint nicht im Befehlsmenü, tippe ihn also vollständig).

Option C (warten) läuft seit v2.1.234 fast automatisch. In einer interaktiven Sitzung, die mit einem claude.ai-Abo angemeldet ist, wartet Claude Code in der offenen Sitzung, wenn ein Nutzungslimit Claude mitten in der Aufgabe stoppt, und setzt die Aufgabe nach dem Reset fort. Während des Wartens steht unten in der Sitzung:

Usage limit reached · continuing automatically at 3:45pm · esc to cancel

Beim Reset schickt es nicht deine letzte Nachricht erneut, sondern gibt Claude eine feste Anweisung, die Aufgabe dort aufzunehmen, wo sie stehen geblieben ist. Berechtigungsabfragen erscheinen weiterhin wie gewohnt, die Aufgabe kann also bei einer davon stehen bleiben, während du weg bist. Zum Abbrechen des Wartens drückst du Esc bei leerem Prompt; um die automatische Fortsetzung ganz abzuschalten, deaktivierst du Continue automatically at usage limit in /config. Liegt der Reset mehr als 24 Stunden entfernt (etwa bei einem Wochenlimit), startet Claude Code das Warten nicht von selbst — öffne dann /rate-limit-options und wähle Wait here, then continue automatically. Im Code-Tab der Desktop-App hat die Karte des Sitzungslimits ein Kontrollkästchen Auto-continue when limits reset (die Karte des Wochenlimits nicht).

Den API-Wechsel (D) als „Notausgang“ zu kennen, ist mächtig. Anders als die Zeitfenster des Abos hat die API keinen 5-Stunden- oder Wochen-Reset, auf den du warten musst (du zahlst, was du nutzt; es gibt aber Durchsatzlimits pro Minute und eine monatliche Ausgabenobergrenze — siehe Abschnitt 6). Siehe Was ist eine KI-API. Bei Pro / Max kannst du mit /usage-credits (früher /extra-usage) Nutzungs-Credits aktivieren und über das enthaltene Kontingent hinaus zu Standard-API-Preisen weiterarbeiten (offizielle Hilfe). Bei Team / Enterprise schickt derselbe Befehl eine Anfrage an deinen Admin.

5. So siehst du, was übrig ist

Wenn du sehen kannst, „wie viel übrig ist“, kannst du das Limit ganz vermeiden. Drei Wege zur Prüfung.

1) /usage in Claude Code: zeigt, wie viel du von jedem Tarifkontingent verbraucht hast und wann es jeweils zurückgesetzt wird (/cost und /stats sind Aliase). Bei Pro, Max, Team und Enterprise zeigt es außerdem eine Aufschlüsselung nach Skill / Subagent / Plugin / MCP-Server (mit d / w wechselst du zwischen den letzten 24 Stunden und 7 Tagen; die Aufschlüsselung wird aus dem Verlauf dieses Rechners berechnet, Nutzung auf anderen Geräten oder auf claude.ai ist also nicht enthalten). Es zeigt allerdings nicht, welche Sitzung verbraucht hat (Nutzung pro Sitzung ansehen). Bevor ein Fenster aufgebraucht ist, kann eine Warnung wie You've used 85% of your session limit · resets 3:45pm erscheinen, und du kannst rate_limits (Nutzungsanteil und Reset-Zeit des 5-Stunden- und des 7-Tage-Fensters) in deiner Statuszeile anzeigen lassen. 2) Web-/Desktop-App: Settings → Usage zeigt deinen Tarif, die verbleibende Nutzung und das wöchentliche Reset-Datum; in der Desktop-App zeigt es auch der Nutzungsring neben der Modellauswahl. 3) API-Nutzer: die Seiten Usage / Limits der Console und die Antwort-Header anthropic-ratelimit-*. Der Session-Block in /usage zeigt geschätzte Kosten, berechnet aus den Tokens. Beachte: /status zeigt nicht dein Kontingent, sondern mit welchem Konto und welchen Zugangsdaten du verbunden bist (siehe Abschnitt 6).

6. Abo-Limits vs. API-Limits

Sie sind leicht zu verwechseln, doch die Abo-Limits (Pro/Max) und die API-Limits sind völlig unterschiedliche Systeme. Den Unterschied zu kennen, macht die Wechselentscheidung schnell, wenn es darauf ankommt.

Der Punkt: Das Abo stoppt dich per Zeitfenster, die API hat dagegen weder ein 5-Stunden- noch ein Wochenfenster. Für Deadline-Arbeit, die du wirklich nicht stoppen kannst, ist der Wechsel auf einen API-Schlüssel daher der Standardzug. Prüfe nach dem Wechsel mit /status die aktiven Zugangsdaten. Ein genehmigter ANTHROPIC_API_KEY, der in deiner Umgebung übrig geblieben ist, leitet Anfragen über diesen Schlüssel, auch wenn du eigentlich dein Abo nutzen wolltest. Umgekehrt: Siehst du Credit balance is too low, obwohl du glaubst, im Abo zu sein, ist das ein Zeichen, dass ein API-Schlüssel der Console verwendet wird. Wie du das behebst, steht in Your credit balance is too low to access the Anthropic API: Lösungen. Details zur API findest du auf der offiziellen Seite zu Ratenlimits.

7. Checkliste zur Vorbeugung

Eine Betriebs-Checkliste, um „leer im falschen Moment“ zu verhindern.

(1) Standardmäßig Sonnet und nur für die harten Stellen mit /model auf Opus wechseln (das Opus-Wochenlimit schonen). (2) Den Kontext mit häufigem /compact / /clear leicht halten. (3) Guthaben und Reset-Datum mit /usage vor schwerer Arbeit prüfen. (4) Unnötiges MCP und Auto-Schleifen reduzieren; nur die nötigen Dateien anhängen. (5) An Termintagen die nutzungsbasierte API bereithalten (damit du nicht stockst, wenn das Abo leer ist). (6) Wenn es chronisch knapp ist, erwäge ein Tarif-Upgrade oder die Verlagerung dieser Last auf die API.

Zusammenfassung

Das You've hit your session limit · resets 3:45pm von Claude Code (die alte Formulierung war Claude usage limit reached) ist kein Fehler — so funktionieren die Nutzungslimits des Abos. Die Meldung nennt das aufgebrauchte Kontingent: session = das rollierende 5-Stunden-Fenster, weekly = das Wochenfenster (beide gelten für alle Modelle, ein Modellwechsel hilft also nicht) und Opus / Sonnet = ein Limit nur für diese Familie. Weil Claude Code und die Claude-Apps dasselbe Tarifkontingent teilen, kann es zusammen schneller aufgebraucht sein.

Der größte Verbraucher ist die Modellwahl (Opus ist der größte), dann Kontextgröße, lange durchgehende Läufe und Subagenten/MCP. Wenn du das Limit triffst: bei einem Opus-/Sonnet-Limit A: Modell wechseln; beim Sitzungslimit C: auf den Reset warten (ab v2.1.234 automatisch); wenn du nicht warten kannst, D: nutzungsbasierte API / E: Nutzungs-Credits oder Upgrade. B: Kontext kürzen lässt das nächste Fenster länger reichen. Sieh dein Guthaben mit /usage und Settings → Usage. Und da sich die genauen Zahlen im Lauf der Zeit ändern, merke sie dir nicht — prüfe sie in der offiziellen Live-Ansicht. Verwandt: Token sparen und Zusatzkosten, Opus/Sonnet/Haiku-Preise, Claude-Code-Fehlerübersicht.

FAQ

Q. Ist „You've hit your session limit“ ein Bug? Ich bezahle doch dafür.
A. Es ist so vorgesehen, kein Bug. Pro / Max und andere Abos sind nicht „unbegrenzt“ — es gibt Nutzungsobergrenzen pro 5-Stunden-Fenster (session) und pro Woche (weekly). Auch als zahlender Nutzer wirst du vorübergehend pausiert, sobald du überschreitest, was dieses Kontingent abdeckt, und der Zugang kommt zur angezeigten resets-Zeit zurück. Beachte: Claude Code und die Claude-Apps teilen sich dasselbe Kontingent, beides zu nutzen, leert es also schneller.

Q. Wann wird es zurückgesetzt? Da stand „resets 3:45pm“.
A. Bei einem session limit ist das die Reset-Zeit des 5-Stunden-Fensters (deine Ortszeit). Ein weekly limit trägt einen Wochentag oder ein Datum, etwa resets Mon 12:00am, und kann Tage entfernt sein. Jeden Reset kannst du in /usage oder unter Settings → Usage prüfen. Ist sogar das Wochenkontingent weg, bleiben Warten, Nutzungs-Credits, der Umstieg auf die nutzungsbasierte API oder ein Upgrade.

Q. Was ist bei „Claude usage limit reached“ anders?
A. Es ist die ältere Formulierung desselben Nutzungslimits. In Berichten im offiziellen Repository zeigt 2025 Claude usage limit reached. Your limit will reset at …, etwa ab Dezember 2025 You've hit your limit · resets … und etwa ab Mai 2026 die Meldung, die das Kontingent nennt, You've hit your session limit, samt Varianten. Siehst du noch die alte Formulierung, verrät dir ein Update mit claude update, welches Kontingent du getroffen hast, und bringt ab v2.1.234 die automatische Fortsetzung.

Q. Warum erreiche ich das Limit so schnell?
A. Der größte Faktor ist die Modellwahl. Opus brennt das Kontingent weit schneller herunter als Sonnet. Dazu treiben großer Kontext, lange durchgehende Läufe und intensive Nutzung von Subagenten oder MCP den Verbrauch nach oben. Die Nutzung zählt gleichzeitig gegen das Sitzungs- und das Wochenkontingent, anhaltend schwere Arbeit wie parallele Läufe kann also auch das Wochenkontingent früh aufbrauchen. Allein Routinearbeit mit /model auf Sonnet zu verlagern und den Kontext mit /compact zu kürzen, macht einen großen Unterschied.

Q. Wie arbeite ich sofort weiter, ohne zu warten?
A. (1) Bei You've hit your Opus limit / Sonnet limit zu einem Modell außerhalb der Familie wechseln mit /model (bei Sitzungs- und Wochenlimit hilft das nicht), (2) Nutzungs-Credits aktivieren mit /usage-credits (über das enthaltene Kontingent hinaus zu Standard-API-Preisen weiterarbeiten), (3) auf einen nutzungsbasierten API-Schlüssel umsteigen (kein 5-Stunden- oder Wochenfenster), (4) den Tarif upgraden mit /upgrade. Für Deadline-Arbeit ist es sicher, die nutzungsbasierte API vorab bereitzuhalten.

Q. Kann ich prüfen, wie viel noch übrig ist?
A. Ja. In Claude Code zeigt /usage, wie viel du von jedem Kontingent verbraucht hast, wann es jeweils zurückgesetzt wird, und eine Aufschlüsselung nach Skill, Subagent und MCP-Server; mit rate_limits in der Statuszeile behältst du es ständig im Blick. In der Web-/Desktop-App zeigt Settings → Usage deinen Tarif, die verbleibende Nutzung und das wöchentliche Reset-Datum. Einmal vor schwerer Arbeit nachzusehen, hilft dir, das Limit zu vermeiden.