Toda sessão do Claude Code começa do zero. Ele não sabe quem você é, qual é o seu negócio, qual é o seu tom. Para o Claude, você é um estranho aparecendo pela primeira vez. O CLAUDE.md resolve isso. Mas saber o que vai em cada arquivo e como escrever instruções que o Claude realmente executa é o que separa quem usa a ferramenta com precisão de quem fica repetindo contexto toda hora.
O problema real: memória zerada a cada sessão
Imagine um funcionário que perde toda a memória durante a noite. Todo dia de manhã, você precisa sentar com ele e explicar: meu nome é Wellington, tenho um canal chamado EstrategiandoAI, meu público é empreendedor, meu tom de voz é direto e estratégico.
É exatamente isso que acontece sem o CLAUDE.md. Cada nova sessão, memória zerada. O Claude não sabe quem você é, qual é o seu negócio, qual é o tom que você usa. Você explica. Gasta token. Recebe resultado genérico.
O CLAUDE.md é o documento que o Claude Code lê automaticamente ao iniciar cada sessão. Você escreve uma vez. Ele aplica para sempre.
Os dois arquivos que compõem o sistema
Existem dois tipos de CLAUDE.md: o global e o do projeto. Parecem iguais. Funcionam de formas completamente diferentes. Confundir os dois é um dos erros mais comuns de quem está começando.
CLAUDE.md Global — carregado em toda sessão, em qualquer projeto
O arquivo global fica dentro da pasta do sistema do seu
computador. No Windows:
C:\Users\SeuNome\.claude\CLAUDE.md. No Mac:
~/.claude/CLAUDE.md.
Toda vez que você abre qualquer projeto no Claude Code, esse arquivo é carregado. Não importa se é o projeto A, B ou C. O CLAUDE.md Global está sempre presente, em toda sessão.
O que vai aqui: identidade base. Quem você é, qual é o seu negócio, seu tom de voz, suas frases-âncora, suas regras que valem em qualquer contexto e em qualquer projeto.
CLAUDE.md do Projeto — contexto específico de cada trabalho
O arquivo do projeto fica dentro da pasta do projeto, em
.claude/CLAUDE.md. Ele só é carregado quando você
abre aquele projeto específico.
Se você trabalha com três clientes diferentes, cada projeto tem o seu CLAUDE.md. Com as regras, paletas, padrões e decisões que valem só para aquele trabalho. O que era do cliente A não aparece quando você está no projeto do cliente B.
O que vai aqui: contexto local. Estrutura de pastas, padrão de arquivos, regras específicas do projeto, informações do cliente, decisões técnicas que pertencem só àquele trabalho.
| Global | Projeto | |
|---|---|---|
| Onde fica | C:\Users\SeuNome\.claude\ |
Dentro da pasta do projeto |
| Quando carrega | Em toda sessão, qualquer projeto | Só naquele projeto específico |
| O que vai aqui | Identidade, tom, regras gerais | Contexto local, padrões do projeto |
| Exemplo | Quem é Wellington, tom de voz, frases-âncora | Paleta de cores do cliente, estrutura de pastas |
A diferença que mais gente ignora: instrução fraca vs instrução imperativa
Você pode ter o CLAUDE.md mais completo do mundo. Se as instruções forem fracas, o Claude não executa: ele interpreta. E interpretação gera falha.
"Carregue a Copy Mestra em sessões que envolverem conteúdo de estratégia."
"Ao iniciar qualquer sessão, leia imediatamente o arquivo [caminho completo]. Sem exceção."
No CLAUDE.md, toda instrução crítica precisa ser imperativa. Dar margem para interpretação é dar margem para erro. Não é questão de sorte: é questão de como a instrução foi escrita.
A regra prática: se a instrução pode ser lida de mais de uma forma, ela está errada. Reescreva até não sobrar margem para interpretação.
A Copy Mestra separada — por que não vai no CLAUDE.md
O CLAUDE.md é um arquivo de regras fixas. O que está lá, está lá. Você não edita toda semana.
A Copy Mestra é um documento vivo. Tom de voz, posicionamento, frases-âncora, dores do público, exemplos de linguagem. Essas informações evoluem com o negócio. Atualizam conforme você refina o que funciona e descarta o que não funciona.
Manter os dois separados é uma decisão intencional. O CLAUDE.md aponta para onde está a Copy Mestra com uma instrução imperativa para lê-la ao iniciar. A Copy Mestra vive no seu próprio arquivo e pode ser editada sem tocar nas regras do sistema.
Você edita em um único lugar. O Claude sempre acessa a versão mais recente. Sem duplicidade. Sem risco de desatualizar um dos dois.
Não importa o prompt. O que importa é o conteúdo que você envia para a IA. Wellington Luiz
CLAUDE.md economiza token, não gasta
Existe um mito comum: o CLAUDE.md consome mais token porque carrega mais informação logo no início da sessão.
O raciocínio está invertido.
Sem CLAUDE.md, você gasta token dentro da conversa explicando quem você é, qual é o tom, o que você resolve, como você escreve. Esse custo se repete a cada mensagem nova. Quanto mais longa a conversa, mais token vai sendo consumido para manter o contexto que você não documentou.
Com o CLAUDE.md, o contexto entra uma vez no início da sessão. Custo fixo, previsível, pequeno. O resto da conversa já começa com tudo que o Claude precisa saber — sem repetição, sem reexplicação.
- Sem CLAUDE.md: custo variável e crescente — você explica o contexto dentro da conversa toda vez
- Com CLAUDE.md + Copy Mestra: custo fixo mínimo no início — a conversa inteira já parte do contexto correto
Uma Copy Mestra de qualidade com instrução imperativa no CLAUDE.md reduz o consumo de token de forma expressiva em conversas longas. O custo fixo substitui o custo variável.
O erro que apaga tudo: usar o terminal errado
Quando você abre o Claude Code pelo PowerShell ou terminal avulso do sistema, os arquivos são salvos na raiz do computador, não dentro do projeto.
Na próxima sessão, pelo aplicativo desktop ou pelo VS Code, você não encontra nada. Os arquivos existem, mas estão no lugar errado. Tudo que você construiu naquela sessão está perdido para o projeto.
Abra o Claude Code sempre pelo aplicativo desktop ou pela IDE. Nunca pelo terminal avulso.
Leitura complementar · Claude Claude AI e Claude Code: o ecossistema Anthropic na práticaSe você usa Claude Code e ainda não tem um CLAUDE.md configurado, você está pagando mais e recebendo menos. Com o arquivo certo, a instrução certa e a Copy Mestra apontada, cada sessão começa com o Claude já sabendo tudo que precisa. Sem repetição. Sem contexto jogado fora.
Se você quer entender como montar esse sistema dentro da sua operação, o próximo passo é um Diagnóstico Estratégico. Em 45 minutos, você sai com clareza sobre onde sua operação trava e qual é o primeiro passo para construir um sistema que trabalha com você.
