Come controllare l'uso dei token di Claude Code: 4 modi per vedere quanto spendono i tuoi agenti

Se utilizzi Claude Code per più di pochi minuti al giorno, i token sono la tua vera valuta. Decidono quando raggiungi un limite di utilizzo, quanto velocemente consumi un abbonamento e se un lungo utilizzo dell'agente è stato utile. Il problema è che Claude Code non ti comunica il numero. Devi andare a cercarlo.

Ecco quattro modi per controllare l'uso dei token di Claude Code, dal comando integrato più veloce a un misuratore live che mostra ogni agente in tempo reale. Scegli quello che si adatta a quanto in profondità hai bisogno di andare.

1. Il modo più veloce: il comando /cost

All'interno di qualsiasi sessione di Claude Code, digita:

/cost

Claude Code stampa il costo totale e il conteggio dei token per la sessione corrente, oltre a quanto tempo è stata in esecuzione. È la risposta più veloce a "quanto ha speso questa sessione finora", e non richiede nulla da installare.

Il problema: /cost è limitato alla sessione in cui ti trovi. Non ti dice quanto hai speso ieri, quanto è costato un progetto diverso, o come un agente specifico si confronta con un altro. Per un controllo veloce è perfetto. Per qualsiasi cosa storica, continua a leggere.

2. Leggi la fonte: i trascritti delle sessioni

Claude Code scrive ogni sessione su disco come un trascritto JSONL. Su macOS e Linux li troverai qui:

~/.claude/projects/<encoded-project-path>/<session-id>.jsonl

Ogni riga è un messaggio, e i messaggi dell'assistente portano un oggetto usage con i conteggi esatti: input_tokens, output_tokens, e i campi di cache (cache_creation_input_tokens, cache_read_input_tokens). Le letture della cache sono la parte interessante: costano molto meno rispetto all'input fresco, quindi una sessione con un alto tasso di hit della cache costa molto meno di quanto suggerisca il conteggio grezzo dei token.

Questa è la verità fondamentale. Ogni altro strumento, compresi i due qui sotto, legge questi stessi file. Se vuoi creare il tuo report, jq su JSONL ti porterà lì.

3. Un CLI dedicato: ccusage

Se preferisci non scrivere il tuo parser, lo strumento della comunità ccusage legge quei trascritti e li riassume in totali giornalieri, mensili e per sessione:

npx ccusage@latest

È un buon compromesso: più storia di /cost, meno lavoro rispetto a scrivere manualmente jq. Tuttavia, rimane nel terminale, quindi risponde a "cosa ho speso" ma non a "quale agente, in questo momento, lo sta spendendo".

4. Un misuratore live: uso per sessione in AgentsRoom

I tre metodi sopra condividono tutti un punto cieco: sono retrospettivi e a flusso singolo. Nel momento in cui esegui diversi agenti in parallelo, vuoi vedere l'uso per agente, in tempo reale, senza digitare un comando in ogni terminale.

Questo è ciò che fa il misuratore di uso dei token di Claude Code in AgentsRoom. Legge gli stessi trascritti JSONL, per sessione, e mostra:

• token di input, output e cache per agente, aggiornandosi mentre la sessione è in esecuzione
• il tasso di hit della cache, così puoi vedere quando il contesto viene riutilizzato invece di essere reinviato
• un avviso prima che una sessione si avvicini a un limite di utilizzo

Poiché attribuisce l'uso per sessione, rimane corretto anche quando esegui più account di Claude Code affiancati: ogni account mantiene i propri totali, il che rende la fatturazione per cliente semplice.

Quale dovresti usare

• Hai solo bisogno del numero di questa sessione? /cost.
• Vuoi creare un report personalizzato? Leggi direttamente i trascritti JSONL.
• Vuoi totali giornalieri e mensili nel terminale? ccusage.
• Stai eseguendo diversi agenti e vuoi monitorare l'uso in tempo reale, per agente e per account? Usa il misuratore in AgentsRoom.

Controllare l'uso è il primo passo. Se i numeri ti fanno rabbrividire, il passo successivo è ridurli: vedi come ridurre i costi dei token di Claude Code per le leve che contano davvero, a partire dal riutilizzo della cache.