Claude Code Hooks Mastery

Das Referenz-Repo zum Hook-System: lauffähige Beispiele für alle Hook-Events (PreToolUse, PostToolUse, Stop, SubagentStop, Notification, UserPromptSubmit u. a.), deterministische Kontrolle über Claude (Blockieren gefährlicher Befehle, Logging, TTS-Benachrichtigungen), dazu Beispiel-Subagenten und Output-Styles.

Für wen: Alle, die Claude Code per Hooks absichern, auditieren oder automatisieren wollen — vom ersten Hook bis zu fortgeschrittenen Setups.

Im Detail

Dieses Repo ist die praktische Referenz für das Hook-System von Claude Code: lauffähige Beispiele für jedes Hook-Event (PreToolUse, PostToolUse, Stop, SubagentStop, Notification, UserPromptSubmit u. a.). Der Mehrwert gegenüber der offiziellen Doku liegt im direkt kopierbaren Code für konkrete Anwendungsfälle wie das Blockieren gefährlicher Befehle, Logging oder TTS-Benachrichtigungen. Enthält zusätzlich Beispiel-Subagenten und Output-Styles als Bonus. Lohnt sich für alle, die Claude Code deterministisch absichern oder automatisieren wollen. Einsteiger sollten erst die Awesome-Liste für den Überblick nutzen, bevor sie hier in die Tiefe gehen.

Voraussetzungen

• Laufende Claude-Code-Installation
• Grundverständnis des Hook-Systems (Einsteiger sollten vorher die Awesome-Liste zum Überblick nutzen)

Schritt für Schritt

1. Passendes Hook-Event für den eigenen Zweck auswählen, etwa PreToolUse zum Blockieren gefährlicher Befehle oder PostToolUse fürs Logging
2. Beispielcode für dieses Event in die eigene Claude-Code-Konfiguration übernehmen und an eigene Kommandos oder Pfade anpassen
3. Hook mit einem harmlosen Testfall auslösen und prüfen, ob er wie erwartet blockiert, loggt oder benachrichtigt
4. Bei Bedarf mehrere Hooks kombinieren, etwa Logging zusammen mit TTS-Benachrichtigung, und auf Konflikte prüfen
5. Beispiel-Subagenten oder Output-Styles aus dem Repo ergänzend einsetzen, falls passend

Beispiel aus der Praxis

Jemand richtet einen PreToolUse-Hook ein, der Befehle wie rm -rf blockiert, und ergänzt einen Stop-Hook, der per TTS meldet, sobald Claude eine Aufgabe abgeschlossen hat.

Praxis-Tipp

Kopiere das PreToolUse-Beispiel und passe die Blockierliste an, um z. B. “rm -rf” oder Produktions-Deploys aus deinem eigenen Setup zu verbieten.

Stolperfallen

Hooks zu breit fassen, etwa alle Bash-Befehle blockieren, und dadurch legitime Arbeit behindern. Ungetestete Hooks direkt in produktiven Projekten aktivieren statt vorher mit einem harmlosen Testfall zu prüfen, dass sie korrekt greifen.

Siehe auch

• Awesome Claude Code
• Claude Command Suite

Lizenz & Quelle

• Lizenz: nur Link
• Quelle: disler/claude-code-hooks-mastery