Claude Code Hooks: Wiederkehrende Aktionen automatisieren

Stell dir vor, du hättest einen unsichtbaren Assistenten, der immer genau dann eingreift, wenn etwas Bestimmtes passiert: Immer wenn du eine Datei speicherst, formatiert er deinen Code sauber. Immer wenn dein KI-Helfer einen riskanten Befehl ausführen will, hält er kurz inne und fragt nach. Genau das machen Claude Code Hooks. Ein Hook (englisch für „Haken“) ist ein automatischer Auslöser nach dem Prinzip „immer wenn X passiert, mach Y“. In diesem Artikel zeige ich dir, was Hooks in Claude Code sind, welche es gibt und wie du sie in wenigen Minuten einrichtest, ohne dass du dafür ein Profi-Entwickler sein musst.

Was sind Hooks in Claude Code?

Claude Code Hooks sind kleine Regeln, die automatisch einen Befehl ausführen, sobald ein bestimmtes Ereignis eintritt. Ein „Ereignis“ (auf Englisch: Event) ist einfach ein Moment im Ablauf, zum Beispiel „eine Datei wurde gerade geändert“ oder „die Arbeitssitzung ist zu Ende“. Du legst einmal fest: „Wenn dieses Ereignis passiert, führe diesen Befehl aus“ und ab dann kümmert sich Claude Code von ganz allein darum.

Das Schöne daran: Du musst nicht mehr daran denken. Wiederkehrende Handgriffe, die du sonst nach jeder Änderung manuell machen würdest, passieren jetzt im Hintergrund. Das spart Zeit, sorgt für Konsistenz und nimmt dir das Gefühl, ständig irgendetwas zu vergessen. Gerade für Solopreneure, die alles allein stemmen, ist das Gold wert.

Ein wichtiger Unterschied: Hooks sind keine Bitte an die KI („formatiere doch bitte den Code“), sondern eine feste Anweisung an das Programm selbst. Die KI kann das nicht einfach vergessen oder anders interpretieren. Ein Hook läuft zuverlässig, jedes Mal.

Welche Events gibt es?

Damit ein Hook weiß, wann er loslegen soll, knüpft er sich an ein bestimmtes Event. Hier sind die wichtigsten, die du in der Praxis am häufigsten brauchst:

• PreToolUse – wird ausgelöst, bevor Claude Code ein Werkzeug (ein „Tool“, also zum Beispiel das Schreiben einer Datei oder das Ausführen eines Befehls) benutzt. Praktisch, um vorher zu prüfen oder etwas zu blockieren.
• PostToolUse – wird ausgelöst, nachdem ein Tool benutzt wurde, also zum Beispiel nach einer Datei-Änderung. Ideal, um danach automatisch aufzuräumen oder zu formatieren.
• Stop – wird ausgelöst, wenn Claude Code mit seiner Antwort fertig ist, also am Ende einer Aufgabe. Gut für Benachrichtigungen oder Abschluss-Checks.

Es gibt noch ein paar weitere Events (etwa wenn eine ganze Session startet oder endet), aber mit diesen drei deckst du schon die meisten sinnvollen Automatisierungen ab. Merk dir einfach die Logik: Pre = davor, Post = danach, Stop = am Ende.

Wie richtest du einen Hook ein?

Hooks werden in einer Konfigurationsdatei eingetragen: der settings.json. Das ist eine schlichte Textdatei im sogenannten JSON-Format. JSON ist einfach eine geordnete Schreibweise für Einstellungen, mit geschweiften Klammern und Anführungszeichen, die der Computer gut lesen kann. Du findest die Datei in deinem Projekt unter .claude/settings.json.

Du musst die Datei aber gar nicht von Hand bearbeiten, wenn du nicht willst. Claude Code bringt einen eingebauten Slash-Command mit: Tippe einfach /hooks in den Chat, und du wirst Schritt für Schritt durch die Einrichtung geführt. Ein „Slash-Command“ ist ein Kurzbefehl, der mit einem Schrägstrich beginnt.

So sieht ein einfacher Hook aus, der nach jeder Datei-Änderung deinen Code automatisch formatiert. Das Formatieren übernimmt hier ein sogenannter „Formatter“ namens Prettier, der Einrückungen und Abstände sauber macht:

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "npx prettier --write ."
          }
        ]
      }
    ]
  }
}

Was passiert hier? Unter PostToolUse (also „nachdem ein Tool benutzt wurde“) sagt der matcher: „Reagiere nur, wenn das Tool Edit oder Write war“, also wenn eine Datei bearbeitet oder neu geschrieben wurde. Dann führt der command den Formatier-Befehl aus. Mehr ist es nicht. Ein klares „Wenn das passiert, mach das“.

Nützliche Hook-Ideen für den Alltag

Sobald du das Prinzip verstanden hast, öffnet sich eine ganze Werkzeugkiste. Hier ein paar Ideen, die sich im Alltag richtig auszahlen:

• Auto-Format: Wie oben gezeigt. Nach jeder Änderung läuft automatisch ein Formatter oder ein „Linter“ (ein Programm, das deinen Code auf Fehler und unsauberen Stil prüft). So bleibt dein Projekt immer ordentlich.
• Secrets blocken: Mit einem PreToolUse-Hook kannst du prüfen, ob versehentlich ein Passwort oder ein geheimer Schlüssel (ein „Secret“) in eine Datei geschrieben werden soll, und das stoppen, bevor es passiert. Ein echter Schutz vor peinlichen Pannen.
• Tests anstoßen: Nach einer Code-Änderung automatisch die Tests laufen lassen, damit du sofort siehst, ob noch alles funktioniert.
• Benachrichtigung: Ein Stop-Hook, der dir einen Ton abspielt oder eine kurze Meldung schickt, wenn Claude Code mit einer längeren Aufgabe fertig ist. So musst du nicht ständig auf den Bildschirm starren und kannst nebenbei was anderes machen.

Du siehst: Die meisten Hooks lösen genau die kleinen Nervereien, die sich über den Tag summieren. Einmal eingerichtet, arbeiten sie für dich.

Sicherheit: Hooks führen echte Befehle aus

Ein ehrliches Wort zur Vorsicht: Hooks sind mächtig, weil sie echte Befehle auf deinem Computer ausführen, und zwar automatisch und ohne erneute Nachfrage. Das ist genau ihr Vorteil, aber auch der Punkt, an dem du aufpassen musst.

Halte dich an ein paar einfache Regeln:

• Trage nur Befehle ein, die du selbst verstehst und denen du vertraust. Wenn du nicht weißt, was ein Befehl tut, baue ihn nicht ein.
• Sei besonders vorsichtig mit Hook-Konfigurationen aus fremden Quellen, die du irgendwo kopiert hast. Lies sie durch, bevor du sie übernimmst.
• Vermeide Befehle, die etwas Unwiderrufliches tun (zum Beispiel Dateien löschen), wenn du dir nicht hundertprozentig sicher bist.

Die gute Nachricht: Solange du nur harmlose Dinge wie Formatieren, Testen oder Benachrichtigen einrichtest, bist du auf der sicheren Seite. Behandle deine settings.json einfach mit demselben gesunden Misstrauen, mit dem du auch keine wildfremden Skripte aus dem Internet blind ausführen würdest.

Häufige Fragen zu Claude Code Hooks

Brauche ich Programmierkenntnisse, um Hooks zu nutzen?

Nein, für den Einstieg nicht. Dank des /hooks-Befehls wirst du durch die Einrichtung geführt, und einfache Hooks wie das Auto-Formatieren bestehen nur aus einem einzigen Befehl. Wenn du einen Befehl in der Kommandozeile tippen kannst, kannst du auch einen Hook anlegen.

Gelten Hooks für alle meine Projekte oder nur für eines?

Das hängt davon ab, wo du sie speicherst. Trägst du sie in die .claude/settings.json deines Projekts ein, gelten sie nur dort. Es gibt aber auch eine globale Einstellungsdatei in deinem Benutzerverzeichnis, die für alle Projekte greift. So kannst du allgemeine Hooks überall nutzen und projektspezifische sauber trennen.

Was passiert, wenn ein Hook fehlschlägt?

Wenn der Befehl eines Hooks einen Fehler meldet, bekommst du das in Claude Code mit. Bei einem PreToolUse-Hook kann ein Fehlschlag sogar bewusst dazu dienen, eine Aktion zu stoppen, zum Beispiel, um das versehentliche Speichern eines Secrets zu verhindern. Du verlierst dadurch nichts; du wirst nur darauf hingewiesen, dass etwas nicht durchgelaufen ist.

Fazit

Claude Code Hooks sind eine der unterschätztesten Funktionen für alle, die effizienter arbeiten wollen. Statt wiederkehrende Handgriffe immer wieder selbst zu machen, legst du einmal eine Regel nach dem Muster „immer wenn X passiert, mach Y“ fest und überlässt den Rest dem Programm. Ob automatisches Formatieren, das Blocken von Secrets, das Anstoßen von Tests oder eine kleine Benachrichtigung am Ende, die Events PreToolUse, PostToolUse und Stop decken die wichtigsten Fälle ab. Fang mit einem einzigen, harmlosen Hook an, zum Beispiel dem Auto-Format, und taste dich von dort aus weiter. Du wirst schnell merken, wie viel ruhiger sich dein Workflow anfühlt, wenn die Routine im Hintergrund einfach läuft.