Como funciona:
O Claude Code lê o arquivo CLAUDE.md da pasta do projeto no começo de toda sessão. O que está ali vale como instrução permanente — sem você repetir.
1
Peça pro próprio assistente criar
>_ Gerar o CLAUDE.md do projeto
Analisa esta pasta e cria um CLAUDE.md com: (1) o que é este projeto em 2 linhas; (2) como as pastas se organizam; (3) as convenções que você percebeu no que já existe; (4) o que NUNCA fazer aqui sem me perguntar. Curto e direto — máximo 40 linhas.
2
Corte o excesso
Arquivo de contexto não é manual
- ·Fica: regra que muda decisão (padrão de nome, comando de build, o que não tocar).
- ·Sai: histórico, justificativa longa, tudo que a IA descobre sozinha lendo o código.
- ·Teste prático: se apagar a linha e nada muda no comportamento, a linha sobra.
O erro clássico:
CLAUDE.md gigante. Contexto demais custa token em toda sessão e enterra as regras importantes. Menos de 60 linhas é um bom teto.
3
Atualize quando corrigir
Corrigiu o assistente duas vezes pelo mesmo motivo? Vira linha no CLAUDE.md. É assim que o projeto aprende.
// Depois de corrigir uma resposta
Adiciona no CLAUDE.md: relatórios deste projeto sempre em português, valores em R$.A regra passa a valer em toda sessão futura, sem repetir.