Claude Code Kontingent aufgebraucht: So berechnen sich das 5-Stunden-Fenster und das Wochenlimit bei Max 20x, und wann ein API Key die Lösung ist

Claude Code Kontingent aufgebraucht, was tun? Klären Sie zuerst, welche Schranke greift: Pro und Max haben jeweils zwei Limits, das „5-Stunden-Fenster“ und das „Wochenlimit“. Claude im Web, die Desktop-App und Claude Code teilen sich dasselbe Kontingent. Das „20-Fache“ bei Max 20x bezieht sich laut offizieller Angabe auf jedes einzelne 5-Stunden-Fenster im Vergleich zu Pro, nicht auf das Gesamtvolumen einer Woche. Ist das 5-Stunden-Fenster aufgebraucht, warten Sie einfach auf den Reset. Ist das Wochenlimit aufgebraucht und Sie wollen nicht pausieren, stellen Sie Claude Code auf einen API Key um. Dann wird nach Verbrauch abgerechnet, und die 5-Stunden- und Wochenlimits des Abos gelten nicht.

Fazit

Originalwortlaut aus dem Anthropic-Hilfecenter: „Paid plans have two types of usage limits: a session limit that resets every five hours, and weekly limits that reset once every week.“ Quelle:How do usage and length limits work?

„20x“ bezieht sich auf das 5-Stunden-Fenster. Originalwortlaut: „Max 20x includes 20 times the Pro plan's per-session usage allowance.“ „Max plans also have a weekly usage limit that applies across all models.“ Quelle:What is the Max plan?

Claude und Claude Code teilen sich das Kontingent. Originalwortlaut: „Both Pro and Max plans have a five-hour session limit and a weekly limit. Max plans also have a separate weekly limit for Fable. These limits are shared across Claude and Claude Code, meaning all activity in both tools counts against the same limits.“ Quelle:Use Claude Code with your Pro or Max plan

Wie viel größer ist das Wochenlimit bei Max 20x im Vergleich zu Pro wirklich?

Offiziell ist nur das 5-Stunden-Fenster mit dem Faktor 20 angegeben, einen Faktor für das Wochenlimit gibt es nicht. Nutzermessungen liegen deutlich unter 20:

• Laut Nutzerfeedback liegt das Wochenlimit von Max 20x „in Tests nur beim etwa 9,7-Fachen von Pro“, im Originalwortlaut: „5-Stunden-Fenster und Wochenlimit sind zwei getrennte Schranken“ (@JkwuRmsl).
• Laut Nutzerfeedback: „The "20x" doesn't mean you get 20 times more Claude for the whole week. It only means each 5 hour session is 20 times bigger than Pro's.“ Außerdem sei das Wochenlimit von 20x nur etwa doppelt so groß wie bei Max 5x (@buildwithhassan).

Überlegen Sie sich also vor dem Upgrade auf Max 20x, woran Sie normalerweise stoßen: an das 5-Stunden-Fenster oder an das Wochenlimit. Stoßen Sie nur an das 5-Stunden-Fenster, lohnt sich 20x sehr. Erreichen Sie häufig das Wochenlimit, bringt der zusätzliche Spielraum weniger, als der Name vermuten lässt.

Verbleibendes Kontingent prüfen

Originalwortlaut aus der Claude-Code-Dokumentation: /usage „Show session cost, plan usage limits, and activity stats. On a Pro, Max, Team, or Enterprise plan, includes a breakdown of what counts against your plan limits“; /status „Open the Settings interface on the Status tab, showing version, model, account, and connectivity“. /cost und /stats sind beide Aliase für /usage. Quelle:Claude Code Docs: Commands.

Originalwortlaut aus dem Hilfecenter: „The weekly limit resets at a fixed time each week that is assigned to your account. Your reset day and time stay the same regardless of when you start using Claude or when your subscription begins … You can see your next reset time in Settings > Usage.“

Praxistest: Was /status und /usage bei einem API Key anzeigen

Wir haben beide Befehle mit Claude Code 2.1.308 in einem sauberen, separaten HOME ausgeführt und dabei per globaler settings.json den API Key von AI Code With eingebunden.

Beim Start steht in der Titelleiste hinter dem Modell direkt die Abrechnung per API:

Claude Code v2.1.308
Opus 5.5 · API Usage Billing

Im interaktiven Modus /status eingeben. Innerhalb von 3 Sekunden öffnet sich die Status-Seite (Ausschnitt):

Version:                    2.1.308
Auth token:                 ANTHROPIC_AUTH_TOKEN
Anthropic base URL:         https://api.aicodewith.ai
Model:                      Default (claude-opus-5-5)
Setting sources:            User settings

Erst eine Frage stellen, dann /usage eingeben. Innerhalb von 3 Sekunden öffnet sich die Usage-Seite (Ausschnitt, Betragszeilen ausgelassen):

Session
Total duration (API):  5s
Total duration (wall): 29s
Total code changes:    0 lines added, 0 lines removed
Usage by model:
     claude-opus-5-5:  8 input, 138 output, 10.4k cache read, 2.6k cache write

Ergebnis: Bei der Nutzung über einen API Key zeigt /usage nur die Statistik der aktuellen Sitzung. Die Fortschrittsbalken für das 5-Stunden-Fenster und das Wochenkontingent des Abos fehlen. /status zeigt ANTHROPIC_AUTH_TOKEN und eine benutzerdefinierte Adresse, aber keine Informationen zum Abo-Konto.

Wenn Sie diese beiden Befehle im nicht interaktiven Modus mit claude -p ausführen, unterscheiden sich die Ergebnisse:

/status isn't available in this environment.

claude -p "/usage" liefert nach 0,4 Sekunden nur die Sitzungsstatistik zurück (zu diesem Zeitpunkt war noch keine Anfrage gesendet worden, daher stehen alle Werte auf 0):

Total duration (API):  0s
Total duration (wall): 0s
Total code changes:    0 lines added, 0 lines removed
Usage:                 0 input, 0 output, 0 cache read, 0 cache write

Wenn Sie das Kontingent in einem Skript prüfen möchten, nutzen Sie /usage. /status funktioniert nur im interaktiven Modus.

Warum das Kontingent zuletzt so schnell sinkt

1. Laut SemiAnalysis laufen bei einigen Max-Konten A/B-Tests. SemiAnalysis schrieb am 22. Oktober auf X: „We detected an A/B test going on that DECREASES your monthly API-value by ~20% while INCREASING your 5h usage limits by ~20%. This only affects SOME“ (SemiAnalysis-Originalpost). Laut Berichten haben sie zwei Max-20x-Konten verglichen: Bei einem war das 5-Stunden-Fenster um etwa 19 % größer, das Wochenkontingent um etwa 20 % kleiner (Tech City Authority).

Anthropic hat diesen Test nicht bestätigt. Laut Berichten antwortete Boris Cherny von Anthropic bereits vor dem Post von SemiAnalysis einem Nutzer mit „No changes on our end“, und Lydia Hallie vom Claude-Code-Team sagte ebenfalls „our limits haven't changed“ (Tech City Authority). Beide Antworten stammen aus der Zeit vor dem Post von SemiAnalysis.

Wen das besonders trifft: Das 5-Stunden-Fenster setzt sich mehrmals am Tag zurück, deshalb stoßen Vielnutzer zuerst ans Wochenkontingent. Dort bedeuten 20 % weniger tatsächlich weniger. Wer nur gelegentlich ans 5-Stunden-Fenster stößt, empfindet es dagegen eher als großzügiger.

2. Das Fortsetzen langer, lange ruhender Unterhaltungen ist teuer. Nutzern zufolge hat der Claude-Code-Client vor dem Fortsetzen einer langen Unterhaltung einen Hinweis angezeigt (@pumpccc, Opus 5.5):

This conversation has been inactive for 3h 4m and is 358.4k tokens long. Resuming it will use about 7% of your 5-hour usage limit.

Das heißt: Allein um eine alte Unterhaltung mit 350.000 Token weiterzuführen, gehen zunächst etwa 7 % des 5-Stunden-Fensters drauf.

3. Das Kontingent teilen sich Web und Claude Code. Wer tagsüber viel im Web chattet, hat abends weniger für Claude Code übrig.

So sparen Sie Kontingent

1. Lange Unterhaltungen zuerst mit /compact verkürzen. Laut offizieller Beschreibung wird die Unterhaltung zusammengefasst, um Platz zu schaffen. Ist eine Unterhaltung schon sehr lang, komprimieren Sie zuerst und machen dann weiter. Den Schalter für die automatische Komprimierung im Leerlauf finden Sie in „Was ist Claude Code Idle Compaction?“.
2. Lange, lange ruhende Sitzungen direkt neu starten. Setzen Sie keine alte Unterhaltung mit Hunderttausenden Token fort. Starten Sie mit /clear eine neue Sitzung, halten Sie die wichtigsten Punkte in einer Übergabedatei fest und arbeiten Sie dann weiter. Das Vorgehen steht in „Claude Code mittendrin an Codex übergeben? Kontext per handoff.md weitergeben“.
3. Für Alltagsaufgaben auf Sonnet 5.5 wechseln. Wechseln Sie mit /model claude-sonnet-5-5 und schalten Sie bei schwierigen Aufgaben wieder auf Opus 5.5 zurück. Hilfe bei der Auswahl finden Sie in „Welches Modell für Claude Code?“ und „Claude Sonnet 5.5 vs Opus 5.5“.
4. Weniger parallele Sub-Agents starten. Jeder Sub-Agent hat einen eigenen Kontext. Wenn Sie viele gleichzeitig starten, summiert sich auch der Kontingentverbrauch.
5. Vorsicht beim Fast Mode. Aktivierung und Einschränkungen stehen in „So nutzen Sie den Fast Mode von Claude Opus 5.5“.

Originaltext aus dem Help Center: „Your usage is affected by several factors, including the length and complexity of your conversations, the features you use, which Claude model you're chatting with, and the effort level you've selected.“

Kontingent reicht nicht: auf einen API Key wechseln

Ist das Abo-Kontingent aufgebraucht, bietet Anthropic offiziell folgende Optionen: auf den Reset warten, usage credits freischalten oder auf ein Console-Konto mit API-Nutzung wechseln. Sie können Claude Code auch mit einem API Key von AI Code With verbinden: Abgerechnet wird nach Verbrauch, das 5-Stunden-Fenster und das Wochenkontingent des Abos gelten dann nicht.

Originaltext aus dem Help Center: „Switch to a Claude Console account and purchase API usage credits for intensive coding sprints.“ „Wait until your usage limits reset.“ Quelle: Use Claude Code with your Pro or Max plan

Schritt 1: API Key erstellen

API Key erstellen →

Preise ansehen →

Schritt 2: Globale settings.json schreiben

Öffnen Sie ~/.claude/settings.json und tragen Sie unter env Folgendes ein (ANTHROPIC_BASE_URL ohne /v1):

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.aicodewith.ai",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的Key"
  }
}

Starten Sie Claude Code neu. Wenn in der Titelleiste „API Usage Billing“ steht und in /status die Zeile Auth token ANTHROPIC_AUTH_TOKEN zeigt, läuft die Verbindung über den Key. Erklärungen zu den einzelnen Feldern und häufige Probleme finden Sie in „Wie binde ich Claude Code an eine Drittanbieter-API an? Base URL, API Key und Modellkonfiguration“.

Wenn Sie zurück zum Abo wechseln möchten: Löschen Sie die beiden Zeilen in settings.json, führen Sie im Terminal claude login aus und melden Sie sich mit einem Pro- oder Max-Konto an.

Häufige Fragen

Wann wird das Wochenkontingent zurückgesetzt?

Zu einer festen Zeit pro Woche. Diese Zeit ist Ihrem Konto zugewiesen und hängt weder davon ab, wann Sie mit der Nutzung begonnen haben, noch davon, wann Sie das Abo abgeschlossen haben. Den nächsten Reset sehen Sie auf der Website unter Settings > Usage.

Ab wann zählt das 5-Stunden-Limit von Claude?

Offiziell heißt es, das 5-Stunden-Fenster „resets every five hours“. Ist das Fenster aufgebraucht, warten Sie einfach den Reset ab. In dieser Zeit sind sowohl die Claude-Weboberfläche als auch Claude Code eingeschränkt, da beide dasselbe Kontingent nutzen.

Kann ich Abo und API Key gleichzeitig nutzen?

Claude Code nutzt jeweils nur eine Variante. Sind in settings.json ANTHROPIC_AUTH_TOKEN und eine Adresse eingetragen, läuft es über den Key. Löschen Sie die Einträge und melden Sie sich mit claude login beim Abo-Konto an, läuft es über das Abo. Sie können tagsüber das Abo nutzen und auf den Key umstellen, sobald das Abo aufgebraucht ist.

Kann ich denselben Key in Codex verwenden?

Ja. Tragen Sie Adresse und Key in ~/.codex/config.toml ein, siehe „Codex config.toml Konfigurationsleitfaden“. Die Kontingentregeln von Codex selbst finden Sie in „Wie Codex abrechnet und warum das Kontingent so schnell sinkt“.

Quellen

• Claude Help Center: How do usage and length limits work?
• Claude Help Center: What is the Max plan?
• Claude Help Center: Use Claude Code with your Pro or Max plan
• Claude Code Docs: Commands
• Originalbeitrag von SemiAnalysis
• Tech City Authority: Anthropic is reportedly A/B testing Claude Max usage limits
• @JkwuRmsl, @buildwithhassan, @pumpccc