convez.ai
PluginFinanceiroIntermediário
robbedoo

Claude Token Tracker

robbedoo/claude-token-tracker

Rastreie tokens e custos de API Claude por sessão e projeto

Ver no GitHub
InicialPluginScore · de 0 a 100

Plugin para Claude Code que rastreia automaticamente o uso de tokens (input, output, cache) e calcula custos em dólar por sessão, projeto e período. Armazena dados localmente e oferece resumos formatados de consumo diário, semanal e por modelo.

Instalação

$npx convez-ai robbedoo/claude-token-tracker

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
1
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 7 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Monitorar gastos com API Claude em tempo real
  • Auditar consumo de tokens por projeto ou sessão
  • Identificar modelos mais caros e otimizar escolhas

Veredito

Ferramenta prática para desenvolvedores que usam Claude Code regularmente e precisam controlar custos. Implementação limpa com armazenamento local, sem overhead externo.

README

A tradução para o português deste README ainda está na fila.

Claude Token Tracker

npm version License: MIT

A Claude Code plugin that tracks token usage and dollar costs across sessions.

What It Does

  • Automatically records token usage (input, output, cache) per session
  • Calculates costs using bundled model pricing
  • Tracks per-project usage
  • Aggregates by day and week

Install

claude plugin add robbedoo/claude-token-tracker

Usage

/token-tracker:token

Displays a summary like:

╭────────────────────────────────────────────────╮
│            Claude Token Tracker                 │
├────────────────────────────────────────────────┤
│  Today        42,300 tokens    $1.85  (2 sess) │
│  Week        318,000 tokens   $12.40  (9 sess) │
├────────────────────────────────────────────────┤
│  By model (week):                               │
│    opus-4-6                $11.20  (90%)        │
│    sonnet-4-6               $1.20  (10%)        │
├────────────────────────────────────────────────┤
│  Project: cresly                                │
│    Today $1.85  •  Week $8.60                   │
╰────────────────────────────────────────────────╯

How It Works

  1. SessionStart hook snapshots ~/.claude/stats-cache.json
  2. SessionEnd hook diffs the snapshot against the current state
  3. Cost is calculated per model using bundled pricing
  4. Session record is appended to ~/.claude/token-usage.json
  5. /token-tracker:token reads the store and prints a formatted summary

Data Storage

All data is stored locally in ~/.claude/token-usage.json. Nothing is sent externally.

Updating Pricing

Model pricing is bundled in config/pricing.json. When Anthropic updates prices, install the latest plugin version:

claude plugin update token-tracker

Or manually edit the pricing file in the plugin cache.

Uninstall

claude plugin remove token-tracker

The data file (~/.claude/token-usage.json) is preserved after uninstall. Delete it manually if you want to remove all data.

Requirements

  • Claude Code CLI
  • Node.js (already required by Claude Code)

License

MIT

Ver o original no GitHub

Bom para

Relacionados