Claude Code „prompt is too long“: Was die Ursache ist und wie du ihn behebst

Du bist mitten in einer Aufgabe, sendest eine normale Nachricht und Claude Code antwortet mit Prompt is too long. Manchmal blockiert das danach jede weitere Eingabe, bis du das Problem löst. Es ist kein Fehler in deinem Prompt. Dein Kontextfenster, also die Textmenge, die das Modell auf einmal verarbeiten kann, ist voll. Eine Nachricht mehr war einfach zu viel.

Was „prompt is too long“ eigentlich bedeutet

Es gibt zwei verschiedene Limits, die oft verwechselt werden. Das Nutzungslimit betrifft die Nutzung über einen bestimmten Zeitraum, also das Budget deines Tarifs. Prompt is too long betrifft die aktuelle Größe: Eine einzelne Eingabe hat das Kontextfenster überschritten. In diesem Beitrag geht es um Letzteres. Es bedeutet, dass die Konversation zusammen mit deiner neuen Eingabe nicht mehr hineinpasst. Die Lösung ist also immer dieselbe: Schaffe Platz im Fenster.

Was deinen Kontext füllt

Drei Übeltäter, grob sortiert nach Häufigkeit:

Die Lösung, Schritt für Schritt

1. Führe /compact aus. Das fasst die Konversation auf das Wesentliche zusammen, sodass du weitermachen kannst. Das solltest du als Erstes versuchen, denn es schafft Platz, ohne dass du den Faden verlierst.
2. Oder führe /clear aus. Das löscht die Konversation komplett, während dein Projekt und CLAUDE.md geladen bleiben. Nutze diesen Befehl zwischen verschiedenen Aufgaben. Frisches Fenster, gleiches Projekt.
3. Schalte ungenutzte MCP-Server aus. Jeder verbundene Server verbraucht Platz im Fenster. Beschränke dich auf die Server, die du für diese Aufgabe wirklich brauchst.
4. Füttere das Modell nicht mit riesigen Dateien. Kopiere keine gigantischen Dateien hinein und führe /context nicht auf deinem gesamten Repository aus. Verweise mit @path/to/file gezielt auf das, was du brauchst, oder teile die Datei auf.
5. Teile die Aufgabe auf. Wenn eine Anfrage tatsächlich mehr Platz benötigt, als das Fenster bietet, ist sie zu groß. Erledige sie in kleineren Schritten.

Wie du den Fehler in Zukunft vermeidest

Wer diesen Fehler nie sieht, hat nicht einfach Glück. Diese Leute halten ihren Kontext bewusst schlank: /clear zwischen verschiedenen Aufgaben, /compact vor einer großen neuen Aufgabe, nur die absolut notwendigen MCP-Server und Dateien referenzieren statt komplett hineinkopieren. Der Vorteil: Ein schlanker Kontext ist nicht nur fehlerfrei, sondern auch schneller und günstiger, weil du nicht bei jedem Schritt für die Verarbeitung eines überladenen Fensters bezahlst.

Diese Gewohnheit, den Kontext bewusst klein zu halten, ist fest in kitstarter verankert. Die Befehle des Kits speichern und bereinigen deine Arbeit in sauberen Schritten, sodass sich das Fenster nie unbemerkt bis zum Absturz füllt, und eine schlanke CLAUDE.md hält die Ausgangsbasis klein. Ein überladener Kontext ist nicht nur eine Fehlermeldung. Er ist auch der Grund, warum lange Sessions langsam werden und das Modell Dinge vergisst.

Häufige Fragen

Was bedeutet „prompt is too long“ in Claude Code? Es bedeutet, dass eine einzelne Eingabe das Kontextfenster überschritten hat, also das Token-Limit für eine Nachricht. Das ist etwas anderes als das Erreichen deines Nutzungslimits, bei dem es um die Nutzung über einen längeren Zeitraum geht. „Prompt too long“ bezieht sich auf die aktuelle Größe. Meistens wird der Fehler durch eine überladene Konversation, zu große Dateien oder ungenutzte MCP-Server verursacht, die das Fenster füllen.

Wie behebe ich den „prompt too long“-Fehler in Claude Code? Führe /compact aus, um die Konversation zusammenzufassen und fortzufahren, oder /clear, um sie zu löschen und neu zu starten, während dein Projekt geladen bleibt. Deaktiviere ungenutzte MCP-Server, lade keine riesigen Dateien hoch, führe /context nicht auf deinem gesamten Repository aus und teile große Aufgaben in kleinere Schritte auf.

Wie verhindere ich, dass das wieder passiert? Mache es dir zur Gewohnheit, deinen Kontext schlank zu halten: /clear zwischen verschiedenen Aufgaben, /compact vor einer großen neuen Aufgabe, nur die tatsächlich benötigten MCP-Server nutzen und auf Dateien mit @ verweisen, statt sie komplett hineinzukopieren. Ein schlanker Kontext ist nicht nur fehlerfrei, sondern auch schneller und günstiger.