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 ficheiro CLAUDE.md na raiz do repositório resolve exatamente isso: ele é carregado automaticamente no

É como um bilhete de regras da casa colado na geladeira de um apartamento partilhado — 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 ficheiro 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 ficheiros 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.