Claudlytics: Painel Autohospedado para Monitorar o Uso de Tokens e Custos do Código Claude

O que o Claudlytics faz

Claudlytics é um painel auto-hospedado que monitora o uso de tokens e os custos do Claude Code em tempo real. É especialmente útil para desenvolvedores que executam o Claude Code sem interface gráfica em VPS ou servidores remotos, onde o rastreamento local da máquina do aplicativo de desktop não é suficiente.

Como funciona

O Claude Code grava cada conversa em arquivos ~/.claude/projects/**/*.jsonl. O Claudlytics lê esses arquivos, analisa o uso de tokens e calcula os custos usando o preço do Sonnet 4.6. Nenhuma chamada à API do Claude é necessária para o uso básico — tudo é processado localmente.

Recursos do painel

• Contagem de tokens e custo da sessão atual
• Janela de uso de 5 horas com contagem regressiva de reinício (alinhada aos limites de sessão do Claude Pro/Max)
• Detalhamentos de hoje / últimos 7 dias / ciclo de faturamento
• Contagens de mensagens por sessão e semanais

Configuração e instalação

A configuração requer três comandos:

git clone https://github.com/iansugerman/Claudlytics.git
cd Claudlytics
node server.js

Após executar esses comandos, abra http://localhost:3031 no seu navegador.

Segurança e acesso remoto

O servidor se conecta apenas a 127.0.0.1, portanto nunca fica exposto publicamente. Para acesso a servidores remotos, use um túnel SSH:

ssh -L 3031:localhost:3031 user@your-server

Em seguida, navegue até localhost:3031 na sua máquina local.

Implantação em produção

O Claudlytics pode ser executado como um serviço systemd para disponibilidade em segundo plano. Instruções completas estão disponíveis no README do repositório GitHub.