Tornei o Claude Code pior ao dar-lhe muita liberdade, e aqui está como mantê-lo focado no laser

Eu realmente não preciso convencê-lo de que as ferramentas de IA quebram facilmente. Você faz uma pergunta simples e eles lhe dão uma resposta que não responde a nada do que você realmente está perguntando. Você pede para eles limparem sua área de trabalho, eles limpam tudo. Um agente de criptografia executado por Claude em uma empresa chamada PocketOS excluiu acidentalmente todo o banco de dados de produção em nove segundos durante um teste de rotina. Quando o fundador perguntou o que havia acontecido, o agente admitiu que havia adivinhou em vez de verificando. Tudo isso para dizer que o agente de IA que fica confuso e toma decisões erradas é muito perturbador no momento.

Por melhores que essas ferramentas de codificação de IA tenham se tornado, é tentador continuar atribuindo-lhes mais responsabilidades. Dê-lhes tarefas maiores, resumos mais vagos com instruções vagas e deixe-os executar. Essa é a maioria de nós, e parece certo. Infelizmente, é também um movimento que os quebra silenciosamente. Falando no Código Claude, aqui estão algumas maneiras de mantê-lo focado.

Começa entendendo que o problema não é Claude Code

Nenhuma configuração corrige informações pouco claras

Antes de falar sobre as configurações do código de Claude que eu ajustei especificamente, vale a pena dizer algo mais fundamental: na maioria das vezes, quando o código de Claude sai dos trilhos, o problema geralmente é você é usando-o. Com ferramentas de IA, o modelo fará aproximadamente o que você permitir. Se você lhe confiar uma tarefa vaga e com total autonomia, ele improvisará. Às vezes ele improvisa de maneira brilhante, às vezes desastrosamente, e você não consegue escolher qual. Claro, existem configurações que limitam as ações do agente de IA, mas em última análise a responsabilidade é sua.

Portanto, é extremamente importante que você acerte o básico. Seja extremamente específico sobre o que você quer e igualmente específico sobre o que você não quer. Se você não consegue descrever seus requisitos adequadamente e não sabe realmente o que deseja, o Claude Code (como qualquer outra ferramenta) preencherá as lacunas e você já perderá o controle da saída antes que o primeiro token seja gerado. Com essa mentalidade fora do caminho, aqui está o que eu realmente consertei.

O modo de agendamento faz a maior parte do trabalho

Não apenas no começo

A maneira mais fácil de controlar o Código de Claude é usar o modo de programação. Se você não estiver familiarizado com ele, o modo de planejamento coloca o Cloud em um estado somente leitura, onde ele pode analisar seu código, fazer perguntas e oferecer um plano passo a passo. A diferença é que ele não pode editar nada neste modo. Ele não pode executar comandos ou tocar em seus arquivos até que você desligue o modo de programação. Você pode alterná-lo pressionando Shift + Tab duas vezes e sair da mesma forma quando estiver satisfeito com o que ele tem a oferecer.

A razão pela qual isso é importante é porque a maioria das coisas catastróficas que Claude Code descobre acontecem nos primeiros trinta segundos de uma missão, antes que você tenha a chance de corrigir o curso. Ele lê seu prompt, faz algumas suposições sobre o que você deseja e prossegue para cumprir essas suposições com segurança. No momento em que você percebe que está indo na direção errada, já tem três arquivos de profundidade. O modo de planejamento força uma pausa antes que tudo isso aconteça, e você pode ver exatamente o que Claude pensa que está perguntando e exatamente como planeja fazer isso, antes de alterar uma única linha de código.

Uma coisa importante que quero mencionar aqui é que tenho visto muitas pessoas usarem o modo de planejamento, mas só o usam no início do projeto. Eles planejarão o andaime inicial, farão uma implementação limpa e, depois que a execução começar, nunca mais voltarão ao modo de planejamento pelo resto da sessão. Acho que esse é o maior erro que você pode cometer! O modo de planejamento não é apenas uma etapa de configuração – é uma ferramenta que você precisa usar sempre que a tarefa em questão não for mais trivial. Especialmente se você estiver depurando alguma coisa!

CLAUDE.md é mais importante do que você pensa

Escreva como você quer dizer

Outra coisa inegociável para mim é criar um arquivo CLAUDE.md para cada projeto em que trabalho no código do Claude. Se você ainda não encontrou um, CLAUDE.md é um arquivo tag localizado na raiz do seu projeto que é lido automaticamente pelo Claude Code no início de cada sessão. É aqui que você coloca as regras, convenções e o que fazer/não fazer que Claude faça em cada tarefa. Isso inclui arquivos que você nunca deseja tocar, criação de estilos de mensagens, conjuntos de tecnologia que deseja usar, convenções de nomenclatura de variáveis ​​e funções e basicamente todas as decisões que você toma e que não deseja repetir continuamente.

Sem CLAUDE.md, você depende totalmente do prompt que escreveu há alguns segundos para incluir todo esse contexto. Mesmo que você se lembre de incluir sempre as restrições importantes (o que não fará), você estará queimando fichas e prestando atenção às coisas que deveriam estar no ambiente. Portanto, antes de iniciar qualquer projeto, executo o comando /init para gerar automaticamente o arquivo CLAUDE.md. Então eu anexo a este arquivo. Cada vez que Claude faz algo que eu não quero, isso vai para o arquivo. Ele editou algo que eu disse para deixar de lado? No arquivo. Substituiu uma função limpa em um estilo que não uso? No arquivo.

Ao longo de algumas semanas de trabalho assim, CLAUDE.md naturalmente se torna algo que reflete como o projeto realmente funciona, não apenas o que parece na superfície. No entanto, é importante garantir que o arquivo CLAUDE.md não fique muito longo e esteja limitado às regras mais importantes. Um CLAUDE.md inchado é quase tão ruim quanto não ter um!

Eu uso o comando /clear com bastante frequência

Uma lousa em branco é mais barata que uma hora perdida

Dado que os limites de velocidade das ferramentas de IA têm sido um grande tópico de conversa ultimamente, você provavelmente já ouviu pessoas recomendando o uso de recursos como projetos e a mudança para novas conversas com a maior freqüência possível. Geralmente, a lógica é que sessões mais curtas registram menos tokens de uma só vez, o modelo funciona melhor em um contexto focado e o LLM não precisa mais ler toda a conversa anterior para responder à sua próxima pergunta. Este conselho também se aplica às conversas normais de Claude, mas é ainda mais importante no código de Claude, porque as consequências de uma sessão inchada não são apenas respostas mais lentas ou respostas piores. Agora eles também fazem Claude editar o arquivo errado porque ele ainda se lembra parcialmente da restrição da tarefa que você concluiu há uma hora.

O comando /clear slash é a maneira de fazer isso no código de Claude. Isso exclui completamente sua sessão atual. Agora, muitas pessoas não usam esse comando ou só o usam quando as coisas dão errado. O problema é que, no momento em que uma sessão está ruim o suficiente para ser excluída, você já queimou trinta minutos de produção, degradando silenciosamente os últimos vinte. Vejo /clear como um movimento que faço entre as tarefas, não como um movimento que faço depois que uma delas foi para o lado. Você terminou o recurso? / claro. Você quer começar algo que não tem nada a ver com o anterior? /claro, sempre. Dessa forma, você poderá controlar seus limites e manter Claude mais atento para a tarefa em questão!

Configure as permissões antes que elas sejam necessárias

Não troque segurança por menos cliques

Claude Code pede sua permissão antes de executar qualquer ação potencialmente destrutiva, como executar um comando shell, editar um arquivo ou executar em uma rede. Por padrão, isso significa muitos cliques de “confirmação” durante a sessão, o que a maioria das pessoas incentiva — permissões de pular perigosas a bandeira. Agora você não deveria fazer isso. Há uma razão pela qual a Anthropic literalmente chamou esse modo de perigoso.

A questão das permissões é que elas são a última coisa entre a nuvem e um arquivo destruído, um push de ramificação forçado ou um banco de dados excluído (que é exatamente o cenário do PocketOS que descrevi no início). O que você realmente quer é um meio termo. Você pode abrir .claude/settings.json e colocar comandos na lista de permissões sobre os quais realmente não precisa perguntar. Dessa forma, você para de clicar em “permitir” cinquenta vezes em uma sessão para obter comandos inócuos, e a verdadeira rede de segurança ainda está disponível para os comandos importantes.

Ainda depende de você

Novamente, no final do dia, em última análise, depende de você. O Código Claude só pode ser tão focado quanto as restrições que você aplica a ele!