CLAUDE.md e a configuração do projeto

Toda nova sessão do Claude Code começa do zero — o agente não lembra o que você explicou ontem sobre as convenções do projeto, qual comando roda os testes ou quais pastas estão fora dos limites. Um arquivo CLAUDE.md na raiz do repositório resolve exatamente isso: ele é carregado automaticamente no i

É como um bilhete de regras da casa colado na geladeira de um apartamento compartilhado — cada novo(a) colega de apartamento o lê uma vez e já conhece as regras, sem que ninguém precise repeti-las.

CLAUDE.md: Um arquivo de texto na raiz do repositório que o Claude Code carrega automaticamente no início de cada sessão, contendo as convenções, comandos e instruções duradouras do projeto.
raiz do repositório: O diretório base de um projeto — onde ficam .git e package.json, e o lugar em que o Claude Code procura os arquivos de configuração.
contexto da sessão: Todas as informações que o agente 'vê' no início de uma determinada sessão — incluindo o conteúdo do CLAUDE.md, que é carregado uma única vez, logo no começo.