Hooks in Claude Code

Schlüsselkonzepte

Was sind Hooks?

• Deterministische Ausführung: Hooks werden immer ausgeführt, im Gegensatz zu Prompt-Anweisungen, die möglicherweise nicht ausgeführt werden
• Führen Befehle an bestimmten Punkten im Lebenszyklus von Claude aus

Hook-Ereignisse

• Benutzer-Prompt absenden: Wird ausgeführt, wenn Sie einen Prompt absenden (bevor Claude ihn verarbeitet)
• Pre-Tool-Nutzung: Wird ausgeführt, bevor ein Tool-Aufruf ausgeführt wird
• Post-Tool-Nutzung: Wird ausgeführt, nachdem ein Tool-Aufruf abgeschlossen ist
• Benachrichtigung: Wird ausgeführt, wenn Claude eine Benachrichtigung sendet
• Stopp: Wird ausgeführt, wenn Claude die Antwort beendet

Häufige Anwendungsfälle

• Automatische Formatierung von Dateien nach Bearbeitungen
• Protokollierung ausgeführter Befehle für Compliance
• Blockierung gefährlicher Operationen (z. B. Änderung von Produktionsdateien)
• Senden von Benachrichtigungen nach Abschluss von Aufgaben

Konfiguration

• Konfiguriert in settings. json Datei
• Angeben: Ereignistyp, optionaler Matcher (welche Tools gelten) und auszuführender Befehl
• Hooks auf Projektebene können in Ihr Repository eingecheckt werden, um teamweite Konsistenz zu gewährleisten

Pre-Tool-Use Hooks (Blockierung von Operationen)

• Erhalten Tool-Namen und Input als JSON auf stdin
• Exit-Code 0 = fortfahren
• Exit-Code 2 = Aktion blockieren
• Fehlermeldung wird an Claude als Feedback gesendet, das erklärt, warum sie blockiert wurde

Best Practices

• Verwenden Sie Post-Tool-Use für automatische Formatierung und Protokollierung
• Verwenden Sie Pre-Tool-Use, um strikte Regeln durchzusetzen und gefährliche Operationen zu blockieren
• Verwenden Sie CLAUDE_PROJECT_DIR Umgebungsvariable in Befehlen, um auf Projektskripte zu verweisen
• Wenn etwas unbedingt jedes Mal ohne Fehler passieren muss, verwenden Sie einen Hook statt eines Prompts

Wichtigste Erkenntnisse

• Hooks garantieren Ausführung an bestimmten Lebenszykluspunkten, im Gegensatz zu Prompt-Anweisungen, die übersprungen werden können – verwenden Sie sie, wenn etwas immer passieren muss

• Pre-Tool-Use Hooks können Operationen blockieren, indem sie Exit-Code 2 zurückgeben, was sie ideal für die Durchsetzung von Sicherheitsregeln macht (z. B. Verhinderung von Änderungen an Produktionsdateien)

• Post-Tool-Use Hooks sind für Automatisierung: automatische Formatierung, Protokollierung und Benachrichtigungen, die nach Abschluss der Tool-Ausführung ausgeführt werden sollten

• **Konfigurieren Sie Hooks in settings. json** mit Ereignistyp, optionalem Tool-Matcher und Befehl; Hooks auf Projektebene können versionskontrolliert werden, um Teamkonsistenz zu gewährleisten

• Verwenden Sie Exit-Codes strategisch: Exit 0 zum Fortfahren, Exit 2 zum Blockieren, mit Fehlermeldungen an Claude, die die Ablehnung erklären