7. CLAUDE.md

Não é uma instalação, mas é a primeira coisa a configurar em qualquer projeto. O CLAUDE.md é a memória persistente — o Claude lê automaticamente para entender seu projeto.

Onde colocar

Arquivo	Escopo	Uso típico
./CLAUDE.md	Projeto (raiz)	Arquitetura, stack, convenções
./.claude/CLAUDE.md	Projeto (oculto)	Mesmo, mas organizado dentro de .claude/
./CLAUDE.local.md	Pessoal	Preferências do dev, não commitado
~/.claude/CLAUDE.md	Global	Padrões pessoais para todos projetos

A pasta .claude/ deve ser commitada — ela contém configurações compartilhadas do time (settings, commands, CLAUDE.md). A convenção para separar o que é pessoal é o sufixo .local: arquivos como CLAUDE.local.md e settings.local.json ficam fora do versionamento.

O que colocar

• Descrição do projeto e stack
• Convenções de código (nomenclatura, imports, patterns)
• Comandos para rodar, buildar e testar
• Estrutura de diretórios
• Regras que o Claude deve sempre seguir

Templates prontos

Para facilitar a criação do seu CLAUDE.md, preparamos templates com estruturas testadas em projetos reais:

CLAUDE.md Global Regras universais para qualquer projeto. Salvar em ~/.claude/CLAUDE.md 53 linhas, 9 seções

CLAUDE.md Next.js Full-Stack Arquivo único com regras globais + projeto Next.js 171 linhas, 18 seções

CLAUDE.md Next.js (projeto) Regras específicas do projeto Next.js, requer CLAUDE global 100 linhas, 11 seções