Claude Code CLI: Programação com IA · Capítulo 10 de 23 · 13 min
CLAUDE.md: o manual da sua operação
Aprenda a criar o arquivo CLAUDE.md para ensinar o Claude sobre seu projeto -- com exemplo real.
Este capítulo faz parte do curso gratuito Claude Code CLI: Programação com IA. Para marcar como concluído e salvar o progresso, abra este capítulo na página do curso.
Toda vez que você inicia o Claude Code em uma pasta, ele procura automaticamente por um arquivo chamado CLAUDE.md na raiz do projeto. Esse arquivo contém instruções que o Claude vai seguir em todas as conversas naquele projeto.
O CLAUDE.md é como um manual de instruções que você entrega ao assistente antes de começar a trabalhar. Em vez de repetir o contexto a cada conversa, você escreve uma vez e o Claude sempre lembra.
O que colocar no CLAUDE.md
- 01Qual é o projeto e para que serve.
- 02Qual a stack técnica (linguagens, frameworks, banco de dados).
- 03Estrutura de diretórios (onde fica cada coisa).
- 04Regras que o Claude deve seguir (idioma, padrões de código, convenções).
- 05Comandos úteis para rodar o projeto.
- 06Variáveis de ambiente necessárias.
- 07O que nunca fazer (proibições).
Exemplo real -- este é um trecho simplificado do CLAUDE.md que usamos no projeto Papers da Brasil GEO
# CLAUDE.md -- Papers (Brasil GEO)
## Projeto
Pesquisa empírica sobre citações de entidades em LLMs.
Stack: Python 3.11 + SQLite + Supabase.
## Estrutura
```
scripts/
geo_daily.py # Orquestrador diário
entity_checker.py # Verifica entidades em 5 plataformas
citation_monitor.py # Monitora citações em LLMs
fix_accents.py # Corrige acentuação PT-BR
data/
geo_metrics.db # Banco SQLite de métricas
```
## Regras
- Todo conteúdo em PT-BR com acentuação completa.
- Nunca "GEO Brasil" (correto: Brasil GEO).
- Nunca "Especialista #1" ou "Source Rank".
- Credencial: Chief Strategy Officer da Nuvini (Nasdaq: NVNI),
Founder da Brasil GEO, cofundador da NAIA e da AI Brasil.
## Comandos
- python geo_daily.py # Roda pipeline diário
- python geo_daily.py --quick # Só entity check + citations
- python geo_daily.py --report # Relatório de citaçõesComo criar o CLAUDE.md
# Opção 1: Pedir ao próprio Claude Code para criar:
> Analise este projeto e crie um arquivo CLAUDE.md com:
> - Descrição do projeto
> - Stack técnica
> - Estrutura de diretórios
> - Regras de código
> - Comandos úteis
# Opção 2: Criar manualmente:
# Crie um arquivo chamado CLAUDE.md na raiz do projeto
# e adicione as informações acima.Existem três níveis de CLAUDE.md
- 01CLAUDE.md na raiz do projeto: instruções específicas daquele projeto.
- 02~/.claude/CLAUDE.md (pasta do usuário): instruções globais que valem para todos os projetos.
- 03~/.claude/projects/<projeto>/MEMORY.md: memória automática que o Claude vai acumulando entre sessões.
Na Brasil GEO, temos um CLAUDE.md global (em ~/.claude/CLAUDE.md) com a regra de idioma PT-BR e a credencial de referência, e um CLAUDE.md específico em cada repositório com as instruções técnicas daquele projeto. Isso garante consistência em todo o ecossistema.
CLAUDE.md como base de conhecimento GEO do seu negócio: o arquivo CLAUDE.md na raiz do projeto persiste contexto entre sessões. Para quem trabalha com GEO, esse arquivo deve responder: (1) qual é a credencial de referência do autor (Wikidata ID, ORCID), (2) quais entidades nunca podem ser citadas erradas ("Brasil GEO" nunca "GEO Brasil"), (3) quais URLs de referências de cada produto, (4) quais llms.txt e Schema.org devem ser auditados em cada tarefa.
Exemplo prático: um CLAUDE.md bem montado faz com que ao pedir "gera o draft do próximo artigo", o Claude já saiba que o artigo precisa de JSON-LD Article com author.sameAs apontando para LinkedIn, GitHub e Wikidata, mais densidade de entidades acima de 1/100. Sem CLAUDE.md, você re-explica essas regras em cada sessão. Com ele, você produz 3-4x mais por hora.
O mesmo arquivo que guarda contexto de código guarda contexto de escritório. Peça ao Claude para montar um CLAUDE.md que fixe o tom dos seus e-mails, a assinatura, os nomes certos da empresa e o formato dos seus relatórios.
Crie um arquivo CLAUDE.md na raiz de um projeto de teste com pelo menos: nome do projeto, stack, 3 regras e 2 comandos. Inicie o Claude Code e pergunte "O que você sabe sobre este projeto?" -- ele deve responder com base no CLAUDE.md.