4 truques simples para gastar menos tokens no Claude Code

Renê Fraga
8 min de leitura

Principais destaques

  • Menos exploração: limitar o contexto do repositório evita que o Claude desperdice tokens procurando arquivos que não têm relação com a tarefa.
  • Esforço sob medida: tarefas simples não precisam do nível máximo de raciocínio, enquanto problemas complexos podem justificar um esforço maior.
  • Contexto mais enxuto: regras permanentes no CLAUDE.md e PDFs previamente condensados reduzem instruções e informações desnecessárias.

O Claude Code pode parecer econômico enquanto trabalha, mas existe um detalhe fácil de ignorar: boa parte dos tokens pode ser consumida antes mesmo de a correção começar.

Em projetos grandes, por exemplo, uma solicitação vaga pode fazer o agente vasculhar diretórios, procurar funções, abrir arquivos e tentar entender relações que não têm nenhuma importância para o problema original.

A solução não é simplesmente usar menos o Claude Code. É fazer com que ele gaste esforço onde realmente importa.

1️⃣ Pare de deixar o Claude explorar o projeto inteiro 🔎

Imagine pedir para um programador encontrar um pequeno bug em um sistema com milhares de arquivos.

Se você disser apenas “corrija esse problema”, ele precisará descobrir sozinho onde procurar.

Pode funcionar. Mas cada busca, arquivo aberto e pedaço de código analisado pode entrar no contexto da conversa.

🎯 O ganho está no foco: se você já sabe que o problema está em determinado plugin, componente ou diretório, diga isso.

Em vez de:

“Investigue esse bug no projeto.”

Prefira algo como:

“O bug está provavelmente no componente X. Analise primeiro os arquivos relacionados a ele e faça a menor alteração necessária.”

Isso reduz a exploração e deixa mais tokens disponíveis para a solução.

Quanto maior o projeto, maior a diferença

Em um pequeno repositório, a economia pode ser pouco perceptível.

Em uma aplicação enorme, porém, deixar o agente “andar livremente” pode significar uma quantidade considerável de contexto consumido apenas para descobrir onde está o problema.

A ideia é simples: não entregue uma cidade inteira quando o agente precisa encontrar apenas uma rua.

2️⃣ Não use esforço máximo para tudo 🧠

Outro desperdício aparece quando o Claude é colocado para raciocinar no nível máximo mesmo diante de uma tarefa trivial.

O autor do texto relata que passou a usar Medium para trabalhos como:

• correções pequenas;
• alterações pontuais;
• refatorações simples;
• recursos básicos.

A lógica é evitar transformar cada mudança de código em uma investigação arquitetural.

⚖️ A regra é proporcionalidade: problemas simples recebem esforço moderado; problemas realmente difíceis ganham mais capacidade de raciocínio.

Isso também evita uma armadilha comum dos agentes de IA: pedir que eles pensem profundamente sobre algo que poderia ser resolvido em poucos passos.

💡 O objetivo não é usar sempre menos raciocínio. É não pagar pelo raciocínio que a tarefa não exige.

E quando vale aumentar o esforço?

Há casos em que economizar tokens pode sair caro.

Um bug difícil, uma falha que aparece apenas em determinadas condições ou uma alteração que envolve várias partes do sistema pode exigir uma investigação mais profunda.

Nessas situações, aumentar o esforço faz sentido.

A estratégia, portanto, não é escolher Medium para sempre. É começar de acordo com a complexidade e aumentar quando necessário.

3️⃣ Coloque as regras permanentes no CLAUDE.md 📝

Se você trabalha repetidamente no mesmo projeto, provavelmente existem instruções que se repetem.

Padrões de código, preferências de arquitetura, comandos de teste e outras regras estáveis não precisam ser explicados novamente a cada conversa.

É justamente para isso que serve o CLAUDE.md.

Em vez de escrever:

“Use este padrão, não altere aquele componente, siga determinada convenção…”

em cada novo prompt, as orientações permanentes podem ficar registradas no arquivo do projeto.

📌 Mas há uma diferença importante: nem tudo deve ir para o CLAUDE.md.

Uma instrução específica de uma tarefa, como “não modifique este componente nesta correção”, continua melhor no prompt daquele trabalho.

Tipo de instruçãoOnde colocar
Regra permanente do projetoCLAUDE.md
Preferência recorrenteCLAUDE.md
Restrição de uma tarefaPrompt
Abordagem específica para um bugPrompt

Isso deixa os prompts menores e evita transformar uma exigência temporária em uma regra permanente.

4️⃣ Antes de mandar um PDF gigante, tire a gordura 📄

Documentos também podem consumir contexto rapidamente.

PDFs escaneados ou cheios de imagens, cabeçalhos repetidos, formatação e elementos gráficos podem carregar uma quantidade enorme de informação que nem sempre é necessária para a tarefa.

Uma alternativa apresentada pelo autor é condensar o documento antes de entregá-lo ao modelo mais pesado.

A ideia é produzir uma versão em texto simples com aproximadamente 20% a 30% do tamanho original, preservando o que realmente importa:

• fatos;
• números;
• datas;
• nomes;
• instruções;
• recomendações;
• estrutura essencial do documento.

O restante pode ser eliminado: linguagem promocional, repetições, elementos de formatação e outros ruídos.

O PDF não precisa desaparecer

Isso não significa transformar todo documento em um resumo superficial.

Se uma informação visual específica for importante, obviamente ela precisa ser preservada.

A técnica funciona melhor quando o objetivo é extrair informação textual e factual, e não analisar precisamente gráficos, diagramas, imagens ou a formatação original.

O verdadeiro truque é reduzir o trabalho invisível ⚡

Os quatro métodos têm algo em comum.

Não se trata simplesmente de escrever prompts menores ou ficar obcecado com o contador de tokens. O objetivo é eliminar trabalho que o agente não precisava fazer.

EstratégiaO que reduz
Limitar o repositórioExploração desnecessária
Ajustar o esforçoRaciocínio excessivo
Usar CLAUDE.mdRepetição de instruções
Condensar PDFsContexto irrelevante

Isso muda a maneira de pensar sobre agentes de programação.

O melhor prompt nem sempre é aquele que explica tudo. Muitas vezes, é aquele que elimina as coisas que o agente não precisa investigar.

E isso fica ainda mais importante em projetos grandes

Em um projeto pequeno, talvez você nem perceba a diferença.

Mas imagine trabalhar continuamente em uma base com milhares de arquivos, plugins, componentes e dependências. Se cada tarefa começa com o agente reconstruindo mentalmente uma parte enorme do projeto, o desperdício se acumula.

Por isso, limitar o escopo pode ser tão importante quanto melhorar a própria instrução.

🔎 A pergunta certa deixa de ser “como faço o Claude trabalhar mais?” e passa a ser “o que posso impedir que ele precise investigar?”

No fim, economizar tokens não significa necessariamente fazer menos com o Claude Code. Significa reduzir o caminho entre o problema e a parte do código que realmente precisa ser modificada.

E, em um projeto grande, às vezes a maior economia está justamente em não deixar o agente abrir a primeira porta que aparecer.

Apoie o Eurisko
Este conteúdo é independente, sem anúncios e feito por pessoas.
A inteligência artificial e as mudanças recentes do Google reduziram significativamente o alcance dos sites independentes. Se este conteúdo foi útil para você, considere apoiar o Eurisko e todo o ecossistema de projetos com qualquer valor.
Quero apoiar
Seguir:
Renê Fraga é fundador e editor-chefe do Eurisko, ecossistema editorial independente dedicado à inteligência artificial, código aberto, tecnologia e cultura digital. Atuando com projetos online desde 1996, escreve há mais de 20 anos sobre tecnologia e inovação, acompanhando a evolução da internet e o impacto das novas tecnologias na forma como vivemos, trabalhamos e pensamos.
Nenhum comentário