Befehls-Referenz · Claude Code
/hooks
Zeigt Hook-Konfigurationen für Tool-Events.
/hooks öffnet einen rein lesenden Browser für alle aktuell konfigurierten Hooks - automatisierte Shell-Befehle, HTTP-Aufrufe, Prompts, Agents oder MCP-Tool-Aufrufe, die zu bestimmten Zeitpunkten im Ablauf von Claude Code greifen, etwa vor oder nach einem Tool-Aufruf. Das Menü listet jedes Hook-Event mit der Anzahl konfigurierter Hooks auf, erlaubt das Aufklappen einzelner Matcher und zeigt zu jedem Hook die vollständigen Details: Event, Matcher, Typ und den genauen Befehl, Prompt-Text oder die URL.
Jeder Eintrag ist zusätzlich mit seiner Quelle markiert: User (aus ~/.claude/settings.json), Project (.claude/settings.json), Local (.claude/settings.local.json), Plugin (aus einem installierten Plugin), Session (nur für die laufende Session registriert) oder Built-in (intern von Claude Code).
Der Befehl nimmt kein Argument entgegen und verändert nichts - er dient ausschließlich der Übersicht, etwa um zu prüfen, warum ein Tool-Aufruf blockiert oder verändert wurde.
✅ WANN EINSETZEN?
Vor dem Hinzufügen eines neuen Hooks bestehende Konfiguration prüfen
/hooks aufrufen, um zu sehen, ob für PreToolUse bereits ein Matcher auf Bash-Befehle greift
Nachvollziehen, aus welcher Einstellungsdatei ein Hook stammt
/hooks öffnen und die Quelle-Markierung (User/Project/Local/Plugin) prüfen, wenn ein Hook aus einem installierten Plugin kommt
⛔ WANN EHER NICHT?
Hook-Regeln bearbeiten oder neu konfigurieren
/hooks ist laut Doku ein reiner Read-only-Browser, keine Bearbeitungsoberfläche
Besser: die Konfiguration direkt in settings.json anpassen (lassen) oder den update-config-Skill nutzen
Herausfinden, warum ein konfigurierter Hook zur Laufzeit fehlschlägt
/hooks zeigt nur die Konfiguration (Event, Matcher, Befehl), keine Laufzeit-Fehler - die landen laut Doku im Debug-Log
Besser: /debug nutzen, um das Session-Debug-Log mit den Hook-Fehlermeldungen einzusehen
QUELLEN
- Claude Code Doku (offiziell) ↗ code.claude.com
WEITERE BEFEHLE · Claude Code