Um arquivo chamado CLAUDE.md chegou ao #1 do GitHub Trending.
82 mil estrelas. 7.800 forks.
Tudo começou com Andrej Karpathy. Ex-Diretor de IA na Tesla. Membro fundador da OpenAI. Ele identificou 4 comportamentos que fazem o Claude Code falhar e os escreveu em um único arquivo.
Um desenvolvedor pegou essas 4 regras, expandiu-as e publicou o arquivo. Viralizou.
O motivo: a precisão da codificação saltou de 65% para 94%.
A maioria dos desenvolvedores que usam Claude Code diariamente nunca configurou isso. Eles começam do zero a cada sessão. Reexplicando o mesmo contexto. Limpando mudanças de escopo indesejadas. Revertendo refatorações que ninguém pediu.
Este é o arquivo completo.
A configuração que a maioria dos devs perdeu
Cada vez que você abre o Claude Code, ele começa do nada.
Ele não conhece sua stack. Seus padrões. O contexto do seu projeto. O que você já tentou. O que você explicitamente decidiu não fazer três sessões atrás.
Então ele chuta. E quando chuta, refatora código que você não pediu para tocar. Sugere frameworks que quebram sua arquitetura atual. Deleta arquivos sem perguntar. Contradiz decisões que você já tomou.
CLAUDE.md é um arquivo de texto simples que você coloca na raiz do seu projeto. O Claude Code o lê automaticamente no início de cada sessão.
Uma configuração. Zero explicações repetidas. Três categorias de erros caros corrigidos.
1 / 3 | PADRÕES: US$ 375/semana que você gasta para se repetir
O desenvolvedor médio gasta 30 minutos por dia reexplicando contexto para o Claude.
Stack. Padrões de codificação. Histórico do projeto. O que já foi tentado. Nada disso persiste entre as sessões, a menos que você escreva uma vez e deixe o Claude ler toda vez.
30 minutos por dia a uma taxa de US$ 150/hora para desenvolvedores: US$ 375/semana. Por desenvolvedor.
Para uma equipe de 5: US$ 1.875/semana perdidos.
Estas 7 regras vão no topo do seu arquivo CLAUDE.md.
→ Elimine o excesso:
→ Corresponda o tamanho à tarefa:
→ Mostre opções antes de agir:
→ Admita incerteza antes que me custe caro:
→ Quem eu sou e o que sei:
→ Contexto atual do projeto:
→ Fixe sua voz:
Tempo gasto reexplicando contexto por dia: 30 min A US$ 150/hora de desenvolvedor: US$ 75/dia Por semana: US$ 375/semana por desenvolvedor Equipe de 5: US$ 1.875/semana Configuração do CLAUDE.md para esta seção: 45 minutos no total
erro a evitar: não escreva seu CLAUDE.md do zero. Use este prompt primeiro, depois edite a saída:
2 / 3 | COMPORTAMENTO: as alterações de US$ 150/hora que você não autorizou
Você pede ao Claude para corrigir uma função.
Ele refatora três arquivos, renomeia suas variáveis, reorganiza as importações e reescreve comentários que você levou tempo para criar.
Tudo sem perguntar.
1 hora para revisar e reverter alterações indesejadas: US$ 150. Três vezes por semana: US$ 450/semana. Por desenvolvedor.
Para uma equipe de 5: US$ 2.250/semana gastos limpando alterações que ninguém autorizou.
Estas 7 regras vão na seção de comportamento do seu CLAUDE.md.
→ Mantenha-se no escopo:
→ Pergunte antes de grandes mudanças:
→ Confirme antes de qualquer ação destrutiva:
→ Paradas obrigatórias para produção:
→ Sempre mostre o que mudou:
→ Nunca aja sem confirmação explícita:
→ Pense antes de escrever código:
1 hora/semana revertendo mudanças de escopo indesejadas: US$ 150/semana 30 min/semana fazendo diffs manuais após cada tarefa: US$ 75/semana Total de desperdício relacionado a comportamento por desenvolvedor: US$ 225/semana Equipe de 5: US$ 1.125/semana Configuração da seção de comportamento do CLAUDE.md: 30 minutos
3 / 3 | MEMÓRIA + STACK: a configuração que torna o Claude Code realmente confiável
O Claude esquece tudo entre as sessões.
Cada decisão que você tomou. Cada abordagem que falhou. O motivo pelo qual você escolheu Prisma em vez de Drizzle há seis meses. A restrição que existe por causa de um requisito específico do cliente.
Ele esquece. Então sugere exatamente o que você já descartou.
Esta seção dá ao Claude o mais próximo de uma memória real que existe atualmente. E trava sua stack tecnológica para que ele pare de propor ferramentas que quebram sua arquitetura atual.
→ Registro de decisões do MEMORY.md:
→ Resumo do final da sessão:
→ Registro de falhas do ERRORS.md:
→ Lista de fatos permanentes:
→ Trave sua stack tecnológica:
→ Pensamento Estendido para decisões difíceis:
→ As 4 regras que viralizaram:
Karpathy identificou 4 comportamentos que fazem o Claude Code falhar. Um desenvolvedor os destilou nestas 4 linhas. A precisão da codificação saltou de 65% para 94%.
2 horas/semana se recuperando de decisões esquecidas e sugestões erradas: US$ 300/semana por dev Recomendações de stack erradas e ferramentas incompatíveis: US$ 75/semana Total de desperdício relacionado à memória por desenvolvedor: US$ 375/semana Equipe de 5: US$ 1.875/semana Configuração de MEMORY.md + ERRORS.md + stack: 20 minutos
CONCLUSÃO
Aqui está a matemática completa.
US$ 375/semana reexplicando contexto a cada sessão US$ 225/semana revertendo alterações não autorizadas US$ 375/semana se recuperando de decisões esquecidas Desperdício total por desenvolvedor: US$ 975/semana
Equipe de 5 desenvolvedores: US$ 4.875/semana Por ano: US$ 253.500
Configuração do CLAUDE.md: 2 horas no total Apenas as 4 regras de Karpathy: 65% a 94% de precisão na codificação
Um único arquivo de texto. 21 regras. Duas horas de trabalho.
Os desenvolvedores que configuraram isso estão trabalhando com uma versão do Claude que lembra decisões, permanece no escopo, confirma antes de destruir qualquer coisa, nunca sugere um framework que quebre sua arquitetura.
Os que não configuraram estão gastando US$ 975/semana para se repetir.
p.s. comece com as 4 regras de Karpathy. só essas 4. cole-as em um novo arquivo chamado CLAUDE.md na raiz do seu projeto agora mesmo. leva 2 minutos. adicione o resto uma semana de cada vez, conforme perceber o que está faltando.
Salve isto nos favoritos antes que se perca no feed. Se foi útil, compartilhe com uma pessoa que precisa.
