BRAINS-claude-usage-monitor

O que BRAINS-claude-usage-monitor faz?

Extensão do VSCode que exibe o uso de tokens do Claude Code a partir de transcrições JSONL locais. Janelas rolantes de 5h/7d, sparkline e ponderação de tokens faturáveis compatível com os preços da Anthropic.

Instalação

1. Abra o VSCode.
2. Pressione Ctrl+P (ou Cmd+P no macOS).
3. Cole e execute: ext install shard-BRAINS.BRAINS-claude-usage-monitor.

Uso

Após a instalação, a extensão lê automaticamente as transcrições JSONL do Claude Code do diretório padrão:

• Linux/macOS: ~/.claude/transcripts/
• Windows: %USERPROFILE%\.claude\transcripts\

As seguintes informações são exibidas na barra de status do VSCode:

• Tokens na janela de 5 horas: Total de tokens de entrada + (tokens de saída × 5, para faturáveis).
• Tokens na janela de 7 dias: Mesmo cálculo, mas acumulado em 7 dias.
• Sparkline: Um pequeno gráfico de tendência dos últimos 7 dias.
• Custo estimado: Valor aproximado em USD, baseado na precificação da Anthropic (entrada: $3/milhão de tokens, saída: $15/milhão de tokens).

Configuração

Você pode personalizar o comportamento da extensão via settings.json:

{
  "BRAINS-claude-usage-monitor.transcriptPath": "/caminho/personalizado/para/transcricoes",
  "BRAINS-claude-usage-monitor.inputTokenPrice": 3.0,
  "BRAINS-claude-usage-monitor.outputTokenPrice": 15.0,
  "BRAINS-claude-usage-monitor.showSparkline": true
}

Como funciona

1. A extensão lê todos os arquivos .jsonl do diretório de transcrições.
2. Cada linha JSON contém metadados de uso, incluindo input_tokens, output_tokens e timestamp.
3. Os tokens são agregados nas janelas de 5 horas e 7 dias.
4. O custo é calculado como: (input_tokens × preço_entrada + output_tokens × preço_saída × 5) / 1.000.000.
5. O sparkline é gerado a partir dos dados diários dos últimos 7 dias.

Licença

MIT