Hooks

Hooks são comandos que o Claude Code executa automaticamente em pontos definidos do ciclo de vida — antes de usar uma ferramenta, depois de editar um arquivo, quando você envia um prompt, quando a sessão começa. A diferença para uma instrução no CLAUDE.md é a garantia: o CLAUDE.md pede algo ao modelo, que pode esquecer ou ignorar; o hook é código seu que sempre roda. É o mecanismo determinístico do Claude Code.

#Eventos

Cada hook se prende a um evento. Entre os disponíveis:

• PreToolUse — antes de o Claude executar uma ferramenta (pode bloquear a execução).
• PostToolUse — depois de uma ferramenta rodar com sucesso.
• UserPromptSubmit — quando você envia um prompt, antes de o Claude processá-lo.
• SessionStart / SessionEnd — no início e no fim de uma sessão.
• Stop — quando o Claude termina de responder.
• SubagentStop — quando um subagent conclui.
• Notification — quando o Claude Code emite uma notificação (por exemplo, pedindo permissão).
• PreCompact — antes de compactar a janela de contexto.