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. La cifra in dollari è una stima calcolata localmente dai conteggi dei token e potrebbe differire dalla tua fattura effettiva. Per la fatturazione autorevole, vedi la pagina Usage nella Claude Console.

Total cost:            $0.55
Total duration (API):  6m 19.7s
Total duration (wall): 6h 33m 10.2s
Total code changes:    0 lines added, 0 lines removed

Su un piano Pro, Max, Team o Enterprise, /usage mostra anche una suddivisione di ciò che conta rispetto ai limiti del tuo piano. Attribuisce l'utilizzo recente a skills, subagents, plugins e singoli server MCP, ciascuno mostrato come percentuale del totale. 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, la stessa suddivisione appare nella finestra di dialogo Account & usage con un interruttore Day e Week. Richiede Claude Code v2.1.174 o versione successiva.

Imposta un limite di spesa su Pro e Max

Su piani Pro e Max, puoi impostare un limite di spesa mensile sui crediti di utilizzo con il comando /usage-credits. Se raggiungi quel limite mentre hai ancora crediti di utilizzo disponibili, Claude Code ti chiede di aumentare o rimuovere il limite in modo da poter continuare senza lasciare la CLI. La modifica del limite richiede l'accesso alla fatturazione sull'account.

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.

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.

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. 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. Le tre 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. Queste finestre sono condivise su tutti i modelli, quindi cambiare modelli con /model non ripristina l'accesso, anche se consente allo sviluppatore di continuare a lavorare dopo il messaggio specifico del modello "Hai raggiunto il tuo limite Opus". Il messaggio mostra quando la finestra si ripristina, e lo sviluppatore può eseguire /usage-credits per richiedere utilizzo oltre l'indennità se hai i crediti di utilizzo attivati. Vedi errori di limite di utilizzo.
• Un avviso di contesto o auto-compact: non è un limite di utilizzo. La conversazione è cresciuta vicino alla dimensione massima di input del modello, e 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-compaction, 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.

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. 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 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 "{\"hookSpecificOutput\":{\"hookEventName\":\"PreToolUse\",\"permissionDecision\":\"allow\",\"updatedInput\":{\"command\":\"$filtered_cmd\"}}}"
else
echo "{}"
fi

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, disabilitando il pensiero in /config, o, su modelli con un budget di pensiero fisso, abbassando 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ì. La disabilitazione del pensiero non è disponibile su Fable 5, che utilizza sempre il pensiero esteso.

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.

Comprensione dei cambiamenti nel comportamento di Claude Code

Claude Code riceve regolarmente aggiornamenti che possono cambiare il funzionamento delle funzionalità, inclusa la segnalazione dei costi. Esegui claude --version per controllare la tua versione attuale. Per domande specifiche sulla fatturazione, contatta il supporto di Anthropic tramite il tuo account Console.