Hooks de agente
Hooks de agente (ganchos) são comandos ou scripts definidos pelo usuário que um agente de programação executa automaticamente em pontos fixos do seu trabalho, como antes de uma chamada de ferramenta ou depois da edição de um arquivo, para verificar, bloquear ou ampliar o que ele faz.
Também chamado: hooks
Por Divya Sharma · Verificado em 15 de nov. de 2026 · Como analisamos
Instruções em um prompt ou em um arquivo de instruções são sugestões que o modelo costuma seguir. Hooks são código que roda sempre, seja qual for a decisão do modelo. Isso faz deles o lugar certo para regras que precisam valer e para tarefas rotineiras que você não quer que dependam da memória do modelo.
Como funciona
Você registra um hook nas configurações do agente, associado a um evento. No Claude Code, os eventos incluem o início de uma sessão, o momento em que o usuário envia um prompt, logo antes de uma ferramenta rodar (PreToolUse), logo depois que ela termina (PostToolUse) e quando o agente para. O agente passa detalhes do evento, como o nome da ferramenta e sua entrada, para o seu script. O script pode deixar a ação seguir, bloqueá-la com um motivo que o modelo vê ou acrescentar contexto.
Usos comuns
Rodar um formatador ou linter depois de cada edição de arquivo. Bloquear comandos de shell que apagam arquivos ou mexem em segredos. Recusar edições em caminhos protegidos. Enviar uma notificação na área de trabalho quando o agente precisar de uma resposta. Registrar cada chamada de ferramenta para auditoria.
Hooks versus permissões
Permissões de agente são listas de permissão e de bloqueio para ferramentas. Hooks são programáveis, então podem inspecionar argumentos e aplicar regras que uma lista não consegue expressar. Os dois fazem parte do harness do agente.
Limites
Um hook roda com todo o acesso do seu usuário, então um script de hook descuidado ou malicioso é, ele mesmo, um risco; revise os hooks de repositórios compartilhados antes de ativá-los. A correspondência de padrões em comandos pode ser contornada, então trate os hooks como uma camada ao lado de um sandbox de agente, não como a única.
Termos relacionados
- Agente de programação
- Um agente de programação (coding agent) é um agente de IA que trabalha diretamente no software: lê uma base de código, edita arquivos, roda comandos e testes, e repete até que uma mudança funcione, em vez de apenas sugerir código para uma pessoa colar.
- Harness de agente
- Um harness de agente (a estrutura de execução ao redor do modelo) é o software que transforma um modelo em um agente funcional: o loop, as ferramentas, o prompt de sistema, as permissões, o gerenciamento de contexto e quaisquer arquivos usados para levar o progresso de uma sessão para outra.
- Permissões de agente
- Permissões de agente são as regras que decidem quais ferramentas, arquivos, comandos, redes e contas um agente de IA pode usar, e quais ações precisam antes da aprovação de uma pessoa, para que um agente que erra ou é manipulado cause danos limitados.
- Arquivo de instruções do agente (AGENTS.md)
- Um arquivo de instruções do agente é um arquivo Markdown em um repositório de código, como AGENTS.md ou CLAUDE.md, que um agente de programação lê no início de uma sessão para aprender os comandos, as convenções e as regras do projeto.
- Sandbox de agente
- Um sandbox de agente é um ambiente isolado, como um contêiner, uma máquina virtual ou uma restrição do sistema operacional, em que um agente de IA executa código e comandos sem conseguir alcançar arquivos, redes ou dados fora de limites definidos.