Claude Inference Hooks: eine Erlauben-oder-Ablehnen-Prüfung vor jedem Prompt

So funktionieren Inference Hooks

Deine Organisation (oder ihr Security-Anbieter) betreibt einen KI-Sicherheitsserver: einen HTTPS-Endpoint. Wenn jemand einen Prompt abschickt, sendet Anthropic das Transkript der Unterhaltung an diesen Endpoint, signiert nach dem Standard-Webhooks-Schema, und wartet auf ein Urteil. Bei allow läuft die Inferenz weiter; bei deny erreicht die Anfrage das Modell nie, und der Nutzer sieht deine Begründung plus eine feste Nachricht deiner Admins.

• Zwei Events: prompt, vor jeder kontrollierten Inferenzanfrage, und tool_call, bevor die Tool-Calls in Claudes Antwort ausgeführt werden, wenn Validate tool calls (Tool-Calls prüfen) aktiv ist.
• Eine Einrichtung für die ganze Organisation: claude.ai, Claude Desktop und Mobile, Claude Code (inklusive CLI), Cowork, Claude for Microsoft 365, Claude Tag und Claude in Chrome.
• Was dein Server sieht: den Text des Transkripts, Tool-Calls und ihre Ergebnisse sowie aus Anhängen extrahierten Text. Nie die rohen Bytes von Dateien oder Bildern, System-Prompts oder Tool-Definitionen.
• Urteile sind nur allow oder deny. Einen Prompt umschreiben oder schwärzen geht nicht.
• Jede Ablehnung wird im Activity Feed deiner Organisation protokolliert.

Inference Hooks vs. Claude Code Hooks vs. Compliance API

Die Namen ähneln sich, aber es sind drei verschiedene Werkzeuge. Claude Code Hooks werden pro Projekt oder pro Nutzer konfiguriert und laufen auf dem Rechner des Entwicklers; Inference Hooks legt die Organisation einmal fest, und sie laufen auf Anthropics Seite.

So richtest du Inference Hooks ein

Du brauchst die Rolle Owner oder Primary owner (Admin reicht nicht) und einen öffentlichen HTTPS-Endpoint auf Port 443. Tunnel wie ngrok werden blockiert, hoste den Testserver also auf einer Domain, die du kontrollierst.

1. Die Funktion freischalten

   Öffne in claude.ai Organization settings → Data and privacy (Organisationseinstellungen → Daten und Datenschutz) und aktiviere unter Inference hooks die Option Allow for your organization. Damit startet noch keine Prüfung: Enforce verdicts (Urteile durchsetzen) bleibt aus.

2. Endpoint hinzufügen und Signing Secret sichern

   Klick auf Configure, gib deine https://-URL ein und speichere. Beim ersten Speichern wird einmalig ein Webhook Signing Secret angezeigt: Bewahre es auf, denn dein Server prüft damit jede Anfrage.

3. Header hinzufügen und testen

   Füge bis zu 16 statische Header hinzu, damit dein Server Anthropic authentifizieren kann, und klick dann auf Test connection. Das schickt einen synthetischen Prompt und meldet das Urteil und die Round-Trip-Zeit.

4. Ein Urteil als HTTP-200-JSON zurückgeben

   Beantworte jede Anfrage mit HTTP 200 und einer action. Ein anderer Status als 200 ist ein Fehler, keine Ablehnung.

   // Anfrage erlauben
   { "action": "allow" }
   
   // Ablehnen: deny_reason wird dem Nutzer angezeigt (max. 500 Zeichen),
   // reference_id landet nur in deinem Compliance-Aktivitätsfeed
   {
     "action": "deny",
     "deny_reason": "Dieser Prompt scheint Kartendaten von Kunden zu enthalten.",
     "reference_id": "scan_01HXPT4R9V"
   }

5. Fehlerverhalten und Timeout wählen

   Block the request schlägt geschlossen fehl (fail closed), Allow the request offen (fail open). Der Timeout für das Urteil liegt zwischen 1 und 10.000 ms, standardmäßig 5.000; ein zu langsames Urteil gilt als nicht erreichbar. Wiederholte Fehler lösen einen Circuit Breaker aus, der deine Fehlereinstellung anwendet, bis sich der Server erholt.

6. Schrittweise ausrollen, dann durchsetzen

   Starte im Shadow mode, der Urteile abfragt, ohne etwas zu blockieren, prüfe einen Prozentsatz der Anfragen, schließe bei Bedarf eigene Rollen aus und aktiviere dann Enforce verdicts. Änderungen erreichen alle Server in etwa einer Minute.

Quelle: Claude-Platform-Dokumentation, Inference hooks

Grenzen und Stolperfallen

• Nur Enterprise: nicht in Team, Pro oder Max, nicht für Organisationen der Claude Platform (API) und nicht auf Amazon Bedrock oder Google Cloud.
• Reine Bildinhalte, etwa ein Screenshot eines Dokuments, werden nicht geprüft, weil rohe Bytes nie gesendet werden.
• Eine abgelehnte Nachricht bleibt im Transkript und wird mit jeder späteren Nachricht erneut gesendet. In Claude Code springst du mit /rewind zum Prompt zurück, der sie hereingebracht hat, oder fängst mit /clear neu an.
• Einige Hintergrundaufrufe des Modells durch Anthropic selbst werden nicht kontrolliert, etwa gehostete Scans von Claude Security, Code Review auf GitHub-Pull-Requests und Smart Reports. /code-review lokal in Claude Code auszuführen wird dagegen kontrolliert.
• Im Sprachmodus wird ein kleiner Teil der Tool-Calls nicht gesendet, verlass dich dort also nicht allein auf die Hooks.
• Mit derselben Ankündigung kam ein Security Center (Beta), das deine Einstellungen für Claude, Cowork und Claude Code mit Anthropics empfohlener Konfiguration vergleicht, dazu zentrale Verwaltung und Zugriffskontrollen in der Beta.

Warum das für Agenten zählt, die allein arbeiten

Wenn Claude Code unbeaufsichtigt arbeitet, nach Zeitplan oder im Hintergrund, liest niemand jeden Prompt, bevor er rausgeht. Inference Hooks geben einem Unternehmen eine Inline-Prüfung für jede Anfrage und jeden Tool-Call, egal wo der Agent läuft, und mit dem Shadow mode können Security-Teams die Richtlinie feinjustieren, bevor sie irgendetwas blockieren. Für Leitplanken pro Projekt auf einem einzelnen Rechner gelten weiterhin die eigenen Hooks und Berechtigungsregeln von Claude Code; zu den Berechtigungsmodi siehe Claude Code Plan Mode.

Leitplanken für KI-Mitarbeiter, die arbeiten, während du weg bist

Crewmark macht aus einer Session von Claude Code, Codex, DeepSeek Harness oder OpenCode einen KI-Mitarbeiter mit Rolle, Ziel und Arbeitszeiten und weckt ihn per Heartbeat, damit er das nächste Issue vom Board übernimmt. In einem Claude-Enterprise-Tarif prüfen Inference Hooks seine Prompts wie die aller anderen.

1. Leg fest, was dein Ja braucht

   Jeder Mitarbeiter fragt vor riskanten Aktionen nach, etwa Veröffentlichen, Mergen oder Geld ausgeben, und du gibst sie in einem einzigen Posteingang frei.

2. Behalte den Verlauf auf dem Board

   Jedes Issue speichert die Kommentare und Statuswechsel des Mitarbeiters, sodass du neben den Logs deines Security-Teams nachvollziehen kannst, was er getan hat.

3. Lass den Heartbeat die Arbeit starten

   Während seiner Arbeitszeiten wacht der Mitarbeiter alle 15, 30 oder 60 Minuten in derselben Unterhaltung auf; siehe wie du Claude Code proaktiv machst und was ein KI-Mitarbeiter ist.

FAQ zu Claude Inference Hooks