Claude Code Hooks: Automatisierung einrichten

Du nutzt Claude Code und möchtest, dass bestimmte Dinge automatisch passieren – zum Beispiel, dass dein Code nach jeder Änderung formatiert wird oder dass eine Warnung kommt, bevor Claude eine riskante Datei anfasst? Genau dafür gibt es Hooks. Kurze Antwort vorweg: Hooks sind kleine Regeln, die eigene Befehle auslösen, sobald Claude Code etwas Bestimmtes tut.

Klingt nach Entwickler-Magie, ist es aber nicht. Wenn du eine Konfigurationsdatei bearbeiten und einen Shell-Befehl tippen kannst, kannst du Hooks nutzen. Dieser Artikel gehört zu unserem Überblick über Claude Code, MCP und KI-Agenten – und baut auf dem auf, was du in Was ist Claude Code? Einfach erklärt schon gelesen hast.

Was sind Hooks?

Hooks sind selbst definierte Befehle, die Claude Code automatisch an bestimmten Punkten seines Ablaufs ausführt.

Stell dir Hooks wie Türsteher und Helfer in einem vor. An jeder wichtigen Tür in Claude Codes Arbeitsablauf kannst du einen kleinen Aufpasser hinstellen. Will Claude gerade eine Datei bearbeiten? Dein Hook kann vorher draufschauen. Hat Claude einen Befehl ausgeführt? Dein Hook kann hinterher aufräumen.

Der entscheidende Punkt: Hooks sind deterministisch. Sie laufen immer, wenn das passende Ereignis eintritt – nicht nur dann, wenn Claude „daran denkt”. Du bittest die KI nicht höflich, deinen Code zu formatieren und hoffst, dass sie es macht. Du legst eine Regel fest, und die greift jedes Mal.

Damit lösen Hooks ein typisches Problem beim Arbeiten mit KI-Tools: Verlässlichkeit. Ein Prompt wie „formatiere bitte immer den Code” wird mal befolgt, mal vergessen. Ein Hook vergisst nichts.

Welche Hook-Typen gibt es?

Hooks hängen sich an bestimmte Ereignisse („Events”) in Claude Codes Ablauf – zum Beispiel kurz bevor oder nachdem ein Werkzeug benutzt wird.

Du musst nicht jedes Event auswendig kennen. Für den Anfang reichen ein paar zentrale Auslöser, die du dir merkst:

Bevor ein Werkzeug benutzt wird – ideal, um etwas zu prüfen oder zu blockieren, bevor es passiert (z. B. „Finger weg von dieser Datei”).
Nachdem ein Werkzeug benutzt wurde – ideal zum Aufräumen oder Nacharbeiten (z. B. Code formatieren, Tests anstoßen).
Wenn eine Eingabeaufforderung gesendet wird – um eigene Hinweise oder Kontext mitzugeben.
Wenn eine Sitzung endet oder Claude fertig ist – z. B. für eine Benachrichtigung oder ein Log.

Die genauen Event-Namen und ihre Schreibweise können sich zwischen Versionen unterscheiden. Zur Prüfung: Die aktuell gültige Liste der Hook-Events findest du immer in der offiziellen Claude-Code-Dokumentation – verlasse dich dort auf die Originalschreibweise, nicht auf eine deutsche Übersetzung.

Das Grundprinzip bleibt aber stabil: Jeder Hook besteht aus einem Ereignis (wann?) und einem Befehl (was passiert dann?).

Einen Hook einrichten

Hooks werden in der Konfiguration von Claude Code definiert – als Zuordnung von „Wann?” zu „Welcher Befehl?”.

Hooks lebt in deiner Claude-Code-Konfiguration (settings.json). Du kannst sie auf zwei Ebenen ablegen:

Projektweit – im Projektordner unter .claude/, gilt nur für dieses Projekt.
Global – in deinem Benutzerordner unter ~/.claude/, gilt für alle Projekte.

Das Muster ist immer gleich: Du wählst ein Event, optional einen Filter (auf welches Werkzeug oder welche Datei soll der Hook reagieren?), und gibst den Befehl an, der laufen soll.

Hier ein vereinfachtes Beispiel als Orientierung – ein Hook, der nach jeder Dateiänderung einen Befehl ausführt:

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit",
        "hooks": [
          {
            "type": "command",
            "command": "echo 'Datei wurde bearbeitet' >> aktivitaet.log"
          }
        ]
      }
    ]
  }
}

Zur Prüfung: Die exakten Schlüsselnamen (z. B. PostToolUse, matcher) und der genaue Aufbau dieses JSON-Blocks gehören zu den Dingen, die Anthropic zwischen Versionen anpassen kann. Schau vor dem Einrichten in die offizielle Dokumentation und kopiere die Struktur von dort – das ist sicherer, als ein Beispiel aus einem Artikel blind zu übernehmen.

So gehst du grundsätzlich vor:

Öffne (oder erstelle) deine settings.json im gewünschten .claude/-Ordner.
Füge einen hooks-Abschnitt nach dem Muster aus der Doku hinzu.
Trage Event, optionalen Filter und deinen Befehl ein.
Starte Claude Code neu, damit die Konfiguration geladen wird.
Löse das Event einmal bewusst aus und prüfe, ob dein Befehl tatsächlich lief.

Praxis-Beispiele

Hooks lohnen sich überall dort, wo du dieselbe Handgriff-Routine bei jeder Code-Änderung garantiert haben willst.

Ein paar realistische Einsätze, die du sofort verstehst:

Auto-Formatierung. Nach jeder Dateiänderung läuft dein Formatter (z. B. Prettier oder Black) – dein Code bleibt einheitlich, ohne dass du oder Claude daran denken müsst.
Schutz-Regel. Bevor Claude eine sensible Datei (etwa .env oder Produktions-Configs) bearbeitet, blockiert ein Hook das und gibt eine Warnung aus.
Benachrichtigung. Wenn Claude eine längere Aufgabe abgeschlossen hat, sendet ein Hook dir eine Desktop-Meldung – praktisch, wenn du nebenbei etwas anderes machst.
Aktivitäts-Log. Jede Tool-Nutzung wird in eine Logdatei geschrieben, damit du später nachvollziehen kannst, was passiert ist.
Tests anstoßen. Nach Änderungen am Code startet automatisch dein Test-Befehl, sodass du Fehler früh siehst.

Der gemeinsame Nenner: Du verlagerst Disziplin von „dran denken” zu „passiert automatisch”. Genau das macht einen sauberen Claude-Code-Workflow aus.

Sicherheit

Hooks führen echte Befehle auf deinem Rechner aus – behandle sie mit derselben Vorsicht wie jedes Skript, das du selbst schreibst.

Das ist der wichtigste Abschnitt, also kein Überfliegen. Ein Hook ist kein harmloser Text-Hinweis an die KI. Es ist ein Befehl, der real ausgeführt wird – mit deinen Benutzerrechten, in deiner Shell. Das gibt dir viel Macht und entsprechend Verantwortung.

Ein paar Regeln, an die du dich halten solltest:

Schreibe nur Befehle, die du verstehst. Kopiere keinen Hook-Befehl aus einer fremden Quelle, ohne genau zu wissen, was er tut. Ein Hook kann Dateien löschen oder Daten verschicken.
Sei vorsichtig mit fremden Configs. Wenn du ein fremdes Projekt klonst, kann dessen .claude/-Ordner bereits Hooks enthalten. Sieh sie dir an, bevor du Claude Code darin startest.
Beginne mit harmlosen Aktionen. Teste neue Hooks erst mit etwas Ungefährlichem wie einem echo-Befehl, bevor du sie auf löschende oder veröffentlichende Aktionen loslässt.
Nutze Schutz-Hooks gezielt. Ein „Bevor-Werkzeug”-Hook eignet sich gut, um riskante Aktionen abzufangen – etwa das Bearbeiten von Geheimnis-Dateien zu verhindern.

Kurz gesagt: Hooks sind so sicher wie die Befehle, die du hineinschreibst. Bleibt das in deiner Hand, bleibt es sicher.

Wie es weitergeht

Das größere Bild: Claude Code Workflows
Verwandte Automatisierung: eine eigene Agent Skill bauen
Sicher automatisieren: MCP-Server Sicherheit

FAQ: Häufige Fragen zu Claude Code Hooks

Was sind Claude Code Hooks?

Claude Code Hooks sind eigene Befehle, die automatisch ausgeführt werden, wenn in Claude Code ein bestimmtes Ereignis eintritt – zum Beispiel kurz bevor oder nachdem ein Werkzeug benutzt wird. Sie machen Abläufe verlässlich, weil sie immer greifen und nicht von der KI vergessen werden können.

Wofür brauche ich Hooks überhaupt?

Hooks sind ideal für Routine, die garantiert laufen soll: Code automatisch formatieren, riskante Datei-Änderungen blockieren, nach Aufgaben benachrichtigen oder Aktivität protokollieren. Immer wenn du dir denkst „das sollte eigentlich jedes Mal passieren”, ist ein Hook das passende Werkzeug.

Wo werden Hooks gespeichert?

In der Konfiguration von Claude Code, in einer settings.json innerhalb eines .claude/-Ordners. Projektweite Hooks liegen im Projektordner, globale Hooks in deinem Benutzerordner (~/.claude/) und gelten dann für alle Projekte. Die genaue Struktur prüfst du am besten in der offiziellen Dokumentation.

Brauche ich Programmierkenntnisse für Hooks?

Etwas Grundwissen hilft. Du musst keine Programmiersprache beherrschen, aber du solltest eine JSON-Konfigurationsdatei bearbeiten und einen einfachen Shell-Befehl (z. B. ein Formatierungs- oder Echo-Kommando) schreiben können. Der Einstieg ist mit kleinen, harmlosen Befehlen gut machbar.

Sind Hooks sicher?

So sicher wie die Befehle, die du hineinschreibst. Hooks führen echte Kommandos mit deinen Rechten aus – ein bösartiger oder fehlerhafter Befehl kann also Schaden anrichten. Verwende nur Befehle, die du verstehst, prüfe Hooks aus fremden Projekten vor dem Start und teste neue Hooks zuerst mit ungefährlichen Aktionen.

Worin unterscheiden sich Hooks von normalen Prompts?

Ein Prompt ist eine Bitte an die KI, die mal befolgt und mal übersehen wird. Ein Hook ist eine feste Regel, die deterministisch ausgelöst wird, sobald das passende Ereignis eintritt. Willst du verlässliche Automatisierung statt „hoffentlich”, nimmst du einen Hook.

Fazit

Hooks sind der Schritt von „Claude macht meistens, was ich will” zu „diese Dinge passieren garantiert”. Sie sind kein Hexenwerk: ein Ereignis, ein Befehl, eine Konfigurationsdatei. Fang klein an – ein Auto-Formatter oder ein simples Log – und taste dich vor.

Wenn du Claude Code noch frisch installiert hast, hol dir zuerst die Basics in Claude Code installieren & erste Schritte. Und wenn du danach deinen kompletten Ablauf aufräumen willst, weiter geht’s mit Claude Code Workflows & CLAUDE.md Best Practices.