Para que serve o CLAUDE.md
CLAUDE.md é um arquivo de texto com instruções para o Claude Code, a ferramenta da Anthropic que trabalha nos arquivos de um projeto. Ele pode guardar informações como o idioma do site, como visualizar o resultado e quais dados não devem ser alterados.
Pense nas orientações que você daria a alguém que vai continuar um trabalho: “O site está em português do Brasil; o contato fica no rodapé; confirme comigo antes de mudar o telefone”. Registrar isso evita depender apenas do que ficou em uma conversa anterior.
O arquivo fornece contexto à IA. Não garante que toda instrução será seguida e não substitui a revisão do resultado.
O que vale a pena registrar
Inclua informações que continuarão úteis na próxima tarefa. Para um site de serviços, quatro pontos bastam como início:
- Finalidade: apresentar o serviço e facilitar o contato.
- Conteúdo: idioma, tom e informações confirmadas sobre o negócio.
- Visualização: como abrir o site para revisar uma mudança.
- Revisão: o que verificar antes de publicar.
Um pedido pontual, como trocar uma frase hoje, pode ficar na conversa. Uma regra recorrente, como não inventar depoimentos, faz sentido no arquivo. Não acrescente comandos de outro projeto só porque apareceram em um modelo.
Exemplo completo para adaptar
Este exemplo serve para um site simples de apresentação de serviços. Troque as instruções para refletir o seu projeto:
# Site de serviços
## Objetivo
Apresentar o serviço e facilitar o contato de interessados.
## Conteúdo
Escrever em português do Brasil, com frases claras.
Usar apenas informações fornecidas sobre o negócio.
Não inventar clientes, depoimentos, preços ou resultados.
Confirmar antes de alterar telefone e endereço.
## Como revisar
Explicar como abrir a página depois de cada mudança.
Conferir a leitura no celular e no computador.
Testar os links de contato.
Informar o que foi alterado e o que ainda falta verificar.Não é necessário conhecer uma linguagem de programação para escrever essas orientações. Os títulos e as listas apenas organizam o texto.
Onde salvar e como atualizar
Para instruções do projeto, salve um arquivo chamado CLAUDE.md na pasta principal dele. Use um editor de texto e confira se o nome não ficou CLAUDE.md.txt. O Claude Code oferece diferentes locais e escopos de instrução; a documentação oficial sobre memória explica como eles são carregados.
Atualize o arquivo quando uma regra mudar. Se você passou a revisar o site de outra forma, substitua a orientação antiga. Uma informação desatualizada pode provocar justamente o retrabalho que você queria evitar. Senhas e chaves de acesso não pertencem a esse texto.
Como conferir se está ajudando
Inicie uma nova sessão no projeto e peça: “Resuma as instruções aplicáveis a esta pasta e diga de quais arquivos vieram”. Confira se o arquivo aparece e se as regras principais foram entendidas.
Depois faça uma alteração pequena, como revisar o texto de apresentação. A resposta veio no idioma certo? Preservou as informações de contato? Explicou como conferir? Se uma regra foi ignorada, verifique primeiro se o arquivo está no lugar correto e se outra instrução entra em conflito.
O sinal de utilidade é precisar repetir menos orientações e corrigir menos erros recorrentes. O tamanho do arquivo, sozinho, não diz se ele funciona bem.
Documentação oficial
Fontes consultadas em 9 de setembro de 2026. Os exemplos e critérios de revisão deste artigo são sugestões editoriais da WebVIP.
