CLAUDE.md e o arquivo que define como o Claude entende seu projeto. Um arquivo bem escrito significa menos correcoes, codigo melhor e agentes que realmente sabem no que estao trabalhando.
Este guia percorre cada secao de um arquivo CLAUDE.md, desde declaracoes de stack tecnico ate instrucoes especificas por agente. Acompanhe passo a passo e construa o seu.
CLAUDE.md e um arquivo markdown que voce coloca na raiz do seu projeto. Quando o Claude Code inicia uma sessao, ele le esse arquivo primeiro. Tudo que esta nele se torna parte do contexto do Claude: seu stack tecnico, sua estrutura de arquivos, as convencoes da sua equipe e qualquer instrucao que voce queira que cada agente siga.
Pense nele como um documento de briefing. Sem ele, o Claude precisa adivinhar como seu projeto esta organizado. Com um bom CLAUDE.md, o Claude ja sabe onde as coisas ficam, quais padroes seguir e o que evitar. A diferenca na qualidade dos resultados e significativa.
“Investir 10 minutos no CLAUDE.md economiza horas corrigindo codigo gerado por IA que nao corresponde aos padroes do seu projeto.”
Observado em centenas de projetos Claude Code
A estrutura e a especificidade do seu CLAUDE.md impactam diretamente na qualidade do trabalho do Claude na sua codebase.
Um CLAUDE.md bem estruturado cobre essas seis areas. Cada uma fornece ao Claude informacoes concretas que ele pode usar imediatamente.
Liste seus frameworks, bibliotecas e versoes de forma explicita. Inclua seu gerenciador de pacotes, versao do Node e quaisquer requisitos de execucao. O Claude usa isso para gerar codigo compativel sem adivinhar.
Descreva seus diretorios principais e o que cada um contem. Componentes, stores, servicos, rotas de API, tipos. Um diagrama de arvore curto com uma linha de descricao por pasta funciona bem.
Documente seus padroes de nomenclatura (camelCase para arquivos, PascalCase para componentes), sua abordagem de tratamento de erros, a ordem dos imports e qualquer regra especifica do projeto. Isso mantem a saida do Claude consistente com seu codigo existente.
Inclua seus comandos de dev, build, test e lint. Quando o Claude precisar verificar que algo funciona ou sugerir um script, ele usara exatamente os comandos que seu projeto espera.
Se voce usa varios agentes (QA, frontend, backend, DevOps), adicione uma secao descrevendo o foco de cada papel. Isso e especialmente util com a configuracao multi-agente do AgentsRoom.
Diga ao Claude o que NAO fazer. Nao modificar arquivos de configuracao, nao mexer no sistema de autenticacao, nao refatorar a camada de banco de dados. Limites explicitos impedem que os agentes facam mudancas indesejadas.
Nao precisa escrever tudo de uma vez. Comece pelo basico e expanda conforme voce descobre o que o Claude precisa saber.
Abra seu package.json e liste cada framework, biblioteca e ferramenta que seu projeto usa. Anote as versoes. Verifique os requisitos de execucao (versao do Node, versao do Python, banco de dados). Isso se torna sua secao de stack tecnico.
package.json + versoes runtime + banco de dados
Execute um tree rapido do seu diretorio src. Identifique as pastas de primeiro nivel e escreva uma descricao de uma linha para cada uma. Foque em onde ficam os componentes, stores, servicos, tipos e rotas de API.
Arvore src/ com anotacoes de proposito
Observe seu codigo existente e anote os padroes: como voce nomeia arquivos, como trata erros, como estrutura imports, se usa exports padrao ou nomeados. Escreva-os como regras curtas.
Nomenclatura, imports, tratamento de erros, exports
Se voce trabalha com agentes especializados, adicione areas de foco para cada papel. O agente frontend deve conhecer sua biblioteca de componentes. O agente DevOps deve conhecer seu pipeline de deploy. O agente QA deve conhecer seu framework de testes.
Areas de foco + areas a evitar por papel
AgentsRoom foi construido com o CLAUDE.md como conceito central, nao como algo secundario.
Edite seu CLAUDE.md diretamente no AgentsRoom com destaque de sintaxe e salvamento em tempo real. Sem precisar trocar para seu editor de texto ou IDE.
Veja como cada agente interpreta seu CLAUDE.md em tempo real. Observe a saida do terminal para verificar que os agentes seguem suas convencoes e respeitam suas areas a evitar.
Cada projeto no AgentsRoom tem seu proprio CLAUDE.md. Alterne entre projetos e cada agente carrega automaticamente o arquivo de contexto correto para aquela codebase.
Os 14 papeis de agentes do AgentsRoom se combinam diretamente com as secoes do CLAUDE.md. Defina areas de foco e areas a evitar por papel, e cada agente pega exatamente as instrucoes destinadas a ele.
Baixe o AgentsRoom e use o editor CLAUDE.md integrado para dar aos seus agentes o contexto que precisam. Melhores instrucoes, codigo melhor.
Baixar AgentsRoomGratis para sempre. Traga sua propria API key.