Claude Code hängt oder friert ein? Der komplette Rettungsguide

Hängengeblieben bei „Compacting conversation…“

Auto-Compact greift, wenn das Kontextfenster volläuft: Claude Code fasst die bisherige Konversation zusammen und ersetzt sie. Bei einer wirklich riesigen Session kann dieser Zusammenfassungsdurchlauf Minuten dauern — und in v2.1.282 und v2.1.284 wurden echte Fehlerbilder behoben: Compaction scheiterte an einer abgelehnten Summarizer-Anfrage oder zurück blieb ein „Prompt is too long“-Fehler. Wenn eine normal große Session länger als zwei, drei Minuten schuftet, hängt sie — sie arbeitet nicht.

1. 1Wenn die Session redlicherweise gewaltig ist, gib ihr zuerst ein paar Minuten — v2.1.283 hat den Compaction-Spinner überarbeitet: Sein Timer läuft erst, wenn die Compaction wirklich begonnen hat.
2. 2Danach Esc und dann Ctrl+C drücken, um den Compact abzubrechen. Die offizielle Doku bestätigt: Ctrl+C bricht die laufende Operation ab, ohne deine Session wegzuwerfen.
3. 3Danach von Hand mit Fokus komprimieren, damit die Zusammenfassung sperrige Tool-Ausgaben fallen lässt, zum Beispiel: /compact keep only the plan and the diff.
4. 4Ist die alte Geschichte entbehrlich, lieber /clear und neu anfangen — und auf v2.1.284 oder neuer aktualisieren, damit die reparierten Compaction-Wiederholungen an Bord sind.

/compact keep only the plan and the diff/clear

Hängengeblieben bei „Almost done thinking…“

Kontraintuitiv, aber dieses Spinner-Label ist kein Fortschrittsbericht: Maintainer haben in Issue #63387 bestätigt, dass die rotierenden Phrasen nicht dem echten Denkzustand des Modells entsprechen. „almost done“ kann also viele Minuten auf dem Schirm sitzen bleiben, und Issue #55328 dokumentiert Züge, in denen Esc und Ctrl+C nichts bewirkten, während Extended Thinking sich dehnte.

1. 1Einmal Esc drücken und ein paar Sekunden warten; dreht der Spinner weiter, Ctrl+C drücken.
2. 2Bleibt die Eingabe tot, den Terminal-Tab schließen, einen neuen öffnen und im selben Verzeichnis claude --resume ausführen, um die Session wieder aufzunehmen.
3. 3Hängt jeder lange Zug gleich? Claude Code aktualisieren und dann einen steckengebliebenen MCP-Server oder Hook verdächtigen — von außen nicht von einer Denkblockade zu unterscheiden, und /mcp zeigt, welcher Server spinnt.

claude --resume

„Not responding — try stopping“

Dieses orange Banner ist der Wachhund von Claude Code: Ein Tool-Aufruf — meist ein langer Bash-Befehl — war lange genug still, dass die UI einen Stopp-Knopf anbietet. Das ist ein Hinweis, kein Urteil: In Anthropics eigenen Demos lief der Prozess darunter teils ganz normal weiter, und Claude-Code-Lead Boris Cherny hat öffentlich um Aufnahmen dieses Zustands gebeten — das Team kennt das Problem und untersucht es.

1. 1Prüfe, ob der zugrunde liegende Befehl noch Ausgabe produziert — ein Build, der still kompiliert, muss nicht unterbrochen werden.
2. 2Feststeckt es wirklich, Esc oder den orangen Stopp-Knopf drücken, um den Zug abzubrechen.
3. 3Sag Claude, dass du manuell gestoppt hast — nach einem manuellen Stopp hält das Modell das Tool fälschlich für abgelehnt und entschuldigt sich, statt weiterzumachen.
4. 4Lass die lange Operation künftig im Hintergrund oder in kleineren Happen laufen, damit der Vordergrund-Wachhund nicht erneut zuschlägt.

claude --resume

Bekannte raue Kante: In einer Anthropic-Demo genau dieses Banners erschien der Stopp-Knopf, während der Befehl noch gesund war — erst prüfen, dann stoppen.

Hängengeblieben bei „Resuming container…“ (Cloud-Sessions)

Die Web- und Mobile-Sessions von Claude Code laufen in einem Cloud-Container. Eine ältere Session wieder öffnen heißt, diesen Container neu hochzufahren und das Protokoll zu streamen — bei großen Historien ehrlich langsam. v2.1.286 behebt einen Bug, bei dem Sessions mit sehr großen Historien gar nicht mehr aufwachten, weil der Container stoppte, während das Protokoll noch lud.

1. 1Warte zuerst ein paar Minuten — ein kalter Container-Neustart ist langsamer als eine frische Session, und ein Fortschrittsbalken verrät nicht, dass sich was tut.
2. 2CLI auf v2.1.286 oder neuer bringen — claude update oder npm install -g @anthropic-ai/claude-code — genau dieses Release fixt den „wacht nie auf“-Bug für sehr große Cloud-Historien.
3. 3Nach dem Update weiter eingefroren? Web-Session neu laden; hält es an, eine neue Session starten und dort weiterarbeiten.

claude updatenpm install -g @anthropic-ai/claude-code

Community-Workaround, offizielle Antwort steht aus: Mehrere Nutzer berichten, der Container wachte nach rund fünf Minuten — erst danach für tot erklären.

Einfrieren beim Start

Ein Einfrieren vor dem Prompt ist fast immer lokal: ein abstürzender MCP-Server, ein Plugin oder Hook, ein kaputter Zustand oder ein Erweiterungsproblem. v2.1.284 reparierte VS-Code-Tabs, die nach Restart Extensions nicht mehr reagierten, und v2.1.286 den endlosen „Teleporting session…“-Spinner, wenn die Erweiterung nicht mehr antwortet. Weil das /doctor in der App eine lebende Session braucht, startet man aus der Shell.

1. 1claude doctor aus dem Terminal ausführen — genau das empfiehlt die Doku für den startet-nicht-Fall; es prüft die Installation und schlägt Fixes vor.
2. 2Mit claude --safe-mode starten — das deaktiviert für die Session alle Plugins, MCP-Server und Hooks; klappt der Start, ist einer dieser Eingriffe der Täter.
3. 3Die Eingriffe einzeln wieder zuschalten — oder drin einmal /mcp laufen lassen — den Übeltäter finden und aktualisieren oder entfernen.
4. 4Unter VS Code auch die Erweiterung aktualisieren — die beiden 2.1.28x-Fixes oben existieren nur in aktuellen Versionen.

claude doctorclaude --safe-mode

Im Terminal eingefroren

Der Klassiker: das ganze Fenster friert ein — Eingabe tot, Spinner steht, Ctrl+C wird ignoriert. Dafür gibt es ein dokumentiertes Vorgehen: abbrechen versuchen, nötigenfalls das Terminal neu starten, fortsetzen; verloren ist in beiden Fällen nichts. Matschige oder halb gezeichnete Ausgabe im integrierten Editor-Terminal ist ein anderes Problem — GPU-Beschleunigung — mit Ein-Befehl-Fix.

1. 1Ctrl+C drücken, um die laufende Operation abzubrechen.
2. 2Reagiert das Fenster weiterhin nicht, das Terminal komplett schließen und ein neues öffnen.
3. 3Im frischen Terminal claude --resume im selben Projektverzeichnis ausführen — die Doku verspricht: Die Konversation ist nicht verloren.
4. 4Ausgabe matschig im integrierten VS-Code-Terminal? /terminal-setup ausführen — es schaltet die GPU-Beschleunigung des Terminals aus und räumt die Verzerrung weg.

claude --resume/terminal-setup