Arquivo CLAUDE.md: o que é, onde fica e 3 modelos prontos

Um arquivo CLAUDE.md é um arquivo de texto simples em Markdown que o Claude Code lê no início de toda sessão, para você anotar suas regras, contexto e preferências uma vez só, em vez de repetir em cada conversa. Coloque na pasta principal de um projeto para as regras daquele projeto, ou em ~/.claude/CLAUDE.md para regras que valem para tudo o que você faz. O Claude trata o arquivo como orientação, não como configuração rígida, então instruções curtas e específicas funcionam melhor.

Markdown é só texto com alguns símbolos para dar estrutura: # começa um título e - começa um item de lista. Você não precisa de mais nada para escrever um bom CLAUDE.md.

Como o CLAUDE.md funciona

Toda sessão do Claude Code começa com a memória zerada. Duas coisas levam conhecimento de uma sessão para a próxima: arquivos CLAUDE.md que você escreve e notas de auto memory que o Claude escreve para si mesmo.

Os dois são contexto, não configurações obrigatórias: o Claude lê e tenta seguir, como explica a documentação de memória da Anthropic. Para bloquear algo de qualquer jeito, use uma regra de permissão, que aparece mais adiante.

Onde ficam os arquivos CLAUDE.md

~ significa a sua pasta de usuário (%USERPROFILE% no Windows), e ./ significa a pasta principal do seu projeto.

O Claude Code carrega o CLAUDE.md da pasta em que você o inicia e de todas as pastas acima dela, e os arquivos se somam em vez de se substituírem. Um CLAUDE.md dentro de uma subpasta só carrega quando o Claude começa a trabalhar com arquivos daquela subpasta.

Como o arquivo mais específico é lido por último, uma regra do projeto fica mais perto do trabalho. Mesmo assim, evite contradizer seu arquivo pessoal, porque quando duas regras entram em conflito o Claude pode seguir qualquer uma delas.

Como criar um

1. Abra a pasta do projeto no Claude Code. No terminal, entre na pasta e rode claude; no app desktop, use a aba Code e Select folder.
2. Rode /init. O Claude olha a pasta e escreve um CLAUDE.md inicial. Se já existir um, ele sugere melhorias em vez de sobrescrever.
3. Ou deixe o Claude te entrevistar. Para uma pasta ainda quase vazia, o prompt abaixo dá resultados melhores que o /init.
4. Edite. O /memory lista seus arquivos CLAUDE.md e abre um deles no seu editor, ou você pode simplesmente dizer "adicione esta regra ao CLAUDE.md".
5. Recarregue. O arquivo é lido no início da sessão, então rode /clear ou comece uma nova sessão depois de editar; a página de prompt caching da Anthropic explica por que edições no meio da sessão esperam.
6. Confira se carregou. Rode /context e procure o arquivo em Memory files.

Quero um CLAUDE.md para esta pasta. Me faça até 8 perguntas, uma de cada vez, sobre o meu negócio, para quem é o trabalho, meu tom de voz, as regras que eu sempre quero seguidas e o que "pronto" significa para mim. Depois escreva um CLAUDE.md com menos de 60 linhas e títulos claros, e me mostre antes de salvar.

O que colocar nele, e o que deixar de fora

Trate o CLAUDE.md como o lugar das coisas que você teria que explicar de novo. Um bom sinal para uma nova linha é o Claude cometer o mesmo erro duas vezes, ou você digitar a mesma correção da semana passada.

Se as suas regras já estão em outro arquivo, puxe com um import @, como @brand/voice.md, em vez de copiar. Arquivos importados também carregam no início, então imports deixam tudo organizado mas não deixam o arquivo mais leve.

Três modelos prontos para copiar

Troque tudo o que está entre colchetes, apague o que não se aplica e mantenha o resultado curto. Cada um é um ponto de partida para enxugar depois de uma semana de uso real.

Modelo 1: dono de negócio

Salve como ~/.claude/CLAUDE.md para valer em tudo, ou como CLAUDE.md na pasta que você usa para o trabalho administrativo.

# Sobre mim e o meu negócio
- Eu tenho a [NOME DO NEGÓCIO], um(a) [TIPO DE NEGÓCIO] em [CIDADE OU MERCADO].
- Os clientes são [QUEM SÃO]. Principais produtos ou serviços: [LISTA].
- Não sou desenvolvedor. Explique qualquer coisa técnica em uma frase simples.

# Como trabalhar comigo
- Me faça perguntas antes de começar qualquer coisa que leve mais do que alguns passos.
- Me mostre um plano curto antes de mudar mais de 3 arquivos.
- Responda em [IDIOMA], em parágrafos curtos, sem jargão.

# Regras que sempre valem
- Nunca envie e-mails, mensagens ou pagamentos. Prepare rascunhos para eu enviar.
- Nunca apague arquivos. Mova o que quiser remover para uma pasta chamada _trash.
- Nunca invente números, preços ou fatos. Se faltar algo, me pergunte.
- A moeda é [MOEDA]. As datas são escritas [FORMATO DE DATA].

# Arquivos e pastas
- Documentos recebidos ficam em /inbox. Trabalho pronto vai para /output.
- Nomeie os arquivos como AAAA-MM-DD_assunto.

# Quando terminar uma tarefa
- Liste o que você mudou, o que não conseguiu fazer e qualquer coisa de que não teve certeza.

# Compact instructions
Ao compactar, mantenha a lista de arquivos alterados e as perguntas em aberto.

A última seção usa um recurso da documentação da Anthropic: um título "Compact instructions" diz ao Claude o que manter quando ele resume uma conversa longa.

Modelo 2: profissional de marketing

Salve como CLAUDE.md na sua pasta de marketing. Para fluxos completos de marketing que usam esse arquivo, veja Claude Code para profissionais de marketing.

# Marca
- Marca: [NOME DA MARCA]. Vendemos [OFERTA] para [PÚBLICO].
- Voz: [TRÊS ADJETIVOS]. Soamos como [EXEMPLO], nunca como [ANTIEXEMPLO].
- Palavras que nunca usamos: [LISTA].
- Ortografia: português do [BRASIL OU PORTUGAL].

# Fatos e afirmações
- Use só os fatos de /brand/facts.md e dos arquivos que eu te passar.
- Toda estatística precisa de um link de fonte. Se não encontrar, deixe o número de fora.
- Não cite concorrentes a menos que eu peça.

# Canais e formatos
- LinkedIn: menos de [NÚMERO] palavras, uma ideia por post.
- E-mail: assunto com menos de [NÚMERO] caracteres, uma chamada para ação.
- Legendas do Instagram: o gancho vai na primeira linha, menos de [NÚMERO] palavras no total.

# Arquivos
- Briefings ficam em /briefs. Rascunhos vão para /drafts, um arquivo por peça, nomeado canal_assunto_data.

# Antes de dizer que terminou
- Confira cada afirmação com os arquivos de origem e liste o que não tiver respaldo.

Modelo 3: projeto de site

Salve como CLAUDE.md na pasta principal do site. O guia de como criar um site com IA mostra um projeto completo que combina bem com ele.

# Projeto
- Site da [NOME DO NEGÓCIO]: [PARA QUE SERVE O SITE].
- A única ação que queremos dos visitantes: [POR EXEMPLO, AGENDAR UMA CONVERSA].
- Feito com [STACK, POR EXEMPLO HTML E CSS PUROS]. Hospedado em [HOSPEDAGEM].

# Comandos
- Pré-visualizar localmente: [COMANDO]
- Checar antes de publicar: [COMANDO]

# Regras de design
- Cores: [CÓDIGOS HEX]. Fontes: [FONTES]. Mantenha bastante espaço em branco.
- Mobile primeiro: confira cada mudança na largura de celular antes de dizer que está pronta.
- Toda imagem precisa de texto alternativo. Botões dizem o que acontece depois ("Agendar conversa", não "Enviar").

# Regras de conteúdo
- Use só os textos de /content e fatos que eu confirmar. Nada de avaliações, números ou logos inventados.
- Toda página precisa do próprio título e da própria meta description.

# Não faça
- Não adicione bibliotecas, plugins ou serviços novos sem me perguntar.
- Não mude configurações de domínio, DNS ou hospedagem.

# Pronto significa
- O comando de checagem passa, a página funciona na largura de celular e você lista o que mudou.

Quando o CLAUDE.md não basta

O guia para criar uma skill do Claude mostra como transformar um procedimento em skill. Para regras deny, o guia de permissões da Anthropic tem a sintaxe, e nossa cola do Claude Code inclui um arquivo de configurações inicial.

Manter o CLAUDE.md enxuto também economiza uso, porque ele carrega em toda sessão. O guia de limites de uso do Claude Code explica o quanto o tamanho do seu contexto importa.

Quando o Claude ignora seu CLAUDE.md

• Ele nunca carregou. Rode /context e procure o arquivo em Memory files; se não estiver lá, está na pasta errada.
• Você editou no meio da sessão. Rode /clear ou comece uma nova sessão para a nova versão carregar.
• Está longo ou vago demais. Corte o que o Claude já faz sozinho e reescreva regras vagas como regras verificáveis.
• Duas regras conflitam. Olhe seu arquivo pessoal, o arquivo do projeto e os arquivos das subpastas, e apague uma delas.
• Precisa ser uma regra rígida. Passe para uma regra de permissão ou um hook.

O que fazer agora

Abra a pasta de projeto que você mais usa, rode /init ou o prompt de entrevista, e mantenha o resultado abaixo de 60 linhas na primeira semana. Cada vez que corrigir o Claude, pergunte se essa correção pertence ao arquivo, e remova o que o Claude já faz sozinho. O tutorial para iniciantes mostra o CLAUDE.md funcionando num projeto real, e o curso de Claude Code tem uma aula dedicada ao arquivo CLAUDE.md, seguida de skills e MCP.