CodeLedger: Plugin de código Claude de código aberto rastreia uso de tokens e agentes em segundo plano

O que o CodeLedger faz

CodeLedger é um plugin de código aberto para Claude Code (servidor MCP) que rastreia automaticamente o uso de tokens, custos de projeto e atividade de agentes em segundo plano. Foi criado após analisar 77 sessões do Claude Code em 8 projetos no plano Max 20x, revelando consumo significativo de tokens por agentes em segundo plano.

O problema que ele resolve

O comando embutido /cost no Claude Code mostra apenas dados da sessão atual. Não há uma maneira nativa de ver:

• Histórico por projeto
• Detalhamento por agente
• O que os agentes em segundo plano estão consumindo
• Qual modelo está sendo usado para qual tarefa

Quando você fecha o terminal, esse contexto desaparece para sempre.

Principais descobertas da análise

• Custo equivalente de API de $2.061 em 77 sessões, 8 projetos
• Projeto mais caro: $955 em tokens para um projeto paralelo
• 233 agentes em segundo plano consumiram 23% do gasto com tokens de agentes
• 57% da computação foi Opus, incluindo para tarefas como busca de arquivos que o Sonnet lida bem
• Uma sessão gerou mais de 100 agentes em segundo plano, consumindo mais de $80 em valor de tokens

Padrões de agentes em segundo plano descobertos

• Agentes acompact-* são executados automaticamente para compactar contexto quando as conversas ficam longas, usando qualquer modelo que sua sessão usa (incluindo Opus)
• Agentes aprompt_suggestion-* geram sugestões de prompt e aparecem frequentemente em sessões longas
• Não há uma maneira nativa de distinguir "agentes que eu pedi" de "agentes de sistema em segundo plano" sem analisar os prefixos agentId no JSONL

Recursos do CodeLedger

• Acompanhamento de custos por projeto em todas as sessões
• Detalhamento por agente mostrando quais agentes consumiram mais tokens
• Detecção de sobrecarga separando seus agentes de codificação dos agentes de segundo plano acompact-* e aprompt_suggestion-*
• Recomendações de otimização de modelo
• Consultas conversacionais — pergunte "quanto gastei esta semana no projeto X?"

Como funciona

• Conecta-se a eventos SessionEnd e analisa arquivos JSONL locais
• Scanner em segundo plano captura sessões onde os hooks não estavam ativos
• Armazena tudo em um banco de dados SQLite local (~/.codeledger/codeledger.db) — zero nuvem, zero telemetria
• Expõe ferramentas MCP: usage_summary, project_usage, agent_usage, model_stats, cost_optimize

Instalação

npm install -g codeledger

A ferramenta ainda está aguardando aprovação do Anthropic Marketplace, mas a instalação via npm funciona diretamente.