Guia Karpathy: um CLAUDE.md para o Claude Code ser cauteloso antes de alterar código

Para quem é

Se você altera principalmente repositórios no Claude Code e quer menos armadilhas comuns de código dos LLMs, este material cabe melhor. É um CLAUDE.md para melhorar o comportamento do Claude Code, a partir das observações de Andrej Karpathy sobre essas armadilhas:

https://x.com/karpathy/status/2015883857489522876

A página diz que os quatro princípios estão no mesmo arquivo e correspondem diretamente a esses problemas. O texto de página disponível não traz os nomes nem o corpo desses quatro; não invente nomes nem um conjunto de lemas. Você precisa de quem já usa Claude Code e aceita instalar um plugin. Se só quer ler a publicação e não pretende mudar a configuração local do Claude Code, o link acima basta.

Primeira tentativa em 3 minutos

A instalação oficial recomendada são dois passos seguidos; faltar um significa que não está instalado. Primeiro execute no Claude Code:

/plugin marketplace add forrestchang/andrej-karpathy-skills

Em seguida instale o plugin imediatamente:

/plugin install andrej-karpathy-skills@karpathy-skills

Isso altera a configuração de plugins do Claude Code; não é uma consulta somente leitura. Antes de executar, confirme que está no ambiente Claude Code em que quer gravar e conclua os dois passos. Não adicione só o marketplace sem fazer install.

Depois de instalado, compare primeiro; não refatore o repositório de imediato. Escolha uma intenção de mudança não trivial, peça ao Claude Code que explique como pretende alterar e quais arquivos vai tocar, e só permita escrever código depois do seu ok. O sinal de sucesso: ele mostra «cautela antes da velocidade», explica e depois age, em vez de abrir um grande patch de cara. Se começar a refatorar módulos sem relação, pare primeiro.

Casos de uso

Caso 1: Uma tarefa de código não trivial. O guia existe para melhorar o comportamento do Claude Code diante das armadilhas de código dos LLMs. Limite a tarefa a «primeiro confrontar CLAUDE.md e depois alterar». O texto de página disponível não dá títulos desses quatro princípios; você não pode exigir que ele execute um nome de princípio inventado. Você pode pedir: ler este único arquivo e então dar o escopo da mudança. Verifique dois pontos: ele leu este guia e deu o escopo antes de alterar arquivos.

Caso 2: Decidir se aplica o processo rigoroso completo. A página deixa claro que esses guias privilegiam cautela, não velocidade. Em tarefas triviais (erro simples de digitação, alteração óbvia de uma linha), você decide; não precisa do conjunto completo toda vez. Quando só corrige um erro óbvio, diga com clareza que é uma alteração trivial e que não amplie o processo. Ele não define regra automática para «óbvio» e não diz quais tipos de arquivo são exceção. O limite você julga na hora; se o agente transformar a correção de um erro em refatoração, já saiu deste caso.

Limites de uso

Isto é um CLAUDE.md para o Claude Code, não um pacote de regras para editores genéricos. A página não descreve os passos para renomeá-lo para outros produtos. Os quatro princípios estão no mesmo arquivo, mas o texto de página disponível para em «há quatro e correspondem a esses problemas»; não há um inventário de princípios. Não acrescente nomes nem finja que já citou as frases originais do arquivo.

A instalação recomendada é o marketplace add acima e depois plugin install. Os dois passos são necessários. Não coloque outro instalador ao lado. As observações de origem estão na publicação de Karpathy; o guia em si é um uso derivado e não substitui o contexto dessa publicação.

A primeira parada é «primeiro explicar, depois alterar». Qualquer refatoração além da tarefa atual, reordenação em massa ou nova abstração deve primeiro nomear os arquivos que vai alterar e o motivo; você confirma e só então continua. Em alteração trivial, rebaixe o processo você mesmo para que um erro de grafia não percorra o conjunto completo.