O que é TokenEconomizer?
TokenEconomizer é um plugin que deixa agentes de código mais baratos nos repositórios aos quais você volta, sem mudar o agente nem o modelo. Depois de cada sessão concluída, ele atualiza três coisas: micro-skills (fatos sobre o repositório que as sessões redescobrem sem parar, como rodar python -m pytest porque falta o pytest), uma lista de ferramentas que o repositório nunca usa, que ele remove pelas próprias configurações do agente, e um loop guard que pergunta a um modelo juiz se um turno que falha repetidamente está travado e, se estiver, envia um único redirecionamento.
Ele suporta Claude Code, Codex, GitHub Copilot CLI e Pi, com suporte experimental a Cursor, opencode e Hermes. A poda de ferramentas e o loop guard vêm ligados por padrão; as micro-skills vêm desligadas. O plugin não precisa de chave de API própria: suas chamadas a modelos passam pela CLI do seu agente, no seu plano atual, e o que ele aprende fica em ~/.tokeneconomizer.
Ele acompanha o artigo TokenEconomizer: Experience-Driven Black-Box Cost Control for Coding Agents (arXiv 2610.22732), de pesquisadores da Microsoft Research, da Microsoft Security e da UC Berkeley. É escrito em Python usando só a biblioteca padrão, exige Python 3.10 ou mais recente e tem licença Apache-2.0. A versão 0.1.0 saiu em 26 de outubro de 2026.
TokenEconomizer vale a pena?
TokenEconomizer é um complemento de custos para agentes de código com um estudo controlado por trás, e esse estudo sustenta uma afirmação modesta e crível: num repositório ao qual você volta sempre, o agente pode parar de pagar pelos mesmos erros e por ferramentas que nunca chama. O artigo rodou em ordem 277 tarefas do SWE-Bench de 6 repositórios, com três sementes cada, em cinco combinações de agente e modelo. Ele relata custo médio, considerando o cache, de 18,4 a 30,9 % menor que o do agente sem modificação, menor em todas as 30 células de repositório e combinação (de 5,2 a 40,1 %), com as chamadas a modelos do próprio plugin cobradas da tarefa que as disparou. Na mesma configuração, o RTK sozinho aumentou o custo em 12 dessas células e o RepoMap do Aider em 15.
As ressalvas estão no próprio artigo. O Pass@1 subiu em 4 de 5 combinações e caiu 1,0 ponto no Claude Code com Opus 4.8; o artigo informa desvios-padrão sobre três sementes, mas nenhum teste de significância, e a maioria das diferenças é de um ou dois pontos. Os hiperparâmetros foram definidos em execuções de desenvolvimento nos mesmos seis repositórios, as sequências de tarefas são correções independentes e não sessões reais de usuários, e os autores dizem que o uso interativo não foi testado. A economia também demora: todo repositório exceto o xarray custou mais no início, e todos estavam mais baratos a partir da sexta tarefa.
As configurações padrão distribuídas não são a configuração por trás do número de destaque. Os 18,4 a 30,9 % usam os três mecanismos, mas o plugin desliga as micro-skills por padrão. No Claude Code, a ablação do artigo atribui à poda de ferramentas sozinha 13,2 % (Sonnet 5) e 17,7 % (Opus 4.8), às micro-skills sozinhas 11,8 e 14,3 %, e ao loop guard sozinho 7,1 e 5,4 %. O único teste independente que encontramos, do yoDEV no DEV Community antes da tag v0.1.0, combina com isso: em 8 correções de bugs num pequeno repositório Python, rodadas duas vezes de cada lado, a poda removeu 284 ferramentas e cortou o contexto por requisição em 31 %, o custo por sessão caiu 15 % ($0.72 para $0.61) em apenas 4 sessões, as micro-skills nunca foram ativadas e o loop guard nunca agiu.
O tratamento de dados é mais limpo que o da maioria. Não há chave de API extra; as chamadas do juiz, do redirecionamento e do propositor de fatos passam pela CLI do seu próprio agente (claude -p, codex exec, copilot -p), com Haiku por padrão no Claude Code, e a documentação diz que nenhuma chamada recebe o conteúdo dos arquivos nem seus prompts. O juiz vê as últimas 24 ações, com comandos cortados em 90 caracteres, no máximo cerca de 1.500 tokens. O estado aprendido fica em ~/.tokeneconomizer e a documentação não menciona telemetria. A poda, porém, grava listas de bloqueio em arquivos do projeto como .claude/settings.local.json, escondidos do git via .git/info/exclude.
É uma versão de pesquisa inicial. O repositório foi criado em 13 de outubro de 2026 e tem cerca de 4.800 estrelas e 16 issues e pull requests abertos, entre eles um vazamento de memória no Windows no lançador de hooks (#144) e uma condição de corrida no loop guard quando ferramentas rodam em paralelo (#142). Ele é testado com faixas estreitas de versões dos agentes, como Claude Code 2.1.300 a 2.1.310, e versões mais novas não foram testadas. Enquanto o RTK comprime a saída dos comandos, o TokenEconomizer muda o que o agente carrega e repete, então os dois se somam: o melhor resultado do artigo com Opus 4.8, custo 33,2 % menor, combinava os dois.
Onde ele se destaca
Uma desenvolvedora backend com plano de API que usa o Claude Code todo dia num monorepo Django
Parar de pagar por ferramentas MCP e conectores que o repositório nunca usa
Instale o plugin e mantenha o padrão; depois de algumas sessões, a poda grava uma lista de bloqueio em .claude/settings.local.json, após cerca de uma hora ociosa para não quebrar um cache de prompts ainda quente. No pequeno teste do yoDEV isso removeu 284 ferramentas e cortou o contexto por requisição em 31 %; toolprune restore as traz de volta.
Um gerente de engenharia que acompanha o gasto com agentes de uma equipe de dez pessoas no Codex
Ver se o custo dos agentes nos principais repositórios da equipe cai de fato
Cada desenvolvedor instala; status e o ledger.jsonl de cada repositório mostram o custo das sessões, incluindo as chamadas do próprio plugin. Conte com sessões iniciais mais caras e avalie o resultado após uma semana de trabalho normal, não pelos 18,4 a 30,9 % do artigo.
Um desenvolvedor cujo agente roda de novo e de novo o mesmo comando de teste que falha
Quebrar longos loops de falha sem parar o agente na mão
Depois de 5 turnos bem-sucedidos no repositório, o loop guard envia um turno que parece travado a um juiz no seu plano (Haiku por padrão no Claude Code) e redireciona uma vez se o juiz tiver pelo menos 0,7 de confiança. Ele nunca para um turno sozinho; em execuções headless, um turno sinalizado segue até os próprios limites do agente.
Antes de decidir
- Configuração
- Exige Python 3.10 ou mais recente. Clone o repositório e mantenha o clone no lugar, adicione-o como marketplace de plugins e instale tokeneconomizer@tokeneconomizer (comandos de plugin do claude, codex ou copilot); o Pi instala direto do git. No Claude Code e no Copilot CLI, rode toolprune refresh-catalog uma vez por máquina e após atualizar o agente.
- Integrações
- Testado com Claude Code 2.1.300 a 2.1.310, Codex 0.153.1 a 0.164.0, Copilot CLI 1.0.83 a 1.0.102 e Pi 1.2.0 a 1.3.0; Cursor, opencode e Hermes são experimentais. A poda remove ferramentas individuais no Claude Code, pacotes de capacidades no Codex e servidores MCP inteiros no Copilot CLI, e nada nos demais.
- Dados e privacidade
- Fatos, evidências de uso de ferramentas, histórico de loops, um registro de custos e um log de erros ficam em ~/.tokeneconomizer; apagar essa pasta remove o que ele aprendeu. As chamadas a modelos passam pela CLI do seu agente e, segundo a documentação, nunca incluem conteúdo de arquivos nem seus prompts. Nenhuma telemetria documentada. Apache-2.0.
- Custo em escala
- O plugin é gratuito; as chamadas do juiz e do propositor são cobradas no seu plano, e no padrão ele só chama um modelo quando um turno parece travado. Nenhuma edição hospedada ou paga foi publicada.
- Limites
- A economia exige sessões repetidas num mesmo repositório e começa no negativo. Com Copilot BYOK, as chamadas a modelos do plugin ficam pausadas. Rodar um comando do plugin dentro do agente custa um turno do modelo. 16 issues e pull requests abertos, entre eles um vazamento de memória no Windows e uma condição de corrida com ferramentas em paralelo no loop guard.
O que é bom
- Economia medida num artigo com três sementes e chamadas próprias incluídas
- Sem chave de API extra; chamadas a modelos passam pela CLI do seu agente
- O estado aprendido fica local, em ~/.tokeneconomizer
- Toda ação é reversível, e se o plugin falhar a sessão continua
O que não é
- As micro-skills, parte do resultado de destaque, vêm desligadas
- Custa mais nas primeiras tarefas de um repositório novo
- Hiperparâmetros ajustados nos mesmos repositórios em que foi testado
- v0.1.0 com bugs abertos no Windows e de concorrência e poucas versões de agentes testadas
Ideal para
Desenvolvedores e equipes que pagam por token pelo Claude Code, Codex ou Copilot CLI e usam o agente nos mesmos poucos repositórios dia após dia.
Alternativas ao TokenEconomizer
TokenEconomizer: perguntas frequentes
- TokenEconomizer vale a pena?
- Um redutor de custos com um estudo de verdade por trás, que vale a pena nos repositórios em que você trabalha todo dia, desde que você espere das configurações padrão menos do que o número de destaque do artigo. Damos nota 3.8 de 5.
- Quanto custa TokenEconomizer?
- Gratuito sob a licença Apache-2.0; as chamadas a modelos do próprio plugin são cobradas no seu plano ou chave atual do agente.
- Quais são as desvantagens de TokenEconomizer?
- As micro-skills, parte do resultado de destaque, vêm desligadas; custa mais nas primeiras tarefas de um repositório novo; hiperparâmetros ajustados nos mesmos repositórios em que foi testado; v0.1.0 com bugs abertos no Windows e de concorrência e poucas versões de agentes testadas.
- Para quem TokenEconomizer é indicado?
- Desenvolvedores e equipes que pagam por token pelo Claude Code, Codex ou Copilot CLI e usam o agente nos mesmos poucos repositórios dia após dia.
- Quanto custa TokenEconomizer para uma equipe ou em produção?
- O plugin é gratuito; as chamadas do juiz e do propositor são cobradas no seu plano, e no padrão ele só chama um modelo quando um turno parece travado. Nenhuma edição hospedada ou paga foi publicada.
- TokenEconomizer é seguro para dados da empresa?
- Fatos, evidências de uso de ferramentas, histórico de loops, um registro de custos e um log de erros ficam em ~/.tokeneconomizer; apagar essa pasta remove o que ele aprendeu. As chamadas a modelos passam pela CLI do seu agente e, segundo a documentação, nunca incluem conteúdo de arquivos nem seus prompts. Nenhuma telemetria documentada. Apache-2.0.
- Quais são as melhores alternativas ao TokenEconomizer?
- As alternativas mais próximas que analisamos são rtk (Rust Token Killer), context-mode e ccusage.
Respostas verificadas em 5 de nov. de 2026.