Claudetop: Monitoramento de Custos em Tempo Real para Sessões de Código Claude

Claudetop: Monitoramento de Custos em Tempo Real para Sessões do Claude Code

Claudetop é uma ferramenta de monitoramento para o Claude Code que exibe o rastreamento de custos em tempo real, métricas de eficiência do cache e comparações de modelos durante sessões de programação. A ferramenta foi criada depois que o desenvolvedor percebeu uma discrepância onde as estimativas do modelo mostravam US$ 10, mas a cobrança real foi de US$ 65, com a compactação ocultando 80% do uso de tokens.

Opções de Instalação

Três métodos de instalação estão disponíveis:

• Clonar e instalar: git clone https://github.com/liorwn/claudetop.git depois cd claudetop && ./install.sh
• Uma linha: curl -fsSL https://raw.githubusercontent.com/liorwn/claudetop/main/install.sh | bash
• Como um plugin do Claude Code: claude plugin marketplace add liorwn/claudetop depois claude plugin install claudetop

A instalação do plugin fornece o hook SessionEnd mais comandos de barra automaticamente: /claudetop:stats, /claudetop:dashboard, /claudetop:branch, /claudetop:export e /claudetop:pricing.

Informações Exibidas

Durante as sessões, o Claudetop mostra:

• Localização e profundidade do projeto atual
• Modelo ativo e duração da sessão
• Custo atual, taxa de consumo por hora e custo mensal projetado
• Porcentagem de eficiência do cache e custo por linha
• Custos comparativos para outros modelos (Opus, Sonnet, Haiku)
• Detalhamento de tokens: porcentagens de entrada/saída com categorias fresh, cwrite e cread

Principais Funcionalidades

Rastreamento de custos em tempo real: Mostra o custo real da sessão (verde), taxa de consumo por hora e previsão mensal extrapolada do histórico. Os preços são atualizados automaticamente a partir do pricing.json quando a Anthropic altera os preços.

Comparação de custos de modelos: Exibe quanto a sessão custaria no Opus, Sonnet ou Haiku com preços conscientes do cache que consideram a taxa real de acertos do cache. O modelo atual é destacado em negrito para comparação instantânea.

Monitoramento de eficiência do cache: A taxa de acertos do cache indica a eficiência: verde (≥60%) significa que a maioria dos tokens de entrada está sendo reutilizada, vermelho (<30%) indica que algo está forçando releituras completas.

Alertas Inteligentes

Os alertas aparecem apenas quando a atenção é necessária:

• MARCA DE US$ 5 / US$ 10 / US$ 25: Marco de custo ultrapassado - verificação rápida de valor
• ACIMA DO ORÇAMENTO: Orçamento diário excedido - finalize ou troque de modelos
• CONSIDERE UMA SESSÃO FRESCA: >2h + >60% de contexto - retornos decrescentes
• CACHE BAIXO: <20% de cache após 5min - o contexto foi redefinido, tokens estão sendo relidos
• TAXA DE CONSUMO: >US$ 15/h de velocidade - subagentes descontrolados ou loops apertados
• GIRANDO?: >US$ 1 gasto, zero saída de código - preso em loop de pesquisa
• TENTE /fast: >US$ 0,05/linha no Opus - a tarefa não precisa do maior modelo
• COMPACTAR EM BREVE: Janela de contexto >80% cheia - compactação automática iminente

Histórico e Análises da Sessão

Cada sessão é registrada automaticamente. Use claudetop-stats com vários argumentos:

• claudetop-stats - Resumo de hoje
• claudetop-stats week - Esta semana
• claudetop-stats month - Este mês
• claudetop-stats all - Todo o tempo
• claudetop-stats tag auth - Filtrar por tag

Esta ferramenta é para desenvolvedores que usam o Claude Code e desejam visibilidade sobre seus padrões de gastos com IA e querem otimizar o uso de modelos e a eficiência do cache.