Fehlerbehebung

Diese Seite behandelt Leistungs-, Stabilitäts- und Suchprobleme, sobald Claude Code läuft. Für andere Probleme beginnen Sie mit der Seite, die zu Ihrer Situation passt: Wenn Sie sich nicht sicher sind, welcher Fall zutrifft, führen Sie /doctor in Claude Code aus, um eine automatisierte Überprüfung Ihrer Installation, Einstellungen, Erweiterungen und Kontextnutzung durchzuführen; es schlägt Korrektionen vor, die es nach Ihrer Bestätigung anwenden kann. Wenn claude überhaupt nicht startet, führen Sie stattdessen claude doctor aus Ihrer Shell aus. Führen Sie /mcp aus, um den MCP-Server-Status zu überprüfen.

​

Leistung und Stabilität

Diese Abschnitte behandeln Probleme im Zusammenhang mit Ressourcennutzung, Reaktionsfähigkeit und Suchverhalten.

​

Hohe CPU- oder Speichernutzung

Claude Code ist für die Zusammenarbeit mit den meisten Entwicklungsumgebungen konzipiert, kann aber bei der Verarbeitung großer Codebases erhebliche Ressourcen verbrauchen. Wenn Sie Leistungsprobleme haben:

1. Verwenden Sie /compact regelmäßig, um die Kontextgröße zu reduzieren
2. Schließen und starten Sie Claude Code zwischen großen Aufgaben neu
3. Erwägen Sie, große Build-Verzeichnisse zu Ihrer .gitignore-Datei hinzuzufügen
4. Starten Sie mit claude --safe-mode neu, um zu überprüfen, ob ein Plugin, MCP-Server oder Hook die Quelle ist. Dies deaktiviert alle Anpassungen für die Sitzung; wenn die Nutzung sinkt, siehe Konfiguration debuggen, um herauszufinden, welche

Wenn die Speichernutzung nach diesen Schritten hoch bleibt, führen Sie /heapdump aus, um einen JavaScript-Heap-Snapshot und eine Speicheraufschlüsselung auf ~/Desktop zu schreiben. Auf Linux ohne Desktop-Ordner werden die Dateien in Ihr Home-Verzeichnis geschrieben. Die Aufschlüsselung zeigt die Resident Set Size, JS Heap, Array Buffer und nicht berechneten nativen Speicher, was hilft zu identifizieren, ob das Wachstum in JavaScript-Objekten oder in nativem Code liegt. Um Retainer zu überprüfen, öffnen Sie die .heapsnapshot-Datei in Chrome DevTools unter Memory → Load; die Aufschlüsselung ist die Datei, die auf -diagnostics.json endet.

​

Große Tabellen werden im Terminal abgeschnitten

Eine Markdown-Tabelle mit mehr als 200 Zeilen rendert ihre ersten 200 Zeilen gefolgt von einer … N more rows not shown-Zeile. Nur die Anzeige ist begrenzt: Die vollständige Tabelle bleibt in der Konversation, und /copy kopiert jede Zeile. Für eine Tabelle, die zu groß ist, um sie im Terminal zu lesen, bitten Sie Claude, sie stattdessen in eine Datei zu schreiben. Vor v2.1.208 renderte Claude Code jede Zeile, daher konnte das Fortsetzen einer Sitzung, die eine sehr große Tabelle enthielt, beim erneuten Rendern steckenbleiben.

​

Auto-Kompaktierung stoppt mit einem Thrashing-Fehler

Wenn Sie Autocompact is thrashing: the context refilled to the limit... sehen, war die automatische Kompaktierung erfolgreich, aber eine Datei oder ein Tool-Output hat das Kontextfenster sofort mehrmals hintereinander gefüllt. Claude Code stoppt die Wiederholung, um zu vermeiden, dass API-Aufrufe auf einer Schleife verschwendet werden, die keinen Fortschritt macht. Um sich zu erholen:

1. Bitten Sie Claude, die übergroße Datei in kleineren Chunks zu lesen, z. B. einen bestimmten Zeilenbereich oder eine Funktion, statt der ganzen Datei
2. Führen Sie /compact mit einem Fokus aus, der die große Ausgabe löscht, z. B. /compact keep only the plan and the diff
3. Verschieben Sie die Arbeit mit großen Dateien zu einem Subagenten, damit er in einem separaten Kontextfenster ausgeführt wird
4. Führen Sie /clear aus, wenn das frühere Gespräch nicht mehr benötigt wird

​

Befehl hängt oder friert ein

Wenn Claude Code nicht reagiert:

1. Drücken Sie Strg+C, um zu versuchen, den aktuellen Vorgang abzubrechen
2. Wenn nicht reagiert, müssen Sie möglicherweise das Terminal schließen und neu starten

Das Neustarten verliert Ihre Konversation nicht. Führen Sie claude --resume im selben Verzeichnis aus, um die Sitzung fortzusetzen.

​

Verzerrter oder beschädigter Text im integrierten Terminal eines Editors

Wenn Zeichen als Kästchen, Verschmierungen oder falsche Glyphen angezeigt werden, wenn Sie Claude Code im integrierten Terminal von VS Code, Cursor oder Devin Desktop ausführen, ist der GPU-Renderer des Terminals wahrscheinlich die Ursache. Führen Sie /terminal-setup in Claude Code aus, um terminal.integrated.gpuAcceleration auf "off" zu setzen, oder setzen Sie es manuell in Ihren Editor-Einstellungen und laden Sie das Fenster neu. Siehe Terminalkonfiguration für die anderen Einstellungen, die /terminal-setup schreibt.

​

Such- und Erkennungsprobleme

Wenn das Such-Tool, @file-Erwähnungen, benutzerdefinierte Agenten oder benutzerdefinierte Skills Dateien nicht finden, kann die gebündelte ripgrep-Binärdatei auf Ihrem System möglicherweise nicht ausgeführt werden. Installieren Sie das ripgrep-Paket Ihrer Plattform und teilen Sie Claude Code mit, es stattdessen zu verwenden: