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: /usage, /context e la riga di stato

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

/usage

Claude Code mostra l'uso dei token della sessione corrente e, con un piano Claude.ai, quanto resta della tua quota: i limiti sulle 5 ore e sui 7 giorni, più la parte della finestra di contesto che stai già usando. /cost e /stats funzionano ancora, sono alias dello stesso comando. Puoi lanciarlo mentre Claude risponde, i numeri compaiono senza interrompere la risposta (prima della v2.1.234, il comando aspettava la fine del turno).

Vuoi il dettaglio della finestra di contesto invece di una sola percentuale? Digita /context: la finestra viene disegnata come una griglia colorata e viene segnalato ciò che la sta riempiendo, uno strumento con un output troppo pesante, un file di memoria che si è gonfiato, una sessione vicina alla capacità.

I due comandi hanno lo stesso limite: bisogna digitarli, e vedono solo la sessione in cui ti trovi. Niente ti dice quanto hai speso ieri né quanto è costato un altro progetto. Se vuoi un numero che resti sullo schermo, usa la riga di stato. Chiedi a Claude Code di scriverla per te:

/statusline show model name and context percentage with a progress bar

Genera uno script in ~/.claude/ e lo collega alle tue impostazioni. Se preferisci scriverlo tu stesso, aggiungi una voce statusLine in ~/.claude/settings.json. Lo script riceve su stdin un oggetto JSON con context_window.used_percentage, cost.total_cost_usd e, per gli abbonati Pro e Max, rate_limits.five_hour.used_percentage. Basta una riga:

{
  "statusLine": {
    "type": "command",
    "command": "jq -r '\"[\\(.model.display_name)] \\(.context_window.used_percentage // 0)% context\"'"
  }
}

La riga di stato si aggiorna dopo ogni risposta dell'API, quindi la percentuale si muove mentre la sessione va avanti. Resta comunque una sessione per terminale: per lo storico, o per più agenti insieme, 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 /usage, 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, o di quanto resta della tua quota? /usage, e la riga di stato se la vuoi sempre visibile.
• 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.