Pular para o conteúdo principal

CLAUDE.md e arquivos de memória

Iniciante

Se você fizer uma coisa para melhorar o Claude Code, faça esta. O CLAUDE.md é um arquivo de texto simples que o Claude lê no início de cada sessão — o briefing permanente do seu projeto.

What you'll learn
  • Por que o CLAUDE.md é a configuração de maior alavancagem do Claude Code
  • Como a hierarquia de memória se mescla do global ao específico do projeto
  • Como gerar um arquivo inicial com /init e enxugá-lo
  • O que vai no CLAUDE.md — e o que deixar de fora
  • Como as @imports permitem referenciar documentos sem duplicá-los

Por que é a configuração de maior alavancagem​

Sem ele, você reexplica seu projeto a cada sessão ("usamos pnpm, os testes ficam em __tests__, não mexa em /generated…"). Com ele, o Claude já sabe. Boas instruções aqui melhoram todas as interações futuras de uma só vez.

A hierarquia de memória​

O Claude Code lê a memória de vários lugares e os mescla, aproximadamente do mais global ao mais específico:

  • Memória de usuário — suas preferências pessoais em todos os projetos.
  • Memória de projeto (./CLAUDE.md, versionada) — como este repositório funciona. Compartilhada com sua equipe.
  • Aninhada — coloque um CLAUDE.md em uma subpasta para regras que se aplicam apenas ali.
Conheça suas camadas de memória
Pressione Enter ou Espaço para virar o cartão. Use as setas esquerda e direita para navegar entre os cartões.Termo exibido.
1 / 4

Gere um ponto de partida​

Guided walkthrough1 of 3
  1. O Claude inspeciona o código e esboça um CLAUDE.md para você automaticamente.

Gerar um rascunho de CLAUDE.md

/init

Pegue um modelo pronto em Modelos de CLAUDE.md.

O que colocar nele​

  • O que é o projeto, em duas frases.
  • A stack tecnológica e como executar / testar / fazer lint.
  • Convenções que o Claude não consegue inferir (nomenclatura, estrutura, estilo de commit).
  • Proteções: "execute os testes antes de declarar concluído", "nunca edite /vendor", "nunca faça commit de segredos".

O que NÃO colocar nele​

Watch out
  • O Claude segue o CLAUDE.md literalmente — instruções desatualizadas, vagas ou idealizadas prejudicam ativamente.
  • Descreva como o projeto realmente funciona hoje; curto e verdadeiro vence longo e aspiracional.
  • Evite documentos gigantes colados (use @imports em vez disso), segredos e regras que você não segue de fato.
  • Revise-o periodicamente para que continue preciso à medida que o projeto evolui.

Importações​

Traga documentos existentes em vez de duplicá-los — por exemplo, referencie seu guia de estilo com uma importação @path/to/file para que haja uma única fonte da verdade. Veja a documentação oficial de memória para a sintaxe exata.

Pro tip
  • Uma única fonte da verdade: referencie um arquivo com @imports em vez de colar o conteúdo dele no CLAUDE.md.
  • Se um documento já existe, faça um link para ele — não o copie. Cópias ficam desatualizadas.

Teste seus conhecimentos​

Teste seus conhecimentos

0/3
  1. Qual arquivo o Claude Code lê no início de cada sessão como o briefing permanente do seu projeto?
  2. O que executar /init faz em um projeto?
  3. Qual é a maneira recomendada de incluir um documento grande já existente, como um guia de estilo?
Key takeaways
  • O CLAUDE.md é a configuração de maior alavancagem: melhora todas as sessões futuras de uma só vez.
  • A memória se mescla do global ao específico: política empresarial, depois arquivos CLAUDE.md de usuário, de projeto e aninhados.
  • Comece com /init, depois enxugue o rascunho para o que é de fato verdadeiro.
  • Inclua o resumo do projeto, os comandos de executar/testar/lint, as convenções e as proteções.
  • Mantenha-o curto e verdadeiro — use @imports para documentos grandes e nunca faça commit de segredos.

Próximos passos​