Um arquivo chamado CLAUDE.md chegou ao #1 no GitHub Trending.
82.000 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 foi de 65% para 94%.
A maioria dos desenvolvedores que usa o Claude Code diariamente nunca configurou isso. Eles estão começando 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
Toda 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 há três sessões atrás.
Então ele chuta. E quando ele chuta, ele refatora código que você não pediu para mexer. Ele sugere frameworks que quebram sua arquitetura existente. Ele exclui arquivos sem perguntar. Ele 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: $375/semana que você está gastando para se repetir
O desenvolvedor médio gasta 30 minutos por dia reexplicando o 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 desenvolvedor de $150/hora: $375/semana. Por desenvolvedor.
Para uma equipe de 5: $1.875/semana perdidos.
Estas 7 regras vão no topo do seu arquivo CLAUDE.md.
→ Elimine o enchimento:
→ Combine o tamanho com a tarefa:
→ Mostre opções antes de agir:
→ Admita incerteza antes que me custe caro:
→ Quem eu sou e o que eu sei:
→ Contexto atual do projeto:
→ Trave seu tom de voz:
Tempo gasto reexplicando o contexto por dia: 30 min A uma taxa de desenvolvedor de $150/hora: $75/dia Por semana: $375/semana por desenvolvedor Equipe de 5: $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 mudanças de $150/hora que você não autorizou
Você pede para o Claude corrigir uma função.
Ele refatora três arquivos, renomeia suas variáveis, reorganiza os imports e reescreve comentários que você levou tempo para criar.
Tudo isso sem perguntar.
1 hora para revisar e reverter mudanças indesejadas: $150. Três vezes por semana: $450/semana. Por desenvolvedor.
Para uma equipe de 5: $2.250/semana gastos limpando mudanças 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 mudanças grandes:
→ 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: $150/semana 30 min/semana fazendo diffs manuais após cada tarefa: $75/semana Total de desperdício relacionado a comportamento por desenvolvedor: $225/semana Equipe de 5: $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 a coisa mais próxima de memória real que existe atualmente. E trava sua stack de tecnologia para que ele pare de propor ferramentas que quebram sua arquitetura existente.
→ 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 de tecnologia:
→ 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 foi de 65% para 94%.
2 horas/semana se recuperando de decisões esquecidas e sugestões erradas: $300/semana por dev Recomendações de stack erradas e ferramentas incompatíveis: $75/semana Total de desperdício relacionado a memória por desenvolvedor: $375/semana Equipe de 5: $1.875/semana Configuração do MEMORY.md + ERRORS.md + stack: 20 minutos
CONCLUSÃO
Aqui estão as contas completas.
$375/semana reexplicando o contexto a cada sessão $225/semana revertendo mudanças não autorizadas $375/semana se recuperando de decisões esquecidas Total de desperdício por desenvolvedor: $975/semana
Equipe de 5 desenvolvedores: $4.875/semana Por ano: $253.500
Configuração do CLAUDE.md: 2 horas no total As 4 regras do Karpathy sozinhas: 65% para 94% de precisão na codificação
Um arquivo de texto simples. 21 regras. Duas horas de trabalho.
Os desenvolvedores que configuraram isso estão trabalhando com uma versão do Claude que lembra decisões, mantém-se no escopo, confirma antes de destruir qualquer coisa, nunca sugere um framework que quebra sua arquitetura.
Os que não configuraram estão gastando $975/semana para se repetir.
p.s. comece com as 4 regras do 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 notar o que está faltando.
Adicione isto aos favoritos antes que se perca. Se foi útil, compartilhe com uma pessoa que precise.
