Source: https://aiprimetech.io/de/claude-code/errors/claude-code-hangs/ [Startseite](/de/) › [Claude Code](/de/claude-code/) › [Fehler](/de/claude-code/errors/) › Hängt / steckt fest [Überblick](/de/claude-code/)[Installation](/de/claude-code/install/)[CLI-Referenz](/de/claude-code/cli/)[Preise und Limits](/de/claude-code/pricing/)[Agent SDK](/de/claude-code/sdk/)[Skills und Plugins](/de/claude-code/skills/)[GitHub](/de/claude-code/github/)[Web, Desktop und IDE](/de/claude-code/web-and-desktop/)[Modelle](/de/claude-code/models/)[Fehler](/de/claude-code/errors/)[Open Source?](/de/claude-code/open-source/)[Tutorial](/de/claude-code/tutorial/)[Für Studierende](/de/claude-code/for-students/)[QA-Automatisierung](/de/claude-code/qa-automation/)[Vergleich mit Cursor](/de/claude-code/vs-cursor/)[Vergleich mit Codex und OpenCode](/de/claude-code/vs-codex/)[Subagenten](/de/claude-code/subagents/)[Hooks](/de/claude-code/hooks/)[MCP](/de/claude-code/mcp/)[Ökosystem](/de/claude-code/ecosystem/)[VS Code](/de/claude-code/vscode/)[OpenRouter](/de/claude-code/openrouter/)[Anfragelimits](/de/claude-code/rate-limits/)[Chinesischer Leitfaden](/claude-code/zh/) Zuletzt aktualisiert: 11. Oktober 2026 # Claude Code hängt, bleibt stecken oder reagiert nicht mehr: So finden Sie heraus, wo es festhängt, und beheben das Problem Ein Hänger hat einen Ort: Claude Code wartet auf die API, auf ein von ihm gestartetes Tool, auf einen MCP-Server, auf Ihr Terminal oder auf sich selbst. Der Ausweg ist jeweils ein anderer, und die Statuszeile verrät Ihnen meist, welcher Fall vorliegt, bevor Sie zu kill greifen. ## TLDR - Warten auf die API → eine Ladeanzeige mit Tokenanzahl oder eine Zeile *Warten auf API-Antwort*; ein [Verbindungsproblem](/de/claude-code/errors/connection-lost/), kein Hänger. - Warten auf ein Tool → die Tool-Zeile bleibt offen; Esc bricht es ab. Ein Shell-Befehl, der auf Eingaben wartet, oder ein außer Kontrolle geratener grep ist die übliche Ursache. - Warten auf Sie → eine Bestätigungs- oder Frageaufforderung liegt außerhalb des sichtbaren Bereichs; drücken Sie Enter oder scrollen Sie. - Tatsächlich festgefahren (keine Ausgabe, keine Reaktion auf Esc, Ctrl+C) → beenden Sie den Prozess und setzen Sie die Sitzung fort mit claude -c; prüfen Sie die bekannten Fehler unten. ## Wo hängt es? Prüfen Sie die Anzeige, dann den Prozess ``` # in the session Esc # cancel the current tool or turn Ctrl+C (twice) # abort the turn / exit # from another terminal ps aux | grep -E "claude|node" | grep -v grep # child processes still running? top -o cpu # is claude spinning or idle? claude --debug # next time: timestamps for every request and tool call claude -c # resume the last session after a kill ``` Eine untätige CPU bei einem eingefrorenen Prompt bedeutet, dass auf etwas Externes gewartet wird: einen Netzwerkstream, einen MCP-Server, einen untergeordneten Prozess oder eine Aufforderung, die Sie nicht sehen können. Eine dauerhaft voll ausgelastete CPU bedeutet, dass intern etwas verarbeitet wird: das Parsen eines riesigen Tool-Ergebnisses, Backtracking bei einem regulären Ausdruck oder das Laden einer großen Sitzung. Stetig steigender Speicherverbrauch bedeutet, dass ein Tool-Ergebnis oder eine Sitzungsdatei vollständig in den Speicher eingelesen wird. ## Bekannte Ursachen im Issue-Tracker - `/rewind` hängt, `Ctrl+C` wird ignoriert, `kill -9` erforderlich ([#53011](https://github.com/anthropics/claude-code/issues/53011), 21 Reaktionen, bei Sitzungen jeder Größe in den Builds 2.1.1xx). Ein Anthropic-Entwickler konnte das Problem auf 2.1.233 nicht reproduzieren, aktualisieren Sie daher zuerst; beenden Sie bei einem älteren Build den Prozess und setzen Sie die Sitzung fort mit claude -c statt zurückzuspringen. - Remote-Control-Sitzungen frieren während der Ausführung ein und lassen sich nur durch ein lokales `Esc` wiederbeleben ([#51267](https://github.com/anthropics/claude-code/issues/51267), offen). Jedes blockierende Tool oder jeder blockierende Unterprozess friert die gesamte Remote-Sitzung ein, ohne dass sie aus der Ferne abgebrochen werden kann; halten Sie solche Sitzungen kurz und vermeiden Sie Tools, die möglicherweise Eingaben anfordern. - MCP-Authentifizierungsaufforderung hängt bei `Enter` ([#42707](https://github.com/anthropics/claude-code/issues/42707), offen). Authentifizieren Sie den Server über einen separaten claude mcp Befehl oder den Browser und starten Sie die Sitzung anschließend neu. - `grep` über den eingebetteten Matcher verbraucht den gesamten Arbeitsspeicher ([#54394](https://github.com/anthropics/claude-code/issues/54394)): Bei nativen Builds läuft jeder Shell- grep Aufruf innerhalb eines claude Prozesses mit eigenem V8-Heap; ein regulärer Ausdruck mit Backtracking auf einer langen minifizierten Zeile lässt den Speicherbedarf auf Gigabytes anwachsen, und der OOM-Killer beendet dabei auch die Sitzung, sowohl unter WSL2 als auch unter Linux. Vermeiden Sie unbeschränkte reguläre Ausdrücke auf minifizierten Dateien, schließen Sie Build-Ausgaben und node_modulesaus oder installieren Sie das systemweite ripgrep und rufen Sie es explizit auf. - Festgefahrene Wiederholungsschleife bei `400 thinking blocks cannot be modified` ([#63231](https://github.com/anthropics/claude-code/issues/63231)) — der Gesprächsverlauf ist ungültig und jeder Wiederholungsversuch scheitert auf dieselbe Weise. /rewind bis vor den Gesprächsschritt oder /clear; siehe die [Anleitung zu 400](/de/claude-code/errors/api-error-400/). - **Cloud- / geplante Ausführungen bleiben bei *Cloud-Container wird eingerichtet* hängen** ([#53691](https://github.com/anthropics/claude-code/issues/53691), [#54528](https://github.com/anthropics/claude-code/issues/54528)) — liegt auf Dienstseite; lokal lässt sich nichts beheben, brechen Sie ab und prüfen Sie status.claude.com. - Das Fortsetzen großer Sitzungen dauert Minuten — das Protokoll wird beim Start erneut abgespielt. Setzen Sie gezielt die benötigte Sitzung fort (claude -r) statt der größten und lassen Sie die Komprimierung riesige Sitzungen verkleinern. ## Hängt beim Start Ein leerer Bildschirm direkt nach claude ohne Eingabeaufforderung bedeutet meist, dass der erste API-Aufruf keine Antwort liefert: eine Proxy-Variable, die auf einen nicht erreichbaren Proxy verweist, ein VPN, DNS oder ein nicht erreichbarer ANTHROPIC_BASE_URL. Führen Sie den curl-Test aus der [Anleitung zu Verbindungsfehlern](/de/claude-code/errors/connection-lost/)aus, dann claude doctor. Wenn der Start langsam ist, aber schließlich eine Eingabeaufforderung erscheint, werden MCP-Server gestartet; claude mcp list und entfernen Sie diejenigen, bei denen das Zeitlimit überschritten wird. ## Kindprozesse, die nie beendet werden Ein Shell-Tool, das einen Editor öffnet, auf ein Passwort wartet, ein Protokoll fortlaufend verfolgt oder einen Entwicklungsserver startet, kehrt nie zurück, und der Gesprächsschritt wartet darauf. Weisen Sie den Agenten an, Server im Hintergrund auszuführen und --no-pager, -y oder < /dev/null hinzuzufügen, wenn ein Befehl möglicherweise eine Eingabe anfordert. Wenn es bereits passiert ist, Esc bricht das Tool ab; ignoriert der Kindprozess dies, beenden Sie ihn anhand seiner PID von einem anderen Terminal aus, und der Gesprächsschritt wird mit der Fehlermeldung fortgesetzt. ## Hohe Arbeitsspeicher- und CPU-Auslastung - Tool-Ergebnisse werden für die Sitzung im Arbeitsspeicher und auf der Festplatte gespeichert; das Lesen einer 200-MB-Datei ergibt eine 200-MB-Sitzung. Lesen Sie nur die benötigten Teile. - Viele parallele Subagenten vervielfachen alles; CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY=2 auf Rechnern mit wenig Ressourcen. - Terminalemulatoren mit langsamer Darstellung (einige Windows-Konsolen, entferntes tmux über eine schwache Verbindung) lassen Streaming-Ausgaben eingefroren wirken; claude --debug zeigt, ob weiterhin Tokens eintreffen. - Wenn der Arbeitsspeicherverbrauch im Leerlauf steigt, suchen Sie nach übrig gebliebenen claude Prozessen aus abgestürzten IDE-Sitzungen und beenden Sie sie ([Prozess mit Code 1 beendet](/de/claude-code/errors/process-exited-code-1/) behandelt den Fall verwaister Prozesse unter Windows). ## Wenn es an der API liegt, nicht am Client Eine Sitzung, die bei jedem Gesprächsschritt an derselben Stelle hängen bleibt, mit einem kleinen Aktivitätsindikator und einer später erscheinenden Wiederholungsmeldung, deutet auf einen langsamen oder abbrechenden API-Verbindungsweg statt auf einen Client-Fehler hin: [529 überlastet](/de/claude-code/errors/overloaded-529/), [serverseitige Drosselung](/de/claude-code/errors/usage-limit-reached/) oder eine zurückgesetzte Verbindung. Über ein Gateway (ANTHROPIC_BASE_URL=https://aiprimetech.io) wird bei einem ausgelasteten Upstream-Konto auf ein anderes umgeschaltet, was genau diese Wartezeiten verkürzt. ## Müde vom ständigen Kampf mit diesem Problem? Nutzen Sie Claude Code stattdessen über das Gateway von AI Prime Tech: dieselben Claude-Modelle auf den eigenen Upstream-Konten des Gateways, zwei Umgebungsvariablen für den Wechsel, und neue Konten erhalten $5 kostenloses API-Guthaben mit dem Code FIXIT — ohne Kreditkarte. ``` export ANTHROPIC_BASE_URL=https://aiprimetech.io export ANTHROPIC_API_KEY=your_key ``` [Konto mit dem Code FIXIT erstellen](/register?promo=FIXIT) ## Häufig gestellte Fragen Warum hängt Claude Code und reagiert nicht? Es wartet auf etwas: einen API-Stream, ein gestartetes Tool, einen MCP-Server oder eine Freigabeaufforderung außerhalb des sichtbaren Bereichs. Drücken Sie Esc, um das Tool abzubrechen, und zweimal Ctrl+C, um den Vorgang abzubrechen; wenn nichts reagiert, beenden Sie den Prozess und setzen Sie die Sitzung mit claude -c fort.Wie behebe ich das Hängen von Claude Code bei /rewind? Aktualisieren Sie auf einen aktuellen Build; das Hängen wurde für 2.1.1xx gemeldet, und Anthropic konnte es auf 2.1.233 nicht reproduzieren. Beenden Sie bei einem alten Build den Prozess und verwenden Sie claude -c statt /rewind.Warum verbraucht Claude Code so viel Arbeitsspeicher? Große Tool-Ergebnisse und Sitzungsprotokolle werden vollständig gespeichert, Subagenten vervielfachen sie, und bei nativen Builds läuft ein grep-Ausdruck mit Backtracking innerhalb eines claude-Prozesses mit großem V8-Heap. Lesen Sie weniger, schließen Sie Build-Ausgaben aus und reduzieren Sie die Parallelität.Claude Code hängt beim Start ohne Eingabeaufforderung. Was soll ich prüfen? Die erste API-Anfrage liefert keine Antwort: Proxy-Variablen, VPN, DNS oder ein nicht erreichbarer ANTHROPIC_BASE_URL. Führen Sie einen curl-Aufruf gegen den Endpunkt aus, dann claude doctor, und entfernen Sie MCP-Server, bei denen das Zeitlimit überschritten wird. ## Claude Code über das Gateway nutzen Dieselben Modelle, zwei Umgebungsvariablen, Guthaben zum 7.69231-Fachen des Nennwerts — oder ein unbegrenzter Pauschaltarif. Neue Konten: $5 kostenloses API-Guthaben mit dem Code FIXIT.[API-Schlüssel erhalten](/register?promo=FIXIT) [Unbegrenzte Tarife ansehen](/de/plans/) AI Prime Tech ist ein unabhängiges API-Gateway und ist weder mit Anthropic verbunden noch wird es von Anthropic unterstützt oder gesponsert. „Claude“ und „Claude Code“ sind Marken von Anthropic. Die hier beschriebenen Funktionen von Claude Code entsprechen der öffentlichen Dokumentation von Anthropic zum Zeitpunkt der Erstellung und ändern sich häufig; Preise und Modelllisten auf dieser Seite werden aus den aktuellen Einstellungen dieses Gateways ausgelesen. ## Weitere Leitfäden zu Claude Code [Fehler in Claude Code und wie Sie sie beheben](/de/claude-code/errors/)[Claude Code „API-Fehler: 500“: Was er bedeutet und was wirklich hilft](/de/claude-code/errors/api-error-500/)[Claude-Fehler „Überlastet“ (API-Fehler 529): Was er bedeutet und was Sie tun können](/de/claude-code/errors/overloaded-529/)[Claude Code API-Fehler 400: Prompt zu lang, gleichzeitige Tool-Nutzung und weitere Ursachen](/de/claude-code/errors/api-error-400/)[Claude Code OAuth-Fehler: Zeitüberschreitung von 15000ms und Statuscode 500](/de/claude-code/errors/oauth-error/)[„Claude Code-Prozess mit Code 1 beendet“: So finden und beheben Sie den eigentlichen Fehler](/de/claude-code/errors/process-exited-code-1/)[Claude „Prompt ist zu lang“, „Eingabe ist für das angeforderte Modell zu lang“ und „Kontextlimit erreicht“: Was das Fenster füllt und wie Sie wieder Platz schaffen](/de/claude-code/errors/prompt-too-long/)[Claude-Nutzungslimit erreicht: Sitzungs-, Wochen- und Opus-Limits, „festgelegte API-Nutzungslimits“, „Guthaben ist zu niedrig“ — und was Sie tun können](/de/claude-code/errors/usage-limit-reached/)[Claude Code 401 und 403: ungültige Authentifizierungsdaten, ungültiger API-Schlüssel, „Nicht angemeldet“, host_not_allowed](/de/claude-code/errors/auth-401-403/)[Claude Code-Verbindungsfehler: ECONNRESET, Verbindung während der Antwort unterbrochen, „Warten auf API-Antwort“, „Verbindung zur API nicht möglich“, SSL-Zertifikatfehler](/de/claude-code/errors/connection-lost/)[Claude.ai funktioniert nicht: „Etwas ist schiefgelaufen“, Kapazitätsengpässe, „5-Stunden-Limit erreicht“, „Fehler bei der Anmeldung“ und weitere Probleme](/de/claude-code/errors/claude-ai-not-working/)