Ratgeber
Claude Code Hooks erklärt: was sie sind und was Sie damit bauen können
Kurze Antwort: Mit Hooks führt Claude Code Ihren Befehl aus, wenn ein Tool startet, es um Erlaubnis bittet oder ein Durchgang endet. So funktionieren sie, und so nutzt Herdbell sie.
Ein Hook ist ein kleiner Befehl, den ein Agent zu einem bestimmten Zeitpunkt ausführt. Claude Code, Codex und Cursor unterstützen sie in irgendeiner Form, und sie sind der saubere Weg für ein anderes Programm, mitzuverfolgen, was ein Agent tut, ohne sich irgendwo anzumelden oder den Bildschirm auszulesen.
Die Idee in einem Absatz
Sie sagen dem Agenten: Wenn das passiert, führe diesen Befehl aus. Der Agent führt ihn aus und übergibt ihm eine kurze Beschreibung des Ereignisses. Der Befehl kann es einfach festhalten (um zum Beispiel eine Benachrichtigung zu senden) oder bei manchen Ereignissen eine Antwort zurücksenden, die der Agent verwendet.
Zeitpunkte, an die Sie sich einklinken können
Genaue Ereignisnamen und Einstellungen unterscheiden sich je nach Agent und Version. Lesen Sie daher die Dokumentation des jeweiligen Agenten, bevor Sie etwas Eigenes schreiben.
- Eine Sitzung beginnt oder endet, oder Sie senden einen Prompt.
- Ein Tool wird gleich ausgeführt oder wurde gerade ausgeführt.
- Der Agent bittet um Erlaubnis für etwas.
- Der Agent beendet seinen Durchgang (ein Stop-Ereignis).
Wo sie sitzen
In einer Einstellungsdatei: bei Claude Code ist das ~/.claude/settings.json, bei Codex ~/.codex/hooks.json und bei Cursor ~/.cursor/hooks.json. Diese Dateien von Hand zu bearbeiten ist in Ordnung, und genauso verbindet sich auch ein Tool wie Herdbell.
Wie Herdbell sie nutzt
- Beim Verbinden sichert Herdbell die Datei und fügt dann seinen eigenen kleinen Befehl für die benötigten Ereignisse hinzu.
- Bei den meisten Ereignissen hört es nur zu, damit es zeigen kann, was der Agent gerade tut.
- Bei einer Berechtigungsanfrage wartet es auf Ihre Antwort und gibt sie zurück, sodass Allow und Deny wirksam werden. Am Ende eines Durchgangs kann es den Agenten offen halten, damit Ihre Antwort in denselben Chat zurückgeht.
- Antworten Sie nicht rechtzeitig, lässt es los, und der Agent fällt auf seine eigene Abfrage zurück. Beim Trennen werden nur die Hooks von Herdbell entfernt.
Häufige Fragen
Brauchen Hooks einen API-Schlüssel oder eine Anmeldung?
Nein. Ein Hook ist ein lokaler Befehl auf Ihrem Mac. Herdbell nutzt sie, damit es sich nie bei einem Agenten anmelden oder ein KI-Modell aufrufen muss.
Kann ein Hook meinen Agenten kaputt machen?
Ein schlecht geschriebener Hook kann den Agenten ausbremsen oder verwirren. Deshalb sichert Herdbell zuerst Ihre Einstellungen, hält seine Hooks klein und lässt los, wenn Sie nicht antworten. Sie können die Verbindung jederzeit trennen.