Repolode
Enviar
microsoft

microsoft/TokenEconomizer

Plugin para Claude Code, Codex, Copilot CLI e Pi que aprende com sessões anteriores em um repositório para reduzir os custos de tokens dos agentes de programação.

Ver no GitHub
Estrelas
4,833
Forks
292
Issues abertas
6
Último commit
anteontem

O que é?

O TokenEconomizer reduz o custo de executar agentes de programação em um repositório que você usa com frequência, sem alterar o agente nem o modelo. Ele registra o que aconteceu em sessões anteriores e usa esse histórico para reduzir desperdícios nas sessões seguintes. Há três mecanismos: micro-skills, que armazenam informações sobre o repositório, como o comando correto de teste, e as inserem no início da sessão depois que várias sessões as confirmam; poda de ferramentas, que remove ferramentas não utilizadas pelas próprias configurações do agente e permite restaurá-las com um comando; e um guardião de loop, que usa um modelo avaliador para detectar quando um turno fica preso e redireciona o agente, deixando a decisão de parar a cargo do usuário.

O plugin é compatível com Claude Code, Codex, GitHub Copilot CLI e Pi, e oferece suporte experimental ao opencode. Cada mecanismo pode ser ativado ou desativado, e é possível configurar limites, como quantos prompts sem uso são necessários para acionar a poda. As chamadas ao modelo do próprio plugin usam o login existente do agente pelo usuário, e o que ele aprende fica armazenado localmente em ~/.tokeneconomizer.

O artigo que acompanha o projeto relata resultados em tarefas do SWE-Bench com cinco combinações de agente e modelo, com redução média de custo entre 18,4% e 30,9%. Esses números vêm das medições dos autores.

Recursos principais

  • 01Insere informações aprendidas sobre o repositório, como etapas de build e comandos de teste, no início da sessão.
  • 02Remove ferramentas não utilizadas pelas próprias configurações do agente e permite restaurá-las com um único comando.
  • 03Detecta turnos presos com um modelo avaliador e redireciona o agente até um número configurável de vezes.
  • 04Funciona com Claude Code, Codex, GitHub Copilot CLI e Pi.
  • 05Armazena os dados aprendidos localmente e permite reverter todas as ações.

Casos de uso

  • Reduzir os gastos com tokens quando uma equipe executa repetidamente um agente de programação na mesma base de código.
  • Reduzir custos em tarefas longas no estilo SWE, nas quais o agente redescobre as mesmas informações sobre o repositório.
  • Impedir que um agente fique repetindo o mesmo comando com falha sem intervenção manual.

Início rápido

  1. 1

    Clone o repositório

    git clone https://github.com/microsoft/TokenEconomizer.git
  2. 2

    Adicione o marketplace de plugins ao Claude Code

    claude plugin marketplace add "$PWD/TokenEconomizer"
  3. 3

    Instale o plugin

    claude plugin install tokeneconomizer@tokeneconomizer
  4. 4

    Inicie o Claude Code e confira o status do plugin

    /tokeneconomizer:status

Antes de usar

  • Compatível apenas com versões específicas e testadas de cada agente; versões mais antigas não são compatíveis.
  • Requer Python 3.10 ou mais recente e um dos agentes de programação compatíveis.
  • O suporte a opencode é experimental e foi testado em apenas duas versões.

Destaque no Repolode Weekly

Em coleções

Ferramentas, skills e plugins para Claude CodeFrameworks e apps de agentes de IA open sourceAssistentes e agentes de programação com IA

Tópicos

#coding-agent#llm-cost#claude-code#codex#token-optimization#ai-agents#developer-tools

Perguntas frequentes

O que é TokenEconomizer?
Plugin para Claude Code, Codex, Copilot CLI e Pi que aprende com sessões anteriores em um repositório para reduzir os custos de tokens dos agentes de programação. O TokenEconomizer reduz o custo de executar agentes de programação em um repositório que você usa com frequência, sem alterar o agente nem o modelo. Ele registra o que aconteceu em sessões anteriores e usa esse histórico para reduzir desperdícios nas sessões seguintes. Há três mecanismos: micro-skills, que armazenam informações sobre o repositório, como o comando correto de teste, e as inserem no início da sessão depois que várias sessões as confirmam; poda de ferramentas, que remove ferramentas não utilizadas pelas próprias configurações do agente e permite restaurá-las com um comando; e um guardião de loop, que usa um modelo avaliador para detectar quando um turno fica preso e redireciona o agente, deixando a decisão de parar a cargo do usuário.
TokenEconomizer é gratuito? Qual é a licença?
TokenEconomizer é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
TokenEconomizer ainda é mantido?
Manutenção ativa. O último commit de TokenEconomizer foi em 4 de nov. de 2026.
Para que posso usar TokenEconomizer?
Reduzir os gastos com tokens quando uma equipe executa repetidamente um agente de programação na mesma base de código. Reduzir custos em tarefas longas no estilo SWE, nas quais o agente redescobre as mesmas informações sobre o repositório. Impedir que um agente fique repetindo o mesmo comando com falha sem intervenção manual.
Como instalar TokenEconomizer?
Clone o repositório: git clone https://github.com/microsoft/TokenEconomizer.git Adicione o marketplace de plugins ao Claude Code: claude plugin marketplace add "$PWD/TokenEconomizer" Instale o plugin: claude plugin install tokeneconomizer@tokeneconomizer Inicie o Claude Code e confira o status do plugin: /tokeneconomizer:status
Onde consigo TokenEconomizer?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/microsoft/TokenEconomizer

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados