Gestisci i costi in modo efficace

Traccia l'utilizzo dei token, imposta i limiti di spesa del team e riduci i costi di Claude Code con la gestione del contesto, la selezione del modello, le impostazioni del pensiero esteso e gli hook di pre-elaborazione.

Claude Code addebita il consumo di token API. Per i prezzi dei piani di abbonamento (Pro, Max, Team, Enterprise), vedi claude.com/pricing. I costi per sviluppatore variano notevolmente in base alla selezione del modello, alle dimensioni della codebase e ai modelli di utilizzo come l'esecuzione di più istanze o l'automazione.

Nelle distribuzioni aziendali, il costo medio è di circa $13 per sviluppatore per giorno attivo e $150-250 per sviluppatore al mese, con costi che rimangono al di sotto di $30 per giorno attivo per il 90% degli utenti. Per stimare la spesa per il tuo team, inizia con un piccolo gruppo pilota e utilizza gli strumenti di tracciamento di seguito per stabilire una baseline prima di un rollout più ampio.

Questa pagina spiega come tracciare i tuoi costi, gestire i costi per la tua organizzazione e ridurre l'utilizzo dei token.

Traccia i tuoi costi

Utilizzo del comando `/usage`

Il blocco Session in cima a /usage mostra statistiche dettagliate sull'utilizzo dei token per la tua sessione attuale. Claude Code calcola la cifra in dollari localmente dai conteggi dei token al prezzo di listino, a meno che non sia in vigore una tabella modelPricing. Un amministratore ne imposta una nelle impostazioni gestite della tua organizzazione in modo che la cifra utilizzi le tue tariffe contrattuali, e mentre una tabella è in vigore la riga Total cost riporta la nota at your organization's configured rates. La cifra è una stima, quindi per la fatturazione autorevole vedi la pagina Usage nella Claude Console.

Total cost:            $0.55
Total duration (API):  6m 20s
Total duration (wall): 6h 33m 10s
Total code changes:    0 lines added, 0 lines removed
Usage by model:
   claude-sonnet-4-6:  1.2k input, 5.3k output, 940.0k cache read, 50.0k cache write ($0.55)

Questi totali si azzerano quando /clear avvia una nuova sessione, quindi il costo totale della sessione successiva ricomincia da $0. Prima della v2.1.211, continuavano ad accumularsi attraverso /clear per la durata del processo Claude Code.

Per una risposta dall'API Claude fatturata al tasso di residenza dei dati 1.1×, Claude Code moltiplica il prezzo di listino dei token di quella risposta per 1.1 nella cifra del costo della sessione. Lo stesso totale appare nel campo costo della riga di stato, e la cifra moltiplicata conta anche verso --max-budget-usd. Prima della v2.1.239, Claude Code non applicava l'1.1× a quelle risposte, quindi la cifra del costo della sessione era inferiore alla fattura.

Statistiche della cache dei prompt

Dopo la prima risposta API della conversazione principale, Claude Code aggiunge anche una riga Prompt cache (main) al blocco Session, riepilogando l'utilizzo della cache dei prompt della sessione: il conteggio delle richieste, la quota di token di input serviti dalla cache, i mancati accessi alla cache e se la cache è calda in questo momento. Richiede Claude Code v2.1.251 o versione successiva.

Prompt cache (main):   14 requests · 91% of input tokens from cache · 2 misses (last 6m 10s ago, 310.2k tokens re-cached) · 1 expected rebuild (compaction or tool-result clearing) · warm (1h TTL, last activity 40s ago)

I mancati accessi, i rebuild previsti e le parti calde o fredde della riga significano quanto segue:

• Misses: richieste che hanno rielaborato contenuti che la cache già conteneva, con l'ora dell'ultimo mancato accesso e quanti token quelle richieste hanno scritto di nuovo nella cache. Claude Code conta una richiesta come mancato accesso quando la richiesta ha rielaborato più del 5% e almeno 2.000 token di ciò che avrebbe potuto leggere dalla cache. Le azioni che invalidano la cache elencano le cause usuali. Quando Claude Code riesce a identificare una probabile causa per l'ultimo mancato accesso, la riga la nomina anche, ad esempio likely cause: tool definitions changed. Il testo della probabile causa richiede Claude Code v2.1.260 o versione successiva.
• Expected rebuilds: quando Claude Code ha appena riscritto la conversazione, per compattazione o per cancellazione dei vecchi risultati degli strumenti dal contesto, conta lo stesso tipo di mancato accesso come rebuild previsto. Questa parte appare solo dopo che si è verificato almeno un rebuild previsto.
• Warm or cold: se il prefisso memorizzato nella cache è ancora entro la sua durata della cache, con il TTL in vigore. Quando la cache è fredda, la riga mostra quanto tempo la sessione è rimasta inattiva. Quando nessuna risposta ha segnalato token della cache, la riga termina con no prompt caching reported by the API invece.

I conteggi provengono dai campi dei token della cache nelle risposte dell'API, quindi la riga funziona su ogni provider e gateway. Copre solo la conversazione principale, non i subagent. /clear la azzera insieme al resto del blocco Session.

Gli script della riga di stato possono leggere gli stessi numeri dall'oggetto prompt_cache.

Suddivisione dell'utilizzo del piano

Su un piano Pro, Max, Team o Enterprise, /usage mostra anche una suddivisione di ciò che conta rispetto ai limiti del tuo piano:

• Attribution: utilizzo recente attribuito a skills, subagent, plugin e singoli server MCP, ciascuno mostrato come percentuale del totale. La quota di un server MCP conta solo le richieste che hanno consumato uno dei risultati dei suoi strumenti. Prima della v2.1.222, dopo una chiamata a un server MCP, Claude Code attribuiva ogni richiesta successiva a quel server, sovrastimando la sua quota.
• Behavior flags: comportamenti come contesto lungo o mancati accessi alla cache, contrassegnati quando uno rappresenta il 10% o più dell'utilizzo recente.
• Loops: una riga per ciascuno dei /loop o altri task programmati più pesanti che sono stati eseguiti di recente, ordinati per token totali, con un conteggio del resto. Claude Code segnala con quale frequenza ogni task si attiva, quante volte è stato eseguito, i suoi token totali e per esecuzione, e quando è stato eseguito l'ultima volta. Claude Code identifica una riga dal prompt del task, quindi un loop che interrompi e ricrei rimane una riga. Richiede Claude Code v2.1.242 o versione successiva.

Premi d o w per passare tra le ultime 24 ore e gli ultimi 7 giorni. Le cifre sono approssimative e calcolate dalla cronologia della sessione locale su questa macchina, quindi l'utilizzo da altri dispositivi o da claude.ai non è incluso.

Nell'estensione VS Code, le quote di attribuzione e i flag di comportamento appaiono nella finestra di dialogo Account & usage con un interruttore Day e Week, senza le righe Loops.

Controlla la tua spesa in crediti di utilizzo

/usage mostra anche una riga di crediti di utilizzo mentre i crediti di utilizzo sono attivi. Ciò che la riga mostra dipende dal tuo piano:

• Pro e Max: la tua spesa per il mese corrente, misurata rispetto al tuo limite di spesa mensile quando ne hai impostato uno. Quando non hai impostato un limite, la riga mostra Unlimited e nessuna cifra di spesa.
• Team e Enterprise: la tua spesa per il mese corrente, misurata rispetto a qualsiasi limite impostato dalla tua organizzazione che si applica a te. Un limite che copre l'intera organizzazione non appare nella riga. Quando non hai un limite tuo, la riga mostra la tua spesa senza limite accanto. Mentre i crediti di utilizzo sono disattivati per te, /usage non mostra alcuna riga di crediti di utilizzo.

Quando hai un limite di spesa, la riga appare non appena i crediti di utilizzo sono attivi e mostra 0% fino a quando non spendi per la prima volta i crediti di utilizzo. Prima della v2.1.236, /usage mostrava la riga solo su piani Pro e Max, e una riga con un limite di spesa rimaneva nascosta fino a quando non avevi speso qualcosa.

Quando la richiesta di utilizzo non riesce

Quando la richiesta per i limiti del tuo piano non riesce, il più delle volte perché l'endpoint di utilizzo è limitato dalla frequenza, /usage mostra le ultime barre di utilizzo caricate su questa macchina negli ultimi 60 minuti, insieme a una nota Showing last-known usage che indica quanto tempo fa sono stati recuperati i dati. Premi r per riprovare; un nuovo tentativo riuscito sostituisce le ultime barre conosciute con dati freschi. Senza uno snapshot degli ultimi 60 minuti, /usage segnala che l'endpoint di utilizzo è limitato dalla frequenza e offre lo stesso collegamento di riprovazione. Prima della v2.1.208, una richiesta limitata dalla frequenza in una sessione che non aveva ancora caricato l'utilizzo mostrava sempre l'errore senza barre.

Analizza i tuoi modelli di utilizzo

Esegui /insights per un rapporto su come lavori piuttosto che su quanti token hai utilizzato. Analizza le tue sessioni recenti su questa macchina e scrive un rapporto HTML che copre su cosa lavori, punti di attrito come richieste fraintese o codice buggy, e suggerimenti per utilizzare Claude Code più efficacemente. Una singola esecuzione analizza fino a 200 sessioni che non ha ancora visto e salta quelle molto brevi. Quando le sessioni vengono omesse, l'intestazione del rapporto mostra il conteggio analizzato con il totale tra parentesi, ad esempio 200 sessions (412 total).

Claude Code scrive l'ultimo rapporto in ~/.claude/usage-data/report.html e salva una copia con timestamp di ogni esecuzione nella stessa directory, quindi i rapporti precedenti non vengono sovrascritti. Claude Code elimina i rapporti secondo la stessa pianificazione del resto dei tuoi dati di sessione: all'avvio, rimuove i file più vecchi di cleanupPeriodDays, 30 giorni per impostazione predefinita.

Puoi eseguire /insights su qualsiasi piano e con qualsiasi provider. L'analisi viene eseguita attraverso lo stesso provider e account delle tue sessioni regolari, e i token contano rispetto al tuo utilizzo del piano o dell'API. Le sessioni da altri dispositivi e da claude.ai non sono incluse.

Aggiungi crediti di utilizzo al tuo abbonamento

I crediti di utilizzo ti permettono di continuare a lavorare oltre il limite di utilizzo del tuo piano. Per gestirli, esegui /usage-credits dopo aver effettuato l'accesso con il tuo abbonamento claude.ai tramite /login; il comando non è disponibile con l'autenticazione tramite chiave API. Nelle organizzazioni Enterprise self-serve, nei trial Enterprise e nelle organizzazioni Enterprise fatturate tramite AWS Marketplace, il comando richiede Claude Code v2.1.248 o versione successiva; le versioni precedenti lo rifiutano con Unknown command: /usage-credits. Ciò che apre dipende dal tuo ruolo:

Per i membri Team e Enterprise senza accesso alla fatturazione, la conferma appare solo nelle sessioni interattive: in modalità non interattiva con il flag -p e da Remote Control, il comando non invia alcuna richiesta e ti dice di eseguirlo in una sessione interattiva.

Se esegui /usage-credits di nuovo mentre la tua richiesta precedente è in attesa di un amministratore, Claude Code ti dice che una richiesta è già stata inviata piuttosto che inviarne una duplicata. Dopo che un amministratore ha respinto la tua richiesta, l'esecuzione del comando di nuovo invia una nuova. Prima della v2.1.222, una richiesta respinta bloccava anche le nuove richieste.

Su piani Pro e Max, quando raggiungi il tuo limite di spesa con crediti di utilizzo ancora disponibili, Claude Code ti chiede di aumentare o rimuovere il limite senza lasciare la CLI. Se il server rifiuta la modifica, vedi Could not update your spend limit.

Gestione dei costi per la tua organizzazione

I controlli che hai a disposizione dipendono da come la tua organizzazione accede a Claude Code: un piano Claude for Teams o Enterprise, la Claude Console, o un provider cloud. Nei piani Teams e Enterprise, l'utilizzo viene prelevato dall'indennità di posto di ogni membro. Nella Console e presso i provider cloud, l'utilizzo viene fatturato per token alla tua organizzazione. Se la tua organizzazione mescola metodi di accesso, ogni sviluppatore viene misurato in base a quello con cui si è autenticato.

La tabella mappa ogni configurazione a dove vedi la spesa, dove la limiti, e come estrai i numeri per utente. Su un piano individuale Pro o Max non hai un'organizzazione da gestire, quindi traccia il tuo utilizzo di crediti di spesa, incluso fast mode, in Aggiungi crediti di utilizzo al tuo abbonamento.

L'esportazione OpenTelemetry funziona su ogni configurazione ed è l'unica opzione che trasmette metriche di token e costo per utente nel tuo stack di osservabilità in tempo quasi reale.

Rapporta la spesa alle tue tariffe contrattuali

Per impostazione predefinita, Claude Code calcola ogni cifra di costo che mostra agli sviluppatori al prezzo di listino, quindi se la tua organizzazione paga tariffe contrattuali, le cifre in /usage, la riga di stato e OpenTelemetry non corrispondono alla tua fattura. Per farle corrispondere, imposta l'impostazione gestita modelPricing alle tue tariffe. L'impostazione cambia ciò che Claude Code segnala, non ciò che Anthropic addebita. Richiede Claude Code v2.1.242 o successivo.

Per confermare che le tariffe sono in vigore, esegui /usage in una sessione che ha ricevuto le impostazioni gestite: il blocco Session della riga Total cost riporta la nota at your organization's configured rates. Le cifre sono ancora stime, non una fattura. I prezzi per milione di token nel selettore /model rimangono al prezzo di listino.

Claude for Teams e Enterprise

Nei piani Claude for Teams e Enterprise, l'utilizzo di Claude Code di ogni membro viene prelevato da un'indennità per posto che si ripristina su una finestra mobile di cinque ore e una finestra settimanale. L'indennità è condivisa con Claude chat e Cowork, e la sua dimensione dipende dal livello di posto (Standard o Premium). I tuoi controlli si trovano nella console admin di claude.ai, non nella Claude Console.

• Visualizza spesa: il rapporto spesa in analitiche org mostra la spesa stimata per utente e per modello, con esportazione CSV, aggiornato quotidianamente. Il rapporto copre la spesa in crediti di utilizzo e appare una volta che i crediti di utilizzo sono attivati. L'utilizzo all'interno dell'indennità di posto non viene misurato in dollari.
• Visualizza adozione: il dashboard analitiche mostra utenti attivi giornalieri, sessioni e metriche di contributo, con esportazione CSV dei dati di contributo. Vedi traccia l'utilizzo del team con analitiche.
• Limita spesa: l'indennità di posto è il limite predefinito. Per consentire ai membri di continuare oltre, attiva i crediti di utilizzo e imposta limiti di spesa a livello organizzativo, di gruppo o di singolo membro.
• Estrai numeri per utente: nel piano Enterprise, l'Enterprise Analytics API restituisce rapporti di utilizzo e costo per utente su tutte le superfici Claude, incluso Claude Code. Un Primary Owner crea una chiave con l'ambito read:analytics su claude.ai/analytics/api-keys. Nel piano Teams, esporta il CSV rapporto spesa, che elenca l'utilizzo dei token e la spesa stimata per utente e per modello.

La guida al consumo Claude Enterprise è il riferimento di pianificazione per gli amministratori. Spiega come il consumo differisce tra Claude chat, Claude Code e Cowork, e fornisce punti di partenza in dollari per utente per il budgeting. Stanzia di più per un posto di codifica rispetto a un posto di chat: ogni turno di Claude Code contiene contenuti di file, chiamate di strumenti e ragionamento multi-step, quindi una sessione di debug può consumare più di un giorno di chat.

Claude Console

Le organizzazioni API gestiscono la spesa di Claude Code attraverso aree di lavoro. Puoi impostare limiti di spesa dell'area di lavoro sulla spesa totale di Claude Code e visualizzare rapporti di costo e utilizzo nella Console.

Per la segnalazione per utente, il dashboard Console mostra la spesa e le righe accettate per membro, e l'Claude Code Analytics API restituisce le stesse metriche giornaliere per utente a livello di programmazione con una chiave API Admin. Vedi analitiche per clienti API.

Raccomandazioni sui limiti di velocità

Quando configuri Claude Code per i team, considera queste raccomandazioni Token Per Minuto (TPM) e Richieste Per Minuto (RPM) per utente in base alle dimensioni della tua organizzazione:

Ad esempio, se hai 200 utenti, potresti richiedere 20k TPM per ogni utente, o 4 milioni di TPM totali (200*20.000 = 4 milioni).

Il TPM per utente diminuisce man mano che le dimensioni del team crescono perché meno utenti tendono a utilizzare Claude Code contemporaneamente nelle organizzazioni più grandi. Questi limiti di velocità si applicano a livello organizzativo, non per singolo utente, il che significa che i singoli utenti possono temporaneamente consumare più della loro quota calcolata quando altri non stanno utilizzando attivamente il servizio.

Provider cloud

Su Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry, Claude Code viene fatturato per token al tuo account cloud, e i controlli di spesa si trovano nella console di fatturazione del tuo provider cloud. Claude Code non invia metriche dal tuo cloud ad Anthropic, quindi i dashboard analitiche e l'Claude Code Analytics API non coprono questo utilizzo.

Per l'attribuzione dei costi per utente, hai tre opzioni:

• OpenTelemetry: esporta metriche dalla macchina di ogni sviluppatore nel tuo stack di osservabilità. Questo ti dà conteggi di token per utente, costi e attività di strumenti indipendentemente dal provider.
• Un gateway di app Claude: un gateway di app Claude self-hosted fornisce l'attribuzione dell'utilizzo per utente, metriche OTLP con conteggi dei token e limiti di spesa per utente su questi provider.
• Un gateway LLM: instrada tutto il traffico di Claude Code attraverso un proxy che traccia la spesa per chiave. Diversi grandi enterprise hanno riferito di utilizzare LiteLLM, uno strumento open-source che traccia la spesa per chiave. Questo progetto non è affiliato ad Anthropic e non è stato sottoposto a audit di sicurezza.

Quando uno sviluppatore chiede informazioni su un limite

Gli sviluppatori di solito portano domande sui limiti al loro amministratore, quindi è utile sapere quale limite hanno raggiunto. Queste situazioni significano cose diverse:

• "Hai raggiunto il tuo limite di sessione" o "Hai raggiunto il tuo limite settimanale": una finestra di utilizzo basata su posto in un piano di abbonamento, condivisa su tutti i modelli, quindi lo sviluppatore non può ripristinare l'accesso cambiando modelli con /model. Il messaggio mostra quando la finestra si ripristina. Dopo il messaggio specifico del modello "Hai raggiunto il tuo limite Opus" o "Hai raggiunto il tuo limite Sonnet", cambiare a un modello al di fuori di quella famiglia con /model mantiene lo sviluppatore al lavoro. Vedi errori di limite di utilizzo. Quello che lo sviluppatore può fare nel frattempo:
  • Esegui /usage-credits per richiedere utilizzo oltre l'indennità, se hai i crediti di utilizzo attivati.
  • Su Claude Code v2.1.234 o successivo, attendi e continua il compito interrotto automaticamente dopo il ripristino; quella sezione elenca quando Claude Code avvia l'attesa da solo e quando lo sviluppatore lo seleziona da /rate-limit-options. Per controllare per la tua flotta se Claude Code avvia quell'attesa da solo, imposta autoContinueAtUsageLimit nelle impostazioni gestite.
• "Hai raggiunto il tuo limite di spesa individuale", "limite di spesa mensile dell'organizzazione", o "budget condiviso del team": la richiesta dello sviluppatore verrebbe fatturata ai crediti di utilizzo, e quei crediti hanno raggiunto un limite di spesa che hai impostato. Per consentire allo sviluppatore di continuare, vai a Impostazioni Admin > Utilizzo e aumenta il limite che il messaggio nomina. Quando il messaggio nomina anche un'ora di ripristino del piano, lo sviluppatore può invece attendere fino ad allora. Vedi il riferimento degli errori per ogni variante.
• Un messaggio di limite di spesa da un gateway di app Claude: lo sviluppatore ha superato un limite di spesa che hai impostato sul tuo gateway self-hosted, e il gateway blocca le sue richieste fino al ripristino del periodo o fino a quando non aumenti il limite. Vedi limiti di spesa del gateway per i limiti, i programmi di ripristino e il messaggio che lo sviluppatore vede.
• Un avviso di contesto o auto-compact: non è un limite di utilizzo. La conversazione è cresciuta vicino alla finestra auto-compact della sessione, la soglia in cui Claude Code riassume la cronologia più vecchia per liberare spazio. Indirizza lo sviluppatore a riduci l'utilizzo dei token.
• Spesa inaspettatamente alta su un piano API o provider cloud: di solito risale a sessioni lunghe che non sono mai state cancellate o a Opus lasciato come modello predefinito. Le abitudini con il maggiore impatto da condividere sono cancellare tra compiti non correlati e abbinare il modello al lavoro, entrambi coperti in riduci l'utilizzo dei token.

Costi dei token del team di agenti

I team di agenti generano più istanze di Claude Code, ognuna con la propria finestra di contesto. L'utilizzo dei token si ridimensiona con il numero di compagni di squadra attivi e per quanto tempo ognuno viene eseguito.

Per mantenere i costi del team di agenti gestibili:

• Utilizza Sonnet per i compagni di squadra. Bilancia la capacità e il costo per i compiti di coordinamento.
• Mantieni i team piccoli. Ogni compagno di squadra esegue la propria finestra di contesto, quindi l'utilizzo dei token è approssimativamente proporzionale alle dimensioni del team.
• Mantieni i prompt di generazione focalizzati. I compagni di squadra caricano automaticamente CLAUDE.md, i server MCP e le skills, ma tutto nel prompt di generazione si aggiunge al loro contesto dall'inizio.
• Spegni i compagni di squadra quando il loro lavoro è terminato. Ogni compagno di squadra attivo continua a consumare token finché non esce o la sessione termina.
• I team di agenti sono disabilitati per impostazione predefinita. Imposta CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 nel tuo settings.json o nell'ambiente per abilitarli. Vedi abilita i team di agenti.

Riduci l'utilizzo dei token

I costi dei token si ridimensionano con la dimensione del contesto: più contesto Claude elabora, più token utilizzi. Claude Code ottimizza automaticamente i costi attraverso il prompt caching, che riduce i costi per il contenuto ripetuto come i prompt di sistema, e l'auto-compact, che riassume la cronologia della conversazione quando ci si avvicina ai limiti del contesto.

Le seguenti strategie ti aiutano a mantenere il contesto piccolo e ridurre i costi per messaggio.

Gestisci il contesto in modo proattivo

Utilizza /usage per controllare l'utilizzo attuale dei token, o configura la tua linea di stato per visualizzarla continuamente.

• Cancella tra i compiti: Utilizza /clear per ricominciare da capo quando passi a lavori non correlati. Il contesto obsoleto spreca token su ogni messaggio successivo. Utilizza /rename prima di cancellare in modo da poter trovare facilmente la sessione in seguito, quindi /resume per tornare ad essa.
• Aggiungi istruzioni di compaction personalizzate: /compact Focus on code samples and API usage dice a Claude cosa preservare durante la sintesi. In una sessione nuova, /compact stampa Not enough messages to compact. perché non c'è ancora cronologia della conversazione da riassumere.

Puoi anche personalizzare il comportamento della compaction nel tuo file CLAUDE.md nella radice del tuo progetto:

# Compact instructions

When you are using compact, please focus on test output and code changes

Scegli il modello giusto

Sonnet gestisce bene la maggior parte dei compiti di codifica e costa meno di Opus. Riserva Opus per decisioni architettoniche complesse o ragionamento multi-step. Utilizza /model per cambiare modello a metà sessione, o imposta un valore predefinito in /config. Un passaggio a Opus si applica anche ai subagent che ereditano il modello della tua sessione. Per semplici compiti subagent, specifica model: haiku nella tua configurazione subagent.

Riduci l'overhead del server MCP

Le definizioni degli strumenti MCP sono rinviate per impostazione predefinita, quindi solo i nomi degli strumenti e le istruzioni del server entrano nel contesto finché Claude non utilizza uno strumento specifico. Esegui /context per vedere cosa sta consumando spazio.

• Preferisci gli strumenti CLI quando disponibili: Strumenti come gh, aws, gcloud e sentry-cli sono ancora più efficienti dal punto di vista del contesto rispetto ai server MCP perché non aggiungono alcun elenco di strumenti per strumento. Claude può eseguire comandi CLI direttamente.
• Disabilita i server inutilizzati: Esegui /mcp per vedere i server configurati e disabilita quelli che non stai utilizzando attivamente.

Installa plugin di intelligenza del codice per i linguaggi tipizzati

I plugin di intelligenza del codice danno a Claude una navigazione precisa dei simboli invece della ricerca basata su testo, riducendo le letture di file non necessarie quando si esplora codice sconosciuto. Una singola chiamata "vai alla definizione" sostituisce quello che altrimenti potrebbe essere un grep seguito dalla lettura di più file candidati. I server di linguaggio installati segnalano anche gli errori di tipo automaticamente dopo le modifiche, quindi Claude cattura gli errori senza eseguire un compilatore.

Offload dell'elaborazione agli hook e alle skills

Gli hook personalizzati possono pre-elaborare i dati prima che Claude li veda. Invece di Claude che legge un file di log di 10.000 righe per trovare errori, un hook può cercare ERROR e restituire solo le righe corrispondenti, riducendo il contesto da decine di migliaia di token a centinaia.

Una skill può dare a Claude la conoscenza del dominio in modo che non debba esplorare. Ad esempio, una skill "codebase-overview" potrebbe descrivere l'architettura del tuo progetto, le directory chiave e le convenzioni di denominazione. Quando Claude invoca la skill, ottiene questo contesto immediatamente invece di spendere token leggendo più file per comprendere la struttura.

Ad esempio, questo hook PreToolUse filtra l'output del test per mostrare solo i fallimenti:

{
"hooks": {
"PreToolUse": [
{
"matcher": "Bash",
"hooks": [
{
"type": "command",
"command": "~/.claude/hooks/filter-test-output.sh"
}
]
}
]
}
}

#!/bin/bash
input=$(cat)
cmd=$(echo "$input" | jq -r '.tool_input.command')

# If running tests, filter to show only failures
if [[ "$cmd" =~ ^(npm test|pytest|go test) ]]; then
filtered_cmd="$cmd 2>&1 | grep -A 5 -E '(FAIL|ERROR|error:)' | head -100"
echo "$input" | jq --arg filtered "$filtered_cmd" \
'{hookSpecificOutput: {hookEventName: "PreToolUse", permissionDecision: "allow", updatedInput: (.tool_input + {command: $filtered})}}'
else
echo "{}"
fi

Per verificare la configurazione, esegui /hooks e controlla che l'hook appaia sotto PreToolUse. Puoi anche avviare Claude Code con claude --debug-file ./claude-debug.txt e chiedere a Claude di eseguire npm test. Quando l'hook riscrive il comando, quel file di log contiene una riga modified tool input keys che elenca command e gli altri campi di input Bash.

Sposta le istruzioni da CLAUDE.md alle skills

Il tuo file CLAUDE.md viene caricato nel contesto all'inizio della sessione. Se contiene istruzioni dettagliate per flussi di lavoro specifici (come revisioni PR o migrazioni di database), quei token sono presenti anche quando stai facendo lavori non correlati. Le skills si caricano su richiesta solo quando invocate, quindi spostare le istruzioni specializzate nelle skills mantiene il tuo contesto di base più piccolo. Mira a mantenere CLAUDE.md sotto 200 righe includendo solo gli elementi essenziali.

Regola il pensiero esteso

Il pensiero esteso è abilitato per impostazione predefinita perché migliora significativamente le prestazioni su compiti complessi di pianificazione e ragionamento. I token di pensiero vengono fatturati come token di output, e il budget predefinito può essere decine di migliaia di token per richiesta a seconda del modello.

Per compiti più semplici dove il ragionamento profondo non è necessario, puoi ridurre i costi abbassando il livello di sforzo con /effort o in /model, o disabilitando il pensiero in /config. Non puoi disattivare il pensiero su Opus 5.5 o sui modelli Fable, che utilizzano sempre il pensiero esteso.

Sui modelli con un budget di pensiero fisso, puoi anche abbassare il budget impostando la variabile di ambiente MAX_THINKING_TOKENS, ad esempio MAX_THINKING_TOKENS=8000. I modelli di ragionamento adattivo ignorano i budget diversi da zero, quindi utilizza i livelli di sforzo lì.

Delega le operazioni dettagliate ai subagent

L'esecuzione di test, il recupero della documentazione o l'elaborazione di file di log possono consumare un contesto significativo. Delega questi ai subagent in modo che l'output dettagliato rimanga nel contesto del subagent mentre solo un riassunto ritorna alla tua conversazione principale.

Gestisci i costi del team di agenti

I team di agenti utilizzano approssimativamente 7 volte più token rispetto alle sessioni standard quando i compagni di squadra vengono eseguiti in plan mode, perché ogni compagno di squadra mantiene la propria finestra di contesto ed esegue come un'istanza Claude separata. Mantieni i compiti del team piccoli e autonomi per limitare l'utilizzo dei token per compagno di squadra. Vedi team di agenti per i dettagli.

Scrivi prompt specifici

Richieste vaghe come "migliora questa codebase" attivano una scansione ampia. Richieste specifiche come "aggiungi la convalida dell'input alla funzione di accesso in auth.ts" permettono a Claude di lavorare in modo efficiente con letture di file minime.

Lavora in modo efficiente su compiti complessi

Per lavori più lunghi o complessi, queste abitudini aiutano a evitare token sprecati andando nella direzione sbagliata:

• Utilizza plan mode per compiti complessi: Premi Shift+Tab per entrare in plan mode prima dell'implementazione. Claude esplora la codebase e propone un approccio per la tua approvazione, prevenendo la rielaborazione costosa quando la direzione iniziale è sbagliata.
• Correggi la rotta presto: Se Claude inizia a andare nella direzione sbagliata, premi Escape per fermarti immediatamente. Utilizza /rewind o doppio tocco Escape per ripristinare la conversazione e il codice a un checkpoint precedente.
• Fornisci target di verifica: Includi casi di test, incolla screenshot o definisci l'output previsto nel tuo prompt. Quando Claude può verificare il suo lavoro, cattura i problemi prima che tu debba richiedere correzioni.
• Testa in modo incrementale: Scrivi un file, testalo, quindi continua. Questo cattura i problemi presto quando sono economici da risolvere.

Utilizzo dei token in background

Claude Code utilizza token per alcune funzionalità in background anche quando inattivo:

• Sintesi della conversazione: Processi in background che riassumono le conversazioni precedenti per la funzione claude --resume
• Elaborazione dei comandi: Alcuni comandi come /usage possono generare richieste per controllare lo stato

Questi processi in background consumano una piccola quantità di token (in genere meno di $0,04 per sessione) anche senza interazione attiva.

Perché l'utilizzo aumenta in una sessione lunga

Una sessione che è rimasta aperta per ore può utilizzare molto più dei limiti del vostro piano di quanto l'attività suggerisca, solitamente per uno di questi motivi:

• Contesto lungo: Claude Code invia la vostra conversazione completa con ogni richiesta, e ogni volta che Claude utilizza gli strumenti invia un'altra richiesta contenente quel batch di risultati degli strumenti. Con prompt caching, Claude Code rilegge quella cronologia alla cached token rate, quindi una domanda di una sola riga in una sessione che è rimasta aperta tutto il giorno consuma comunque utilizzo per l'intera conversazione. Consultate Manage context proactively per i modi di mantenere il vostro contesto piccolo
• Cache misses: il vostro primo messaggio dopo una pausa più lunga della cache lifetime manca la cache e rielabora il vostro contesto completo. La durata è di un'ora su un abbonamento e scende a cinque minuti una volta che state utilizzando usage credits; su una chiave API o provider cloud, è cinque minuti per impostazione predefinita. Per mantenere la durata di un'ora mentre utilizzate usage credits, scegliete il TTL voi stessi. Sui piani Pro e Max, quando riprendete una sessione grande dopo una lunga pausa, Claude Code offre di riprendere da un riepilogo in modo che le richieste successive non portino la cronologia completa
• Scheduled tasks: un scheduled task si attiva al suo intervallo anche mentre la sessione è inattiva, inviando il vostro contesto completo ogni volta
• Cross-session messages: Claude Code consegna un message from another of your sessions come un nuovo turno quando questa sessione rimane inattiva, inviando il vostro contesto completo ogni volta. Per trattenere i messaggi in entrata invece di consegnarli, impostate crossSessionInbound su hold
• Goal check-ins: mentre il lavoro in background mantiene un goal attivo in attesa, Claude Code chiede a Claude di controllare quel lavoro anche quando la sessione rimane inattiva, avviando un nuovo turno che invia il vostro contesto completo. Claude Code avvia al massimo tre check-in inattivi per goal tra i vostri prompt. Prima della v2.1.246, i check-in inattivi erano illimitati. Per disattivare i check-in, impostate CLAUDE_CODE_GOAL_CHECKIN_MINUTES su 0. I check-in inattivi richiedono Claude Code v2.1.236 o successivo
• Agent teammates: ogni teammate attivo continua a consumare token fino a quando non esce
• Compaction: /compact legge la conversazione che riassume, quindi compacting a large context è essa stessa una richiesta grande. Quando volete un nuovo inizio invece della continuità, /clear non costa nulla

Su un piano Pro, Max, Team o Enterprise, il breakdown di /usage segnala i comportamenti che rappresentano il 10% o più dell'utilizzo recente, come il contesto lungo o i cache misses, ciascuno con un suggerimento per ridurlo.

Comprensione dei cambiamenti nel comportamento di Claude Code

Claude Code riceve regolarmente aggiornamenti che possono modificare il funzionamento delle funzionalità, inclusa la segnalazione dei costi. Eseguire claude --version per verificare la versione corrente.

Per domande sulla fatturazione relative al tuo account specifico, contatta il supporto Anthropic tramite il messenger integrato nel prodotto:

• Piani di abbonamento (Pro, Max, Team, Enterprise): accedi a claude.ai, fai clic sulle tue iniziali in basso a sinistra e seleziona Ottieni aiuto
• Fatturazione Console (API): accedi a platform.claude.com, fai clic sulle tue iniziali e seleziona Ottieni aiuto

Consulta Come ottenere supporto per il flusso completo, incluso chi può raggiungere un agente umano per ogni piano.