As Regras do Que o Claude Não Pode Fazer
O CLAUDE.md de 4 regras que diz o que a IA não deve fazer: como instalar no Claude Code, versão em português e teste de antes e depois.
O que é
As Regras do Que o Claude Não Pode Fazer
Neste tutorial você coloca no seu projeto um CLAUDE.md com quatro regras que dizem o que o Claude não deve fazer: complicar o simples, assumir sem entender, mexer além do pedido e dar o trabalho por terminado sem prova.
O arquivo original vem de um desenvolvedor que reuniu observações de Andrej Karpathy sobre erros de IA ao programar. Você instala o original ou usa a versão em português da página, confirma com /context que o Claude leu e roda um teste de antes e depois.
O arquivo reduz erros comuns, mas é contexto e não uma trava: a página explica o limite e o que fazer quando o Claude não obedece.
4 regras de proibição
Simplicidade, perguntar antes, mudanças cirúrgicas e prova de que ficou pronto.
Instalação segura
Comandos que não sobrescrevem um CLAUDE.md que você já tem.
Versão em português
Texto pronto para colar, com a regra de prova.
Teste antes e depois
Prompts para comparar o Claude com e sem o arquivo.
Nível: iniciante · Tempo estimado: ~15 min
Este arquivo reduz erros comuns de uma IA de código (complicar demais, assumir sem perguntar, mexer no que não pediu). Não há benchmark que prove que o Claude fica mais inteligente, e o nosso antes/depois ainda não foi feito: rode o teste da página no seu projeto e compare. O CLAUDE.md é lido pelo Claude como contexto, não como regra imposta; para travar de verdade existem hooks.
Pré-requisitos
- Claude Code instalado (precisa de assinatura Claude ou conta Console) e um projeto com código. Para só usar no app do Claude, veja o passo 6: instruções de projeto exigem plano pago.
- Terminal aberto na pasta do projeto.
- Custo: o arquivo é grátis. O repositório original declara licença MIT no README, mas não tem arquivo LICENSE no GitHub; por isso a versão em português abaixo é a que recomendamos reproduzir.
Conceitos-chave
- 01
CLAUDE.md
Arquivo de texto que o Claude Code lê no começo de toda sessão. Fica na raiz do projeto (ou em .claude/CLAUDE.md), ou em ~/.claude/CLAUDE.md para valer em todos os projetos.
- 02
Regra de proibição
Em vez de dizer só o que fazer, o arquivo diz o que não fazer: não complicar, não assumir, não mexer no que não foi pedido. A quarta regra é positiva: definir como saber que terminou.
- 03
Origem do arquivo
O arquivo não foi escrito por Andrej Karpathy. O desenvolvedor Jiayuan Zhang (usuário @forrestchang) o derivou de observações de Karpathy sobre erros de IA ao programar. Hoje o repositório está em multica-ai/andrej-karpathy-skills.
- 04
Contexto, não trava
O Claude trata o CLAUDE.md como contexto. Mantenha curto (a documentação recomenda menos de 200 linhas) e sem instruções que se contradigam.
Passo a passo
- 01
Entre na pasta do projeto
Abra o terminal na raiz do projeto.
cd seu-projeto - 02
Veja se já existe um CLAUDE.md
Se aparecer o nome do arquivo, ele já existe: use a opção B do passo seguinte. Se aparecer erro, use a A.
ls CLAUDE.md - 03
Instale as regras originais em inglês (opcional)
A: projeto sem CLAUDE.md, baixa o arquivo original. B: projeto com CLAUDE.md, acrescenta no final. Nunca use curl -o se o arquivo já existe, porque ele sobrescreve tudo.
# A) não existe CLAUDE.md curl -o CLAUDE.md https://raw.githubusercontent.com/multica-ai/andrej-karpathy-skills/main/CLAUDE.md # B) já existe CLAUDE.md echo "" >> CLAUDE.md curl https://raw.githubusercontent.com/multica-ai/andrej-karpathy-skills/main/CLAUDE.md >> CLAUDE.md - 04
Ou use a versão em português
Crie ou edite o CLAUDE.md na raiz e cole o primeiro prompt abaixo (a versão em português, com as 4 regras e a regra de prova). É a recomendada: o texto é nosso, derivado dos princípios do original, e a regra 4 é adaptada.
- 05
Confirme que o Claude carregou o arquivo
Abra o Claude Code na pasta e rode /context. O CLAUDE.md deve aparecer em Memory files.
claude /context - 06
Teste antes e depois
Rode o terceiro prompt numa sessão sem o arquivo e depois com ele, na mesma base de código, e compare quanto o Claude mexeu e se mostrou como conferiu. Para usar no app do Claude, cole a versão em português nas instruções de um projeto (disponível em plano pago).
Alternativa por plugin (não testada por nós): o README do repositório indica instalar como plugin no Claude Code, que vale para todos os projetos. Como plugin é uma skill, ela carrega sob demanda e pode não valer o tempo todo; o CLAUDE.md vale sempre. Se quiser tentar, confira o comando atualizado no README do repositório.
Prompts prontos
Prompt: Versão em português com as 4 regras (cole no CLAUDE.md)
Regras deste projeto. Valem para toda tarefa, sem exceção. 1. Não complique o que é simples. Faça a menor mudança que resolve. Nada de estrutura, abstração ou opção que ninguém pediu. 2. Não assuma quando não entendeu. Se o pedido estiver ambíguo, diga o que ficou confuso e pergunte antes de fazer. 3. Não mexa em nada além do que foi pedido. Não "melhore" arquivo, texto ou código vizinho. Foco num lugar só. 4. Confira antes de dizer que terminou. Defina como saber que ficou pronto, rode a verificação e mostre a prova: o que rodou e o que deu. "Deve funcionar" não conta como pronto.
Prompt: Confirmar que o Claude leu as regras
Liste, uma por uma, as regras do CLAUDE.md deste projeto que você vai seguir nesta sessão e diga em uma frase o que cada uma muda no seu comportamento.
Prompt: Teste antes e depois com uma tarefa pequena
Troque o texto do botão principal da página inicial de "Enviar" para "Quero começar". Mexa só no necessário e, antes de dizer que terminou, mostre como você conferiu.
Prompt: Forçar a regra 2 (perguntar antes)
Quero melhorar a performance do meu site. Antes de mexer em qualquer coisa, me diga o que ficou ambíguo no pedido e faça as perguntas necessárias.
Prompt: Forçar a regra 4 (prova de que ficou pronto)
Corrija o bug descrito abaixo. Só considere pronto quando você tiver rodado o teste que reproduzia o bug, visto ele falhar antes e passar depois, e me mostrado a saída dos dois. Bug: [descreva o bug aqui, com a mensagem de erro]
No último prompt, troque o trecho entre colchetes pela descrição do seu bug. A regra de prova (mostrar o que rodou e o que deu) é uma adaptação nossa; o arquivo original pede critérios de sucesso verificáveis e iterar até confirmar.
Erros comuns
- O curl -o apagou o meu CLAUDE.md: ele sobrescreve. Restaure pelo git e use >> (opção B do passo 3).
- Colei e nada mudou: o arquivo não foi carregado. Rode /context e confira se ele aparece; ele precisa estar na pasta onde você abriu o claude.
- O Claude desobedeceu uma regra: CLAUDE.md é contexto, não trava. Reforce no pedido ou use hooks para impor de verdade.
- Regras que se contradizem (as suas com as do arquivo): o Claude pode escolher uma delas de forma arbitrária. Revise e deixe só uma versão de cada regra.
- Arquivo enorme: acima de umas 200 linhas o Claude segue pior. Mantenha só o que importa.
- Esperar que fique mais inteligente: o ganho esperado é errar menos nos erros comuns, não raciocinar melhor.
Checklist final
- O CLAUDE.md está na raiz do projeto, com as 4 regras
- /context lista o CLAUDE.md em Memory files
- Rodei a tarefa de teste antes e depois do arquivo e comparei
- Na regra 4, o Claude me mostrou o que rodou e o resultado
- Não coloquei senha, chave ou dado de cliente no arquivo
- Escolhi entre CLAUDE.md (vale sempre) e plugin (sob demanda)
Créditos
Os princípios vêm de observações de Andrej Karpathy sobre erros de IA ao programar, reunidas em um CLAUDE.md por Jiayuan Zhang (@forrestchang), hoje em github.com/multica-ai/andrej-karpathy-skills. A versão em português e a regra de prova são nossas.
Próximos passos
- Entenda o erro de não usar CLAUDE.md e mais quatro: /open-source/aprendizado/5-erros-que-estao-sabotando-seus-resultados-com-claude
- Veja o CLAUDE.md como um dos recursos do Claude Code: /open-source/skills/5-codigos-secretos-do-claude-que-mudam-tudo
- Instalar e configurar o Claude Code (documentação oficial): https://code.claude.com/docs/en/overview
- Dê atalhos de resposta ao Claude: /open-source/skills/20-codigos-secretos-do-claude
Comece agora
Pronto para colocar As Regras do Que o Claude Não Pode Fazer para rodar?
Ver o repositório no GitHubPróximo passo
Veja os outros recursos do catálogo
Dezenas de recursos entre squads, skills, apps e integrações — todos usados em produção pelo João.
Voltar ao catálogo