Befehls-Referenz · Claude Code
/debug
Aktiviert Debug-Logging für die aktuelle Session und hilft bei der Fehlersuche über das Session-Debug-Log.
/debug [Beschreibung] ist ein gebündelter Skill, der Debug-Logging für die aktuelle Session aktiviert und anschließend beim Auswerten des Session-Debug-Logs hilft, um die Ursache eines Problems zu finden. Debug-Logging ist standardmäßig ausgeschaltet, außer die Session wurde mit claude --debug gestartet; wird /debug erst mitten in der Session aufgerufen, werden Logs erst ab diesem Zeitpunkt mitgeschrieben — frühere Ereignisse fehlen dann im Log. Optional lässt sich eine Problembeschreibung anhängen, um die anschließende Analyse zu fokussieren, etwa auf einen bestimmten MCP-Server, einen einzelnen Tool-Aufruf oder ein Hook-Problem.
/debug unterscheidet sich von verwandten Diagnose-Befehlen: /doctor prüft Installation, Konfiguration und Setup umfassend und kann gefundene Probleme teils selbst beheben, /heapdump schreibt bei hohem Speicherverbrauch einen JavaScript-Heap-Snapshot samt Speicher-Aufschlüsselung nach ~/Desktop. /debug ist dagegen speziell für das Nachvollziehen von Laufzeitproblemen innerhalb einer laufenden Session gedacht, etwa Verbindungsabbrüche zu MCP-Servern oder unerwartetes Tool-Verhalten, das sich sonst schwer reproduzieren lässt.
✅ WANN EINSETZEN?
Bei einem reproduzierbaren Problem ab sofort mitschreiben lassen
/debug MCP server keeps disconnecting — direkt bevor man das Problem erneut auslöst.
Vor einer schwer nachvollziehbaren Fehlersuche systematisch Logging aktivieren
/debug aufrufen, um Tool-Aufrufe und Fehler im Session-Debug-Log zu erfassen, bevor der nächste Schritt ausprobiert wird.
⛔ WANN EHER NICHT?
Der Fehler ist bereits vorher aufgetreten
/debug erfasst Logs erst ab dem Aktivierungszeitpunkt, frühere Ereignisse fehlen im Log.
Besser: Session neu mit claude --debug starten, um von Anfang an zu loggen.
Installationsprobleme oder Setup-Fehler diagnostizieren
/debug befasst sich mit dem Laufzeitverhalten der aktuellen Session, nicht mit Installation, PATH-Problemen oder fehlerhaften Settings-Dateien.
Besser: /doctor nutzen, das eine Setup-Checkup durchführt und Probleme teils automatisch behebt.
QUELLEN
- Claude Code Doku (offiziell) ↗ code.claude.com