Inference hooks de Claude: un control de permitir o denegar antes de cada prompt

Cómo funcionan los inference hooks

Tu organización (o su proveedor de seguridad) opera un servidor de seguridad de IA: un endpoint HTTPS. Cuando alguien envía un prompt, Anthropic publica la transcripción de la conversación en ese endpoint, firmada con el esquema Standard Webhooks, y espera un veredicto. Si es allow, la inferencia continúa; si es deny, la solicitud nunca llega al modelo y el usuario ve tu motivo junto con un mensaje fijo de tus administradores.

• Dos eventos: prompt, antes de cada solicitud de inferencia gobernada, y tool_call, antes de que se ejecuten las llamadas a herramientas de la respuesta de Claude, cuando Validate tool calls (validar llamadas a herramientas) está activado.
• Una configuración para toda la organización: claude.ai, Claude Desktop y móvil, Claude Code (CLI incluida), Cowork, Claude for Microsoft 365, Claude Tag y Claude in Chrome.
• Lo que ve tu servidor: el texto de la transcripción, las llamadas a herramientas y sus resultados, y el texto extraído de los adjuntos. Nunca los bytes en bruto de archivos o imágenes, los prompts de sistema ni las definiciones de herramientas.
• Los veredictos son solo allow o deny. No se admite reescribir ni redactar (ocultar datos de) un prompt.
• Cada denegación queda registrada en el Activity Feed de tu organización.

Inference hooks vs hooks de Claude Code vs Compliance API

Los nombres se parecen, pero son tres herramientas distintas. Los hooks de Claude Code se configuran por proyecto o por usuario y se ejecutan en la máquina del desarrollador; los inference hooks los define una vez la organización y se ejecutan en el lado de Anthropic.

Cómo configurar los inference hooks

Necesitas el rol de Owner o Primary owner (Admin no basta) y un endpoint HTTPS público en el puerto 443. Los túneles como ngrok están bloqueados, así que aloja el servidor de pruebas en un dominio que controles.

1. Habilita la función

   En claude.ai, abre Organization settings → Data and privacy (configuración de la organización → datos y privacidad) y activa Allow for your organization en Inference hooks. Esto no inicia la inspección: Enforce verdicts (aplicar veredictos) sigue desactivado.

2. Añade tu endpoint y guarda el secreto de firma

   Haz clic en Configure, introduce tu URL https:// y guarda. Al guardar por primera vez se muestra una sola vez un secreto de firma del webhook: guárdalo, porque tu servidor lo usa para verificar cada solicitud.

3. Añade cabeceras y prueba

   Añade hasta 16 cabeceras estáticas para que tu servidor pueda autenticar a Anthropic y luego haz clic en Test connection. Envía un prompt sintético e informa del veredicto y del tiempo de ida y vuelta.

4. Devuelve un veredicto como JSON con HTTP 200

   Responde a cada solicitud con HTTP 200 y un action. Un estado distinto de 200 es un fallo, no una denegación.

   // Permitir la solicitud
   { "action": "allow" }
   
   // Denegarla: deny_reason se muestra al usuario (máx. 500 caracteres),
   // reference_id solo va a tu feed de actividad de cumplimiento
   {
     "action": "deny",
     "deny_reason": "Este prompt parece contener datos de tarjetas de clientes.",
     "reference_id": "scan_01HXPT4R9V"
   }

5. Elige el manejo de fallos y un tiempo de espera

   Block the request falla en cerrado, Allow the request falla en abierto. El tiempo de espera del veredicto va de 1 a 10.000 ms, 5.000 por defecto; un veredicto lento cuenta como servidor inaccesible. Los fallos repetidos activan un circuit breaker que aplica tu ajuste de fallo hasta que el servidor se recupera.

6. Despliega de forma gradual y luego aplica

   Empieza en Shadow mode, que envía los veredictos sin bloquear nada, inspecciona un porcentaje de las solicitudes, excluye roles personalizados si hace falta y luego activa Enforce verdicts. Los cambios llegan a todos los servidores en aproximadamente un minuto.

Fuente: documentación de Claude Platform, Inference hooks

Límites y detalles a tener en cuenta

• Solo Enterprise: no están en Team, Pro ni Max, ni para organizaciones de Claude Platform (API), ni en Amazon Bedrock o Google Cloud.
• El contenido que es solo imagen, como una captura de pantalla de un documento, no se inspecciona porque nunca se envían los bytes en bruto.
• Un mensaje denegado permanece en la transcripción y se reenvía con cada mensaje posterior. En Claude Code, ejecuta /rewind hasta el prompt que lo introdujo o /clear para empezar de cero.
• Algunas llamadas de fondo al modelo que hace la propia Anthropic no están gobernadas, como los escaneos alojados de Claude Security, Code Review en pull requests de GitHub y los informes inteligentes. Ejecutar /code-review en local en Claude Code sí está gobernado.
• En el modo de voz una pequeña parte de las llamadas a herramientas no se envía, así que no confíes en los hooks como único control ahí.
• El mismo anuncio añadió un centro de seguridad (beta) que compara tu configuración de Claude, Cowork y Claude Code con la configuración recomendada por Anthropic, además de gestión centralizada y controles de acceso en beta.

Por qué importa para los agentes que trabajan solos

Cuando Claude Code trabaja sin supervisión, con una programación o en segundo plano, nadie lee cada prompt antes de que se envíe. Los inference hooks dan a una empresa un control en línea sobre cada solicitud y llamada a herramientas, se ejecute donde se ejecute el agente, y el shadow mode permite a los equipos de seguridad ajustar la política antes de bloquear nada. Para barreras por proyecto en una sola máquina siguen valiendo los hooks y las reglas de permisos de Claude Code; consulta el plan mode de Claude Code para los modos de permisos.

Barreras para empleados de IA que trabajan mientras no estás

Crewmark convierte una sesión de Claude Code, Codex, DeepSeek Harness u OpenCode en un empleado de IA con un rol, un objetivo y un horario, y la despierta con un heartbeat para que tome la siguiente issue de un tablero. Con un plan Claude Enterprise, los inference hooks revisan sus prompts como los de cualquier otra persona.

1. Decide qué necesita tu visto bueno

   Cada empleado pregunta antes de acciones arriesgadas, como publicar, hacer merge o gastar dinero, y tú apruebas desde una sola bandeja de entrada.

2. Mantén el registro en el tablero

   Cada issue conserva los comentarios y cambios de estado del empleado, así que puedes revisar lo que hizo junto a los registros de tu equipo de seguridad.

3. Deja que el heartbeat arranque el trabajo

   Durante su horario laboral el empleado se despierta cada 15, 30 o 60 minutos en la misma conversación; mira cómo hacer proactivo a Claude Code y qué es un empleado de IA.

Preguntas frecuentes sobre los inference hooks de Claude