Inference hooks do Claude: uma checagem de permitir ou negar antes de cada prompt

Como os inference hooks funcionam

A sua organização (ou o fornecedor de segurança dela) mantém um servidor de segurança de IA: um endpoint HTTPS. Quando alguém envia um prompt, a Anthropic posta a transcrição da conversa nesse endpoint, assinada com o esquema Standard Webhooks, e espera um veredito. Com allow, a inferência segue; com deny, a solicitação nunca chega ao modelo e o usuário vê o seu motivo mais uma mensagem fixa dos seus administradores.

• Dois eventos: prompt, antes de cada solicitação de inferência governada, e tool_call, antes de as chamadas de ferramenta da resposta do Claude rodarem, quando Validate tool calls (validar chamadas de ferramenta) está ativado.
• Uma configuração para a organização inteira: claude.ai, Claude Desktop e mobile, Claude Code (CLI incluída), Cowork, Claude for Microsoft 365, Claude Tag e Claude in Chrome.
• O que o seu servidor vê: o texto da transcrição, as chamadas de ferramenta e seus resultados, e o texto extraído de anexos. Nunca os bytes brutos de arquivos ou imagens, os prompts de sistema ou as definições de ferramentas.
• Os vereditos são só allow ou deny. Reescrever ou mascarar dados de um prompt não é suportado.
• Cada negação fica registrada no Activity Feed da sua organização.

Inference hooks vs hooks do Claude Code vs Compliance API

Os nomes são parecidos, mas são três ferramentas diferentes. Os hooks do Claude Code são configurados por projeto ou por usuário e rodam na máquina do desenvolvedor; os inference hooks são definidos uma vez pela organização e rodam do lado da Anthropic.

Como configurar os inference hooks

Você precisa do papel de Owner ou Primary owner (Admin não basta) e de um endpoint HTTPS público na porta 443. Túneis como o ngrok são bloqueados, então hospede o servidor de teste em um domínio que você controla.

1. Libere o recurso

   No claude.ai, abra Organization settings → Data and privacy (configurações da organização → dados e privacidade) e ative Allow for your organization em Inference hooks. Isso não inicia a inspeção: Enforce verdicts (aplicar vereditos) continua desligado.

2. Adicione o seu endpoint e guarde o segredo de assinatura

   Clique em Configure, informe a sua URL https:// e salve. No primeiro salvamento aparece, uma única vez, um segredo de assinatura do webhook: guarde-o, porque o seu servidor o usa para verificar cada solicitação.

3. Adicione headers e teste

   Adicione até 16 headers estáticos para que o seu servidor possa autenticar a Anthropic e depois clique em Test connection. Ele envia um prompt sintético e mostra o veredito e o tempo de ida e volta.

4. Devolva um veredito como JSON com HTTP 200

   Responda a cada solicitação com HTTP 200 e um action. Um status diferente de 200 é uma falha, não uma negação.

   // Permitir a solicitação
   { "action": "allow" }
   
   // Negá-la: deny_reason aparece para o usuário (máx. 500 caracteres),
   // reference_id vai apenas para o feed de atividade de compliance
   {
     "action": "deny",
     "deny_reason": "Este prompt parece conter dados de cartão de clientes.",
     "reference_id": "scan_01HXPT4R9V"
   }

5. Escolha o tratamento de falhas e um timeout

   Block the request falha fechado, Allow the request falha aberto. O timeout do veredito vai de 1 a 10.000 ms, 5.000 por padrão; um veredito lento conta como servidor inacessível. Falhas repetidas acionam um circuit breaker que aplica a sua configuração de falha até o servidor se recuperar.

6. Implante aos poucos e depois aplique

   Comece no Shadow mode, que envia os vereditos sem bloquear nada, inspecione uma porcentagem das solicitações, exclua papéis personalizados se precisar e depois ative Enforce verdicts. As mudanças chegam a todos os servidores em cerca de um minuto.

Fonte: documentação da Claude Platform, Inference hooks

Limites e pegadinhas

• Só Enterprise: não estão no Team, Pro ou Max, nem em organizações da Claude Platform (API), nem no Amazon Bedrock ou Google Cloud.
• Conteúdo só de imagem, como uma captura de tela de um documento, não é inspecionado, porque os bytes brutos nunca são enviados.
• Uma mensagem negada continua na transcrição e é reenviada a cada mensagem seguinte. No Claude Code, rode /rewind até o prompt que a trouxe ou /clear para recomeçar.
• Algumas chamadas de modelo em segundo plano da própria Anthropic não são governadas, como as varreduras hospedadas do Claude Security, o Code Review em pull requests do GitHub e os relatórios inteligentes. Rodar /code-review localmente no Claude Code é governado.
• No modo de voz, uma pequena parte das chamadas de ferramenta não é enviada, então não dependa dos hooks como único controle ali.
• O mesmo anúncio trouxe uma central de segurança (beta) que compara as suas configurações do Claude, do Cowork e do Claude Code com a configuração recomendada pela Anthropic, além de gerenciamento centralizado e controles de acesso em beta.

Por que isso importa para agentes que trabalham sozinhos

Quando o Claude Code trabalha sem supervisão, em um agendamento ou em segundo plano, ninguém lê cada prompt antes de ele ser enviado. Os inference hooks dão a uma empresa uma checagem em linha em cada solicitação e chamada de ferramenta, onde quer que o agente rode, e o shadow mode permite que as equipes de segurança ajustem a política antes de bloquear qualquer coisa. Para proteções por projeto em uma única máquina, os hooks e as regras de permissão do próprio Claude Code continuam valendo; veja o plan mode do Claude Code para os modos de permissão.

Proteções para funcionários de IA que trabalham enquanto você está fora

O Crewmark transforma uma sessão do Claude Code, Codex, DeepSeek Harness ou OpenCode em um funcionário de IA com um papel, uma meta e um horário de trabalho, e a acorda com um heartbeat para pegar a próxima issue de um quadro. Em um plano Claude Enterprise, os inference hooks checam os prompts dele como os de qualquer outra pessoa.

1. Decida o que precisa do seu sim

   Cada funcionário pergunta antes de ações arriscadas, como publicar, fazer merge ou gastar dinheiro, e você aprova a partir de uma única caixa de entrada.

2. Mantenha o registro no quadro

   Cada issue guarda os comentários e as mudanças de status do funcionário, então você pode revisar o que ele fez ao lado dos logs da sua equipe de segurança.

3. Deixe o heartbeat começar o trabalho

   Durante o horário de trabalho, o funcionário acorda a cada 15, 30 ou 60 minutos na mesma conversa; veja como tornar o Claude Code proativo e o que é um funcionário de IA.

Perguntas frequentes sobre os inference hooks do Claude