Claude Code

CLAUDE.md é pedido, hook é regra

Por que eu tirei as regras importantes do arquivo de instruções e passei para hooks.

O problema

O agente leu. E ignorou.

Em tarefa longa, com contexto cheio, até o 'NUNCA edite o .env' escorrega.

A documentação diz

CLAUDE.md é contexto

Não é configuração obrigatória. Para bloquear algo sempre, a recomendação é um hook PreToolUse.

Como funciona

Hooks rodam em pontos fixos

PreToolUse antes da ação, PostToolUse depois, Stop quando o Claude termina, SessionStart no início.

Hook 1

Arquivos protegidos

PreToolUse em Edit|Write: .env, lockfiles e migrations já aplicadas saem com exit 2.

Hook 2

Comandos proibidos

git push --force, DROP TABLE, produção: bloqueio com uma mensagem que orienta o agente.

Hook 3

Formatter a cada edição

PostToolUse roda Pint, Ruff ou Prettier. Erro de lint volta para o Claude corrigir na hora.

Hook 4

Sem 'pronto' com teste quebrado

Stop roda os testes se houve mudança. Checa stop_hook_active para não entrar em loop.

Armadilha nº 1

Exit 1 não bloqueia

Só o código 2 bloqueia. Hook que termina com exit 1 deixa a ação passar.

Por onde começar

Comece com dois hooks

Arquivos protegidos e formatter: menor atrito e maior retorno.

Artigo completo

Scripts prontos no artigo

Os hooks completos, as armadilhas e minha opinião. E mais IA na prática no Labs de IA.

Ler o artigo