Kurs
Du steckst mitten in einem Refactor, Claude Code macht gute Fortschritte – und plötzlich ist Schluss. Kein Absturz. Keine Fehlermeldung. Nur der Hinweis, dass du eine Nutzungsgrenze erreicht hast. Die meisten denken, das liegt an zu vielen Prompts. In Wirklichkeit sind Prompts aber nur ein kleiner Teil der Gleichung. Ich bin selbst schon in diese Falle getappt, und es hat eine Weile gedauert, bis ich das System komplett verstanden habe.
Das Limit-System von Claude Code basiert auf einer Kombination aus rollierenden Sitzungsfenstern, Wochenlimits, modellabhängigen Kontingenten und tokenintensivem Hintergrundkontext, der bei jeder Anfrage mitgeschickt wird. Dinge wie Rules-Dateien, MCP-Tooldefinitionen, Memory-Dateien und der Gesprächsverlauf können einen großen Teil deiner verfügbaren Kapazität verbrauchen, bevor du überhaupt viel getippt hast.
In diesem Leitfaden erkläre ich, wie die Nutzungsgrenzen von Claude Code funktionieren, wie du deine aktuelle Nutzung prüfst und welche versteckten Overheads dafür sorgen, dass Entwickler oft früher als erwartet an Grenzen stoßen.
Wenn du neu bei Claude Code bist, schau dir zuerst unser Claude Code Tutorial an oder belege den Kurs Claude Code 101.
Einführung in Claude-Modelle
Was sind die Nutzungsgrenzen von Claude Code?
Die Nutzung von Claude Code wird von zwei überlappenden Systemen gesteuert:
- Ein rollierendes 5-Stunden-Sitzungsfenster
- Ein oder mehrere wöchentliche Nutzungslimits
Wenn du eines davon erreichst, greift die Ratenbegrenzung.
Das 5-Stunden-Fenster
Das sichtbarste Limit ist das rollierende 5-Stunden-Fenster. Es startet mit deinem ersten Prompt. Alles, was du in den nächsten fünf Stunden tust, läuft auf dasselbe Nutzungskonto. Dieses Konto teilst du dir zwischen Claude Code und Claude Chat – Aktivitäten in einem beeinflussen das andere.
Beispiel:
- Erster Prompt: 9:00 Uhr
- Fenster endet: 14:00 Uhr
Wenn du deinen verfügbaren Rahmen bis 10:30 Uhr ausschöpfst, pausiert der Zugriff, bis das Fenster um 14:00 Uhr zurückgesetzt wird.
Ein verbreitetes Missverständnis ist, dass eine neue Unterhaltung die Nutzung zurücksetzt. Tut sie nicht. Der Befehl /clear startet nur einen frischen Gesprächskontext. Er stellt weder dein Nutzungskontingent wieder her noch setzt er den 5-Stunden-Timer zurück.
Wochenlimits
Zusätzlich zu zeitbasierten Sitzungsgrenzen gibt es auch Wochenlimits. Selbst wenn in deiner aktuellen Sitzung noch Luft ist, kann das Erreichen eines Wochenlimits die weitere Nutzung vorübergehend verhindern, bis der Wochenreset greift.
Denk es dir so: Die 5-Stunden-Grenze limitiert das Timing deiner Nutzung, das Wochenlimit begrenzt dein Gesamtvolumen.
Das bedeutet: Es kann sein, dass du im aktuellen 5-Stunden-Fenster noch Kapazität hast, aber dennoch blockiert wirst, weil du dein wöchentliches Kontingent aufgebraucht hast. Für die meisten Pro-User ist das recht eindeutig. Max-Pläne bringen allerdings eine zusätzliche Ebene an Komplexität mit.
Wöchentliches Sonnet-Limit für Max-Nutzende
Anthropic wendet derzeit folgende Limits für Max-Pläne an:
- Ein wöchentliches Limit über alle Modelle
- Ein separates wöchentliches Limit speziell für Sonnet-Nutzung
Das ist wichtig, weil du eventuell noch Sonnet-Kapazität hast, obwohl dein breiteres Modellkontingent erschöpft ist – oder umgekehrt.
Beispielsweise kannst du den Großteil der Woche Sonnet für Implementierungsarbeit nutzen. Dann ist dein Sonnet-spezifisches Wochenkontingent aufgebraucht, während im allgemeinen Wochenlimit noch Kapazität bleibt. In dem Fall musst du je nach Restkontingent das Modell wechseln, auf den Sonnet-Reset warten oder deinen Plan upgraden.
Auch der umgekehrte Fall ist möglich: Wenn du viel Opus nutzt, kannst du dein allgemeines Wochenlimit erreichen, obwohl dein Sonnet-spezifisches Kontingent noch nicht ausgeschöpft ist. Da das allgemeine Limit das Dachlimit ist, blockiert dessen Erreichen jede weitere Nutzung – egal wie viel Sonnet-Kapazität noch übrig ist.
Damit Sonnet-Anfragen durchgehen, müssen beide Bedingungen erfüllt sein:
- Du hast noch Luft im allgemeinen Wochenlimit.
- Du hast noch Luft im Sonnet-Wochenlimit.
Opus-Anfragen hingegen verbrauchen nur das allgemeine Wochenkontingent, da es kein separates Opus-spezifisches Kontingent gibt. Deshalb ist die Usage-Seite in Claude.ai so wichtig. Sie zeigt jedes Wochenlimit separat inklusive Reset-Zeit – so erkennst du vor einer langen Codingsession, welches Limit näher rückt.

Nutzung von Claude Code nach Plan
Ein Problem beim Vergleich von Plänen: Anthropic veröffentlicht keine einfachen „Prompt-Zählungen“ mehr.
Stattdessen werden Pläne über relative Kapazitätsmultiplikatoren beschrieben. Diese Multiplikatoren spiegeln die Nutzungskapazität relativ zur Pro-Basis wider. Exakte Zahlen sind nicht leicht zu bekommen; einige Nutzende tracken ihre Nutzung prozentual, um ein Gefühl dafür zu erhalten, wie viele Tokens sie pro Prozent Kapazität verbraucht haben.
|
Plan |
Monatspreis |
Relative Kapazität |
Wochenlimits |
Mit Claude Chat geteilt |
|
Pro |
$20 |
Baseline |
Ja |
Ja |
|
Max 5x |
$100 |
5× Pro-Kapazität |
Ja |
Ja |
|
Max 20x |
$200 |
20× Pro-Kapazität |
Ja |
Ja |
|
Team |
Variiert |
Höheres gemeinsames Kontingent |
Ja |
Ja |
|
Enterprise |
Individuell |
Organisationsspezifisch |
Ja |
Ja |
Änderungen der Nutzungsgrenzen im Mai 2026
Anthropic hat im Mai 2026 die Kapazität von Claude Code erweitert: Die Abo-Grenzen wurden verdoppelt und die früheren Reduktionen zu Stoßzeiten für Pro- und Max-Abos entfernt. Anstelle fixer Prompt-Zahlen drückt Anthropic die Planunterschiede nun als relative Kapazitätsmultiplikatoren aus, da die tatsächliche Nutzung von Modellwahl, Kontextgröße und Tooling abhängt.
Seitdem hat Anthropic die Wochenlimits gelegentlich über temporäre Promotions angepasst. Während des Claude Fable 5 Rollouts wurden die wöchentlichen Claude Code Limits für berechtigte Abonnenten beispielsweise um 50% erhöht. Weil diese Erhöhungen temporär sind, solltest du vor länger laufenden Workloads immer die aktuellen Limits im Claude Usage Dashboard prüfen.
Agent SDK Credits (Juni 2026)
Der Plan, interaktive Codingsessions von automatisierten Agent-Workloads zu trennen, sorgte im Juni 2026 für Verwirrung.
Vor dem 15. Juni floss jede Claude Code Aktivität aus demselben Abo-Pool: Egal ob interaktives Chatten im Terminal, ein GitHub Action Run oder der Aufruf von claude -p in einer CI-Pipeline – alles konkurrierte um dieselben 5-Stunden- und Wochenlimits.
Anthropic wollte ab dem 15. Juni 2026 mit der Trennung dieser Workloads beginnen, pausierte die Umstellung jedoch am Launch-Tag selbst. Das bedeutet: Interaktive Nutzung und programmgesteuerte Nutzung (Agent SDK, claude -p, GitHub Actions) ziehen weiterhin aus demselben Abo-Pool wie zuvor.
Stand Juli 2026 gibt es keine separaten Agent SDK Credits live und auch keinen Opt-in-Credit zum Aktivieren.
Was saugt deine Quota wirklich leer?
Viele Entwickler fokussieren sich auf Prompts und Token-Tuning. Der wahre Kostentreiber ist oft der Kontext. Jede Interaktion enthält deutlich mehr Information als die Frage, die du tippst.
CLAUDE.md und Rules-Dateien
Claude Code lädt Anweisungen automatisch aus:
-
CLAUDE.md -
Elternverzeichnis-
CLAUDE.md-Dateien -
Importierten
@-Referenzen -
.claude/rules/*.md-Dateien
All dieser Kontext und zusätzliche Instruktionen werden bei Anfragen wiederholt mitgeschickt. Eine überladene Rules-Datei erhöht damit still den Tokenverbrauch der gesamten Sitzung. Anthropic empfiehlt, einzelne CLAUDE.md-Dateien auf etwa 200 Zeilen zu begrenzen.
Für größere Projekte lohnt es sich, Anweisungen in gescopete Regeln mit paths-Frontmatter aufzuteilen, sodass sie nur geladen werden, wenn sie relevant sind. Mehr dazu in unserem Guide für das optimale CLAUDE.md mit erprobten Organisationsstrategien.
MCP-Tooldefinitionen
Model Context Protocol (MCP) Server sind eine weitere versteckte Overhead-Quelle. Jeder verbundene MCP-Server injiziert Tool-Schemata in den Kontext von Claude – selbst wenn du diese Tools nie nutzt.
Stell dir vor:
- 5 MCP-Server
- 10 Tools pro Server
Das sind 50 Tooldefinitionen, die jeder Anfrage beiliegen. Nicht benötigte MCP-Server zu trennen, ist einer der einfachsten Wege, den Tokenverbrauch von Claude Code zu senken.
Wichtiger Hinweis: Vermeide das Hinzufügen oder Entfernen von MCP-Servern während einer aktiven Sitzung. Das invalidiert Prompt-Cache-Präfixe und kann die Nutzungskosten erhöhen.
Auto Memory
Seit Claude Code v2.1.59 ist Auto Memory standardmäßig aktiviert. Memory ist globales Wissen, das Claude aus verschiedenen Sitzungen gespeichert hat und das zusätzlichen Kontext liefert – von Methoden zum Abrufen von Daten aus einer Datenbank bis zu technischen Implementierungsdetails.
Beim Start lädt Claude Inhalte aus MEMORY.md, bis zu:
- Den ersten 200 Zeilen
- Den ersten 25 KB
Je nach Workflow ist das hilfreich – oder nur weiterer Ballast.
Du kannst Auto Memory auf zwei Arten deaktivieren. Für einen dauerhaften Kill-Switch, der alle anderen Einstellungen überschreibt (nützlich in CI-Pipelines und automatisierten Umgebungen), setze die Umgebungsvariable in deiner Shell:
export CLAUDE_CODE_DISABLE_AUTO_MEMORY=1
Alternativ fügst du Folgendes zu deiner settings.json hinzu. Verwende ~/.claude/settings.json, um es global für alle Projekte zu deaktivieren, oder .claude/settings.json für ein einzelnes Projekt:
{ "autoMemoryEnabled": false }
Wenn du Memory-Dateien nicht aktiv nutzt, kann das Deaktivieren die Grundkontextgröße reduzieren.
Gesprächsverlauf und Suche
Der Gesprächsverlauf wächst kontinuierlich. Jeder Tool-Output, jeder Dateiread, jedes Grep-Ergebnis, jeder Terminalbefehl und jede Codesuche wird Teil des Sitzungskontexts.
Aus meiner Erfahrung ist Repository-Exploration oft der größte Treiber. Claude liest womöglich Dutzende Dateien, um eine einzige Funktion zu finden. Diese Dateien bleiben im Kontext verfügbar und verursachen auch in künftigen Turns Token-Overhead.
Für automatisierte Workflows kann claude -p --bare einen Großteil dieses fixen Overheads reduzieren, indem unnötiger Sitzungskontext entfernt wird. Das spart viele der monatlichen Agent SDK Credits, die sonst dafür draufgehen, dass Claude Dateien durchsucht.
So prüfst du deine Claude Code Nutzung
Am besten prüfst du deine Nutzung, bevor du in eine längere Codingsession startest. So weißt du, wie nah du an deinen Limits bist, bevor es losgeht.
Mit /usage
In Claude Code zeigt /usage Folgendes an:
- Sitzungsverbrauch
- Wöchentlicher Verbrauch
- Verbleibendes Kontingent
So bekommst du schnell einen Überblick, wie viel Quota dir in der interaktiven Sitzung noch bleibt – und kannst planen. Direkt vor Limit-Erreichung eine komplexe Aufgabe zu starten, ist meist unklug. Kleine Aufgaben wie File-Cleanup sind dagegen eine gute Nutzung der Restquote.
Mit /status
Du kannst auch /status ausführen. Das liefert folgende Infos:
- Aktueller Plan
- Kontodaten
- Aktiver Nutzungsstatus
Plan und Status zu kennen, hilft, mögliche Begrenzungen einzuschätzen. Es macht einen Unterschied, ob deine Nutzung das 5- oder 20-fache der Basis ist.
Im Claude-Dashboard prüfen
Die vollständigste Sicht findest du unter Settings → Usage in Claude.ai.

Dieses Dashboard kombiniert:
- Claude Chat Nutzung
- Claude Code Nutzung
- Wöchentliche Reset-Zeitpläne
- Modellspezifische Limits
Weil mehrere Limits gleichzeitig gelten können, ist dieses Dashboard deine Single Source of Truth. Praktisch ist es, vor großen Refactors, langen Debugging-Sessions oder autonomen Coding-Aufgaben einen Blick darauf zu werfen.
So holst du mehr aus deinen Claude Code Limits heraus
Schauen wir uns an, wie wir unsere Nutzung ausweiten können, ohne den Plan upzugraden. Oft bekommst du deutlich mehr effektive Kapazität, indem du Overhead reduzierst.
Dein CLAUDE.md verschlanken
Ziele auf weniger als 200 Zeilen pro Datei, um den mitgesendeten Kontext und potenzielle Verwirrung für den Agenten zu minimieren. Achte besonders auf:
- Veraltete Projektanweisungen
- Historische Notizen
- Regeln, die besser in Einzelprompts gehören
Wenn Anweisungen nur für bestimmte Verzeichnisse relevant sind, nutze gescopete Regeln mit paths-Frontmatter, damit nicht ständig alle Regeln aktiv sind, sondern nur in den passenden Pfaden. Du kannst auch projektweite CLAUDE.md-Dateien statt einer globalen verwenden.
Deine MCP-Server aufräumen
Behalte nur die MCP-Server, die du aktiv nutzt. Jeder verbundene Server fügt bei jeder Interaktion Schema-Overhead hinzu. Behandle deine MCP-Konfiguration wie Browsertabs: Wenn du sie gerade nicht brauchst, schließ sie.
Eine gute Methode ist, MCP-Server auf Projektebene zu installieren, wenn du weißt, dass du bestimmte MCPs nur für bestimmte Projekte brauchst – statt auf User-Ebene. So versucht Claude nicht, sie in jedem Projekt oder jeder Sitzung zu laden, sondern nur bei Bedarf.
/compact früh nutzen
Der Befehl /compact fasst die Gesprächshistorie zusammen und senkt künftige Tokenkosten. Indem weniger wachsender Kontext pro Turn verarbeitet wird, sinkt die Quota-Nutzung.
Er stellt bereits verbrauchte Quota zwar nicht wieder her, ist aber hilfreich, wenn du /compact nutzt, bevor die Sitzung zu groß wird.
Modell zur Aufgabe passend wählen
Nicht jede Aufgabe braucht Opus oder Fable. Oft helfen kleinere Modelle oder clevere Modellnutzung beim Quota-Management. Du kannst deine verfügbare Kapazität deutlich erhöhen, wenn du Premium-Modelle für besonders wertschöpfende Arbeiten reservierst.
Einige Optimierungsstrategien:
- Opus für Architekturentscheidungen, komplexes Reasoning und unklare Anforderungen
- Sonnet für Editing, Suchen und Implementierung
- Haiku für leichte Tasks und schnelle Reads
Wechsle Modelle jedoch nicht dauernd innerhalb einer Sitzung. Prompt-Caches sind modellspezifisch, daher muss das neue Modell bei jedem Wechsel die gesamte Historie erneut zum vollen Tokenpreis verarbeiten, statt günstig aus dem Cache zu lesen. Das kann deine Quota schneller verbrennen als beim Bleiben – selbst wenn du zu einem „günstigeren“ Modell wechselst.
Wenn gar nichts mehr geht: API als Fallback
Wenn Abo-Grenzen zum Flaschenhals werden, bietet die Claude API eine Alternative. Die API zwingt dich weder in 5-Stunden-Fenster noch in Wochen-Caps. Stattdessen zahlst du nach Tokenverbrauch.
Dieses Modell passt oft für:
- CI-Pipelines
- Lange laufende autonome Agents
- Automatisierung im großen Stil
- Produktions-Workflows mit planbaren Budgets
Achte darauf, die Umgebungsvariable ANTHROPIC_API_KEY nicht unbeabsichtigt in deiner Claude Code Shell konfiguriert zu lassen. Ist der Key in deiner Umgebung vorhanden, authentifiziert sich Claude Code möglicherweise über die API statt über dein Abo.
Das kann zu unerwarteten API-Kosten führen, weil du dann nicht mehr deine Abo-Limits nutzt, sondern pro Token zahlst. Wenn Kosten ungewohnt wirken, sollte die Prüfung der Authentifizierung eine der ersten Fehlersuchmaßnahmen sein.
Für aktuelle Modellpreise gilt: Immer die offizielle Preisdokumentation von Anthropic prüfen, da sich Tarife häufig ändern und modellabhängig sind.
Fazit
Die Nutzungsgrenzen von Claude Code sind leichter zu managen, wenn du verstehst, dass nicht einfach nur Prompts gezählt werden.
Das System kombiniert:
- Ein rollierendes 5-Stunden-Fenster
- Wochenlimits
- Modellspezifische Kontingente
- Kontext-Overhead
Die größte Überraschung für viele Entwickler: Prompts sind oft nur ein kleiner Teil des gesamten Tokenverbrauchs. Große CLAUDE.md-Dateien, MCP-Tooldefinitionen, Auto Memory, Repository-Suchen und ein wachsender Gesprächsverlauf verbrauchen häufig mehr Kapazität als die eigentlichen Fragen.
In der Praxis haben die meisten, die auffallend schnell Limits erreichen, eher ein Konfigurations- als ein Kapazitätsproblem. Bevor du deinen Plan upgradest, reduziere den Overhead, indem du den Kontext aufräumst – statt einfach mehr Quota zu kaufen.
Um deinen Workflow weiter zu verbessern, empfehle ich unseren Guide zu Claude Code Best Practices und das Claude Code Hooks Tutorial. Beide zeigen Techniken, um Claude Code in langen Entwicklungssessions effizienter und robuster zu machen.
FAQs zu Claude Code Nutzungsgrenzen
Was sind die Nutzungsgrenzen von Claude Code?
Die Nutzungsgrenzen von Claude Code bestehen aus einem rollierenden 5-Stunden-Sitzungsfenster und einem oder mehreren wöchentlichen Nutzungslimits. Sowohl Claude Code als auch Claude Chat greifen auf denselben Abo-Pool zu.
Wie prüfe ich die Nutzung von Claude Code?
Du kannst die Nutzung mit /usage in Claude Code prüfen, mit /status Kontodetails abrufen oder das Usage-Dashboard in Claude.ai unter Settings → Usage nutzen.
Was verbraucht die meisten Claude Code Tokens?
Häufige versteckte Treiber sind große CLAUDE.md-Dateien, MCP-Tool-Schemata, Auto Memory, Gesprächsverlauf, Tool-Ausgaben und Ergebnisse aus Repository-Suchen.
Wie kann ich den Tokenverbrauch von Claude Code reduzieren?
Best Practices sind u. a.: CLAUDE.md-Dateien schlank halten, ungenutzte MCP-Server deaktivieren, /compact proaktiv einsetzen, unnötige Memory-Dateien entfernen, das Modell an die Aufgabenkomplexität anpassen und exzessive Repository-weite Suchen vermeiden.
Wurde das Agent SDK Credit-System bereits eingeführt?
Nein. Anthropic plante, die programmgesteuerte Nutzung ab dem 15. Juni 2026 von der interaktiven Claude-Nutzung zu trennen, hat diese Änderung am Launch-Tag jedoch pausiert und erklärt, dass sich vorerst nichts ändert. Claude Agent SDK, claude -p, Claude Code GitHub Actions und Drittanbieter-Anwendungen mit Agent SDK greifen derzeit weiterhin auf dieselben Abo-Nutzungslimits zu wie interaktives Claude Code.
Ich bin Datenwissenschaftler mit Erfahrung in räumlicher Analyse, maschinellem Lernen und Datenpipelines. Ich habe mit GCP, Hadoop, Hive, Snowflake, Airflow und anderen Data Science/Engineering-Prozessen gearbeitet.


