A maioria das pessoas que usa o Claude nunca ouviu falar dele.
Quem já ouviu não sabe o que colocar nele de fato.
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 o que você faz. Não sabe suas preferências ou como você gosta que as coisas sejam feitas.
Então você passa os primeiros minutos reexplicando tudo do zero. Ou não faz isso — 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 — isto 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. Empresários 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 em cada sessão. Você se repete. Corrige os mesmos erros. 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 criar 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, tanto faz. 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 naquela pasta.
Sem configuração. Sem passos 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 absolutamente nada e perdem seu tempo todos os dias.
Uma instrução elimina isso permanentemente. Cada resposta começa diretamente com a resposta. Sem aquecimento. Sem encenação de utilidade. Apenas o que você pediu — imediatamente.
"Nunca abra respostas com frases de rodeio 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. 🎯
Por padrão, o Claude escolhe uma abordagem e segue com ela.
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 em nada 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 a 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 a 3 abordagens possíveis primeiro. Aguarde minha escolha antes de prosseguir."
- Seja honesto quando não souber. 🔍
O Claude dará uma resposta confiante, detalhada e completamente errada antes de admitir incerteza.
Ele preenche lacunas com informações que parecem plausíveis — datas, estatísticas, citações, fatos — que soam verdadeiras mas simplesmente não são. Você usa essa informação e o problema aparece mais tarde, 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."
- Combine o tamanho com o 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.
"Combine o tamanho da resposta com a complexidade da tarefa. Perguntas simples recebem respostas curtas e diretas. Tarefas complexas recebem respostas completas e detalhadas. Nunca encha 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 completamente satisfeito.
Agora você tem que vasculhar tudo só para encontrar o que realmente mudou. 😤
"Mude apenas o que eu pedi especificamente para mudar. Não reescreva, reformule ou 'melhore' nada que eu não tenha pedido — mesmo que você ache que seria melhor. Se notar algo que vale a pena melhorar em outro lugar, mencione no final. Não mexa a menos que eu peça explicitamente."
- Sempre me diga o que você mudou. 📋
O Claude termina uma tarefa e você fica escaneando a saída 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. Seja breve — isso é uma atualização de status, não um resumo."
- Nunca tome ações em meu nome sem perguntar. 🚨
Conforme as ferramentas de IA se tornam mais conectadas — ao seu e-mail, calendário, contas de redes sociais, documentos — o risco de o 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 que queria 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ê é especialista ou iniciante, fundador ou 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 precisa de mais contexto]. Ajuste a profundidade de cada resposta para corresponder a essa formação. Nunca explique demais o que já sei."
- Dê ao Claude o contexto do que você está fazendo. 📌
A cada sessão, o Claude começa sem saber no que você está trabalhando, para quem é ou o que realmente importa.
Ele produz 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 cada tarefa. Quando algo não se encaixar neste quadro — sinalize antes de prosseguir."
- Fixe sua voz e seu estilo. ✍️
O Claude tem um estilo de escrita padrão. É razoável. Mas não é o seu.
Toda vez que você usa o Claude para escrever algo — acaba editando de volta para sua própria voz de qualquer maneira.
Defina sua voz uma vez e o Claude escreve nela desde o primeiro rascunho.
"Meu estilo de escrita — sempre combine com isto: Voz. Tamanho das frases. Palavras que uso. Palavras que nunca uso. Preferência de formato. Ao escrever algo em meu nome, combine exatamente com este estilo. Não use seus padrões padrão."
⚡ 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 tomarem 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 do fim da sessão — nunca mais perca o progresso. 📝
Você fecha a sessão. Volta dois dias depois. Passa 15 minutos lendo mensagens antigas tentando lembrar onde parou e o que terminou.
Isto é um 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 semelhante e o Claude recomeça com as mesmas sugestões ruins.
Mesmo teste e erro. Mesmo tempo perdido. Desde o início. 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 para a próxima vez. Verifique o ERRORS.md antes de sugerir abordagens para tarefas semelhantes."
- 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 sugere casualmente coisas que contradizem completamente sua realidade.
"Estes fatos são sempre verdadeiros. Aplique-os a cada 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 mexa no 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 com o qual você trabalha há meses — tudo sem perguntar.
Algumas dessas mudanças quebram coisas. Outras introduzem diferenças sutis que levam dias para serem encontradas.
"Apenas modifique arquivos, funções e linhas de código diretamente relacionadas à tarefa atual. Não refatore, renomeie ou 'melhore' nada que eu não tenha pedido explicitamente para mudar. Se notar algo que vale a pena corrigir em outro lugar — mencione. Não mexa. Nunca."
- Confirme antes de qualquer ação destrutiva. ⚠️
O Claude Code vai deletar arquivos, sobrescrever funções e derrubar tabelas de banco de dados sem hesitação — porque você mandou, mesmo que não tenha percebido completamente o que estava mandando.
Uma instrução mal interpretada e horas de trabalho desaparecem completamente, sem desfazer.
"Antes de deletar qualquer arquivo, sobrescrever código existente, remover 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 migrações 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 migrações em qualquer banco de dados. Enviar qualquer e-mail ou chamada de API externa. Executar qualquer comando com efeitos colaterais externos irreversíveis."
- Fixe sua stack tecnológica. 🔧
Sem uma stack definida — o Claude vai sugerir o framework que considera mais popular, a biblioteca que vê 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 tecnológica — 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 mesmo assim, 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 escaneando a saída tentando descobrir o que é diferente.
Quais arquivos mudaram? Ele mexeu em mais alguma coisa? 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. Seja breve — 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 suponha — 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 mexa em código não relacionado — se um arquivo não fizer 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.
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 da sua primeira sessão real.
As instruções 1 a 4 corrigem como o Claude se comunica. As instruções 5 a 8 impedem que ele mude coisas que você não autorizou. As instruções 9 a 11 dão a ele contexto para produzir resultados que se encaixam no seu trabalho real. As instruções 12 a 15 dão a ele o mais próximo da memória real que existe atualmente. As instruções 16 a 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 usando.
A diferença na qualidade dos resultados será imediata e óbvia desde a primeira sessão. 🚀
Siga para mais sistemas que realmente mudam como você trabalha com IA. 💯
