Postagem em destaque

CodeBurn: Veja para onde vão seus tokens de IA na programação

Atualizado em Agosto de 2026

Você usa Claude Code, Cursor, Codex, Gemini ou outros agentes de IA para programar. No final do mês chega a fatura — e você não tem ideia de para onde realmente foi o dinheiro.

Foi em conversas longas? Em tentativas de debug que falharam? Em um modelo caro fazendo trabalho que um mais barato resolveria? O CodeBurn responde exatamente essas perguntas.

O que é o CodeBurn?

O CodeBurn é uma ferramenta gratuita, open-source e local-first que analisa o uso de tokens e o custo dos seus assistentes de programação com IA.

Ele lê os arquivos de sessão que as ferramentas de IA já gravam no seu disco (JSONL, SQLite etc.) e transforma esses dados em um dashboard claro, quebrado por:

  • Ferramenta (Claude Code, Cursor, Codex, Gemini, Grok e dezenas de outras)
  • Modelo utilizado
  • Projeto
  • Tipo de tarefa (codificação, debug, refatoração, testes etc.)

Tudo roda localmente. Não precisa de API key, não envia dados para a nuvem e não exige proxy.

Para que serve?

O principal valor do CodeBurn é dar visibilidade real do seu gasto com IA de programação. Com ele você consegue:

  • Saber quanto está gastando por dia, semana ou mês
  • Identificar quais projetos consomem mais tokens
  • Descobrir se um modelo caro está sendo usado em tarefas simples
  • Ver taxa de sucesso “one-shot” (quando a IA acerta de primeira)
  • Encontrar padrões de desperdício (retries, loops de edição, conversas longas)
  • Receber sugestões de otimização com correções prontas para copiar

Em resumo: ele transforma a fatura opaca das ferramentas de IA em dados acionáveis.

Como instalar

O CodeBurn exige Node.js 22.13+ (recomendado verificar com node --version).

1. Forma mais rápida (sem instalar)

npx codeburn

Também funciona com:

bunx codeburn
pnpm dlx codeburn

2. Instalação global (recomendado)

npm install -g codeburn

3. macOS com Homebrew

brew install codeburn

Ou, se necessário:

brew tap getagentseal/codeburn
brew install codeburn

Verificar instalação

codeburn --version
codeburn status

Como usar

Dashboard interativo (principal)

codeburn

Abre o dashboard no terminal. Por padrão mostra o dia atual (ou os últimos 7 dias se não houver uso hoje). Use as setas para navegar entre períodos e q para sair.

Comandos úteis

codeburn today          # Uso de hoje
codeburn month          # Uso do mês
codeburn status         # Resumo compacto (hoje + semana + mês)
codeburn overview       # Resumo textual pronto para copiar
codeburn optimize       # Detecta desperdícios e sugere correções
codeburn export         # Exporta dados (CSV/JSON)
codeburn web            # Abre dashboard no navegador (localhost)

Menu bar (macOS / Windows)

codeburn menubar

Instala um pequeno app na barra de menu (macOS) ou bandeja do sistema (Windows) mostrando o gasto do dia em tempo real.

Ferramentas suportadas

O CodeBurn lê dados locais de dezenas de ferramentas, incluindo:

  • Claude Code
  • Cursor
  • OpenAI Codex
  • Gemini
  • Grok
  • GitHub Copilot
  • OpenCode
  • E várias outras (a lista passa de 40 ferramentas/agentes)

Como ele lê os arquivos que as próprias ferramentas já gravam no disco, não é necessário configurar nada dentro do Cursor, Claude Code etc.

Dicas práticas de uso

  • Rode codeburn optimize periodicamente. Ele aponta padrões comuns de desperdício (hooks permissivos demais, MCP servers não usados, system prompts duplicados etc.).
  • Use o filtro por provedor quando quiser analisar só uma ferramenta específica.
  • Exporte os dados (codeburn export) se quiser fazer análises próprias ou acompanhar evolução ao longo do tempo.
  • Combine com o dashboard web (codeburn web) quando preferir visualização em gráficos no navegador.

Pontos de atenção

  • O CodeBurn só analisa dados que já existem no seu disco. Se você nunca usou as ferramentas localmente, não haverá nada para mostrar.
  • Alguns modos (como o “Auto” do Cursor) não expõem o modelo real usado. Nesses casos o CodeBurn faz estimativas.
  • Os preços vêm da base do LiteLLM e podem ter pequeno atraso em relação a modelos muito novos.

Conclusão

Se você usa IA para programar com frequência, o CodeBurn é uma das ferramentas mais úteis que você pode adicionar ao seu fluxo. Ele não muda a forma como você trabalha — apenas revela, de forma clara e local, para onde seus tokens (e seu dinheiro) estão indo.

Comece com um simples:

npx codeburn

Em poucos segundos você já terá uma visão bem mais honesta do seu uso real de IA na programação.

Repositório oficial: github.com/getagentseal/codeburn

Comentários

Postar um comentário

Postagens mais visitadas