Quatro regras que tiram os vícios do seu Claude
Elas saíram de um post do Andrej Karpathy sobre os erros que a IA comete quando ele programa com ela, e viraram um arquivo para o Claude Code. Aqui você pega o arquivo original e a minha versão em português para colar no Claude.ai, mesmo que você não programe.
De onde veio o arquivo
O post do Karpathy
Em 26 de janeiro de 2026, Andrej Karpathy, um dos membros fundadores da OpenAI, publicou umas notas sobre as semanas em que passou programando com o Claude. No meio delas, listou os erros que mais via a IA cometer. O post passou de 7,8 milhões de visualizações.
Ler o post no X ↗O arquivo do forrestchang
Menos de oito horas depois, o desenvolvedor Jiayuan Zhang, o forrestchang no GitHub, transformou essas queixas num arquivo só, com quatro regras para o Claude Code ler antes de trabalhar. Hoje o repositório passa de 220 mil estrelas.
Ver o repositório ↗A resposta do criador do Claude Code
Boris Cherny, que criou o Claude Code, respondeu o post seis horas depois: "os problemas de qualidade de código que você listou são reais: o modelo complica as coisas, deixa código morto para trás". A aposta dele é que isso melhora com o modelo. Enquanto não melhora, as regras ajudam.
Ler a resposta no X ↗O que tem aqui em quatro partes
Os quatro defeitos
O que a IA faz de errado, com um exemplo de quem usa o Claude para processo e documento.
As regras para o Claude.ai
A minha versão, em português, para colar nas instruções. Para quem não programa.
Instalar no Claude Code
O arquivo original, pelo caminho que o próprio autor indica.
Como testar
Quatro pedidos para conferir se cada regra pegou.
Os quatro defeitos e a regra para cada um
Os três primeiros estão na lista de erros do Karpathy. O quarto aparece no mesmo post como dica: a IA rende mais quando sabe como é o resultado certo. Os nomes das regras são os do arquivo, traduzidos.
Ela sai fazendo antes de entender o pedido
Nas palavras do Karpathy, o modelo "faz suposições erradas por você e segue com elas sem conferir". Não pergunta, não aponta o que está confuso, não mostra as opções.
Está funcionando quando as perguntas chegam antes da primeira versão, não depois do erro.
Ela complica o que é simples
O Karpathy conta que a IA escreve mil linhas onde cem resolviam, e só enxuga quando você pergunta "não dava para fazer assim?".
Está funcionando quando você para de pedir "resume isso" depois de toda resposta.
Ela mexe no que você não pediu
O modelo "muda ou apaga o que não entendeu direito como efeito colateral, mesmo quando não tem nada a ver com a tarefa", escreveu o Karpathy.
Está funcionando quando você compara as duas versões e só o trecho pedido mudou.
Ela trabalha sem saber onde quer chegar
Essa é a dica do post: a IA é muito boa em insistir até atingir um objetivo claro. "Não diga o que fazer, dê o critério de sucesso e deixe ela ir."
Está funcionando quando a resposta abre com o critério e fecha dizendo se cumpriu.
As regras para colar no Claude.ai
O arquivo original fala de código. Esta é a minha versão das quatro regras, em português, para quem usa o Claude no navegador ou no app com texto, planilha, processo e documento. Colada nas instruções da conta, ela vale para todas as conversas.
Siga estas quatro regras em toda conversa. Em pedido trivial, como corrigir uma palavra ou responder uma pergunta direta, use bom senso e vá direto ao ponto.
Antes de começar uma tarefa, diga em uma ou duas frases o que você entendeu e quais suposições está fazendo. Se o pedido puder ser lido de mais de um jeito, mostre as leituras e pergunte qual é a minha. Se faltar uma informação que muda o resultado, pare e pergunte em vez de inventar. Se existir um caminho mais simples do que o que eu pedi, me diga.
Entregue a menor solução que resolve o que eu pedi. Nada de etapas, seções, opções ou extras que eu não pedi. Processo com o mínimo de passos que funciona. Documento com o tamanho que o assunto pede, e não mais. Antes de entregar, pergunte a si mesmo se dá para cortar pela metade sem perder nada. Se der, corte.
Quando eu pedir um ajuste num texto, planilha, processo ou documento que já existe, mude só aquele ponto. Não reescreva o que está em volta, não troque o tom, a formatação ou a estrutura, não aproveite para melhorar o resto. Se notar outro problema, me avise numa linha no fim, sem corrigir. Toda mudança precisa voltar direto ao meu pedido.
Em tarefa com mais de um passo, comece definindo como vamos saber que ficou certo, numa frase que dá para conferir. Depois mostre um plano curto, com o que você vai checar em cada passo. No fim, confira o resultado contra esse critério e me diga se passou ou o que faltou.
Onde colar
Nas instruções da conta
Abra as configurações do Claude e cole no campo de instruções. Segundo a central de ajuda da Anthropic, o que fica ali vale para todas as suas conversas. Se você nunca mexeu nisso, tenho um guia de onde fica cada campo.
Onde ficam as instruções do Claude ↗Já tem instruções lá?
Cole as regras no fim do que já existe, sem apagar nada. Se alguma instrução sua disser o contrário, por exemplo "sempre me dê três opções", decida qual fica.
Só para um projeto
Se quiser as regras só num trabalho específico, cole nas instruções do projeto. Aí elas valem só para as conversas daquele projeto.
O arquivo original no Claude Code
Se você programa, use o arquivo do autor, em inglês e pensado para código. Os dois caminhos abaixo são os que o README do repositório indica. O arquivo fica lá, com o autor.
Caminho 1 plugin, para todos os projetos
É o caminho que o autor recomenda. Dentro do Claude Code, rode os dois comandos, um de cada vez.
/plugin marketplace add forrestchang/andrej-karpathy-skills
/plugin install andrej-karpathy-skills@karpathy-skills
Caminho 2 CLAUDE.md, num projeto só
No terminal, dentro da pasta do projeto. Se o projeto ainda não tem CLAUDE.md:
curl -o CLAUDE.md https://raw.githubusercontent.com/forrestchang/andrej-karpathy-skills/main/CLAUDE.md
Se já tem, acrescente no fim, sem apagar o que existe:
echo "" >> CLAUDE.md
curl https://raw.githubusercontent.com/forrestchang/andrej-karpathy-skills/main/CLAUDE.md >> CLAUDE.md
O repositório também traz uma regra pronta para o Cursor. Detalhes no README do autor.
Teste cada regra numa conversa nova
Abra uma conversa nova, para nada do que já foi combinado antes interferir, e mande os quatro pedidos abaixo, um de cada vez. Troque pelo seu caso se quiser; o que importa é o tipo de pedido.
Um pedido vago
"Monta um processo de aprovação de compras para a minha empresa."
Esperado: ele pergunta valor, quem aprova e onde isso roda antes de escrever o processo, ou lista as suposições que fez.Um pedido simples
"Escreve o procedimento para um funcionário pedir férias."
Esperado: poucos passos, sem seções de política, exceções e FAQ que você não pediu.Um ajuste pontual
Cole um parágrafo seu e peça: "troca só a segunda frase para um tom mais direto".
Esperado: o resto do parágrafo volta igual, palavra por palavra.Uma tarefa com etapas
"Organiza minha lista de fornecedores e me diz quais dá para cortar." Cole a lista junto.
Esperado: ele abre dizendo como vai decidir o que cortar e fecha conferindo se respondeu.Não pegou? É um destes três
O teste foi numa conversa antiga
Com histórico no meio, fica difícil saber se a resposta veio da regra ou do que já estava na conversa. Teste numa conversa nova.
Outra instrução manda o contrário
Se as suas instruções pedem "respostas completas e detalhadas", a regra 2 perde. Releia o campo inteiro e tire o que briga com as regras.
Agora ele pergunta demais
É a troca que o próprio autor do arquivo avisa: as regras puxam para cautela em vez de velocidade. Em pedido rápido, escreva "pode ir direto" e ele vai.
Créditos
Andrej Karpathy
O post de 26 de janeiro de 2026 com os erros e a dica do critério de sucesso.
x.com/karpathy ↗Jiayuan Zhang (forrestchang)
O arquivo com as quatro regras e o plugin para o Claude Code.
github.com/multica-ai/andrej-karpathy-skills ↗Testou?
Me conta nos comentários do Reel, ou no direct, qual das quatro regras mais mudou as respostas do seu Claude. E me segue no Instagram: é lá que eu posto o que testo.
Dante Araújo @dantearaujo