Setup Completo: do zero ao Claude Code · Capítulo 14 de 18 · 20 min
Crie automações que disparam sempre (avançado, opcional)
Travas, registros de auditoria e avisos passam a acontecer em todo pedido, mesmo quando o modelo esquece.
Este capítulo faz parte do curso gratuito Setup Completo: do zero ao Claude Code.
Selo: Avançado (opcional). Pode pular sem culpa se estiver começando. O Claude Code funciona perfeitamente sem nenhum hook, e nada à frente depende deste passo.
Por que um executivo deveria olhar mesmo assim
Hooks são o mecanismo de governança e controle de qualidade do Claude Code. São regras que a própria ferramenta executa em momentos definidos, independentemente do que o modelo resolve fazer naquele instante. Pense em trilha de auditoria, trava de segurança e checagem obrigatória antes de uma ação sensível, o tipo de controle que uma área de risco exigiria de qualquer processo automatizado. Quem configura o primeiro costuma virar fã. Suponha um escritório de advocacia de duas pessoas: um hook que bloqueia apagar pastas protege os contratos mesmo quando alguém pede com pressa. A seguir, uma série de receitas prontas.
O que são, em uma analogia
Imagine que você contratou um motorista (o Claude). Hooks são instruções tipo "toda vez que você for sair da garagem, dê uma buzinada" ou "toda vez que estacionar, mande uma foto pelo WhatsApp". São automatismos disparados por momentos específicos do que o Claude faz.
Outra metáfora: hooks são os sensores da sua casa inteligente. Você não precisa lembrar de acender a luz quando entra no quarto (sensor de movimento faz), nem de fechar o portão (timer fecha sozinho), nem de avisar quem está na porta (campainha com câmera). Hooks são esses sensores aplicados ao seu trabalho com o Claude.
┌─────────────────────────────────────────────────────────────────┐ │ Claude Code — Hooks /exit │ ├─────────────────────────────────────────────────────────────────┤ │ │ │ Hooks ativos: │ │ ───────────────────────────────────────────────────── │ │ │ │ Stop (quando Claude termina uma resposta) │ │ └── [console]::Beep(880, 200) [×] │ │ │ │ PreToolUse (antes de Claude usar uma ferramenta) │ │ └── Bloqueio de rm -rf, Remove-Item -Recurse C:\, push --force │ │ [×]│ │ │ │ PostToolUse (depois de Claude usar uma ferramenta) │ │ └── Registra em audit.log: [data] <ferramenta> <ação> [×] │ │ │ │ [+ Adicionar novo hook] │ │ │ │ ← Assim fica depois de configurar os hooks deste módulo. │ └─────────────────────────────────────────────────────────────────┘
Qual a diferença para o CLAUDE.md?
- CLAUDE.md = preferências (o Claude lê e decide se segue), como um bilhetinho na geladeira.
- Hooks = automatismos forçados (acontece sempre, mesmo se o Claude esquecer), como uma fechadura com timer: à meia-noite a porta tranca, queira ela ou não.
Para coisas onde "esquecer" não é opção (segurança, backup, notificação), use hook. Para coisas onde tudo bem se ele relaxar de vez em quando (estilo, tom), use CLAUDE.md. De bônus, um hook não ocupa a memória de trabalho do modelo, a menos que devolva alguma mensagem, e pode disparar um script, um endereço na web ou até outro agente.
EVENTO QUANDO ACONTECE EXEMPLO DE HOOK ──────── ───────────────────── ───────────────────── PreToolUse Claude vai usar uma ferramenta "se for `Remove-Item -Recurse`, bloqueie" PostToolUse Claude usou uma ferramenta "faça backup do arquivo editado" Notification Claude vai pedir confirmação "toque sino para eu olhar" Stop Claude terminou uma resposta "diga 'pronto' em voz alta" Há outros eventos, como SessionStart (a sessão acabou de abrir), mas estes quatro cobrem as receitas deste passo.
Como configurar (sem precisar programar)
O Claude Code tem um menu visual para hooks. Para chegar nele
- 01Abra o Claude Code.
- 02Digite /hooks e aperte Enter.
- 03Vai aparecer um menu mostrando os tipos de hook que você pode criar.
- 04Escolha um (exemplo: Stop, "quando eu terminar uma tarefa").
- 05Diga ao Claude o que você quer que aconteça em português comum.
- 06O Claude monta o hook para você, mostra antes de salvar, e você confirma.
10 hooks de rotina prontos para você pedir ao Claude (cole o prompt abaixo dos exemplos)
1. Sino quando terminar. Metáfora: "campainha do micro-ondas". Você pede uma tarefa que vai demorar, vai fazer um café, e quando voltar quer ouvir um som dizendo que está pronto.
2. Toast no canto da tela. Metáfora: "recado na geladeira". Toda vez que o Claude termina, aparece uma notificaçãozinha tipo Windows 11.
3. Aviso de tarefa longa. Metáfora: "alarme do despertador". Se o Claude estiver trabalhando há mais de 2 minutos sem parar, ele te avisa que ainda está vivo.
4. Bloquear comandos perigosos. Metáfora: "trava de segurança da pistola". Mesmo o melhor profissional pode errar: o hook impede que Remove-Item -Recurse C:\ ou git push --force na main passem.
5. Backup automático antes de editar. Metáfora: "backup do OneDrive nos esteroides". Toda vez que o Claude vai editar um arquivo importante, ele faz uma cópia com timestamp na pasta %USERPROFILE%\claude-backups\.
6. Avisar antes de instalar pacote. Metáfora: "você confirma com o porteiro antes de receber entrega". Toda vez que o Claude tenta rodar npm install, pip install ou winget install, ele pergunta antes.
7. Log de tudo o que o Claude fez. Metáfora: "câmera do Uber". Cada ação do Claude vai parar num arquivo de log com data, hora e ferramenta, útil para revisar depois ou em auditoria.
8. Pomodoro automático. Metáfora: "sinal de fim de aula". A cada 25 minutos de uso do Claude, ele toca um som dizendo 'hora de levantar e tomar água'.
9. Anti-emoji. Metáfora: "corretor automático que apaga gírias antes de você enviar email pro chefe". Toda vez que o Claude tenta escrever emoji num arquivo, o hook avisa ou bloqueia.
10. Commit Git automático no fim do dia. Metáfora: "alarme de empregada que dobra a roupa antes de ir embora". Se o Claude terminou uma sessão e o repo está sujo, ele dispara um commit com mensagem 'WIP: progresso até <data>'.
CENÁRIO ONDE CONFIGURAR
──────────────────────────────────────────────────────────────────
"Quero respostas mais curtas" → CLAUDE.md
(preferência — Claude pode esquecer às vezes)
"Beep quando terminar" → Hook (Stop)
(automático, sempre, sem exceção)
"Não use emojis" → CLAUDE.md
(estilo e preferência pessoal)
"Bloqueie rm -rf de verdade" → Hook (PreToolUse)
(segurança — não pode depender de memória do Claude)
"Faça backup antes de editar" → Hook (PreToolUse)
(ação que deve acontecer SEMPRE, sem falha)
"Prefiro tabelas a listas" → CLAUDE.md
(preferência de formato de resposta)
Regra rápida: se "esquecer" é inaceitável → Hook.
se é apenas preferência → CLAUDE.md.Hooks executam de verdade comandos no seu computador. Antes de aceitar um hook que o Claude propôs, leia o que ele vai fazer. Se você não entendeu o comando, não aceite. Pergunte ao Claude "o que esse comando faz, em português?": ele explica. Hooks com Remove-Item, Invoke-WebRequest http*, redirecionamentos para $null ou comandos que mexem em arquivos fora da pasta do projeto merecem atenção redobrada.
Se você nunca configurar nenhum hook, está tudo certo. O sistema funciona perfeitamente sem eles. Volte neste módulo só quando sentir que está repetindo o mesmo lembrete várias vezes: esse é o sinal de que vale automatizar. Comece pelo Hook #1 (beep quando terminar), o mais simples e o mais útil no dia a dia.
Cole o prompt do Hook #1, confira o JSON que o Claude mostrar e aprove. Depois faça qualquer pergunta curta. Acertou se o Windows apita no instante em que a resposta termina, em todas as três perguntas seguintes. Apitou nas três? Guarde as outras receitas para quando um lembrete se repetir.
Seu caderno neste capítulo
Abrir o caderno completoSelecione um trecho do capítulo para destacar ou anotar. Nos vídeos e áudios, use Anotar este momento. No teclado, selecione com Shift e as setas e use Alt+Shift+D para destacar ou Alt+Shift+N para anotar.
Salvo neste navegador. Entre na sua conta para levar o caderno a outros aparelhos.
Entre na sua conta para compartilhar o que aprendeu e convidar alguém para estudar com você.
Conexões deste capítulo
Veja o que estudar antes e para onde seguir depois, explore os conceitos e compare abordagens em outros cursos. Sugestões marcadas como “sugerido pelo grafo” vêm dos assuntos em comum, não do índice do curso.
Estude antes
- Git vs GitHubsugerido pelo grafoApresenta o conceito “Git”, usado em “Crie automações que disparam sempre (avançado, opcional)”.
- CursoGitHub: Controle de Versão do Zerosugerido pelo grafo6 capítulos de “Setup Completo: do zero ao Claude Code” usam conceitos apresentados em “GitHub: Controle de Versão do Zero”.
Depois, siga para
- CursoClaude Code CLI: Programação com IA
- CursoAgentes de código para executivossugerido pelo grafoO Setup ensina permissões, contexto do projeto e escolha de modelo por custo. Essa preparação sustenta os exercícios de comparação de assistentes, criação do gerador de UTM e regras de projeto no curso de aprendizado por reforço e vibecoding.
- CursoSetup de Vibecoding no Macsugerido pelo grafo11 capítulos de “Setup de Vibecoding no Mac” usam conceitos apresentados em “Setup Completo: do zero ao Claude Code”.
- CursoVídeo com IA: Claude Code, Codex e ElevenLabssugerido pelo grafo7 capítulos de “Vídeo com IA: Claude Code, Codex e ElevenLabs” usam conceitos apresentados em “Setup Completo: do zero ao Claude Code”.
Conceitos deste capítulo
O mesmo assunto em outros cursos
- Setup de Vibecoding no MacHooks — automatizar coisas que devem acontecer sempre (opcional)Examinar conexões de Hooks — automatizar coisas que devem acontecer sempre (opcional)
- Claude Code CLI: Programação com IARevisar o plano antes de agir e ligar suas ferramentasExaminar conexões de Revisar o plano antes de agir e ligar suas ferramentas
- Vídeo com IA: Claude Code, Codex e ElevenLabsEstruturar o projeto de vídeo para o Claude Code operar sem improvisarExaminar conexões de Estruturar o projeto de vídeo para o Claude Code operar sem improvisar
- Skills de IA com Vibecoding e TerminalCLAUDE.md: A Constituição do ProjetoExaminar conexões de CLAUDE.md: A Constituição do Projeto
Voltar ao capítulo anterior: Deixe o Claude operar o seu Chrome (avançado, opcional)
Leve uma ideia para a prática
Escolha uma atividade no painel e volte a este curso quando quiser.
Atividades e evolução ficam reunidas no painel da sua conta.
Capítulos vizinhos em Setup Completo: do zero ao Claude Code
- 12Registre suas preferências uma vez para o Claude lembrar sempre
- 13Deixe o Claude operar o seu Chrome (avançado, opcional)
- 14Crie automações que disparam sempre (avançado, opcional)
- 15Divida tarefas grandes entre Claudes ajudantes (avançado, opcional)
- 16Publique sua página de apresentação profissional na internet