Claude Token Tracker
robbedoo/claude-token-tracker
Rastreie tokens e custos de API Claude por sessão e projeto
Ver no GitHubPlugin 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-tracker1 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
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
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
- SessionStart hook snapshots
~/.claude/stats-cache.json - SessionEnd hook diffs the snapshot against the current state
- Cost is calculated per model using bundled pricing
- Session record is appended to
~/.claude/token-usage.json /token-tracker:tokenreads 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