Inference hooks de Claude : un contrôle autoriser ou refuser avant chaque prompt

Comment fonctionnent les inference hooks

Votre organisation (ou son fournisseur de sécurité) exploite un serveur de sécurité IA : un endpoint HTTPS. Quand quelqu’un envoie un prompt, Anthropic transmet la transcription de la conversation à cet endpoint, signée selon le schéma Standard Webhooks, et attend un verdict. Sur allow, l’inférence continue ; sur deny, la requête n’atteint jamais le modèle et l’utilisateur voit votre motif ainsi qu’un message permanent de vos administrateurs.

• Deux événements : prompt, avant chaque requête d’inférence encadrée, et tool_call, avant l’exécution des appels d’outils de la réponse de Claude, lorsque Validate tool calls (valider les appels d’outils) est activé.
• Une seule configuration pour toute l’organisation : claude.ai, Claude Desktop et mobile, Claude Code (CLI comprise), Cowork, Claude for Microsoft 365, Claude Tag et Claude in Chrome.
• Ce que voit votre serveur : le texte de la transcription, les appels d’outils et leurs résultats, et le texte extrait des pièces jointes. Jamais les octets bruts des fichiers ou des images, ni les prompts système ni les définitions d’outils.
• Les verdicts sont uniquement allow ou deny. Réécrire ou caviarder un prompt n’est pas pris en charge.
• Chaque refus est consigné dans l’Activity Feed de votre organisation.

Inference hooks vs hooks de Claude Code vs Compliance API

Les noms se ressemblent, mais il s’agit de trois outils différents. Les hooks de Claude Code se configurent par projet ou par utilisateur et s’exécutent sur la machine du développeur ; les inference hooks sont définis une fois par l’organisation et s’exécutent côté Anthropic.

Comment configurer les inference hooks

Il vous faut le rôle Owner ou Primary owner (Admin ne suffit pas) et un endpoint HTTPS public sur le port 443. Les tunnels comme ngrok sont bloqués : hébergez donc le serveur de test sur un domaine que vous contrôlez.

1. Autorisez la fonctionnalité

   Dans claude.ai, ouvrez Organization settings → Data and privacy (paramètres de l’organisation → données et confidentialité) et activez Allow for your organization sous Inference hooks. Cela ne démarre pas l’inspection : Enforce verdicts (appliquer les verdicts) reste désactivé.

2. Ajoutez votre endpoint et conservez le secret de signature

   Cliquez sur Configure, saisissez votre URL https:// et enregistrez. Le premier enregistrement affiche une seule fois un secret de signature du webhook : conservez-le, car votre serveur s’en sert pour vérifier chaque requête.

3. Ajoutez des en-têtes et testez

   Ajoutez jusqu’à 16 en-têtes statiques pour que votre serveur puisse authentifier Anthropic, puis cliquez sur Test connection. Un prompt synthétique est envoyé, et le verdict ainsi que le temps aller-retour s’affichent.

4. Renvoyez un verdict en JSON avec HTTP 200

   Répondez à chaque requête avec HTTP 200 et un action. Un statut autre que 200 est un échec, pas un refus.

   // Autoriser la requête
   { "action": "allow" }
   
   // La refuser : deny_reason est affiché à l’utilisateur (500 caractères max.),
   // reference_id va uniquement dans votre flux d’activité de conformité
   {
     "action": "deny",
     "deny_reason": "Ce prompt semble contenir des données de carte bancaire de clients.",
     "reference_id": "scan_01HXPT4R9V"
   }

5. Choisissez la gestion des échecs et un délai

   Block the request échoue en mode fermé, Allow the request en mode ouvert. Le délai du verdict va de 1 à 10 000 ms, 5 000 par défaut ; un verdict trop lent compte comme un serveur injoignable. Des échecs répétés déclenchent un disjoncteur (circuit breaker) qui applique votre réglage d’échec jusqu’au rétablissement du serveur.

6. Déployez progressivement, puis appliquez

   Commencez en Shadow mode, qui envoie les verdicts sans rien bloquer, inspectez un pourcentage des requêtes, excluez des rôles personnalisés si besoin, puis activez Enforce verdicts. Les changements atteignent tous les serveurs en une minute environ.

Source : documentation de Claude Platform, Inference hooks

Limites et pièges

• Enterprise uniquement : pas sur Team, Pro ou Max, pas pour les organisations Claude Platform (API), ni sur Amazon Bedrock ou Google Cloud.
• Le contenu uniquement en image, comme une capture d’écran d’un document, n’est pas inspecté, car les octets bruts ne sont jamais envoyés.
• Un message refusé reste dans la transcription et est renvoyé avec chaque message suivant. Dans Claude Code, lancez /rewind jusqu’au prompt qui l’a introduit, ou /clear pour repartir de zéro.
• Certains appels de modèle en arrière-plan d’Anthropic elle-même ne sont pas encadrés, comme les analyses hébergées de Claude Security, Code Review sur les pull requests GitHub et les rapports intelligents. Lancer /code-review en local dans Claude Code est encadré.
• En mode vocal, une petite part des appels d’outils n’est pas envoyée : ne comptez donc pas sur les hooks comme seul contrôle dans ce cas.
• La même annonce a ajouté un centre de sécurité (bêta) qui compare vos paramètres Claude, Cowork et Claude Code à la configuration recommandée par Anthropic, ainsi qu’une gestion centralisée et des contrôles d’accès en bêta.

Pourquoi c’est important pour les agents qui travaillent seuls

Quand Claude Code travaille sans surveillance, selon un planning ou en arrière-plan, personne ne lit chaque prompt avant son envoi. Les inference hooks donnent à une entreprise un contrôle en ligne sur chaque requête et chaque appel d’outil, où que tourne l’agent, et le shadow mode permet aux équipes sécurité d’affiner la politique avant de bloquer quoi que ce soit. Pour des garde-fous par projet sur une seule machine, les hooks et les règles de permissions de Claude Code restent valables ; voir le plan mode de Claude Code pour les modes de permissions.

Des garde-fous pour les employés IA qui travaillent en votre absence

Crewmark transforme une session Claude Code, Codex, DeepSeek Harness ou OpenCode en employé IA avec un rôle, un objectif et des horaires de travail, et la réveille à intervalle régulier (heartbeat) pour qu’elle prenne la prochaine issue d’un tableau. Avec une offre Claude Enterprise, les inference hooks vérifient ses prompts comme ceux de n’importe qui.

1. Décidez de ce qui exige votre accord

   Chaque employé demande avant les actions risquées, comme publier, fusionner ou dépenser de l’argent, et vous validez depuis une seule boîte de réception.

2. Gardez la trace sur le tableau

   Chaque issue conserve les commentaires et changements de statut de l’employé : vous pouvez ainsi revoir ce qu’il a fait à côté des journaux de votre équipe sécurité.

3. Laissez la pulsation lancer le travail

   Pendant ses horaires de travail, l’employé se réveille toutes les 15, 30 ou 60 minutes dans la même conversation ; voir comment rendre Claude Code proactif et ce qu’est un employé IA.

FAQ inference hooks de Claude