Hooks: Gestalten Sie Ihren eigenen Workflow

Was sind Claude Code Hooks?

Hooks sind das Ereignissystem von Claude Code, mit dem Sie eigene Shell-Skripte vor und nach Tool-Aufrufen ausführen können. Automatisch Linter nach dem Speichern von Dateien ausführen, Tests vor Commits durchlaufen oder Warnungen bei Zugriff auf sensible Dateien auslösen — ganz ohne manuelles Eingreifen.

Die Konfiguration verschachtelt drei Ebenen: das Event, ein Matcher, der Tools filtert, und Ihr Skript im inneren hooks-Array. Das Skript liest das JSON dieses Events von stdin und antwortet mit Exit-Codes: 0 bedeutet kein Einspruch, 2 blockiert den Aufruf bei Events, die dies erlauben. Bei den vier untenstehenden Events wird ein Command-Hook bei seinem Standardwert von 600 Sekunden abgebrochen; diese vier sind die gängigen, nicht die vollständige offizielle Liste (geprüft 2026-09-22).

Drei praktische Automatisierungsfälle

Die drei nachstehenden Fälle teilen eine Struktur: wählen Sie das Event, grenzen Sie es mit einem Matcher ein und setzen Sie das Skript in das innere hooks-Array. Die Snippets zeigen nur die Absicht – betrachten Sie die offizielle Referenz als Quelle für Feldnamen und Verschachtelung, und lesen Sie alles, was Ihr Skript prüfen muss, aus diesem JSON auf stdin.

{
  "hooks": {
    "PreToolUse": [{
      "matcher": "Bash",
      "command": "if echo \"$TOOL_INPUT\" | grep -q 'git commit'; then npm run format; fi"
    }]
  }
}

{
  "hooks": {
    "PostToolUse": [{
      "matcher": "Bash",
      "command": "if echo \"$TOOL_INPUT\" | grep -q 'pytest\\|npm test'; then notify-send 'Tests completed'; fi"
    }]
  }
}

{
  "hooks": {
    "PreToolUse": [{
      "matcher": "Edit|Write",
      "command": "if echo \"$TOOL_INPUT\" | grep -qE '\\.env|credentials|secrets'; then exit 2; fi"
    }]
  }
}

settings.json-Konfiguration

Definieren Sie Ihre Hooks in .claude/settings.json

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "command": "~/scripts/pre-bash-hook.sh"
      },
      {
        "matcher": "Edit|Write",
        "command": "~/scripts/protect-sensitive-files.sh"
      }
    ],
    "PostToolUse": [
      {
        "matcher": "Bash",
        "command": "~/scripts/post-bash-hook.sh"
      }
    ],
    "Notification": [
      {
        "command": "~/scripts/send-notification.sh"
      }
    ],
    "Stop": [
      {
        "command": "~/scripts/on-stop.sh"
      }
    ]
  }
}

Häufig gestellte Fragen