Stats

La sezione Stats è la versione estesa delle card Utilizzo Claude Code in Dashboard. Legge i file JSONL di sessione che Claude Code scrive in locale e li trasforma in un vero report d’uso: quante sessioni, quanti token, quale modello, quale progetto, quanto è costato, cosa ha guidato l’utilizzo e quanto è stata efficiente la cache.

I numeri sono calcolati dal vivo dai transcript, non da una cache che può restare indietro: ogni apertura ri-scansiona le sessioni su disco. E tutto avviene sulla tua macchina — CLACOROO non fa nessuna chiamata remota per produrre questi numeri.

Panoramica

Stats è organizzata in tab:

• Overview — i numeri principali, il breakdown trasparente dei token e la heatmap di attività
• Quota Claude — le barre dei limiti in tempo reale più cosa incide sul tuo utilizzo
• Models — utilizzo e costo scomposti per modello
• Per-project — utilizzo e costo scomposti per progetto (cartella)
• Attribuzione — quanto costo è attribuibile a ogni plugin / skill / agent / server MCP, più la ripartizione sessione principale vs subagent
• Efficienza — cache hit ratio, contesto medio, turni pesanti e tool più usati con tasso di errore

Tutti i tab live sono scopabili per intervallo temporale: All time · ultimi 30 giorni · ultimi 7 giorni — heatmap, barre, attribuzione, efficienza e tool si riscalano di conseguenza. (Il tab Quota Claude usa invece il suo switch Giorno / Settimana.)

Token: “di lavoro” vs cache (il dato in chiaro)

Un numero come “83 milioni di token” è quasi sempre fuorviante: il 90%+ è cache read — contesto riletto a costo molto basso che gonfia i totali ma incide pochissimo. Per questo CLACOROO non mostra un unico numero da miliardi. Distingue:

• Token di lavoro = input + output: ciò che produci davvero (prompt nuovi + risposte). È il numero in evidenza.
• Cache read = contesto riletto dalla cache (economico).
• Cache write = contesto salvato in cache la prima volta.

La card Token, in chiaro nell’Overview tiene i quattro tipi separati e spiega la quota di cache, così capisci a colpo d’occhio quanto del totale è lavoro reale e quanto è solo contesto riletto.

Cosa mostra

Tab Overview

Riga in cima: una piastrellatura di KPI principali —

• Sessioni — sessioni Claude Code nel range
• Turni — turni assistant (risposte del modello)
• Token di lavoro — input + output, cache esclusa
• Costo API reale — quanto i token sarebbero costati sull’API, calcolato sui prezzi per ogni tipo di token (input, output, cache write/read)
• Giorni attivi e Giorno più attivo
• Serie attuale / Serie più lunga — giorni consecutivi di utilizzo
• Ora di punta — l’ora del giorno in cui usi di più
• Modello preferito — il modello che hai usato di più

Sotto i KPI: la card Token, in chiaro (vedi sopra) e una heatmap dell’attività — ogni giorno nell’intervallo, colorato per intensità di turni (grafico in stile contribution di GitHub). Hover su un quadratino per il conteggio esatto.

Tab Quota Claude

Questo tab rispecchia il pannello /usage di Claude Code stesso, in due parti.

Utilizzo corrente — le barre dei limiti del tuo piano Claude:

• Session (5h) — la finestra mobile di 5 ore
• Weekly (7d) — la finestra di 7 giorni
• Weekly Sonnet — la finestra Sonnet separata, a 7 giorni

Ogni barra mostra la percentuale usata e quando si resetta. Arrivano dall’endpoint usage di Claude, quindi aprire questo tab fa una chiamata on-demand — gli stessi dati, sullo stesso rate-limit condiviso per-account, che usa Claude Code. Di default CLACOROO non interroga questo endpoint in background (vedi Modalità di aggiornamento sotto).

Cosa incide sui limiti — una stima, calcolata interamente sulla tua macchina scansionando i transcript di sessione locali, di quali comportamenti e plugin stanno guidando il tuo utilizzo. Passa tra Giorno (ultime 24h) e Settimana (ultimi 7 giorni). Ogni riga è una quota del tuo utilizzo pesato per costo:

• contesto >150k — turni con un contesto molto grande (costosi anche con la cache)
• sessioni con molti subagent — utilizzo da sessioni che hanno spawnato molti subagent
• sessioni attive 8+ ore — sessioni lunghe, spesso in background o in loop
• 4+ sessioni in parallelo — utilizzo prodotto mentre più sessioni giravano insieme
• input non in cache >100k — turni con un grande input fresco (non in cache)
• plugin “nome” — utilizzo attribuibile a un plugin specifico (sue skill, agent, tool MCP)

Sono caratteristiche indipendenti, non una ripartizione — possono sovrapporsi e superarsi, quindi le percentuali non sommano a 100%. Vengono mostrate solo le voci sopra il ~10%.

Privacy. La lista di “cosa incide” non lascia mai la tua macchina: è letta da ~/.claude/projects/ in locale, con zero chiamate di rete. È una stima allineata al pannello /usage di Claude Code, non una copia identica al bit — le finestre temporali esatte differiscono leggermente.

Modalità di aggiornamento e il rate-limit condiviso

Le barre di Utilizzo corrente sono l’unica parte di CLACOROO che parla col tuo account Claude, e condividono lo stesso rate-limit per-account di Claude Code. Perché CLACOROO non eroda quel budget mentre resta aperto, il polling delle quote è Manuale di default: le barre si aggiornano solo quando apri questo tab (o la Dashboard / il pannello Account) o premi Aggiorna. Puoi cambiare la cadenza — o lasciarla manuale — in Impostazioni → Frequenza aggiornamento quota.

CLACOROO inoltre non rinnova mai il token di login Claude, così non può disturbare la sessione che Claude Code sta usando.

Tab Models

Una scomposizione token per modello con, accanto a ogni modello, il costo $ reale: una barra per la quota d’uso, più l’istogramma dei token giornalieri nel range. Se usi Sonnet l’80% delle volte e Opus il 20%, lo vedi qui — ed è il posto più semplice per cogliere un cambio improvviso (es. passare per errore a un modello costoso).

Tab Per-project

Una scomposizione di utilizzo per cartella di progetto. Claude Code registra la working directory di ogni sessione; CLACOROO le raggruppa e mostra, per ogni progetto:

• Nome cartella (e path completo)
• Token di lavoro (input + output, cache esclusa)
• Costo API reale
• Turni e sessioni distinte

Utile per dividere il costo di un progetto da un altro, o per sapere dove va davvero il tempo del tuo assistente.

Tab Attribuzione

Il tab che Opcode non ha. I transcript di Claude Code marcano ogni turno con il plugin / skill / agent / server MCP che l’ha generato; CLACOROO lo aggrega in costo $ per voce:

• Principale vs subagent — quanto costo arriva dal flusso principale e quanto dai subagent (Task/Agent), con il numero di turni eseguiti dai subagent
• Subagent per tipo — quante chiamate e quanti token per ogni tipo di agent
• Costo per plugin / skill / agent / server MCP — le voci più costose, ordinate

È il modo più diretto per scoprire quale automazione ti sta costando di più.

Tab Efficienza

Quanto bene stai usando cache e contesto:

• Cache hit (read / input) — quanto del contesto viene riletto dalla cache (economico) invece di reinviato
• Contesto medio per turno e turni oltre 150k token — quanto “pesano” le tue sessioni
• Successo tool (non-errore) — la quota di chiamate a tool andate a buon fine
• Tool più usati — i tool che usi di più nel range, con il totale dei risultati in errore

Operazioni comuni

Come vedere quanto è costata la settimana scorsa

1. Apri il tab Overview
2. Cambia l’intervallo a 7d
3. Leggi la card Costo API reale — è l’equivalente del prezzo off-API per gli ultimi 7 giorni

Nota. Il costo si basa sul pricing pubblico di Anthropic per ogni tipo di token. È un’approssimazione, non una fattura — se hai un abbonamento claude.ai, il costo reale è quello dell’abbonamento, comunque vada.

Come sapere quale modello (o plugin) sta mangiando il budget

1. Apri il tab Models per il costo per modello, oppure Attribuzione per il costo per plugin / skill / agent / MCP
2. La prima riga è il tuo consumatore principale
3. Se è qualcosa che non avevi pianificato, vale la pena scoprire perché

Come capire se la cache lavora per te

1. Apri il tab Efficienza
2. Leggi Cache hit — più è alto, più contesto viene riletto a basso costo invece di reinviato
3. Se è basso e Contesto medio è alto, le tue sessioni stanno reinviando molto contesto fresco: /compact o sessioni più corte aiutano

Come confrontare progetti

1. Tab Per-project
2. Le righe in cima (ordinate per costo) sono dove va il tempo dell’assistente

Come vedere cosa guida il tuo utilizzo

1. Apri il tab Quota Claude
2. Passa tra Giorno e Settimana
3. Leggi la lista cosa incide — la prima riga è la leva più grande

Se un comportamento o un plugin domina, è lì che agire: un modello più economico per i subagent, /compact sulle sessioni a contesto lungo, o accodare le run parallele invece di lanciarle tutte insieme.

Come aggiornare le stats

Le stats vengono calcolate da disco ogni volta che apri la sezione. Per forzare un ricalcolo (dopo una sessione lunga che vuoi vedere subito):

• Clicca Aggiorna nella topbar, oppure
• Premi Cmd / Ctrl + R

Suggerimenti e scorciatoie

• Guarda i “token di lavoro”, non il totale grezzo: il totale è dominato dalla cache read e non racconta quanto hai prodotto davvero
• Hover sulla heatmap per il conteggio esatto dei turni del giorno
• I contatori serie sono basati su giorni interi — se salti anche un solo giorno, la serie si resetta
• Il costo API usa il pricing pubblico attuale per ogni modello e tipo di token: se Anthropic pubblica prezzi nuovi, lo storico si re-pricia al volo
• Il tab Models è il segnale più veloce per “cos’è cambiato?” — un modello nuovo che domina di colpo è di solito una deriva di configurazione da investigare
• Passa a 7d quando vuoi un colpo d’occhio rapido di “questa settimana” senza il rumore della storia

Casi limite ed errori

• È tutto a zero. O Claude Code è appena installato (nessuna sessione ancora), o i suoi log di sessione stanno in un posto che CLACOROO non può leggere. Assicurati che CLACOROO possa accedere a ~/.claude/projects/ (macOS/Linux) o al path Windows equivalente.
• Un progetto mostra il nome sbagliato. Stats usa la working directory; se hai rinominato la cartella dopo la sessione, il nome vecchio persiste nel JSONL. Il path completo conferma quale cartella era.
• I conteggi token non corrispondono al mio dashboard claude.ai. I log locali e il dashboard dell’abbonamento cloud possono differire — misurano cose leggermente diverse e si aggiornano in tempi diversi. Usa CLACOROO come trend locale coerente invece che come fattura autoritativa.
• La heatmap è vuota per i giorni recenti. I file JSONL di sessione vengono flushati quando Claude Code chiude una sessione. Se una sessione è ancora aperta, i suoi turni non appariranno finché non la chiudi.
• Un modello che non uso appare nella scomposizione. Un plugin o un agent potrebbe averlo forzato per una chiamata specifica — il tab Attribuzione aiuta a capire da dove arriva.
• Il tab Attribuzione è quasi vuoto. Normale: i transcript marcano plugin/skill/agent/MCP solo quando vengono effettivamente invocati in un turno. Se lavori soprattutto “a mano”, c’è poco da attribuire.
• Le barre Quota Claude mostrano “in pausa” o un errore. Di solito il token di login Claude è scaduto o hai toccato il rate-limit condiviso. Usa Claude Code una volta per rinnovare il token, poi premi Aggiorna. CLACOROO non rinnova il token da sé, per scelta.
• Le percentuali di “cosa incide” differiscono un po’ da /usage di Claude Code. È atteso: entrambi scansionano le stesse sessioni locali, ma le finestre temporali esatte e il momento dello snapshot differiscono. Trattalo come una stima allineata, non un valore identico.

Correlati

• Dashboard — la versione KPI compatta di questa sezione
• Notifiche quota — quando questi numeri di utilizzo superano una soglia, ricevi una notifica di sistema
• Account Claude — informazioni dell’account, che influenzano come le quote sono riportate
• Concetti — cosa Claude Code logga in locale, e perché