Claude Usage Tracker

O que é o Claude Usage Tracker?

Claude Usage Tracker é uma ferramenta local-first que detecta automaticamente e agrega custos de uso do Claude AI em múltiplas ferramentas de desenvolvimento local. Ela escaneia diretórios de dados conhecidos, analisa arquivos JSONL/log, calcula custos usando preços específicos por modelo e exibe os resultados em um dashboard interativo.

O propósito principal é o rastreamento e visualização de custos — para que você possa revisar gastos por origem, modelo e período sem enviar dados de uso para a nuvem. Tudo roda na sua máquina e o dashboard é alimentado pelo Chart.js.

Principais Recursos

• Detecta automaticamente 9+ ferramentas integradas ao Claude e mescla dados de uso para uma visão consolidada.
• Cálculo de custos usando preços por milhão de tokens específicos do modelo para famílias de modelos Anthropic (Opus, Sonnet, Haiku), incluindo entrada/saída e leitura/escrita de cache quando aplicável.
• Dashboard interativo com tema dark usando Chart.js com gráficos visuais e detalhamentos.
• Rastreamento de custos por tempo com visualizações diária, semanal, mensal e total.
• Análises por modelo e origem incluindo detalhamentos de custos por modelo e filtros (origem, modelo, intervalo de datas e custo mínimo).
• Visualização de padrões de pico via mapas de calor e duas visualizações: Peak Hours (grade dia × hora) e Peak Days (calendário estilo GitHub).
• Detalhes em nível de sessão incluindo log de sessões expansível com cards de origem codificados por cor, destaques de custo por sessão (ex.: sessão mais cara) e painel de detalhes da sessão.
• Projeção de cadência de projeto com projeções mensais baseadas no ritmo atual de gastos.
• Opção de bundle de app macOS para criar um .app standalone para lançamento por duplo-clique.

Como Usar o Claude Usage Tracker

1. Instale e inicie a versão mais recente (recomendada) ou execute a ferramenta localmente a partir do código-fonte.
2. Execute um scan para coletar dados e renderizar o dashboard: o app macOS coleta dados frescos e exibe o dashboard interativo, e o modo browser inicia um servidor local e carrega dashboard.html.
3. Revise o dashboard para explorar custos totais e detalhá-los por origem/modelo e por períodos usando os gráficos, mapas de calor e filtros disponíveis.

Opções de início rápido (do repositório):

• macOS (Apple Silicon/Intel): baixe a versão mais recente, descompacte, mova Claude Usage Dashboard.app para Aplicativos, depois dê duplo-clique para iniciar.
• Compilar a partir do fonte: clone o repo, execute ./build-app.sh, depois dê duplo-clique no app compilado.
• Modo browser (qualquer SO): execute node collect-usage.js, inicie um servidor local com python3 -m http.server 8765 e abra http://localhost:8765/dashboard.html.

Casos de Uso

• Consolidar gastos em múltiplas ferramentas Claude: Se você usa várias integrações locais (por exemplo, Cursor, Windsurf, Claude Desktop e Continue.dev), o tracker mescla o uso dessas origens em um dashboard único.
• Identificar quando os gastos são mais altos: Use Peak Hours (mapa de calor dia × hora) e calendário Peak Days para detectar os horários e dias com sessões de uso mais caras.
• Auditar sessões ou dias específicos: Expanda o log de sessões de uma data para inspecionar custos por sessão e ver detalhamento de tokens e histórico de conversa no painel de detalhes da sessão.
• Comparar mudanças dia a dia: Use Yesterday Delta para comparar os gastos de hoje com os de ontem de forma rápida.
• Planejar expectativas para o mês atual: Revise Monthly Projections para estimar custos mensais projetados com base no ritmo atual de gastos.

FAQ

• O tracker envia dados de uso para um servidor? Não. A descrição do projeto afirma “No cloud” e “No telemetry”, e que tudo fica na sua máquina.

• Quais ferramentas ele suporta? O repositório lista uso do Claude de OpenClaw/Clawdbot, Claude Code CLI, Claude Desktop (modo agente local), Cursor, Windsurf, Cline, Roo Code, Aider e Continue.dev. A detecção de ferramentas é automática.

• Quais formatos de dados ele lê? Ele escaneia diretórios conhecidos e analisa arquivos JSONL/log; a seção de ferramentas suportadas especifica JSONL para cada uma listada.

• E se uma ferramenta não estiver instalada ou não tiver dados de uso? O comportamento de detecção de ferramentas é: se uma ferramenta não estiver instalada ou não tiver dados, ela é ignorada silenciosamente.

• Como ele calcula os custos? Os custos são calculados usando os preços por milhão de tokens da Anthropic para as famílias de modelos suportadas (Opus, Sonnet, Haiku), com base em entrada/saída e leitura/escrita de cache quando fornecido.

Alternativas

• Análise de logs locais + planilhas: Exporte ou colete os logs de uso do Claude e calcule os custos manualmente em uma planilha. É mais manual que um dashboard interativo, mas pode se adequar a fluxos de trabalho personalizados.
• Dashboards de uso fornecidos pelo fornecedor (se disponíveis): Alguns provedores oferecem visualizações de uso para faturamento/relatórios. Eles geralmente focam em um único produto/conta, em vez de agregar vários ferramentas locais.
• Ferramentas gerais de análise de tempo/custo para desenvolvedores: Ferramentas que analisam atividade no IDE ou calculam custos com base em eventos de uso podem ajudar, mas talvez não modelem a precificação por tokens específica do Claude ou parse automaticamente o formato de armazenamento de cada ferramenta.
• Outros dashboards de monitoramento local-first: Ferramentas adjacentes que visualizam logs locais no navegador podem fornecer gráficos semelhantes, embora exijam que você prepare os dados em vez de depender da detecção automática e parsing JSONL do tracker.