Quanti token mi restano su Claude? Non esiste un numero da leggere.

È una delle domande più cercate su Claude, e viene posta in quasi tutte le lingue. Ha anche una risposta scomoda: quel numero non esiste, perché il vostro abbonamento non viene venduto in token.

Non è un cavillo tecnico. Spiega perché non riuscite a trovare il contatore che state cercando, perché ogni pagina che sostiene di mostrarvene uno sta tirando a indovinare, e perché la cosa che vi ferma davvero a metà di un lavoro non è quella che quasi tutti tengono d'occhio.

L'abbonamento si misura in finestre, non in token

Anthropic non esprime un abbonamento a Claude come quota di token. Lo misura in finestre di utilizzo: una finestra di sessione mobile e, sopra di essa, una finestra settimanale. Entrambe sono condivise da tutte le superfici su cui effettuate l'accesso, quindi un lungo pomeriggio nella chat di Claude vi lascia meno spazio per Claude Code la sera. Entrambe sono condivise anche tra i modelli, ed è il motivo per cui passare a un modello più economico con /model non vi restituisce il limite una volta che l'avete raggiunto.

Quello che potete leggere è quindi una quota di una finestra e l'orario in cui torna disponibile, non un saldo. Quando esaurite davvero tutto, il messaggio che vi blocca dice quale tetto avete toccato e quando si rinnova, e quel messaggio è l'unica cifra autorevole per il vostro account.

L'unico posto in cui un conteggio di token ha un significato letterale è l'API, che viene fatturata a token. Tutto quello che segue riguarda l'abbonamento, che è ciò di cui quasi tutti stanno realmente parlando.

La cifra che potete leggere davvero, e dove si trova

Due schermate, e rispondono a domande diverse.

Dentro Claude Code, /usage è quella che vale la pena imparare. Con un abbonamento Pro, Max, Team o Enterprise mostra le barre di utilizzo dei limiti del vostro abbonamento, e premendo d o w si passa dalle ultime 24 ore agli ultimi 7 giorni. Sotto le barre fa qualcosa di più utile di qualsiasi numero grezzo: attribuisce il consumo recente a skill, subagent, plugin e singoli server MCP, ciascuno con la sua percentuale, e alza un segnalatore di comportamento quando un singolo schema pesa per il 10% o più del vostro consumo recente, per esempio un contesto lungo o i cache miss.

C'è un'avvertenza che conta ed è facile da mancare: quelle cifre sono calcolate a partire dalla cronologia locale delle sessioni su quella macchina. Il lavoro fatto da un altro portatile, o su claude.ai, non ci rientra.

Sul web, Impostazioni e poi Utilizzo su claude.ai è la vista a livello di account: il vostro abbonamento, a che punto siete e quando si rinnova la finestra settimanale. Se lavorate su due macchine, è questa la vista completa.

Per un dettaglio per sessione di quanto è costato davvero un pezzo di lavoro, il blocco in cima a /usage stampa i conteggi grezzi:

Usage by model:
   claude-sonnet-4-6:  1.2k input, 5.3k output, 940.0k cache read, 50.0k cache write

Quei quattro numeri raccontano per intero una sessione di programmazione, e il più grande è quasi sempre cache read. Se volete quella vista in continuo invece che su richiesta, AgentsRoom tiene un misuratore di token in tempo reale su ogni sessione accanto al terminale, con la stessa suddivisione tra input, output e cache e un badge rosso quando una sessione comincia a scaldarsi. La versione passo passo su come leggere il contatore del CLI è trattata in come controllare l'uso dei token di Claude Code.

Che cos'è davvero un token quando entra in gioco un agente

Un token è un frammento di testo: all'incirca tre quarti di una parola in inglese, e sensibilmente meno nel codice, dove la punteggiatura e gli identificatori si spezzano con facilità.

La parte che sorprende è che una conversazione viene rinviata per intero a ogni richiesta. Ponete una domanda di una riga in una sessione aperta dalla mattina e non state pagando quella riga: state pagando tutta la cronologia che viaggia insieme a essa. Ogni volta che l'agente usa uno strumento invia un'altra richiesta, portandosi dietro i risultati degli strumenti precedenti, ed è il motivo per cui un singolo "sistema questo test" può trasformarsi in una dozzina di andate e ritorni.

È la cache dei prompt a rendere tutto questo sostenibile. La cronologia ripetuta viene addebitata a una tariffa in cache molto più bassa, ed è per questo che la cifra di cache read è enorme mentre il conto non lo è. È anche ciò che prepara l'abitudine più costosa del lavoro con gli agenti, che è l'argomento della sezione successiva.

Perché la barra si muove mentre non state scrivendo

Se il vostro consumo cresce su una sessione inattiva, la causa è una di queste, e nessuna è un bug:

• La cache che scade. Il contesto in cache vive circa un'ora con un abbonamento, e scende a cinque minuti quando attingete ai crediti di utilizzo, oppure con una chiave API. Tornate dalla pausa pranzo e il vostro primo messaggio manca la cache: l'intera conversazione viene rielaborata a prezzo pieno. Una pausa, una rielaborazione completa.
• Tutto ciò che avvia un turno da solo. Un'attività pianificata che parte, un messaggio in arrivo da un'altra delle vostre sessioni, un controllo di avanzamento su un obiettivo mentre gira del lavoro in background. Ognuno di questi rinvia il contesto completo, esattamente come un messaggio digitato da voi.
• Gli agenti compagni di squadra. Ogni compagno attivo gira con la propria finestra di contesto e continua a consumare finché non termina. Le indicazioni di Anthropic collocano una squadra in modalità piano attorno a sette volte una sessione standard.
• La compattazione. /compact deve leggere la conversazione che riassume, quindi compattare un contesto grande è a sua volta una richiesta grande. /clear non costa niente e, quando non vi serve continuità, è la mossa migliore.
• Il lavoro in background. I riassunti per --resume e altre incombenze simili consumano un po' anche quando siete inattivi, di solito meno di quattro centesimi per sessione.

È anche qui che si separano i due avvisi che la gente confonde. Un avviso di contesto o di compattazione automatica dice che una conversazione si sta avvicinando alla finestra di contesto del modello, e azzerare quella sessione lo risolve. Un limite di utilizzo dice che la quota inclusa nel vostro abbonamento è esaurita su tutte le sessioni, e azzerare non ne restituisce niente. L'indizio affidabile: un limite di utilizzo indica un orario di rinnovo, un avviso di contesto no.

Cosa fare quando la barra è quasi piena

Più o meno in ordine di quanto rendono rispetto alla fatica che chiedono:

1. Azzerate tra attività scollegate. Un contesto ormai inutile viene rinviato a ogni messaggio per tutto il resto della sessione. Usate /rename prima di /clear se volete ritrovare la sessione con /resume.
2. Adattate il modello al lavoro. Sonnet gestisce la maggior parte del lavoro di programmazione; tenere Opus come impostazione predefinita è la causa più comune di una quota che sparisce entro giovedì.
3. Leggete l'attribuzione in /usage. Se un singolo server MCP o un singolo subagent vale il 30% della vostra settimana, la soluzione è lì, e non avreste mai indovinato quale fosse.
4. Abbassate il ragionamento prima di disattivarlo. I token di ragionamento vengono fatturati come output. Ridurre il livello di sforzo di ragionamento di solito basta.
5. Spostate il lavoro prolisso nei subagent. L'output dei test e i file di log restano nel contesto del subagent e torna indietro solo un riassunto.
6. Tenete corto il file di contesto. Tutto quello che sta in CLAUDE.md o AGENTS.md viene caricato all'avvio della sessione e pagato a ogni turno, anche quando non c'entra niente. Le istruzioni di workflow lunghe vanno in una skill, che si carica solo quando viene invocata. Trovate altro in proposito nella guida al file di contesto AGENTS.md.

Se volete la versione più lunga specificamente sul lato della riduzione dei costi, ridurre i costi in token di Claude Code la affronta nel dettaglio.

La versione corta

Smettete di cercare un saldo di token: il vostro abbonamento non ne ha uno. Imparate a conoscere le due finestre, leggete /usage per l'attribuzione più che per un totale, e trattate la cache come la cosa che decide la vostra settimana. Gli sviluppatori che non raggiungono mai un limite raramente sono quelli che scrivono di meno. Sono quelli che aprono una sessione nuova quando cambia l'argomento.

Far girare più agenti insieme rende tutto questo insieme peggiore e più facile da vedere, perché il consumo smette di essere un numero solo e diventa un numero per agente. È attorno a questa vista che è costruito AgentsRoom.

Domande frequenti

Quanti token mi restano su Claude?

Non esiste un numero del genere da consultare. Un abbonamento a Claude non viene venduto come budget di token: viene misurato come quota di una finestra di sessione mobile più una finestra settimanale, e quello che potete leggere è una percentuale di quelle finestre e l'orario in cui si rinnovano, non un saldo di token. Il posto giusto per leggerlo è il comando /usage dentro Claude Code, oppure Impostazioni e poi Utilizzo su claude.ai. Solo sull'API, fatturata a token, una cifra in token vuole dire davvero qualcosa.

Come funzionano i token di Claude?

Un token è un frammento di testo, all'incirca tre quarti di una parola in inglese e meno nel codice. Ogni richiesta invia di nuovo l'intera conversazione, quindi una sessione di programmazione paga la cronologia accumulata a ogni turno, non solo la frase che avete digitato. Ecco perché il consumo viene contato in quattro cifre distinte: input, output, scrittura della cache e lettura della cache. La cronologia in cache viene addebitata a una tariffa molto più bassa rispetto all'input nuovo, ed è esattamente il motivo per cui una sessione lasciata aperta tutto il giorno continua ad attingere al vostro abbonamento.

Quando si rinnova il limite di utilizzo di Claude?

Ci sono due orologi e sono indipendenti. Una finestra di sessione è mobile, quindi scade un numero fisso di ore dopo il momento in cui si è aperta e non a un orario scelto da voi. Una finestra settimanale sta sopra a questa e si rinnova in un momento fisso assegnato al vostro account. È il messaggio di limite stesso a dirvi quando torna disponibile la finestra che vi ha bloccati, e quel messaggio è la risposta autorevole per il vostro account. I due orologi sono condivisi tra la chat di Claude e Claude Code, quindi un uso intenso della chat accorcia il budget che vi resta per programmare.

Passare a un modello più economico mi restituisce il limite?

No. La finestra di sessione e quella settimanale sono condivise tra i modelli, quindi cambiare con /model non ripristina l'accesso una volta che le avete esaurite. Serve in un caso preciso: un messaggio legato a un modello specifico, per esempio il raggiungimento del limite di Opus, dove passare a Sonnet vi permette di continuare a lavorare. Serve anche prima di esaurire tutto, perché a parità di lavoro un modello più economico consuma meno della stessa quota inclusa nell'abbonamento.

Perché il mio consumo sale quando non sto facendo niente?

Perché l'inattività non è gratis in una sessione con agenti. Qualsiasi cosa avvii un turno rinvia l'intero contesto: un'attività pianificata che parte, un messaggio in arrivo da un'altra sessione, un agente compagno di squadra ancora in esecuzione, un controllo di avanzamento su un obiettivo. Altre due cose costano token senza un turno: la compattazione, che deve leggere la conversazione che riassume, e il primo messaggio dopo una lunga pausa, che manca la cache dei prompt e rielabora l'intera cronologia a prezzo pieno.

Un avviso sul contesto è la stessa cosa di un limite di utilizzo?

No, e confondere i due porta le persone alla soluzione sbagliata. Un avviso di contesto o di compattazione automatica riguarda una singola conversazione che si avvicina alla finestra di contesto del modello, e si risolve azzerando o compattando quella sessione. Un limite di utilizzo riguarda la quota inclusa nel vostro abbonamento su tutte le sessioni, e azzerare non ne restituisce niente. L'indizio sta nel testo: un messaggio di limite indica un orario di rinnovo, un avviso di contesto no.