Claude Code „Prompt is too long“ — Kontextfenster verstehen und beheben

Prompt is too long bedeutet in Claude Code, dass die gesendete Eingabe die Grenze des Kontextfensters überschreitet. In der interaktiven Oberfläche beginnt die Grundform als einzeilige Meldung mit Context limit reached; längere Formen mit Angabe der Ursache erscheinen weiterhin als Prompt is too long ·. Der hintere Teil der Meldung hängt von der Situation ab und nennt den nächsten Schritt. Vergleichen Sie den Text auf Ihrem Bildschirm mit der folgenden Übersicht.

# Interaktive Oberfläche (Standard)
Context limit reached · /compact or /clear to continue

# Interaktive Oberfläche (automatische Verdichtung ausgeschaltet)
Context limit reached · /compact or /clear to continue · auto-compact is off · /config to turn it on

# Interaktive Oberfläche (Verdichtung mit DISABLE_COMPACT ganz abgeschaltet)
Context limit reached · /clear to continue

# Ausgabe von -p und Gesprächsprotokoll
Prompt is too long

# Automatische Verdichtung scheitert an einem anderen Fehler
Prompt is too long · automatic compaction failed: <ursächlicher Fehler>

# Gespräch aus nur einem Austausch, kein zusammenfassbarer Verlauf
Prompt is too long · this conversation is a single exchange and cannot be compacted — …
Prompt is too long · the request is ~<N> tokens (limit <Grenze>) … A single-exchange conversation cannot be compacted; …

# Über Amazon Bedrock
Input is too long for requested model.

# /compact selbst scheitert (Abschnitt 4)
Error during compaction: Conversation too long. Press esc twice to go up a few messages and try again.

# Antworttext der API (Zahlen als Beispiel)
prompt is too long: 209117 tokens > 200000 maximum

Jetzt weiterarbeiten →

Zur Eingabe gehören nicht nur die gerade getippten Wörter, sondern auch Gesprächsverlauf, gelesene Dateien, Werkzeugergebnisse und Anweisungen. 209117 tokens > 200000 maximum im Antworttext der API bedeutet, dass 209.117 Eingabetokens die Grenze von 200.000 überschritten haben. Das Kontextfenster umfasst sowohl Eingabe als auch die für diese Antwort erzeugte Ausgabe; dieser Fehler bedeutet, dass schon die Eingabe allein die Grenze überschreitet. Die Lösung unterscheidet sich von einem usage limit durch ausgeschöpftes Plankontingent.

Bei langem Verlauf /compact verwenden, bei zu großer erster Eingabe diese verkleinern und bei gemeldetem Verdichtungsfehler zuerst dessen Ursache beheben. Das sind die grundlegenden Wege zurück zur Arbeit. Automatische Verdichtung ist standardmäßig aktiv und verhindert diesen Fehler normalerweise. Tritt er trotzdem auf, entscheidet sich an diesen drei Punkten, wie es weitergeht. Dieser Artikel erläutert Ursachen, Schritte sowie Bedingungen für 200K und 1M anhand der offiziellen Claude-Code-Fehlerbeschreibung und API-Spezifikation mit Stand 21. September 2026. Direkte API-Aufrufe werden getrennt behandelt.

1. Was dieser Fehler bedeutet

Das Kontextfenster begrenzt die Informationsmenge, die ein Modell für eine Antwort berücksichtigen und erzeugen kann. Gezählt werden Tokens, nicht Zeichen; neben der Eingabe zählen aktuelle Ausgabe und Denktokens. Auch aus dem API-Cache gelesene Eingabe belegt das Fenster. Caching verändert Preis oder Verarbeitung, macht die Belegung aber nicht null. Grundlage ist Anthropics Kontextfenster-Spezifikation.

Prompt is too long tritt auf, wenn bereits die gesendete Eingabe allein nicht ins Fenster passt. Selbst eine kurze Frage kann Teil einer großen Anfrage sein, wenn alte Gesprächsteile oder Dateien mitgeschickt werden. Deshalb reicht es möglicherweise nicht, nur die letzte Frage zu kürzen. Grundlagen: Was ist ein Kontextfenster?

Nahe der Grenze entfernt Claude Code ältere Werkzeugausgaben und fasst bei Bedarf das Gespräch zusammen. Zum Stillstand kommt es trotzdem bei einer riesigen eingefügten Eingabe, bei deaktivierter automatischer Verdichtung oder wenn die Verdichtung selbst scheitert. Erneutes Lesen derselben großen Datei kann das Fenster sofort wieder füllen. Welcher Fall vorliegt, verrät der hintere Teil der Meldung vom Anfang dieses Artikels. Bei automatic compaction failed: folgt dahinter die Ursache des Verdichtungsfehlers, bei single exchange gibt es keinen zusammenfassbaren Verlauf, und bei auto-compact is off ist die automatische Verdichtung ausgeschaltet.

2. Was füllt das Kontextfenster?

Die folgende Übersicht folgt der Erklärung zur Arbeitsweise von Claude Code. Das gespeicherte Gesprächsprotokoll ist nicht identisch mit dem aktuell an das Modell gesendeten Inhalt. Das Entfernen alter Werkzeugergebnisse und Zusammenfassungen verändern das aktive Fenster.

MCP-Werkzeugdefinitionen werden standardmäßig über Tool Search erst bei Bedarf geladen. Zu Sitzungsbeginn kommen nur Werkzeugnamen und Serverbeschreibungen hinzu, sodass zusätzliche Server das Fenster kaum belasten. Von Anfang an geladen werden die Definitionen etwa, wenn ENABLE_TOOL_SEARCH=false gesetzt ist, ein Server mit alwaysLoad konfiguriert ist oder CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS gesetzt ist. Bei einem Gateway über ANTHROPIC_BASE_URL gilt Tool Search ab v2.1.304 standardmäßig (alle Bedingungen in der offiziellen Tool-Search-Konfigurationstabelle). Die tatsächliche Belastung zeigt nicht die Serverzahl, sondern /context.

Subagenten recherchieren in einem eigenen Fenster und können Ergebnisse liefern, ohne sämtliche Zwischenausgaben in das Hauptgespräch zu bringen. Allerdings belegen zurückgelieferte Zusammenfassungen und Schlussfolgerungen das Fenster des übergeordneten Agenten. Vollständiges Abschreiben der Recherche schmälert den Nutzen. Geben Sie benötigte Ergebnisse vor, etwa „Nur relevante Dateien und Zeilen, Fazit und offene Punkte zurückgeben“. Außerdem übernehmen Subagenten alle MCP-Werkzeugdefinitionen des übergeordneten Agenten; die offizielle Fehlerbeschreibung empfiehlt deshalb, ungenutzte MCP-Server vor dem Start von Subagenten zu deaktivieren. Die Gestaltung behandelt Context Engineering.

/context zeigt die Belegung des aktuellen Fensters, /usage den Tokenverbrauch und die Plannutzung. Dessen Kostenanzeige ist eine Schätzung, keine endgültige Rechnung. In unterstützten Umgebungen untersucht /skill-doctor auch die Skill-Belegung. Fehlt der Befehl, beginnen Sie einfach mit /context. Messschritte stehen unter Was verbraucht Ihren Kontext?, Bereitstellungsbedingungen in der offiziellen Befehlsliste.

3. Kontextgrößen: 200K und 1M

200K sind 200.000 Tokens, 1M eine Million. Modellkapazität, von Claude Code für die Verbindung verwendete Kapazität, Schwelle der automatischen Verdichtung und Preisbedingungen sind jedoch jeweils eigene Zahlen. Aktuelles Modell und Konto zeigt /status, die verfügbaren Optionen /model.

Bei Abonnements spielt Nutzungsguthaben nur für Opus 4.6 und Sonnet 4.6 eine Rolle, die 1M über ihre [1m]-Variante erreichen. Opus 4.6 mit 1M ist in Max, Team und Enterprise enthalten, benötigt unter Pro aber Nutzungsguthaben; Sonnet 4.6 mit 1M benötigt in jedem Abonnement Nutzungsguthaben. Die Fable-Familie, Sonnet ab 5 (einschließlich des aktuellen Sonnet 5.5) und Opus ab 4.7 mit direkter Verbindung zur Anthropic API werden anders behandelt: auf allen Plänen einschließlich Pro standardmäßig 1M, ohne zusätzliches Nutzungsguthaben und ohne Auswahl von [1m]. Gateways und Einstellungen zum Deaktivieren von 1M schaffen Ausnahmen. Entscheiden Sie nicht allein nach dem Modellnamen.

„Standardpreis“ für 1M bedeutet, dass für mehr als 200K kein zusätzlicher Langkontext-Aufschlag je Token berechnet wird. Es bedeutet nicht unbegrenzt mehr Eingabe zum gleichen Gesamtpreis. Mehr verarbeitete Tokens erhöhen den Verbrauch. Ob 1M im Plan enthalten ist oder über Guthaben abgerechnet wird, ist eine weitere getrennte Frage.

Auch das Verhältnis von Zeichen zu Tokens hängt von Modell und Inhalt ab. Nehmen Sie für neuere Modelle keine pauschale prozentuale Erhöhung an, sondern nutzen Sie bei API-Aufrufen die Tokenzählung des Zielmodells. Manche Aufgaben brauchen größere Fenster; zuvor irrelevante Protokolle und doppelte Anweisungen zu entfernen erleichtert die Kapazitätsentscheidung.

4. Jetzt weiterarbeiten

Wählen Sie nach der Situation: gewachsener Verlauf oder hinzugefügte große Datei. Die folgenden Maßnahmen sind nach Priorität geordnet.

Scheitert /compact mit Error during compaction: Conversation too long, fehlt Platz für die erzeugte Zusammenfassung. Drücken Sie bei leerem Eingabefeld zweimal Esc (oder verwenden Sie /rewind), um das Zurückspulmenü zu öffnen, und setzen Sie das Gespräch auf eine Nachricht vor der großen Eingabe zurück. Soll der Code unverändert bleiben und nur das Gespräch zurückgesetzt werden, wählen Sie Restore conversation. Verdichten Sie danach erneut; reicht der Platz weiterhin nicht, beginnen Sie nach /clear mit kleinerer Eingabe. Das vorherige Gespräch bleibt gespeichert und lässt sich mit /resume wieder öffnen. Die Menüoptionen beschreibt die offizielle Erklärung zum Zurückspulen.

Folgen auf automatic compaction failed: Authentifizierungsfehler oder ein nicht verfügbares Modell, beheben Sie dies vor dem Freiräumen. Bis dahin scheitert auch /compact mit demselben Fehler. Antwortet /compact mit Not enough messages to compact., handelt es sich um ein Gespräch aus nur einem Austausch ohne zusammenfassbaren früheren Verlauf. Führen Sie /clear aus und senden Sie erneut mit weniger eingefügtem Text oder kleineren Anhängen. Füllt sich das Fenster sofort wieder, begrenzen Sie die letzten großen Protokolle oder Dateien auf benötigte Teile.

Bei direkter Nutzung der API

/compact und /clear sind Claude-Code-Aktionen, keine Steuerbefehle für die Messages API. Überschreitet allein die Eingabe das Fenster, gibt die API den Fehler 400 invalid_request_error („prompt is too long“) zurück. Überprüfen Sie die gesendeten messages, system, tools und Anhänge und schätzen Sie die Eingabe mit der Tokenzählungs-API des Zielmodells. Verkleinern Sie die Anfrage: alten Verlauf zusammenfassen, relevante Dokumentteile auswählen, unnötige Definitionen entfernen. Schneiden Sie nicht so ab, dass Werkzeugaufrufe und zugehörige Ergebnisse getrennt werden. API-seitige Verdichtung für lange Gespräche existiert ebenfalls, hat aber andere Modell- und Einstellungsbedingungen als Claude-Code-Befehle.

Warten Sie nach der Wiederherstellung ab, ob eine kleine Anfrage beantwortet wird, und ergänzen Sie Informationen dann schrittweise. Dieselbe große Eingabe erneut zu senden und zu warten vergrößert keine Kapazität. Regelmäßige Pflege behandelt Tokensparen in Claude Code.

5. Ähnliche Fehler unterscheiden

Zu große Eingabe, eingestellte Ausgabegrenze, während der Erzeugung erreichtes Fenster und Verbrauch im Zeitraum sind verschiedene Probleme. Unterscheiden Sie sie anhand des Fehlertexts oder des stop_reason der API, nicht danach, ob eine Antwort abgeschnitten aussieht.

Laut Anthropic akzeptiert die API ab Claude 4.5 Anfragen, deren Eingabe selbst passt, auch wenn Eingabe plus angefragtes max_tokens das Fenster überschreiten. Wird die Fenstergrenze während der Generierung erreicht, lautet der Stoppgrund model_context_window_exceeded. Daher beweist eine kurze Antwort allein nicht den Stoppgrund max_tokens. Weitere Probleme: häufige Claude-Code-Fehler.

Verwandt: Ist der Verlauf in der Codex-App noch sichtbar, scheitert aber nur das Senden, liegt kein Problem der Eingabegröße vor, sondern eines des Unterhaltungszustands. Das behandelt Codex „thread not found“: Fehlerdiagnose und ein Wiederherstellungsbeispiel.

6. Vorbeugende Checkliste

Vor der Arbeit: Mit /context geladene Inhalte prüfen. Große Dokumente über Suche oder Zeilenbereiche eingrenzen, nicht gleich vollständig einfügen. Bei ausgelagerter Recherche auch den Umfang der Rückmeldung des Subagenten festlegen.

Während der Arbeit: Automatische Verdichtung in der Standardeinstellung (aktiv) lassen. Erscheint in der Fehlerzeile auto-compact is off, schalten Sie sie mit /config wieder ein. Wurde sie über die Umgebungsvariable DISABLE_AUTO_COMPACT abgeschaltet, erscheint dieser Hinweis nicht; entfernen Sie dann diese Einstellung. Achten Sie auf erneutes Laden derselben Inhalte nach jeder Verdichtung. Häufigere manuelle Verdichtung ist nicht automatisch besser: der richtige Zeitpunkt für /compact und die Angabe zu bewahrender Entscheidungen sind wichtig.

Zwischen Aufgaben: Vor einer unabhängigen Aufgabe nötige Informationen in Dateien sichern und mit /clear ein neues Gespräch beginnen. Das alte Gespräch bleibt gespeichert; denselben riesigen Verlauf zur Wiederherstellung fortzusetzen kann aber die Ursache zurückbringen. In CLAUDE.md nur ständig benötigte Regeln behalten.

Eigene Verbindungen: Bei Gateway oder eigener Modell-ID prüfen, ob das von Claude Code angenommene Fenster von der tatsächlichen Kapazität abweicht. Eine höhere Konfigurationszahl vergrößert das echte Modellfenster nicht. Wie Sie beides abgleichen, steht in den offiziellen Einstellungen für eigene Modelle.

Zusammenfassung

Prompt is too long betrifft die gesamte Eingabe mit Verlauf und Anhängen, nicht nur den letzten Satz. Wählen Sie situationsabhängig: /compact bei langem Verlauf, kleinere anfängliche Eingabe oder Behebung der eigentlichen Verdichtungsstörung.

Welcher Zustand vorliegt, verrät der hintere Teil der Fehlermeldung (automatic compaction failed:, single exchange, auto-compact is off). Detaillierte MCP-Definitionen werden standardmäßig bei Bedarf geladen; die Belastung zeigt daher nicht die Serverzahl, sondern /context. Bei 1M werden Kapazität, Preis und Verdichtungsschwelle je nach Modell, Verbindung und Plan getrennt festgelegt. Bei direkter API-Nutzung überprüfen Sie Anfrage und Stoppgrund, nicht Claude-Code-Befehle.

FAQ

F. Sind „Prompt is too long“ und „usage limit reached“ dasselbe?
A. Nein. Ersteres betrifft die Kontextgrenze einer Anfrage, Letzteres das Plankontingent. Bei Eingabeüberlauf verkleinern Sie die gesendeten Inhalte. /clear stellt das Plankontingent nicht wieder her.

F. Warum tritt das trotz automatischer Verdichtung auf?
A. Ursachen sind riesige Eingabe, fehlender früherer Verlauf, fehlgeschlagene Verdichtung oder sofortiges Wiederauffüllen. Sie lassen sich am hinteren Teil der Fehlermeldung unterscheiden. Steht hinter automatic compaction failed: eine Ursache wie ein Authentifizierungsfehler, beheben Sie diese zuerst. Bei single exchange führen Sie /clear aus und beginnen mit einer kleineren Eingabe.

F. Auch /compact scheitert mit „Conversation too long“.
A. Es fehlt Platz für die Zusammenfassung. Drücken Sie bei leerem Eingabefeld zweimal Esc, um das Zurückspulmenü zu öffnen, setzen Sie das Gespräch auf eine Nachricht vor der großen Eingabe zurück und versuchen Sie es erneut. Soll der Code erhalten bleiben, wählen Sie Restore conversation. Reicht das nicht, nötige Informationen sichern und nach /clear mit kleinerer Eingabe beginnen.

F. Hilft der Wechsel zu einem 1M-Modell?
A. Wenn die nötige Eingabe hineinpasst, kann er helfen. Bedingungen unterscheiden sich nach Modell, Verbindung und Plan. Standardpreise je Token bedeuten bei mehr Verarbeitung keinen gleichbleibenden Gesamtpreis. Unnötigen Verlauf und große Ausgaben zuerst zu reduzieren erleichtert die Kapazitätswahl.

F. Wie finde ich heraus, was das Fenster belegt?
A. In Claude Code zeigt /context die Aufschlüsselung. Das ist etwas anderes als kumulierter Verbrauch oder Kontingente in /usage. MCP-Definitionen werden standardmäßig bei Bedarf geladen, daher sagt die Verbindungszahl allein nichts über die Belastung. Bei API-Nutzung die Eingabe mit der Tokenzählungs-API des Zielmodells schätzen.