o manual que sua ia lê antes de tudo · caderno secreto

O passo a passo

3 passos · raiz do projeto

O que é e onde criar

Crie o arquivo na raiz do projeto

O CLAUDE.md é um arquivo de texto simples que fica na raiz da pasta do seu projeto, o primeiro nível dela, não dentro de uma subpasta. Toda vez que você abre uma conversa nova ali dentro, o Claude lê esse arquivo automaticamente antes de responder qualquer coisa.

Vá até a pasta principal do projetoO nível de cima, onde ficam os arquivos principais, não uma subpasta interna.
Crie um arquivo novo chamado CLAUDE.mdCom esse nome exato: maiúsculo e com a extensão .md. Em meu-projeto/ ele fica em meu-projeto/CLAUDE.md.
Deixe ele vazio por enquantoNo passo 02 você preenche com o modelo pronto. Por ora, basta o arquivo existir no lugar certo.

não precisa ser longo

Um arquivo de 200 palavras já muda a qualidade das respostas. O que importa é existir e estar atualizado, não o tamanho.

O modelo pronto pra copiar

Preencha as 6 seções do arquivo

Copie o bloco abaixo, cole dentro do seu CLAUDE.md e preencha as 6 seções com as informações do seu projeto. Apague os colchetes e escreva por cima de cada um.

Cole isso no seu CLAUDE.md

# Identidade do projeto
[o que é este projeto em 1-2 frases]

## Objetivo
[o que este projeto deve alcançar]

## Decisões já tomadas
[decisões que não devem ser questionadas de novo]

## Referências
[links, arquivos ou pastas importantes]

## Convenções
[padrões de nomenclatura, estilo ou formatação]

## Restrições
[o que NUNCA fazer neste projeto]

um exemplo de preenchimento

Em Restrições, algo como "nunca alterar a configuração de produção sem confirmar antes". Em Decisões já tomadas, algo como "usamos sempre a paleta X, já decidido, não sugerir outra". O mínimo que evita uma explicação repetida já vale.

seção vazia é válida

Se uma seção ainda não se aplica, deixe uma frase curta como "nenhuma restrição definida ainda" em vez de apagar a seção inteira. Assim a IA não assume que ela nunca existiu.

Como testar se está funcionando

Faça o teste de 1 pergunta

Com o arquivo salvo, um teste rápido confirma se a IA já está lendo o contexto sozinha, antes de você explicar qualquer coisa.

Abra uma conversa nova dentro da pastaNão continue uma conversa antiga: comece uma do zero, dentro do projeto.
Pergunte só isso: "o que é este projeto?"Se a IA responder certo, no tom certo e sem você explicar nada antes, o arquivo está funcionando.

se a resposta vier genérica

Alguma seção provavelmente está vaga demais ou faltando. Reescreva a Identidade do projeto sendo mais específica, salve, e repita o teste numa conversa nova. É ajuste, não recémeço.

mantenha vivo

Sempre que uma decisão nova for tomada, volte no CLAUDE.md e anote. Um arquivo desatualizado ensina o projeto errado pra IA.

Dúvidas comuns

Quando algo não sai como o esperado

O arquivo precisa ser grande pra funcionar?

Não. Um arquivo de 200 palavras já muda a qualidade das respostas. O que importa é existir, estar na raiz com o nome exato CLAUDE.md e ser atualizado, não o tamanho.

E se uma seção ainda não se aplica ao meu projeto?

Seção vazia é válida. Em vez de apagar a seção inteira, deixe uma frase curta como "nenhuma restrição definida ainda". Assim a IA não assume que ela nunca existiu.

Como sei se a IA está mesmo lendo o arquivo?

Faça o teste de 1 pergunta: abra uma conversa nova dentro da pasta e pergunte só "o que é este projeto?". Se a resposta vier certa e no tom certo sem você explicar antes, o CLAUDE.md está funcionando.

~ $ lendo CLAUDE.md
✓ Contexto do projeto carregado, a IA já chega sabendo

Se você criou o arquivo, parou de reexplicar o seu projeto.

É a diferença entre repetir tudo em cada conversa e a IA já chegar sabendo o que é, o que evitar e o que já foi decidido. E esse é só o começo do que dá pra fazer com contexto. É dentro da comunidade que a gente vai fundo, junto.

Quero entrar na comunidade →