Hooks no Claude Code: o momento da ação muda o controle

Use PreToolUse quando sua checagem precisar atuar antes da ferramenta. Escolha o evento primeiro: em PostToolUse, a ação já aconteceu. A documentação de hooks do Claude Code explica esses pontos do ciclo como um recurso existente, sem anunciar aqui um novo lançamento.

Hooks associam eventos a comportamentos configurados. PreToolUse ocorre antes da chamada de ferramenta; PostToolUse trabalha depois de sua execução. A escolha do evento define quando uma checagem pode atuar. Um relatório posterior ajuda a detectar um problema, mas não deve ser apresentado como barreira preventiva.

A documentação oferece diferentes tipos de handler, incluindo comandos e mecanismos apoiados em modelos. Portanto, “usar hook” não significa necessariamente executar uma regra determinística. Para uma condição objetiva, como conferir uma propriedade conhecida, um comando apropriado pode ter comportamento mais previsível do que uma avaliação aberta por linguagem.

1. Escolha um evento e descreva a saída esperada da checagem.
2. Leia o comportamento documentado para falhas naquele evento antes de depender dele como bloqueio. Confira qual decisão o handler pode tomar nesse momento; um relatório posterior não transforma uma ação já executada em ação impedida.