andrej-karpathy-skills: CLAUDE.md que corrige vícios do Claude Code — código limpo
O repositório multica-ai/andrej-karpathy-skills é um único arquivo CLAUDE.md que ensina o Claude Code a parar de inventar código, inflar abstrações e assumir coisas erradas. Com 137.195 stars e 14.064 forks em maio de 2026, virou um dos projetos open-source mais populares do GitHub. A proposta nasceu de um post viral de Andrej Karpathy (ex-OpenAI, ex-Tesla) listando os vícios dos LLMs ao programar: não pedem esclarecimento, não gerenciam confusão, não apresentam trade-offs e adoram criar 1.000 linhas onde 100 bastariam. O autor jiayuan_jy condensou essas observações em regras práticas que você cola no projeto e o agente passa a se comportar de outro jeito. Para quem está fazendo vibe coding sério — não brincadeira de fim de semana — é a diferença entre código que entra em produção e código que vira dívida técnica em 2 semanas.
O que faz
Um único arquivo de texto. Você baixa, coloca na raiz do projeto como CLAUDE.md, e o Claude Code passa a seguir aquelas regras em toda conversa.
O conteúdo é um conjunto de instruções diretas para o agente: pesquise o código antes de editar, não invente APIs, não crie abstrações desnecessárias, não escreva error handling para cenários impossíveis, não deixe código morto, peça esclarecimento quando algo estiver ambíguo.
Funciona porque o Claude Code lê CLAUDE.md automaticamente no início de cada sessão e trata aquilo como instrução prioritária. Não precisa instalar nada, não precisa rodar comando. É configuração por arquivo.
O efeito prático: o agente para de gerar funções genéricas “por garantia”, para de adicionar try/catch em código que não pode falhar, e começa a perguntar antes de assumir.
Por que está em alta
O post original de Karpathy no X teve milhões de visualizações em fevereiro de 2026 e gerou uma onda de devs procurando soluções práticas. O repositório saiu de 0 a 137 mil stars em menos de 90 dias.
O último commit foi há 29 dias — sinal de que o autor ainda mantém, mas o projeto também não precisa de muito código. É um arquivo de texto.
A validação social está nos 14 mil forks: empresas e devs estão pegando o CLAUDE.md base e adaptando para seus stacks (Next.js, Rails, Django, etc).
Tabela de métricas
| Métrica | Valor |
|---|---|
| Stars | 137.195 |
| Forks | 14.064 |
| Licença | Não especificada |
| Último update | 29 dias atrás (abril 2026) |
| Linguagem | Markdown (arquivo único) |
| Contributors | 7 |
| Issues abertas | 94 |
Para quem serve / Para quem NÃO serve
Serve para: empreendedor que usa Claude Code para construir MVP, automações internas, scripts de pipeline ou sites. Quem já sentiu o agente criar uma classe de 400 linhas para fazer um IF. Quem cansou de ver try/except em código que não pode lançar exceção. Quem quer que o agente pergunte em vez de chutar.
Não serve para: quem usa Cursor, Copilot, Windsurf ou qualquer outro agente que não seja Claude Code — o arquivo é lido especificamente por essa ferramenta. Também não resolve problemas de prompt do usuário: se você pedir “faz uma coisa legal aí”, nem CLAUDE.md salva.
Limitação honesta: não tem licença declarada. Para uso pessoal e em projetos privados, tranquilo. Para incluir em produto comercial open-source, o ideal é abrir uma issue pedindo esclarecimento.
A concentração de commits (61% em um único contributor) é risco médio — se o autor parar, o repo vira monumento. Mas como é arquivo único de texto, dá para forkar e seguir.
Alternativas
Cursor Rules (.cursorrules) — equivalente nativo do Cursor IDE. Grátis. Mesma lógica: arquivo de texto que vira instrução persistente. Funciona só dentro do Cursor.
Continue.dev — agente open-source com sistema de “rules” e “context providers”. Grátis. Mais complexo de configurar, mas funciona em VS Code e JetBrains.
Aider conventions — Aider (CLI open-source) suporta CONVENTIONS.md com função parecida. Grátis. Para quem prefere terminal puro.
Para quem está usando IA em fluxos de trabalho como Google Ads, a lógica é a mesma: instrução boa = resultado bom.
Veredicto
Vale o download. É arquivo de texto, custo zero, instalação em 10 segundos. Se você usa Claude Code para qualquer coisa séria — mesmo automações pequenas de marketing — o ganho de qualidade compensa nos 5 primeiros prompts. Forke, adapte ao seu stack, commite no repo do projeto.
CEO @leadmarkbr · Especialista em SEO e Tráfego Pago
CEO da LeadMark desde 2012. Mais de 15 anos em Google Ads, SEO/GEO e Meta Ads. Gero +60k leads/mês para 30 mil corretores de planos de saúde em todo o Brasil. Certificado Google Ads Search. Palestrante em eventos de marketing digital.
