A maioria das pessoas que usa o Claude nunca ouviu falar disso.
Quem já ouviu não sabe realmente o que colocar nele.
E essa lacuna está custando horas para as pessoas toda semana. ⏰
A verdade é esta — toda vez que você abre uma nova sessão no Claude, ele começa com memória zero.
Ele não sabe seu nome. Não sabe seu trabalho. Não sabe suas preferências ou como você gosta que as coisas sejam feitas.
Então você perde os primeiros minutos reexplicando tudo do zero. Ou não perde — e o Claude te dá algo que não se encaixa em como você realmente trabalha.
O CLAUDE.md resolve isso permanentemente. 💡
Aqui estão todas as 21 instruções que você precisa para configurá-lo corretamente. 👇
Primeiro — isso NÃO é só uma ferramenta para desenvolvedores. 🔥
Escritores usam para fixar sua voz, para que o Claude nunca soe como outra pessoa. Profissionais de marketing usam para definir seu público, para que o Claude pare de escrever textos genéricos. Pesquisadores usam para definir como querem que as informações sejam estruturadas. Donos de negócios usam para dar ao Claude o contexto completo da empresa, para que cada resultado se encaixe na realidade deles.
Sem o CLAUDE.md — você começa do zero toda sessão. Você se repete. Você corrige os mesmos erros. Você explica suas preferências pela centésima vez.
O CLAUDE.md é a primeira coisa que você deve configurar antes de qualquer trabalho sério com o Claude. 🎯
Como criá-lo em 2 minutos ⚡
Abra a pasta do seu projeto e crie um novo arquivo. Nomeie-o exatamente como "CLAUDE.md" — letras maiúsculas, sem espaços.
Abra-o em qualquer editor de texto — Notepad, TextEdit, VS Code, o que você usar. Cole suas instruções diretamente neste arquivo em texto simples.
Comece com 3 ou 4 instruções que resolvam suas maiores frustrações primeiro. Salve o arquivo. O Claude o lê automaticamente toda vez que você abre uma sessão nessa pasta.
Sem configuração. Sem etapas extras. Funciona desde a primeira mensagem. 💡
⚡ PARTE 1: Como o Claude Fala com Você
- Elimine os rodeios para sempre. 🚫
O padrão do Claude é abrir cada resposta com — "Ótima pergunta!", "Claro!", "Certamente!", "Com certeza!"
Frases que não acrescentam nada e perdem seu tempo todos os dias.
Uma instrução elimina isso permanentemente. Toda resposta começa diretamente com a resposta. Sem aquecimento. Sem performance de utilidade. Só o que você pediu — imediatamente.
"Nunca abra respostas com frases de preenchimento como 'Ótima pergunta!', 'Claro!', 'Certamente!' ou aquecimentos similares. Comece cada resposta com a resposta real. Sem preâmbulo. Apenas a informação."
- Sempre mostre opções antes de agir. 🎯
O Claude escolhe uma abordagem e segue com ela por padrão.
Você pede para reescrever um parágrafo e ele muda o tom inteiro do texto. Você pede para reestruturar um documento e ele reorganiza as coisas de uma forma que não combina com como você pensa.
Agora você está corrigindo algo que nunca pediu para mudar. 😤
Esta instrução corrige isso completamente. Antes de qualquer tarefa significativa, o Claude mostra 2-3 maneiras de abordar o trabalho. Você escolhe a direção. O que vem depois é exatamente o que você queria.
"Antes de qualquer tarefa significativa, sempre me mostre 2-3 abordagens possíveis primeiro. Aguarde minha escolha antes de prosseguir."
- Seja honesto quando não souber. 🔍
O Claude vai te dar uma resposta confiante, detalhada e completamente errada antes de admitir incerteza.
Ele preenche lacunas com informações que soam plausíveis — datas, estatísticas, citações, fatos — que parecem verdadeiras mas simplesmente não são. Você usa essa informação e o problema aparece depois, quando mais importa.
Esta instrução muda esse comportamento permanentemente.
"Se você não tiver certeza sobre qualquer fato, estatística, data ou citação — diga isso explicitamente antes de incluí-lo. 'Não tenho certeza sobre isso' é sempre melhor do que apresentar um palpite como fato. Nunca preencha lacunas com informações que soam plausíveis."
- Corresponda o tamanho ao que é realmente necessário. 📏
Faça uma pergunta simples ao Claude e ele escreve quatro parágrafos. Pergunte algo complexo e ele te dá um esqueleto que parece completo mas não é.
Nenhum dos dois é útil. O tamanho da resposta deve corresponder ao que a tarefa realmente exige.
"Corresponda o tamanho da resposta à complexidade da tarefa. Perguntas simples recebem respostas curtas e diretas. Tarefas complexas recebem respostas completas e detalhadas. Nunca infle respostas com reafirmações ou frases de encerramento que repetem o que você acabou de dizer."
⚡ PARTE 2: Como o Claude se Comporta
- Pergunte antes de fazer grandes mudanças. ✋
Você pede ao Claude para corrigir um parágrafo e ele reescreve o documento inteiro. Você pede para encurtar algo e ele remove seções que você realmente precisava.
Toda vez — você perde algo que não queria perder.
"Antes de fazer qualquer mudança que altere significativamente o conteúdo que já criei — pare completamente. Descreva exatamente o que você está prestes a mudar e por quê. Aguarde minha confirmação antes de prosseguir. 'Acho que isso seria melhor' não é permissão para mudar."
- Mantenha o foco no que foi pedido. 🎯
Peça ao Claude para corrigir uma coisa e ele vai "melhorar" outras cinco enquanto está nisso — ajustando sua redação, reorganizando sua estrutura, reformulando frases com as quais você estava perfeitamente satisfeito.
Agora você tem que vasculhar tudo só para encontrar o que realmente mudou. 😤
"Mude apenas o que eu especificamente pedi para você mudar. Não reescreva, reformule ou 'melhore' nada que eu não pedi — mesmo que você ache que ficaria melhor. Se notar algo que vale a pena melhorar em outro lugar, mencione no final. Não toque nisso a menos que eu peça explicitamente."
- Sempre me diga o que você mudou. 📋
O Claude termina uma tarefa e você fica examinando o resultado tentando descobrir o que é diferente do que você tinha antes.
Quais seções mudaram? Ele cortou algo? Adicionou algo que você nunca pediu?
"Após concluir qualquer tarefa de edição ou escrita, sempre termine com um breve resumo: O que foi mudado. O que foi deixado intacto. O que precisa da minha atenção. Mantenha curto — isso é uma atualização de status, não um resumo."
- Nunca tome ações em meu nome sem perguntar. 🚨
À medida que as ferramentas de IA se tornam mais conectadas — ao seu email, calendário, contas sociais, documentos — o risco do Claude tomar uma ação que você não pretendia totalmente cresce a cada nova integração.
Enviar uma mensagem. Publicar conteúdo. Agendar algo. Essas ações têm consequências reais e acontecem rápido.
"Nunca envie, publique, compartilhe ou agende nada em meu nome sem minha confirmação explícita na mensagem atual. 'Você mencionou querer fazer isso' não é confirmação. Eu devo dizer sim na mensagem atual."
⚡ PARTE 3: Seu Contexto
- Diga ao Claude quem você é e o que você sabe. 👤
O Claude não sabe se você é um especialista ou um iniciante, um fundador ou um freelancer, alguém que quer profundidade técnica ou linguagem simples.
Sem esse contexto — ele adivinha. E erra tantas vezes quanto acerta.
"Sobre mim: Nome. Função. Formação. Forte em [tópicos que você conhece bem]. Ainda aprendendo [áreas onde você precisa de mais contexto]. Ajuste a profundidade de cada resposta para corresponder a esta formação. Nunca explique demais o que eu já sei."
- Dê ao Claude o contexto do que você está trabalhando. 📌
Toda sessão, o Claude começa sem ideia do que você está trabalhando, para quem é, ou o que realmente importa.
Ele dá resultados genéricos porque não tem outra escolha.
"No que estou trabalhando: Projeto. Objetivo. Público-alvo. Tom. O que evitar. Aplique este contexto a toda tarefa. Quando algo não se encaixar neste quadro — sinalize antes de prosseguir."
- Fixe sua voz e estilo. ✍️
O Claude tem um estilo de escrita padrão. É aceitável. Mas não é o seu.
Toda vez que você usa o Claude para escrever algo — você acaba editando de volta para sua voz de qualquer maneira.
Defina sua voz uma vez e o Claude escreve nela desde o primeiro rascunho.
"Meu estilo de escrita — sempre corresponda a isto: Voz. Comprimento das frases. Palavras que uso. Palavras que nunca uso. Preferência de formato. Ao escrever algo em meu nome, corresponda exatamente a este estilo. Não use seus próprios padrões."
⚡ PARTE 4: Memória e Continuidade
- Faça o Claude manter um arquivo de memória. 🧠
O Claude esquece tudo entre as sessões. Cada conversa começa completamente do zero.
Mas o Claude pode escrever arquivos — e arquivos persistem.
Esta instrução diz ao Claude para manter um arquivo MEMORY.md com cada decisão importante que vocês tomam juntos — o que foi decidido, por quê, e quais alternativas foram rejeitadas.
"Mantenha um arquivo chamado MEMORY.md. Após qualquer decisão significativa — adicione uma entrada com o que foi decidido, por quê, e o que foi rejeitado. Leia o MEMORY.md no início de cada sessão antes de fazer qualquer coisa."
- Resumo de fim de sessão — nunca perca progresso novamente. 📝
Você fecha a sessão. Volta dois dias depois. Passa 15 minutos lendo mensagens antigas tentando lembrar onde parou e o que terminou.
Isso é desperdício completamente evitável que acontece com quase todo mundo que usa o Claude regularmente.
"Quando eu disser 'fim da sessão' ou 'vamos parar por aqui' — escreva um resumo da sessão no MEMORY.md: No que trabalhamos. O que está completo. O que está em andamento. Quais decisões foram tomadas. O que retomar na próxima sessão."
- Registre o que não funcionou — pare de resolver o mesmo problema duas vezes. 🔄
Você tenta uma abordagem de prompt. Leva quatro tentativas para conseguir algo utilizável. Três semanas depois você volta com uma tarefa similar e o Claude começa de novo com as mesmas sugestões ruins.
Mesma tentativa e erro. Mesmo tempo perdido. Do começo. Toda vez.
"Mantenha um arquivo chamado ERRORS.md. Quando uma abordagem levar mais de 2 tentativas para funcionar — registre o que não funcionou, o que funcionou, e o que lembrar da próxima vez. Verifique o ERRORS.md antes de sugerir abordagens para tarefas similares."
- Dê ao Claude uma lista de fatos que nunca mudam. 📌
Todo projeto tem fatos permanentes — restrições de decisões passadas, regras que existem por razões importantes, coisas que são sempre verdade sobre seu trabalho independentemente da tarefa específica.
Sem isso — o Claude casualmente sugere coisas que contradizem completamente sua realidade.
"Estes fatos são sempre verdadeiros. Aplique-os a toda sessão sem exceção: [Seus fatos permanentes aqui]. Se qualquer tarefa entrar em conflito com um deles — sinalize antes de prosseguir."
⚡ PARTE 5: Para Desenvolvedores
- Fique no escopo — não toque em nada que não foi pedido. 🔒
Peça ao Claude para corrigir um bug e ele vai refatorar três arquivos, renomear suas variáveis, reorganizar suas importações e "melhorar" código que você vem usando há meses — tudo sem perguntar.
Algumas dessas mudanças quebram coisas. Algumas introduzem diferenças sutis que levam dias para serem rastreadas.
"Apenas modifique arquivos, funções e linhas de código diretamente relacionados à tarefa atual. Não refatore, renomeie ou 'melhore' nada que eu não pedi explicitamente para você mudar. Se notar algo que vale a pena corrigir em outro lugar — mencione. Não toque nisso. Nunca."
- Confirme antes de qualquer ação destrutiva. ⚠️
O Claude Code vai deletar arquivos, sobrescrever funções e dropar tabelas de banco de dados sem hesitação — porque você disse a ele para fazer, mesmo que não tenha percebido totalmente o que estava dizendo.
Uma instrução mal interpretada e horas de trabalho desaparecem completamente sem desfazer.
"Antes de deletar qualquer arquivo, sobrescrever código existente, deletar registros de banco de dados ou fazer qualquer mudança que não possa ser trivialmente desfeita — pare completamente. Liste exatamente o que será afetado. Peça confirmação explícita. Só prossiga depois que eu disser sim na mensagem atual."
- Paradas obrigatórias — ações que nunca acontecem sem permissão. 🚨
Fazer deploy para produção. Rodar migrations em um banco de dados ativo. Enviar chamadas de API para serviços externos.
Estas não são situações de "ter cuidado". São paradas completas.
"As seguintes ações exigem confirmação explícita na sessão atual antes de serem executadas — sem exceções: Fazer deploy para qualquer ambiente. Rodar migrations em qualquer banco de dados. Enviar qualquer email ou chamada de API externa. Executar qualquer comando com efeitos colaterais externos irreversíveis."
- Fixe sua stack de tecnologia. 🔧
Sem uma stack definida — o Claude vai sugerir o framework que considerar mais popular, a biblioteca que viu com mais frequência e o gerenciador de pacotes que usa por padrão.
Frequentemente não é o que você usa, não é o que seu time conhece e não é compatível com o que você já construiu.
"Stack de tecnologia — sempre use estas, nunca sugira alternativas a menos que eu peça: Linguagem. Framework. Gerenciador de pacotes. Banco de dados. Testes. Linting. Se algo parecer a ferramenta errada — sinalize. Mas use de qualquer maneira a menos que eu diga o contrário."
- Sempre mostre exatamente o que mudou. 📊
O Claude termina uma tarefa de codificação e você fica examinando o resultado tentando descobrir o que é diferente.
Quais arquivos mudaram? Ele tocou em algo mais? Deixou algo inacabado?
"Após concluir qualquer tarefa de codificação, sempre termine com: Arquivos alterados. O que foi modificado — uma linha por arquivo. Arquivos intencionalmente não tocados. Acompanhamento necessário. Mantenha curto — isso é uma atualização de status, não um resumo."
- As 4 regras que fizeram o CLAUDE.md de Andrej Karpathy viralizar. 🔥
Andrej Karpathy — ex-Diretor de IA na Tesla, membro fundador da OpenAI — identificou 4 comportamentos específicos que fazem o Claude Code falhar em tarefas de codificação.
Um desenvolvedor as destilou em 4 instruções. Esse arquivo chegou ao #1 no GitHub Trending e melhorou a precisão da codificação de 65% para 94%. 😱
Aqui estão elas:
- Pergunte, não presuma — se algo não estiver claro, pergunte antes de escrever uma única linha. Nunca faça suposições silenciosas.
- Solução mais simples primeiro — sempre implemente a coisa mais simples que poderia funcionar. Não adicione abstrações que não foram solicitadas.
- Não toque em código não relacionado — se um arquivo não faz parte diretamente da tarefa atual, não o modifique. Nunca.
- Sinalize incerteza explicitamente — se você não estiver confiante sobre uma abordagem, diga antes de prosseguir. Confiança sem certeza causa mais danos do que admitir uma lacuna.
A conclusão. 💎
O CLAUDE.md não é apenas uma ferramenta para desenvolvedores.
É um arquivo de instruções permanente que qualquer pessoa que usa o Claude seriamente deve configurar antes de sua primeira sessão real.
As instruções 1-4 corrigem como o Claude se comunica. As instruções 5-8 impedem que ele mude coisas que você não autorizou. As instruções 9-11 dão a ele contexto para produzir resultados que se encaixam no seu trabalho real. As instruções 12-15 dão a ele o mais próximo da memória real que existe atualmente. As instruções 16-21 fazem o Claude Code se comportar como uma ferramenta precisa em vez de uma imprevisível.
Crie o arquivo. Cole 3 instruções. Adicione mais conforme for avançando.
A diferença na qualidade do resultado será imediata e óbvia desde a primeira sessão. 🚀
Siga para mais sistemas que realmente mudam como você trabalha com IA. 💯
