La CLI di Claude Code è gratuita da installare. Eseguirla non lo è. Ogni azione eseguita da Claude Code — leggere un file, proporre una modifica, eseguire un comando, verificare il risultato — è una chiamata al modello che qualcuno deve pagare. Anthropic offre ai nuovi account API una piccola quantità di credito gratuito per i test, ma oltre a questo credito non esiste un livello gratuito: una volta esaurito, ogni chiamata viene fatturata.
Il costo dipende interamente da quale delle due modalità di pagamento scegli — un abbonamento claude.ai o una chiave API fatturata per token — e sono adatte a modelli di utilizzo molto diversi. Il modo più economico per eseguirlo senza abbonamento è una chiave pay-as-you-go: su Kunavo ogni modello Claude costa 30% in meno rispetto al listino Anthropic, a partire da una ricarica di $10 senza canone mensile, e la configurazione richiede poche variabili d’ambiente (vedi sotto). Ecco i calcoli effettivi.
Cosa è gratuito e cosa no
| Componente | Costi |
|---|---|
| Installazione della CLI | Gratuita |
| Le estensioni per VS Code e JetBrains | Gratuita |
| Configurazione, hook, skill, subagenti, server MCP | Gratuita |
| Chiamate al modello — cioè l’utilizzo effettivo | A pagamento |
L’unico modo gratuito per iniziare è un pass ospite. Gli abbonati Pro e Max idonei possono condividere pass che offrono una prova di Pro di sette giorni, con Claude Code incluso, a chi non ha mai sottoscritto un piano a pagamento di Claude; chi li invia li trova con il comando /passes. I pass sono limitati e possono scadere: permettono di provare Claude Code, ma non di continuare a usarlo gratuitamente (articolo di Anthropic sui pass ospite, consultato il 2026-10-10). Il piano Free non include Claude Code.
Codex è il caso opposto: il piano Free di ChatGPT include Codex nell’app desktop, con alcuni limiti. Il confronto affiancato è disponibile in Codex è gratuito?.
I due modi per pagare
| Abbonamento | Chiave API | |
|---|---|---|
| Fatturazione | Mensile fisso (Claude Pro o Max) | Per token, senza canone mensile |
| Limiti | Limiti di utilizzo per finestra | Nessuno — paghi ciò che utilizzi |
| Mese tranquillo | Viene comunque addebitato | Nessun addebito |
| Mese intenso | Limitato, ma raggiungi i limiti | Aumenta con il lavoro |
| Ideale per | Utilizzo quotidiano e prevedibile | Utilizzo irregolare o a intermittenza |
Le due modalità non si sommano e conta quale è attiva: quando è impostata una variabile di credenziale come ANTHROPIC_AUTH_TOKEN o ANTHROPIC_API_KEY, Claude Code la usa invece di un accesso claude.ai salvato. L’abbonamento resta sospeso e inutilizzato, i suoi limiti smettono di applicarsi e l’utilizzo viene addebitato sulla chiave. Rimuovi la variabile e Claude Code torna all’abbonamento. Esegui /status per vedere quale modalità è attiva in questo momento.
Quanto costa un mese reale
Il costo segue i passaggi agentici, non i giorni del calendario. Claude Code reinvia il prompt di sistema, la conversazione e il nuovo contesto dei file a ogni passaggio, quindi un passaggio è più grande di un messaggio di chat: in genere circa 25.000 token di input e 1.200 di output. Alle tariffe Kunavo su claude-sonnet-5:
| Carico di lavoro | Kunavo | Al listino Anthropic |
|---|---|---|
| Un passaggio agentico | $0,043 | $0,062 |
| Un’attività di 20 passaggi | ~$0,87 | ~$1,24 |
| Una giornata intensa (5 attività) | ~$4,34 | ~$6,20 |
| 20 giornate di questo tipo | ~$87 | ~$124 |
Questi sono valori non ottimizzati: nessuna memorizzazione nella cache dei prompt, tutto sul modello principale. Un utilizzo leggero o esplorativo si aggira sulle unità di dollari al mese; la voce più costosa è il lavoro agentico quotidiano continuativo, cioè proprio il caso in cui la tariffa per token si accumula. Esegui i tuoi calcoli nel calcolatore dei costi oppure consulta prezzi di Claude Code per i livelli di abbonamento, la tabella completa delle tariffe per modello e il punto di pareggio tra le due modalità. La colonna “Al listino Anthropic” qui sopra proviene dai prezzi ufficiali delle API Anthropic, che riportano il prezzo corrente per token di ogni modello Claude accanto al costo dello stesso modello qui.
Il modo più economico per eseguirlo
Claude Code legge ANTHROPIC_BASE_URL nativamente, quindi funziona con qualsiasi endpoint che esponga l’Anthropic Messages API: nessun plugin, nessun binario modificato, nessun proxy da sorvegliare. È il percorso supportato per ottenere una tariffa per token più bassa:
export ANTHROPIC_BASE_URL=https://api.kunavo.com
export ANTHROPIC_AUTH_TOKEN=sk-kn-...
export ANTHROPIC_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5Gli stessi modelli, la stessa CLI, circa il 30% in meno rispetto al listino sul modello principale. Mantieni le righe dei modelli: il modello predefinito integrato di Claude Code e i suoi alias opus e sonnet seguono i modelli più recenti di Anthropic e, se Kunavo non ne serve ancora uno, la richiesta restituisce 404. L'alias sonnet richiede Sonnet 5.5, che Kunavo non serve, quindi /model sonnet, la fase di esecuzione di opusplan e i subagenti impostati su sonnet restituiscono 404 a meno che ANTHROPIC_DEFAULT_SONNET_MODEL non lo associ. L'associazione opus è Opus 5.5, che richiede Claude Code v2.1.280 o successivo — esegui claude update su un'installazione precedente. Pagamento a consumo con una ricarica da $10, nessun canone mensile e saldo senza scadenza: quindi un mese tranquillo non costa davvero nulla. La procedura completa è nella guida alla configurazione di Claude Code. Se hai già un piano e continui a raggiungere il limite della finestra, cosa succede quando raggiungi un limite Claude calcola il punto di pareggio tra mantenere il piano e aggiungere una chiave per le ore in cui ha smesso di fornire il servizio.
Quattro leve che modificano davvero il numero
- Mantieni la riga di Haiku. Senza
ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5, l'aliashaikudi Claude Code richiede un ID modello che Kunavo non offre (Haiku 5.5 dalla v2.1.293), quindi/model haikue i subagenti impostati suhaikurestituiscono 404. Con questa impostazione, le chiamate che Claude Code avvia autonomamente per generare riepiloghi e titoli vengono eseguite con il modello meno costoso ($0,70 / $3,50 per 1M) anziché con quello principale: il listino prezzi dell'API Anthropic Claude riporta le tariffe per modello, ufficiali e scontate, una accanto all'altra. - Avvia attività nuove. Il contesto viene reinviato a ogni passaggio, quindi una sessione lunga diventa costosa in modo quadratico. Una nuova attività riparte con un contesto ridotto.
- Lascia che funzioni la memorizzazione nella cache dei prompt. L’input memorizzato nella cache viene fatturato al 10% della tariffa di input. In un ciclo che reinvia un prefisso stabile a ogni passaggio, è il principale risparmio disponibile (come funziona).
- Imposta un limite per la chiave. Assegna all’editor una chiave propria con un limite di spesa nella dashboard. Un ciclo fuori controllo diventa un ciclo limitato invece di produrre una sorpresa.
Cose che spesso vengono fraintese
“Claude Code è open source, quindi è gratuito”
Il fatto che il client sia gratuito da installare non dice nulla sulle chiamate al modello. La CLI è la parte economica; l’inferenza è il costo.
“Il mio abbonamento Claude Pro copre l’API”
Non è così. Abbonamenti e chiavi API sono prodotti separati con fatturazione separata: claude.ai gestisce il primo, console.anthropic.com il secondo. Pro finanzia Claude Code solo tramite l’abbonamento, non tramite una chiave.
“Deve esserci un livello gratuito se uso un modello piccolo”
Più economico, non gratuito. claude-haiku-4-5 a $0,70 / $3,50 per 1M è una frazione di Sonnet, ma viene comunque fatturato.
“Un gateway significa che posso usarlo senza pagare Anthropic”
Paghi comunque l’inferenza, solo a una tariffa diversa e a un soggetto diverso. Cambiano il prezzo e il modello di fatturazione, non il fatto che abbia un costo.
Domande frequenti
Claude Code è gratuito?
La CLI di Claude Code è gratuita da installare, ma eseguirla non lo è — ogni azione che compie è una chiamata al modello che deve essere pagata. Paghi in uno dei due modi seguenti: un abbonamento claude.ai (Pro o Max), che include l'utilizzo di Claude Code entro i limiti del piano, oppure una chiave API fatturata per token senza canone mensile. Non esiste un livello gratuito che permetta a Claude Code di chiamare un modello senza costi.
Posso usare Claude Code senza un abbonamento?
Sì — con una chiave API. Claude Code accetta una chiave fatturata per token, adatta all'uso irregolare perché nei mesi in cui non programmi non paghi nulla. Impostare una chiave sospende inoltre qualsiasi abbonamento claude.ai: finché la variabile delle credenziali è impostata, i limiti del piano smettono di applicarsi e l'utilizzo viene fatturato alla chiave.
Quanto costa effettivamente Claude Code al mese?
Dipende dal numero di passaggi agentici eseguiti, non dai giorni di utilizzo. Un passaggio tipico contiene circa 25.000 token di input e 1.200 di output; un’attività di 20 passaggi costa all’incirca $0,87 con Claude Sonnet 5 alle tariffe Kunavo, contro circa $1,24 al prezzo di listino Anthropic. Un uso leggero costa pochi dollari al mese; un uso quotidiano intenso — cinque attività di questo tipo al giorno per 20 giorni — costa circa $87.
Esiste una prova gratuita di Claude Code?
Solo su invito. Gli abbonati Pro e Max idonei possono inviare pass ospite; il pass offre sette giorni di Pro, che include Claude Code, a chi non ha mai sottoscritto un piano a pagamento di Claude. Senza invito non c’è un modo gratuito per usarlo: installare la CLI è gratuito, ma per il primo prompt effettivo serve un piano a pagamento o una chiave API con saldo. Una piccola ricarica a consumo, senza costi mensili, è il modo per provarlo con il minimo impegno.
Qual è il modo più economico per eseguire Claude Code?
Indirizzalo a un endpoint meno costoso. Claude Code legge ANTHROPIC_BASE_URL in modo nativo, quindi un gateway non richiede software aggiuntivo; su Kunavo gli stessi modelli Claude costano circa 30% in meno rispetto ai prezzi di listino di Anthropic. Mantieni ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5 in questa configurazione: senza, l'alias haiku di Claude Code richiede un ID modello che Kunavo non offre, quindi /model haiku e i subagenti impostati su haiku restituiscono 404. La stessa riga sposta le chiamate automatiche in background di Claude Code dal modello principale a quello meno costoso.
Posso provare Claude Code senza impegnarmi in un abbonamento?
Sì — una chiave pay-as-you-go è l'opzione meno vincolante, poiché una piccola ricarica non comporta canone mensile né scadenza. Puoi anche installare la CLI ed esplorarne configurazione, skill e comandi prima di aggiungere fondi; solo il primo prompt reale richiede una credenziale.
Cosa mi conviene di più: abbonamento o API?
Regola generale: se raggiungeresti i limiti dell’abbonamento quasi ogni giorno, conviene la tariffa fissa. Se programmi a intermittenza — alcune settimane intensamente, altre per nulla — conviene pagare per token, perché le settimane tranquille non costano nulla. Stima il tuo punto di pareggio con il calcolatore dei costi.
L’uso di un gateway causa problemi?
Codifica, strumenti, subagenti, MCP e memorizzazione nella cache dei prompt funzionano normalmente. Remote Control e la dettatura vocale invece no: entrambi richiedono un’identità claude.ai e non sono disponibili quando è impostata una credenziale del gateway. L’elenco completo è nella guida alla configurazione.
Come configuro la chiave?
Consulta ottenere una chiave API per Claude Code — dove crearla, in quale variabile inserirla e perché quella sbagliata non produce errori visibili. Se non hai ancora installato la CLI, installare Claude Code contiene il comando per ogni sistema operativo.