CLAUDE.md: o arquivo que entra em toda conversa, e o que cabe nele
Ele carrega inteiro toda vez que você abre uma sessão. Saber o que colocar e o que tirar é a diferença entre contexto útil e token gasto à toa.
O que você vai aprender
- Por que dividir o arquivo em imports não economiza contexto nenhum
- Os quatro lugares onde ele pode viver, e em que ordem são lidos
- O critério oficial do que tirar do arquivo — e para onde mover
Uma prévia do material
O CLAUDE.md é um arquivo de texto com as instruções que você não quer repetir. Como
nomear as coisas, qual comando roda o teste, o que nunca mexer.
A frase que muda tudo está na documentação oficial: ele é carregado no contexto no começo de toda sessão, consumindo tokens junto com a sua conversa. Não é sob demanda, não é quando precisa. É sempre, inteiro, antes de você digitar a primeira palavra.
Então cada linha que você acrescenta é uma linha que ele relê em toda conversa nova pelo resto do projeto. É por isso que arquivo inchado não é só desorganização — é custo fixo. E é por isso que a doc recomenda menos de 200 linhas, dizendo o motivo na mesma frase: arquivo mais longo consome mais contexto e reduz a adesão às instruções.