Wird geladen
Wird geladen

Hooks

ZusammenfassungTranskript

Mit Hooks kannst du Befehle an bestimmten Punkten im Lebenszyklus von Claude Code ausführen. Der entscheidende Unterschied zwischen Hooks und allem anderen, was in diesem Kurs behandelt wird, besteht darin, dass Hooks deterministisch sind — sie laufen immer.

Warum Hooks verwenden

Du kannst Claude in deiner CLAUDE.md anweisen, nach jeder Dateibearbeitung Prettier auszuführen. Meistens wird es das auch tun. Aber manchmal eben nicht. Ein Hook sorgt dafür, dass es wirklich jedes Mal passiert, ohne Ausnahme.

Typische Anwendungsfälle sind:

  • Automatische Formatierung nach Dateibearbeitungen
  • Protokollierung aller ausgeführten Befehle für Compliance-Zwecke
  • Blockieren gefährlicher Operationen wie das Bearbeiten von Produktionsdateien
  • Versenden von Benachrichtigungen an dich selbst, wenn Claude eine Aufgabe abschließt

Wie sie funktionieren

Hooks werden in deiner settings.json konfiguriert. Du wählst ein Ereignis aus, legst optional einen Matcher fest, auf welche Tools es zutrifft, und gibst einen auszuführenden Befehl an. Einige der gängigsten Ereignisse sind:

  • PreToolUse — läuft vor einem Tool-Aufruf
  • PostToolUse — läuft, nachdem ein Tool-Aufruf abgeschlossen ist
  • UserPromptSubmit — läuft, wenn du einen Prompt absendest, bevor Claude ihn verarbeitet
  • Stop — läuft, wenn Claude mit der Antwort fertig ist
  • Notification — läuft, wenn Claude eine Benachrichtigung sendet

Das sind nur einige der Ereignisse, in die du dich einklinken kannst — Claude Code unterstützt noch viele weitere. Die vollständige Liste findest du in der Hooks-Referenz.

Du konfigurierst sie, indem du settings.json direkt bearbeitest. Der Befehl /hooks innerhalb von Claude Code öffnet eine schreibgeschützte Liste deiner konfigurierten Hooks, sodass du überprüfen kannst, ob ein neuer Hook auch tatsächlich erscheint.

Die Datei settings.json im Verzeichnis .claude mit der Hooks-Konfiguration

Ein praktisches Beispiel

Der häufigste Hook: automatische Formatierung nach Bearbeitungen. Richte einen PostToolUse-Hook mit einem Matcher von "Edit|Write" ein, sodass er ausgelöst wird, nachdem Claude das Edit- oder Write-Tool verwendet hat. Der Befehl führt den Formatter aus, den dein Projekt verwendet. Für Prettier fügst du Folgendes zu .claude/settings.json hinzu (dafür wird jq benötigt):

json
{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "file=$(jq -r '.tool_input.file_path') && npx prettier --write -- \"$file\""
          }
        ]
      }
    ]
  }
}

Um es zu testen, bitte Claude, eine Datei zu bearbeiten, und überprüfe anschließend, ob die Datei neu formatiert wurde.

Blockieren mit PreToolUse

PreToolUse-Hooks können Tool-Aufrufe blockieren, bevor sie ausgeführt werden. Dein Hook erhält den Tool-Namen und die Eingabe als JSON über stdin. Der Exit-Code bestimmt das Verhalten:

  • Exit-Code 0 — normal fortfahren.
  • Exit-Code 2 — die Aktion blockieren. Die stderr-Meldung wird an Claude als Feedback zurückgegeben, damit es weiß, warum es blockiert wurde, und sich entsprechend anpassen kann.
  • Jeder andere Exit-Code — ein nicht blockierender Fehler, der dir angezeigt wird, aber nichts aufhält.

So setzt du feste Regeln durch. Blockiere Schreibzugriffe auf ein Produktions-Konfigurationsverzeichnis. Blockiere Bash-Befehle, die rm -rf enthalten. Blockiere Commits auf main. Was auch immer dein Team als garantiert benötigt, nicht nur als Vorschlag.

Eine settings.json-Datei mit PreToolUse- und PostToolUse-Hooks samt Matchern und Befehlen

Hooks mit deinem Team teilen

Hooks, die in .claude/settings.json konfiguriert sind, gelten auf Projektebene und können in dein Repo eingecheckt werden. Das bedeutet, dein gesamtes Team erhält automatisch dieselben Hooks. Verwende die Umgebungsvariable CLAUDE_PROJECT_DIR in deinen Befehlen, um auf Skripte zu verweisen, die in deinem Projekt gespeichert sind, damit sie unabhängig vom aktuellen Arbeitsverzeichnis von Claude funktionieren.

Zusammenfassung

Hooks geben dir deterministische Kontrolle über das Verhalten von Claude Code. Verwende PostToolUse für automatische Formatierung und Protokollierung. Verwende PreToolUse, um gefährliche Operationen zu blockieren. Konfiguriere sie in settings.json und zeige sie mit /hooks an. Und checke sie in dein Repo ein, damit auch dein Team sie erhält.

Wenn etwas jedes Mal ohne Ausnahme passieren muss, schreib es nicht in einen Prompt. Schreib es in einen Hook.