Quando não usar o Claude Code? Os casos em que fazer na mão sai mais rápido

Fala aí, beleza? Nem toda tarefa fica mais rápida só porque tu jogou ela pro agente

Esse é o ponto que quase ninguém fala no meio do hype de delegar tudo

A pergunta que importa não é "o Claude Code consegue fazer isso?", porque na maioria das vezes ele consegue

A pergunta certa é outra: compensa o tempo que tu gasta descrevendo o pedido, esperando a leitura do arquivo e revisando o diff, mais o custo que aquilo queima?

Tem tarefa em que a resposta é um sonoro não, e é justamente essa lista que eu quero montar aqui 🙂

Os cenários em que fazer na mão sai mais rápido

Correção de uma linha, typo, log ou renomear variável:

A documentação oficial de boas práticas do Claude Code é bem direta nisso: quando o escopo é claro e a correção é pequena, tu pede a alteração direta, sem plan mode

E os exemplos que ela cita são exatamente esses três: corrigir um erro de digitação, adicionar uma linha de log, renomear uma variável

A regra prática que a doc dá vale o post inteiro: se você consegue descrever o diff em uma frase, pule o plano

Formação Recomendada

Formação Claude Code

Domine Claude Code do absoluto zero até o avançado

• 120 aulas
• 4 projetos
• 9h 45min

Conhecer formação

Agora estica esse raciocínio mais um passo, que é onde entra a mão

Se o diff cabe em uma frase E tu já sabe o arquivo e a linha, descrever o pedido é escrever o mesmo código só que com mais palavras

Se liga na diferença: a doc te manda pular o PLANO, não a ferramenta. Pular a ferramenta é decisão tua, e ela nasce do mesmo critério

O ajuste que você já sabe de cabeça:

Esse é o clássico

Tu abre o arquivo, sabe a linha, sabe o valor novo, sabe o efeito colateral, e mesmo assim abre uma sessão pra pedir

Aí o tempo de escrever um pedido BOM (contexto, arquivo, o que não pode quebrar) passa do tempo de digitar a mudança

E tem o custo escondido: tu ainda vai ler o diff pra conferir

Ou seja, tu paga o preço de revisar um código que tu já tinha na cabeça pronto

Aqui a régua é honesta: se o gargalo da tarefa era DIGITAÇÃO, agente nenhum acelera isso

Decisão que depende de contexto que não está no repositório:

Esse cenário é o mais subestimado de todos

O Claude Code opera sobre o diretório de trabalho, e o acesso a pastas fora dele depende de configuração explícita: a doc de bases de código grandes cita a configuração additionalDirectories, em .claude/settings.json, pra dar acesso a diretórios fora do diretório de trabalho

Traduzindo pro dia a dia: o que está fora do que ele enxerga, ele não sabe

Combinado verbal de time, decisão de arquitetura tomada numa call, restrição de negócio que só o cliente falou, regra que mora na cabeça de um dev sênior

Nada disso está no repo

Então quando a decisão é "qual das duas abordagens respeita o acordo que a gente fechou semana passada", o agente não tem como acertar por adivinhação, e tu vai gastar mais tempo explicando o mundo do que resolvendo

Tome cuidado com esse tipo de tarefa: ela parece técnica, mas é política. E política não está commitada 😀

Trabalho rotineiro entregue a um time de agentes:

Aqui quem desaconselha é a própria documentação

A doc de agent teams diz que times de agentes consomem cerca de 7x mais tokens que uma sessão padrão quando os teammates rodam em plan mode, porque cada teammate mantém a própria janela de contexto e roda como uma instância separada do Claude

E ela é explícita sobre o critério: para tarefas rotineiras, uma sessão única é mais econômica; para pesquisa, revisão e feature nova, os tokens extras costumam valer a pena

Ou seja, não é só "na mão x agente"

Tem um degrau no meio que muita gente pula: sessão única em vez de time inteiro pra fazer coisa repetitiva

Na mão x Claude Code: qual escolher por tipo de tarefa

A fronteira aqui não é chute meu, sai direto da doc de boas práticas: planejar compensa quando tu está incerto sobre a abordagem, quando a mudança altera múltiplos arquivos ou quando tu não conhece o código que vai ser modificado

Inverteu qualquer um desses três? Provavelmente a mão ganha

Repara que a tabela não tem nenhuma linha dizendo "o agente não consegue"

Ele consegue. A conta é de tempo e de custo, não de capacidade

O que eu vi na prática antes de decidir delegar

Agora sai da doc e vai pro material meu mesmo

No vídeo abaixo eu rodo um projeto novo do zero (um app de resenhas de livros) com planejamento em um modelo e execução em outro

Dois números que saíram dali e que eu uso como referência até hoje: a ferramenta levou quase meia hora pra montar o projeto inicial, e no fim da execução apareceram 2 tarefas marcadas como pendentes

Cobrei essas duas e a conclusão foi que já estavam feitas: era só falha visual

E teve atrito de verdade no meio do caminho

Abri o app e tomei erro logo de cara, tive que pedir correção mais de uma vez até rodar

Precisei digitar eu mesmo o comando de reiniciar o servidor no terminal, e olha que reiniciar nem foi um comando só: apareceu processo sendo morto e mais passo manual no meio

Pra quem é leigo, isso já é uma barreira

Na hora de resolver o problema fui EU que sugeri o caminho pra ferramenta, uma luta 😛

Ainda apareceu aviso de contexto no meio, resolvi limpando o contexto e mandando reiniciar

No fim o app funcionou: like contando, dados persistindo, resenha publicada

A entrega saiu apesar do atrito

Meia hora de execução vale MUITO num projeto do zero, porque o começo é justamente a parte que mais demora

A mesma meia hora vale pouquíssimo num ajuste de uma linha que tu resolveria em dez segundos

Mesma ferramenta, mesmo modelo, resultado econômico oposto

Delegar sem queimar orçamento: o custo entra na conta

Parte do "não usar" não é sobre tempo, é sobre dinheiro

A documentação oficial de custos do Claude Code publica a média observada em implantações enterprise: cerca de US$ 13 por desenvolvedor por dia ativo e US$ 150 a US$ 250 por desenvolvedor por mês, sendo que pra 90% dos usuários o custo fica abaixo de US$ 30 por dia ativo

A própria doc põe a ressalva, e ela é importante: esse custo varia muito conforme escolha de modelo, tamanho da base de código e padrão de uso (rodar múltiplas instâncias, automação)

Por isso a recomendação dela é fazer um piloto pequeno pra estabelecer a linha de base, em vez de assumir a média dos outros como se fosse tua

E lembra do multiplicador lá de cima: cerca de 7x mais tokens quando o trabalho vai pra um time de agentes com teammates em plan mode

Joga isso numa tarefa rotineira e tu tem a receita perfeita de queimar orçamento pra fazer algo que uma sessão só resolvia

Agora o meio-termo, que é o que eu mais uso

Nem tudo é "mão ou agente", dá pra baixar o custo da própria delegação:

1. Trocar de modelo pelo comando /model: ele aceita um alias, por exemplo haiku, ou o nome completo do modelo. Tarefa mecânica não precisa do modelo mais caro da casa
2. Fixar pra qual modelo cada alias resolve por variável de ambiente: a doc de model config lista as variáveis ANTHROPIC_DEFAULT_SONNET_MODEL, ANTHROPIC_DEFAULT_OPUS_MODEL, ANTHROPIC_DEFAULT_HAIKU_MODEL e ANTHROPIC_DEFAULT_FABLE_MODEL, que definem para qual modelo cada alias resolve no Claude Code
3. Usar subagente pra rotear a tarefa: a doc de subagentes cita controle de custo como motivo pra mandar tarefa pra modelo mais rápido e barato, além de preservar o contexto da conversa principal e limitar quais ferramentas o subagente pode usar

O raciocínio é o mesmo em todos: gastar caro só onde a dificuldade é real

Se o teu caso é o contrário, tarefa difícil que pede raciocínio a mais, vale entender quando o extended thinking compensa antes de sair aumentando a conta no escuro

Veredito: a régua para decidir em 10 segundos

Sem enrolação, a régua é essa:

• Faça na mão se tu consegue descrever o diff em uma frase E conhece o arquivo que vai mexer
• Delegue se a abordagem está incerta, se a mudança cruza múltiplos arquivos ou se o código é desconhecido pra ti
• Não chame um time de agentes pra trabalho rotineiro, porque a doc diz na cara que sessão única sai mais econômica
• Traga o contexto antes quando a decisão depende de coisa que não vive no repositório, senão tu está pedindo adivinhação

E o veredito honesto, sem tom de venda: o problema nunca foi a ferramenta

O problema é usar agente onde o gargalo era digitação

Delegar tarefa pequena não te deixa mais produtivo, te deixa ocupado revisando diff de coisa que tu já sabia fazer

Se a tua dúvida for outra, tipo qual ferramenta deixar aberta o dia inteiro, eu já fiz uma comparação entre Claude Code e Cursor que ataca esse outro lado da decisão

Conclusão

Saber quando não usar o Claude Code não é ceticismo com IA, é gestão de recurso

Cada não numa tarefa de uma linha é orçamento e atenção que sobram pra tarefa grande, aquela que realmente ganha meia hora de execução como a que eu mostrei no vídeo

Próximo passo bem concreto, e dá pra fazer hoje: pega as tuas próximas cinco tarefas e separa em duas pilhas, "diff de uma frase" e "abordagem incerta"

A primeira pilha tu resolve na mão, a segunda tu delega

E roda um piloto pequeno pra descobrir a TUA linha de base de custo, como a própria documentação sugere, em vez de herdar a média de terceiros

Em duas semanas tu vai ter um critério teu, medido, e não uma regra copiada da internet…

até o próximo post! 😀