Führt Shell-Befehle automatisch bei Claude-Code-Events aus.

Was ist das

Hooks sind Shell-Befehle die Claude Code bei bestimmten Events automatisch ausführt — PreToolUse, PostToolUse, SessionStart, UserPromptSubmit und mehr. Einmal konfiguriert laufen sie im Hintergrund, ohne dass Claude dran denken muss. Perfekt für Linter, Tests, Notifications, Backups.

Installation / Aktivierung

Hooks werden in settings.json konfiguriert — NICHT in CLAUDE.md. CLAUDE.md enthält nur Regeln, Hooks sind echte Harness-Konfig.

Option 1 — Terminal:

# Globale Hooks
nano ~/.claude/settings.json

# Projekt-Hooks
nano .claude/settings.json

Beispiel settings.json:

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          { "type": "command", "command": "npm run lint --silent" }
        ]
      }
    ]
  }
}

Option 2 — Prompt an Claude Code:

Konfiguriere mir einen Hook: nach jedem Edit/Write auf .ts oder .tsx Dateien soll "npm run lint" laufen. Schreib das direkt in ~/.claude/settings.json (oder ergänze die bestehende Datei sauber). Erklär mir danach wie ich das teste.

Das update-config Skill von Anthropic hilft beim Hook-Setup — der Harness führt Hooks aus, nicht Claude selbst.

Event-Typen (Auswahl)

• PreToolUse — Vor jedem Tool-Call (Bash, Edit, Write…)
• PostToolUse — Nach Tool-Call
• SessionStart — Beim Start einer Claude-Code-Session
• UserPromptSubmit — Wenn du einen Prompt absendest
• Stop — Wenn Claude einen Turn beendet

Use-Cases

• Auto-Lint nach Edit — PostToolUse-Hook auf Edit/Write, führt Linter für die geänderte Datei.
• Tests bei File-Save — Nach Änderungen an src/**/*.test.ts direkt Tests laufen lassen.
• Session-Start-Check — Beim Start: prüfen ob dev-server läuft, git-status zeigen, letzten Commit anzeigen.
• Commit-Schutz — PreToolUse auf Bash-Call mit git commit: Linter/Tests erzwingen vorher.
• Telegram-Notification — PostToolUse: bei Deploy-Befehl Nachricht ans Handy senden.

Pro-Tipp

Hooks können Tool-Calls blocken (non-zero Exit → Call abgelehnt). Nutz das gezielt: pre-commit Hook der bei roten Tests den Commit verweigert ist Gold wert. Aber: zu aggressive Hooks nerven — wenn der Linter bei jedem Edit 5 Sekunden blockiert, hasst du dein Setup nach einem Tag.

🚀 In der Community bauen wir zusammen komplette Automatisierungs-Systeme und echte Workflows für deinen Alltag. → Zur Claude Code Mastery Community

Wird regelmäßig erweitert — folge @laurinbuilds für Updates.