Claude Usage Tracker

Cos'è Claude Usage Tracker?

Claude Usage Tracker è uno strumento local-first che rileva automaticamente e aggrega i costi di utilizzo di Claude AI su più strumenti di sviluppo locali. Scansiona le directory dati note, analizza file JSONL/log, calcola i costi usando i prezzi specifici del modello e visualizza i risultati in una dashboard interattiva.

Lo scopo principale è il monitoraggio e la visualizzazione dei costi—per revisionare la spesa per fonte, modello e periodo temporale senza inviare dati di utilizzo al cloud. Tutto gira sulla tua macchina e la dashboard è basata su Chart.js.

Caratteristiche Principali

• Rileva automaticamente oltre 9 strumenti integrati con Claude e fonde i dati di utilizzo per una vista unificata.
• Calcolo costi con prezzi per milione di token specifici del modello per le famiglie di modelli Anthropic (Opus, Sonnet, Haiku), inclusi input/output e cache read/write dove applicabile.
• Dashboard interattiva a tema scuro con Chart.js con grafici visivi e breakdown.
• Monitoraggio costi basato sul tempo con viste giornaliere, settimanali, mensili e totali.
• Analisi per modello e fonte inclusi breakdown costi per modello e filtri (fonte, modello, intervallo date e costo minimo).
• Visualizzazione pattern di picco tramite heatmap e due viste: Peak Hours (griglia giorno × ora) e Peak Days (calendario stile GitHub).
• Dettagli a livello sessione inclusi log sessione espandibile con card fonte colorate, callout costi per sessione (es. sessione più costosa) e pannello dettagli sessione.
• Proiezione cadenza progetto con proiezioni mensili basate sul ritmo di spesa attuale.
• Opzione bundle app macOS per creare un .app standalone da lanciare con doppio clic.

Come Usare Claude Usage Tracker

1. Installa e avvia l'ultima release (consigliata) o esegui lo strumento localmente dal sorgente.
2. Esegui una scansione per raccogliere dati e visualizzare la dashboard: l'app macOS raccoglie dati freschi e mostra la dashboard interattiva, mentre la modalità browser avvia un server locale e carica dashboard.html.
3. Esplora la dashboard per analizzare costi totali e suddividerli per fonte/modello e periodi temporali usando grafici, heatmap e filtri disponibili.

Opzioni avvio rapido (dal repository):

• macOS (Apple Silicon/Intel): scarica l'ultima release, decomprimi, sposta Claude Usage Dashboard.app in Applicazioni, poi doppio clic per avviare.
• Build dal sorgente: clona il repo, esegui ./build-app.sh, poi doppio clic sull'app creata.
• Modalità browser (qualsiasi OS): esegui node collect-usage.js, avvia un server locale con python3 -m http.server 8765 e apri http://localhost:8765/dashboard.html.

Casi d'Uso

• Consolida spesa su più strumenti Claude: Se usi diverse integrazioni locali (ad esempio Cursor, Windsurf, Claude Desktop e Continue.dev), il tracker fonde l'utilizzo da queste fonti in una dashboard unica.
• Individua quando la spesa è massima: Usa Peak Hours (heatmap giorno × ora) e calendario Peak Days per identificare orari e giorni con sessioni di utilizzo più costose.
• Audita sessioni o giorni specifici: Espandi il log sessione per una data per ispezionare costi per sessione e vedere breakdown token e storico conversazione nel pannello dettagli sessione.
• Confronta cambiamenti giorno su giorno: Usa Yesterday Delta per confrontare la spesa di oggi con ieri a colpo d'occhio.
• Pianifica aspettative per il mese corrente: Controlla Monthly Projections per stimare costi mensili proiettati basati sul ritmo di spesa attuale.

FAQ

• Il tracker invia dati di utilizzo a un server? No. La descrizione del progetto specifica “No cloud” e “No telemetry”, e che tutto resta sulla tua macchina.

• Quali strumenti supporta? Il repository elenca utilizzo Claude da OpenClaw/Clawdbot, Claude Code CLI, Claude Desktop (modalità agente locale), Cursor, Windsurf, Cline, Roo Code, Aider e Continue.dev. Il rilevamento è automatico.

• Quali formati dati legge? Scansiona directory note e analizza file JSONL/log; la sezione strumenti supportati specifica JSONL per ciascun tool elencato.

• E se uno strumento non è installato o non ha dati di utilizzo? Il comportamento di rilevamento tool è: se uno strumento non è installato o non ha dati, viene saltato silenziosamente.

• Come calcola i costi? I costi sono calcolati usando i prezzi per milione di token di Anthropic per le famiglie di modelli supportate (Opus, Sonnet, Haiku), basati su input/output e cache read/write dove forniti.

Alternative

• Analisi log locali + fogli di calcolo: Esporta o raccogli i log di utilizzo di Claude e calcola i costi manualmente in un foglio di calcolo. È più manuale di una dashboard interattiva, ma si adatta a flussi di lavoro personalizzati.
• Dashboard di utilizzo fornite dal vendor (se disponibili): Alcuni provider offrono viste di utilizzo per fatturazione/riporto. Queste si concentrano tipicamente su un singolo prodotto/account anziché aggregare su più tool locali.
• Tool generali di analisi tempo/costi per sviluppatori: Tool che analizzano l’attività IDE o calcolano costi basati su eventi di utilizzo possono aiutare, ma potrebbero non modellare la tariffazione token specifica di Claude o parsare automaticamente il formato di storage di ciascun tool.
• Altre dashboard di monitoraggio local-first: Tool adiacenti che visualizzano log locali nel browser possono fornire grafici simili, anche se potrebbero richiedere di preparare i dati anziché affidarsi all’auto-rilevamento e al parsing JSONL del tracker.