Hooks para automação
Até agora, toda regra de equipe — "rode o lint antes do commit", "rode os testes antes do push" — dependia da memória: alguém precisava lembrar de rodar isso toda vez, e sob pressão isso passava batido. Nesta aula vamos conhecer os Hooks: scripts que o Claude Code executa automaticamente em um event
Prédios têm detectores de fumaça que disparam sozinhos no instante em que há fumaça, sem que ninguém precise lembrar de checar toda manhã. Da mesma forma, você pode configurar de antemão uma regra que dispara sozinha no momento certo, sem depender jamais da memória de ninguém.
- hook
- Um script ou comando de shell que o Claude Code executa automaticamente quando ocorre um evento predefinido no seu fluxo de trabalho, como PreToolUse ou SessionStart — sem depender jamais da memória do usuário.
- PreToolUse
- Um evento de hook que roda bem antes de o Claude Code realmente invocar uma determinada ferramenta (como Bash). Ele pode inspecionar a ação solicitada e até bloqueá-la antes que ela rode.
- código de saída 2 (bloqueio)
- Quando um script de hook termina com o código 2, o Claude Code bloqueia a ação que estava prestes a rodar e recebe de volta a mensagem de erro, para poder corrigir o problema e tentar de novo.
- SessionStart
- Um evento de hook que roda automaticamente uma vez no início de cada nova sessão — por exemplo, para carregar o status do git ou o contexto do projeto, sem que ninguém precise pedir isso.
