Se você usa Claude Code, Cursor ou qualquer ferramenta de IA para programar, precisa prestar atenção numa coisa que parece simples mas muda completamente o jogo: o que a IA está lendo do seu projeto.
Eu falo com centenas de donos de software houses, e uma reclamação que tenho ouvido muito é: “os tokens acabam rápido demais”. O pessoal abre o Claude Code, faz meia dúzia de perguntas e já estourou a cota. Mas a verdade é que, na maioria dos casos, o problema não é a ferramenta. O problema é que a IA está lendo um monte de lixo que não deveria estar no contexto.
De acordo com a documentação oficial da Anthropic, o custo médio do Claude Code gira em torno de US$ 6 por desenvolvedor por dia. Mas para quem não configura direito, esse valor pode ser muito maior, porque cada arquivo que entra no contexto consome tokens. E tokens custam dinheiro.
O Problema: Projetos Que Enviam 50x Mais Código do Que o Necessário
Segundo dados da CodeAgents, a maioria dos desenvolvedores envia entre 10 e 50 vezes mais código do que a IA realmente precisa ver. Isso acontece porque ferramentas como o Claude Code, por padrão, indexam tudo que encontram no diretório do projeto.
E aqui é onde projetos Delphi sofrem especialmente. Se você trabalha com Delphi, sabe que o compilador gera uma quantidade enorme de arquivos automaticamente: DCUs, DLLs, executáveis, arquivos de configuração local, históricos, backups. O template oficial do .gitignore para Delphi no GitHub lista mais de 30 extensões de arquivos que deveriam ser ignorados, incluindo .dcu, .exe, .dll, .bpl, .cfg, .identcache, pastas __history/ e __recovery/, entre muitos outros.
Agora imagine a IA tentando indexar tudo isso. Cada arquivo binário, cada DCU compilado, cada backup automático entra no contexto e consome tokens preciosos. O resultado? A IA fica mais lenta, as respostas perdem qualidade (porque o contexto está poluído com informação irrelevante) e o custo sobe.
A Solução: O .claudeignore Como o .gitignore da Era da IA
Assim como o .gitignore diz ao Git quais arquivos não devem ser versionados, o .claudeignore diz ao Claude Code quais arquivos não devem entrar no contexto da IA. A sintaxe é idêntica, então se você já sabe configurar um .gitignore, já sabe configurar um .claudeignore.
Um artigo publicado na DEV Community mostrou que configurar um .claudeignore pode entregar uma redução de 30 a 40% no consumo de tokens, com apenas 2 minutos de configuração. Não é otimização complexa. É literalmente criar um arquivo de texto na raiz do projeto.
Para projetos Delphi, um .claudeignore básico ficaria assim:
# Binários e compilados *.dcu *.exe *.dll *.bpl *.bpi *.dcp *.so *.apk *.drc *.map *.dres *.tds *.lib *.a *.o # Configs locais *.local *.identcache *.projdata *.dsk # Histórico e backups __history/ __recovery/ *.~* # Dependências modules/ node_modules/
Pronto. Com esse arquivo, o Claude Code para de indexar centenas de arquivos desnecessários e foca exclusivamente no código-fonte que importa.
Os Números Não Mentem: Quanto Você Está Desperdiçando
Vamos aos dados concretos. A documentação oficial do Claude Code afirma que desenvolvedores que aplicam estratégias de otimização de contexto conseguem reduzir custos entre 40% e 70%.
Segundo a DEV Community, entre 40% e 60% dos tokens gastos em operações de leitura vão para releitura redundante de arquivos que a IA já processou. Ou seja, quase metade do que você paga em tokens é desperdício puro.
Na prática, isso significa que um desenvolvedor que gasta US$ 200 por mês com Claude Code poderia estar pagando US$ 80 a US$ 120 com as mesmas funcionalidades, apenas configurando corretamente o que a IA deve ou não ler.
Para software houses com 5 ou 10 desenvolvedores, estamos falando de uma economia de US$ 500 a US$ 1.000 por mês. Dinheiro que pode ser investido em outras ferramentas, treinamento ou infraestrutura.
Além do .claudeignore: Outras Práticas Que Fazem Diferença
O .claudeignore é o primeiro passo, mas existem outras técnicas que complementam a economia:
Prompts específicos em vez de genéricos: Em vez de pedir “melhore esse código”, peça “adicione validação de input na função ValidarCPF em UnitClientes.pas, linha 42”. Segundo a Anthropic, prompts específicos reduzem a necessidade de exploração em até 10x.
Use /compact entre tarefas: O comando /compact no Claude Code resume o histórico da conversa, liberando espaço no contexto. A regra 80/20 sugerida pelo guia da ClaudeFast recomenda parar tarefas complexas quando atingir 80% da capacidade de contexto e usar os 20% restantes apenas para tarefas isoladas e simples.
Escolha o modelo certo para cada tarefa: Sonnet para tarefas cotidianas, Opus apenas para decisões arquiteturais complexas. Usar Opus para entender o projeto e depois trocar para Sonnet na implementação pode economizar até 50% de tokens.
Delegue operações pesadas para subagentes: Rodar testes, processar logs ou buscar documentação gera muito output. Delegando para subagentes, o output verboso fica isolado e só um resumo retorna para a conversa principal.
O Impacto na Qualidade das Respostas
Esse ponto é tão importante quanto a economia financeira: quando o contexto está limpo, a IA responde melhor.
Pense assim: se você joga 500 arquivos no contexto e só 50 são relevantes, a IA precisa filtrar mentalmente o que importa. Isso consome capacidade de processamento e dilui a atenção do modelo. O resultado são respostas genéricas, código que não segue os padrões do projeto e sugestões que não fazem sentido no seu contexto.
Quando a janela de contexto está enxuta e focada, a IA entende melhor a arquitetura, segue os padrões existentes e produz código mais consistente. É a diferença entre pedir ajuda para alguém que conhece seu projeto e pedir para alguém que está tentando entender tudo ao mesmo tempo.
De acordo com o guia de gestão de contexto da ClaudeFast, contexto sobrecarregado causa quatro problemas previsíveis: código inconsistente que contradiz trabalho anterior, perguntas repetidas sobre estrutura já explicada, decisões arquiteturais perdidas e mudanças que quebram padrões estabelecidos.
Conclusão: 2 Minutos Que Podem Mudar Sua Produtividade
O .claudeignore é provavelmente a otimização com melhor custo-benefício que existe no Claude Code. São 2 minutos de configuração para uma redução de 30 a 40% no consumo de tokens, respostas mais precisas e menos frustração.
Se você trabalha com Delphi, o impacto é ainda maior, porque a quantidade de arquivos gerados automaticamente é muito grande. Mas o princípio vale para qualquer linguagem: diga à IA o que ela NÃO precisa ler, e ela vai ser muito mais eficiente com o que realmente importa.
Na minha experiência mentorando mais de 300 software houses desde 2016, os times que investem tempo em configurar suas ferramentas de IA corretamente são os que mais extraem valor delas. Não é sobre a ferramenta ser boa ou ruim. É sobre usar direito.
Sou Thulio, mentoro 300+ SHs desde 2016.
Este artigo foi baseado no vídeo “Economize Tokens: O Segredo do cloudignore Revelado!” do nosso canal no YouTube.
Assista ao vídeo completo
