Costo in token di Claude Code: cosa brucia davvero una sessione

Risposta rapida: aspettati dollari per sessione, non centesimi.

Claude Code è uno strumento agentico, non una finestra di chat. Una tua richiesta può innescare decine di chiamate al modello, e ogni chiamata reinvia l'intera conversazione crescente come token di input. Questo rende il volume di input, non l'output, il fattore che guida il costo. I token di output sono di solito un errore di arrotondamento rispetto all'input. Cifre approssimative riportate dalla community collocano una sessione seria di un'ora su un repo medio a circa 5-20 milioni di token. Alle tariffe dirette Anthropic per Sonnet 4.6 ($3 per milione di input, $15 per milione di output), la maggior parte delle sessioni finisce tra circa $2 e $40 prima degli sconti di cache, e le giornate intense su Opus vanno ben oltre. Il prompt caching abbassa le bollette reali sotto la matematica ingenua, ma la forma regge: sessioni lunghe su repo grandi costano soldi veri. Hai tre leve. Riduci ciò che entra nella finestra di contesto, instrada il lavoro di routine verso modelli più economici, e abbassa la tariffa per token cambiando dove le richieste vengono fatturate. Il resto di questa pagina esamina ciascuna leva con numeri concreti.

Dove vanno davvero i token.

Due meccanismi attenuano tutto ciò. Primo, il prompt caching di Anthropic: Claude Code segna i prefissi stabili come cacheable, le scritture in cache costano un sovrapprezzo, e le letture in cache fatturano a circa un decimo della tariffa di input normale. Secondo, la compattazione del contesto: il comando /compact riassume la cronologia e scarta la trascrizione grezza. Entrambi aiutano molto, e nessuno dei due cambia la regola fondamentale: tutto ciò che sta nella finestra viene pagato a ogni chiamata che lo include. Questo è il motivo per cui lo stesso prompt costa cifre molto diverse in repo diversi. Una domanda posta in una sessione fresca con un CLAUDE.md snello è economica. La stessa domanda posta 30 turni dentro una sessione che ha letto una dozzina di file grandi viaggia sopra una finestra di token a sei cifre.

• System prompt e definizioni dei tool: circa 15-20K token, reinviati a ogni singola chiamata al modello.
• CLAUDE.md, file di regole e schemi dei tool MCP: caricati all'avvio della sessione e trasportati in ogni chiamata successiva.
• Letture di file: un file sorgente di 500 righe è circa 5-7K token, e rimane nella finestra dopo essere stato letto una volta.
• Risultati dei tool: output dei test, hit di grep e log del terminale vengono aggiunti alla conversazione e rifatturati come input a ogni turno successivo.
• Il ciclo agentico stesso: un singolo "aggiusta questo test che fallisce" può produrre da 10 a 40 chiamate al modello prima che Claude Code riporti il risultato.

Matematica realistica del costo di sessione.

Modellala turno per turno invece di indovinare. Una sessione tipica di media dimensione gira circa 40 chiamate al modello. Una volta accumulati alcuni file e un po' di output di test, la finestra completa fa in media circa 90K token per chiamata. Quaranta chiamate a 90K sono 3.6M token di input. L'output resta piccolo: 40 chiamate a circa 1,000 token ciascuna sono circa 40K token di output. La tabella sotto prezza tre profili di sessione alle tariffe di listino dirette Anthropic. Trattale come tetti massimi: il prompt caching scontano pesantemente il prefisso ripetuto, quindi le sessioni in cache di solito arrivano più basse. Lo schema resta comunque coerente con quanto riportano gli sviluppatori. I pomeriggi occasionali costano pochi dollari; usare Opus come driver quotidiano sull'API può superare qualche centinaio di dollari al mese.

Piano vs API: quale via rende Claude Code più economico?

Anthropic vende Claude Code in due modi: incluso in piani di abbonamento a tariffa fissa con tetti di utilizzo applicati su finestre mobili, oppure misurato per token sull'API. I prezzi API di Claude Code sono semplicemente le tariffe dei modelli sopra applicate a qualunque cosa le tue sessioni brucino, senza tetto e senza interruzione. Il break-even è aritmetica semplice. Se la tua sessione tipica costa circa $11 su Sonnet alle tariffe dirette, un piano da $20 si ripaga da solo con circa due sessioni al mese, a patto di restare sotto i suoi tetti. Il problema sono proprio i tetti: l'uso agentico intenso è esattamente lo schema che fa scattare i limiti mobili, e una tariffa fissa smette di essere economica nel momento in cui vieni bloccato a metà sessione. La fatturazione API inverte il compromesso. Non vieni mai tagliato fuori, e paghi esattamente per quello che bruci. Molti utenti intensivi finiscono per essere ibridi: un piano per il lavoro interattivo, una chiave API per i job di CI e gli sfori.

Come ridurre il costo in token di Claude Code.

Le ultime due leve si sommano. Instradare un modello economico attraverso un endpoint scontato può trasformare una sessione da $10 in ben meno di un dollaro per il lavoro di routine. Un'opzione gateway è APIsRouter, un'API compatibile OpenAI con fatturazione pay-as-you-go e nessun abbonamento: i modelli globali sono prezzati il 20% sotto il listino ufficiale, i modelli cinesi stanno sotto le loro tariffe ufficiali, la prima ricarica aggiunge +100% di saldo, e il checkout senza registrazione su /topup accetta il pagamento prima e invia la chiave via email. La tabella sotto mostra come appare in pratica una scala di routing. Kimi K2.6 (kimi-k2.6) è disponibile anche se preferisci usarlo come tier economico.

• Tieni CLAUDE.md snello. Ogni riga è un costo ricorrente su ogni chiamata al modello in ogni sessione.
• Avvia una sessione fresca per ogni task ed esegui /compact quando una sessione lunga va alla deriva. Una finestra di 150K token fattura 150K a ogni chiamata.
• Limita le letture. Punta Claude Code su file specifici invece di lasciarlo esplorare liberamente, ed escludi output di build e directory vendored.
• Disabilita i server MCP che non stai usando. I loro schemi dei tool viaggiano nel system prompt a ogni chiamata.
• Instrada per modello. Tieni Opus per l'architettura e il debugging ostico, usa Sonnet come default, e sposta boilerplate, scaffolding dei test e commit message su modelli più economici.
• Abbassa la tariffa per token stessa puntando il base URL su un gateway invece di fatturare ai prezzi di listino diretti.

Esempio di configurazione: reindirizza Claude Code e verifica.

Claude Code legge ANTHROPIC_BASE_URL all'avvio, quindi cambiare dove i token vengono fatturati è una modifica di impostazioni, non del workflow. Metti l'endpoint e la chiave in ~/.claude/settings.json e ogni sessione li recupera. Gli ID modello restano gli stessi, l'esecuzione dei tool resta locale sulla tua macchina, e il rollback è commentare una riga. Per strumenti e script compatibili OpenAI, il base URL termina in /v1 (https://api.apisrouter.com/v1). Verifica la chiave con un curl una tantum prima di puntarci il tuo driver quotidiano:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.apisrouter.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-APIsRouter-...",
    "ANTHROPIC_MODEL": "claude-sonnet-4-6",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-7",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-6"
  }
}

Domande frequenti