Hooks

Ein Hook ist ein Befehl, ein Skript oder eine Prüfung, die der Agent-Harness automatisch ausführt, sobald in einer Sitzung ein bestimmtes Ereignis eintritt. In Claude Code gehören dazu:

• PreToolUse vor und PostToolUse nach jedem Tool Call
• UserPromptSubmit beim Eingang eines Prompts
• Stop, wenn der Agent fertig ist
• SessionStart und SessionEnd

Ein Hook kann die Aktion durchlassen, sie blockieren oder dem Agent zusätzlichen Kontext geben.

Warum ein Hook statt einer Instruktion?

Eine Instruktion in CLAUDE.md ist ein Rat, den das Modell abwägt. Ein Hook läuft jedes Mal. Anthropics eigene Empfehlung zieht dieselbe Grenze und empfiehlt Hooks für Aktionen, die ausnahmslos passieren müssen. Prüfungen, die nicht davon abhängen dürfen, dass der Agent an sie denkt, gehören deshalb in Hooks.

Wofür nutzen Teams Hooks?

Kontrolle, Feedback und Protokoll. Ein PreToolUse-Hook blockiert einen gefährlichen Shell-Befehl, bevor er läuft. Ein PostToolUse-Hook startet nach jeder Änderung den Typechecker und meldet die Fehler zurück, sodass der Agent sie sofort behebt. Ein Stop-Hook kann das Transkript archivieren oder das Ende eines Turns verhindern, bis eine Prüfung besteht. Hooks laufen im Harness und sind deshalb allein keine Sicherheitsgrenze. Die Isolation der Umgebung, in der der Agent läuft, bleibt wichtig.

Verwandte Seiten

• Quality Gates: die Prüfungen, die Hooks an Ereignisse binden.
• Sicherheit und Runtime-Isolation: die Grenze, die ein Hook nicht ersetzt.
• Agent-Instruktionen (CLAUDE.md, AGENTS.md): die beratende Ebene, die Hooks ergänzen.

Quellen

Artikel

• Best practices for Claude Code (öffnet in einem neuen Tab) - Artikel von Anthropic Engineering über die Arbeit mit Claude Code. Er empfiehlt Hooks für Aktionen, die ausnahmslos passieren müssen.

Dokumentation

• Hooks reference (öffnet in einem neuen Tab) - Claude-Code-Dokumentation von Anthropic zu Hook-Events, Handler-Typen und dazu, wie ein Hook eine Aktion erlaubt, blockiert oder Kontext ergänzt.