Hooks

🧠 Hooks (Haken) – Schlüsselkonzepte

Definition & Funktion:

• Hook: Ein deterministischer Code an einem festen Punkt im Loop.
• Zweck: Verwandelt eine allgemeine Regel von Claude in eine zwingende Anweisung, die Claude nicht überspringen kann.
• Vorteil: Ermöglicht Garantien und Kontrolle, die über einfache Formatierung hinausgehen.

Wichtige Hook-Typen:

• Pre-tool use: Führt vor einem Tool-Aufruf aus (Einsatz für Durchsetzung/Enforcement).
• Post-tool use: Führt nach einem erfolgreichen Tool-Aufruf aus (z. B. für Auto-Formatting oder Linting).
• Stop: Wird ausgeführt, wenn Claude beenden möchte.
• Refuse: Wird ausgeführt, wenn Bedingungen nicht erfüllt sind.
• Subagent stop: Gleiches Signal wie Stop, aber für Subagent-Abschluss.
• Pre-compact / Post-compact: Führen vor bzw. nach der Kompaktierung (Zusammenfassung) der Konversation.
• Session start: Initialisiert die Umgebung; kann mit dem compact matcher verwendet werden, um Kontext nach der Kompaktierung wieder einzuspeisen.
• Instructions loaded: Führt aus, wenn eine Regel- oder Claude. md-Datei geladen wird (Audit des Kontexts).

Steuerung und Rückgabewerte (Exit Codes):

• Erfolg (0): Standard-Output (stdout) ist JSON → Claude parst es.
• Fehler (2): Standard-Error (stderr) wird als Kontext an Claude zurückgespeist (blockierender Fehler).
• Wichtig: Exit Code 1 ist kein blockierender Fehler; Claude führt den Befehl trotzdem aus.

Aktionsmöglichkeiten in Hooks:

• JSON-Rückgabe: Zur Steuerung des Flusses.
• Decision (Entscheidung): Rückgabe von allow, deny oder ask.
• Defer: Nur in nicht-interaktiven Prozessen; pausiert und setzt das Tool später fort.
• Aktualisierter Input: Ersetzen des gesamten Eingabeobjekts, um Tool-Aufrufe zu modifizieren (z. B. Redaktion von Geheimnissen/Secrets).

Spezialfälle:

• Redaktion (Guardrail): In pre-tool use kann die Rückgabe von deny einen gefährlichen Aufruf stoppen, oder der updated input kann den Aufruf umschreiben.
• Kontext-Wiederherstellung: Session start mit compact matcher stellt sicher, dass Claude nach der Kompaktierung den Kontext wieder aufgreift.
• Ignorierte Events: Einige Events (z. B. notification, session start, file change) ignorieren blockierende Fehler und zeigen stderr an, bevor sie fortfahren.

Zusammenfassung der Strategie:

• Verwende pre-tool use zur Absicherung (Guardrails).
• Verwende stop, um den Turn zu steuern.
• Verwende Hooks, um den Zustand über die Kompaktierung hinweg zu erhalten.

Takeaways

• Hooks sind deterministische Codes, die allgemeine Regeln in zwingende Anweisungen verwandeln, um Garantien und Kontrolle zu gewährleisten.
• Wichtige Hook-Typen umfassen Pre-tool use (Durchsetzung), Post-tool use (Formatierung), Stop und Refuse (Kontrolle).
• Die Steuerung erfolgt über Exit Codes: Erfolg (0) führt zur JSON-Verarbeitung; Fehler (2) blockieren und speisen den Fehler als Kontext zurück.
• Hooks ermöglichen Aktionen wie die Rückgabe von allow/deny (Decision) oder die Redaktion von Eingaben (Guardrails) in pre-tool use.