📄 O que e o CLAUDE.md
O CLAUDE.md e um arquivo Markdown que fica na raiz do seu projeto e funciona como um "manual de instrucoes" para o Claude Code. Ele contem informacoes sobre o projeto, convencoes de codigo, comandos disponiveis e regras que o Claude deve seguir ao trabalhar no seu codigo.
💡 Conceito Principal
Pense no CLAUDE.md como o onboarding de um novo desenvolvedor. Assim como voce explicaria para um colega novo como o projeto funciona, o CLAUDE.md faz o mesmo para o Claude Code.
- •E um arquivo de texto simples no formato Markdown
- •Fica versionado junto com o codigo no repositorio
- •E lido automaticamente pelo Claude Code ao iniciar uma sessao
⚡ Dica Pratica
Crie o arquivo CLAUDE.md na raiz do seu projeto hoje mesmo, mesmo que comece com apenas 5 linhas. Um CLAUDE.md basico ja e melhor do que nenhum.
🤔 Por que o CLAUDE.md Existe
Sem o CLAUDE.md, o Claude Code precisa adivinhar como seu projeto funciona. Ele nao sabe quais frameworks voce usa, quais convencoes de codigo seguir, ou como rodar testes. O CLAUDE.md resolve isso fornecendo contexto explicitamente.
💡 Conceito Principal
O problema fundamental e que o Claude Code e poderoso, mas generico. Ele conhece milhares de frameworks e padroes, mas nao sabe qual o SEU projeto usa. O CLAUDE.md transforma o Claude de um assistente generico em um especialista no seu projeto.
- •Elimina respostas genericas - o Claude segue SUAS convencoes
- •Reduz erros - o Claude sabe o que evitar no seu projeto
- •Acelera o trabalho - menos correcoes manuais necessarias
⚡ Dica Pratica
Se voce ja corrigiu o Claude Code mais de uma vez sobre a mesma coisa (ex: "use Tailwind, nao CSS puro"), isso deveria estar no seu CLAUDE.md. Cada correcao repetida e um sinal de que falta informacao no arquivo.
🧠 Conceito de Memoria de Projeto
O CLAUDE.md funciona como a memoria persistente do Claude Code entre sessoes. Diferente do historico de conversa que se perde, o CLAUDE.md permanece e e carregado automaticamente toda vez que voce inicia o Claude Code no diretorio do projeto.
💡 Conceito Principal
Cada sessao do Claude Code e independente - ele nao lembra o que voce conversou ontem. O CLAUDE.md e a solucao para isso: um arquivo que persiste entre sessoes e garante que o Claude sempre tenha o contexto necessario.
- •Sessoes sao efemeras, mas o CLAUDE.md e permanente
- •Funciona como a "memoria de longo prazo" do Claude no seu projeto
- •Toda a equipe compartilha o mesmo contexto via controle de versao
⚡ Dica Pratica
Apos uma sessao produtiva onde voce ensinou algo novo ao Claude, adicione essa informacao ao CLAUDE.md antes de fechar. Assim, na proxima sessao, ele ja vai saber.
📖 Quando o Claude Le o CLAUDE.md
O Claude Code le o CLAUDE.md automaticamente no inicio de cada conversa. Voce nao precisa pedir para ele ler - o conteudo do arquivo e carregado como parte do system prompt, antes mesmo da sua primeira mensagem.
💡 Conceito Principal
O mecanismo de leitura e automatico e hierarquico. O Claude busca arquivos CLAUDE.md em varios niveis e combina todos eles para formar o contexto completo.
- •Leitura automatica ao iniciar
claudeem qualquer diretorio do projeto - •O conteudo entra no contexto como instrucoes de alto nivel
- •Alteracoes no arquivo durante a sessao nao sao relidas automaticamente
⚡ Dica Pratica
Se voce editar o CLAUDE.md durante uma sessao, inicie uma nova conversa com /clear para que as alteracoes sejam carregadas. O Claude nao rele o arquivo automaticamente no meio de uma sessao.
🎯 Beneficios Concretos
Usar o CLAUDE.md traz beneficios mensuráveis no dia a dia. A diferenca entre um projeto com e sem CLAUDE.md e como a diferenca entre um GPS com e sem o endereco de destino - ambos funcionam, mas um chega la muito mais rapido.
💡 Conceito Principal
Os beneficios se acumulam com o tempo. Quanto mais detalhado e atualizado o CLAUDE.md, melhores sao os resultados em cada sessao.
- •Consistencia - Todo codigo gerado segue os mesmos padroes
- •Velocidade - Menos tempo corrigindo e mais tempo construindo
- •Colaboracao - Todos na equipe tem o mesmo Claude "treinado"
⚡ Dica Pratica
Faca um teste A/B: use o Claude Code em um projeto sem CLAUDE.md e depois adicione um. Compare a qualidade das respostas. Voce vai notar a diferenca ja na primeira interacao.
🚀 Primeiros Passos
Comecar com o CLAUDE.md e simples. Voce pode criar um manualmente ou usar o comando /init do Claude Code para gerar um automaticamente. O importante e comecar - voce pode refinar depois.
💡 Conceito Principal
A abordagem recomendada e iterativa: comece com o basico e va adicionando informacoes conforme voce percebe que o Claude precisa delas.
- •Crie o arquivo
CLAUDE.mdna raiz do projeto - •Comece com: nome do projeto, stack principal e 3 convencoes
- •Va adicionando regras conforme corrige o Claude repetidamente
⚡ Dica Pratica
Use o comando /init dentro do Claude Code para gerar um CLAUDE.md inicial baseado na analise automatica do seu projeto. Depois, personalize com as suas preferencias.
📋 Resumo do Modulo
Proximo Modulo:
2.2 - Anatomia do CLAUDE.md Perfeito