Come usare Claude Code gratis senza abbonamento

Cos'è Claude Code?

Claude Code è lo strumento di coding agentico di Anthropic per il terminale. Gira all’interno della tua directory di progetto, legge i file, li modifica, esegue comandi e gestisce task multi-step senza dover copiare nulla in una scheda del browser.

Il motivo per cui costa è strutturale, non commerciale. Ogni azione è una chiamata API e le sessioni agentiche sono per natura verbose: il modello rilegge il contesto, chiama strumenti, verifica i risultati e riprova. Un pomeriggio intenso in un repository grande può costare diversi dollari in token senza sembrare particolarmente produttivo.

Se vuoi una panoramica completa di cosa fa lo strumento nel quotidiano, il nostro tutorial su Claude Code copre setup, refactoring e debugging nella pratica.

Claude Code è gratis?

La risposta diretta è no. La documentazione di setup di Anthropic afferma che Claude Code richiede un account Pro, Max, Team, Enterprise o Console, e che il piano gratuito di Claude.ai non include l’accesso. Pro parte da 20 $ al mese, o 17 $ al mese se paghi 200 $ subito per l’anno.

L’alternativa è la fatturazione via console, dove paghi a token senza abbonamento. Claude Sonnet 5 di solito costa 3 $ per milione di token in input e 15 $ per milione di token in output. Claude Opus 5 sta a 5 $ e 25 $, e Haiku 4.5 a 1 $ e 5 $.

Queste due strade fatturano con logiche completamente diverse, e scegliere quella sbagliata è il modo in cui si finisce per pagare troppo o venire limitati a metà di un task. Ecco come si confrontano.

Il punto di svolta è la costanza d’uso, non il volume. Un abbonamento compra token a un tasso effettivo molto migliore dell’API finché non arrivi al tetto del piano, quindi chi usa ogni giorno quasi sempre risparmia con Pro. La fatturazione a consumo vince quando le tue settimane non si assomigliano per niente, perché in quelle tranquille non paghi nulla.

Quindi da dove arriva il "gratis"? Da tre posti, più o meno. 

• Credito iniziale che Anthropic assegna ai nuovi account API
• Il fatto che Claude Code parli volentieri con qualunque server che supporti il formato Anthropic Messages, inclusi quelli gratuiti, sia hosted (OpenRouter) che locali (Ollama)
• Un programma di grant per i maintainer open source

Questa seconda categoria merita un avvertimento subito. Puntare Claude Code a un modello gratuito ti dà l’interfaccia e il loop agentico, non Claude. Il divario di qualità sul ragionamento multi-step è reale, e ci tornerò.

Il piano gratuito include Claude Code?

Parto dal fraintendimento più comune, perché fa perdere un sacco di sere.

Il livello gratuito non include Claude Code. Né una versione limitata, né una versione di prova, niente. La documentazione ufficiale di Anthropic è inequivocabile: il piano gratuito copre Claude su web, iOS, Android e desktop; l’agente da terminale non è incluso.

Quello che ottieni è davvero valido. Dal 1° luglio 2026, il piano gratuito esegue Claude Sonnet 5 come modello predefinito, con ricerca sul web, upload di file, Projects e Artifacts, tutti elementi che prima erano dietro il paywall. Per incollare uno stack trace e chiedere cosa è andato storto, regge bene.

Limiti del free tier che gli sviluppatori incontrano per primi

Anthropic non pubblica un conteggio messaggi, e chi cita un numero preciso sta indovinando. L’azienda descrive Pro come almeno cinque volte l’uso per sessione del Free, il che rende Free un baseline, non una quota fissa. In pratica, le segnalazioni si concentrano tra 15 e 40 messaggi per finestra mobile di 5 ore, con messaggi più lunghi e allegati che la consumano più in fretta.

Alcuni limiti contano più del numero di messaggi:

• La finestra di cinque ore inizia a scorrere quando invii il primo messaggio.
• Nessun accesso CLI a Claude Code. Questo è il limite duro, e nessun workaround lo cambia.
• I limiti si adattano al carico del server, quindi le ore di punta sono peggiori.
• Le conversazioni lunghe costano di più per messaggio perché a ogni turno viene riletto l’intero thread.

Dove si finisce: il tier chat gratuito va bene per domande spot e code review, e crolla nel momento in cui vuoi uno scambio sostenuto su una codebase. Che è esattamente ciò per cui esiste Claude Code.

Opzione 1: Crediti gratuiti API di Anthropic

Questa è la via ufficiale meno conosciuta e, secondo me, quella da cui la maggior parte dovrebbe partire.

Creare un account su platform.claude.com concede un credito iniziale una tantum. La documentazione prezzi di Anthropic lo descrive come solo "una piccola quantità di crediti gratuiti" senza specificare una cifra, anche se fonti terze lo indicano costantemente attorno ai 5 $.

I crediti API autenticano la CLI di Claude Code. Ottieni il vero agente, che esegue veri modelli Claude, sul tuo vero codice. I crediti non si rinnovano e scadono dopo 14 giorni, quindi trattalo come una prova e non come una scorta.

Configurare un account API e riscattare i crediti

Tutto il percorso va da una registrazione a freddo a un agente funzionante in circa 10 minuti, e la maggior parte del tempo si passa ad aspettare l’installer. L’ho diviso in cinque passaggi perché il terzo contiene una trappola che spesso costringe a ripartire.

Passaggio 1: Crea il tuo account Console

Vai su platform.claude.com e registrati con il tuo indirizzo email. La console è un prodotto separato dall’interfaccia chat di claude.ai, quindi un account Claude esistente non viene trasferito e potresti dover registrarti di nuovo con lo stesso indirizzo.

Per chiarezza, ad alcuni account viene chiesto di verificare il numero di telefono in questa fase. Una volta dentro, il credito iniziale viene applicato automaticamente invece di essere riscattato da un campo promo.

Passaggio 2: Controlla il saldo crediti

Apri la sezione Billing dalla navigazione della console. Il saldo iniziale appare lì, insieme all’opzione di aggiungere un metodo di pagamento, che per ora non ti serve.

Controlla questo prima di fare altro. Se il saldo è zero, nessuna configurazione corretta più avanti produrrà una sessione funzionante.

Passaggio 3: Crea una chiave API

Vai su Settings > API Keys e crea una nuova chiave. Dalle un nome che riconoscerai tra tre mesi, perché la maggior parte finisce per averne diverse.

Il valore completo della chiave è mostrato una sola volta. Copialo nel tuo password manager appena compare, perché chiudere la finestra senza copiare significa perdere la chiave e dover ripetere il passaggio.

Passaggio 4: Esporta la chiave e installa Claude Code

Esporta la chiave come variabile d’ambiente nella tua shell, poi installa la CLI. Anthropic consiglia l’installer nativo, che include il suo runtime e non richiede affatto Node.js.

export ANTHROPIC_API_KEY="sk-ant-your-key-here"
curl -fsSL https://claude.ai/install.sh | bash

In Windows PowerShell, l’installer è irm https://claude.ai/install.ps1 | iex. Se preferisci npm, nota che a partire da Claude Code v2.1.198, il pacchetto richiede Node.js 22 o successivo, un cambiamento rispetto al requisito minimo Node.js 18 che guide più vecchie ancora citano:

npm install -g @anthropic-ai/claude-code

Aggiungi la riga export al tuo ~/.zshrc o ~/.bashrc se vuoi che la chiave sopravviva a una nuova finestra del terminale. Poi conferma che l’installazione è andata a buon fine:

claude --version

Passaggio 5: Avvia la tua prima sessione

Spostati in una directory di progetto e avvia l’agente. Eseguire claude dalla home tecnicamente funziona, ma lo strumento è quasi inutile senza una codebase da leggere.

cd ~/projects/my-app
claude

Al primo avvio con ANTHROPIC_API_KEY impostata, Claude Code ti chiede una volta di approvare la chiave invece di aprire il browser per l’OAuth. Approva e atterrerai sulla schermata di benvenuto con la tua working directory confermata in basso:

Per confermare la rotta di fatturazione e non solo l’installazione, esegui /status dentro la sessione. La riga API key che nomina ANTHROPIC_API_KEY è ciò che ti dice che la sessione sta attingendo ai crediti Console invece che a un login salvato di claude.ai.

Se qualcosa non torna a questo punto, claude doctor stampa diagnostiche di installazione e impostazioni senza avviare una sessione, ed è una mossa più rapida che cercare stringhe di errore.

Quanto durano i crediti gratuiti?

Conti spannometrici, usando Sonnet 5 alle attuali tariffe introduttive. Immagina quindici scambi su un repository reale, ognuno che invia circa 30.000 token di contesto e produce circa 1.500 token di output. Il primo turno paga il prezzo pieno dell’input e i quattordici successivi colpiscono per lo più la prompt cache al 10% di quel prezzo.

Prendi questo come ordine di grandezza, non come preventivo. Il modello sopra assume un contesto piatto e ignora il premium di scrittura in cache, che è 1,25 volte il prezzo base dell’input per una cache di cinque minuti, quindi le tue sessioni reali cadranno da una parte o dall’altra.

Il divario tra le ultime due righe è la parte da interiorizzare. La cache toglie circa tre quarti dal conto, ed è il motivo per cui le sessioni di Claude Code costano molto meno di quanto suggerisca un conteggio naïf dei token, e perché tutto ciò che rompe la cache (saltare tra repository, riavviare continuamente le sessioni, cambiare modello a metà) triplica silenziosamente ciò che paghi. La documentazione prezzi di Anthropic ha la tabella completa dei moltiplicatori se vuoi modellarlo per bene.

Differenze tra tariffe dei modelli

La scelta del modello muove il numero più di qualunque altra cosa tu controlli. Eseguendo la stessa sessione da quindici scambi lungo la linea:

Quindi un saldo da cinque dollari ti compra tra cinque e ventisette sessioni, a seconda esclusiva di quale modello scegli. Sonnet 5 è il default sensato per valutare.

Spendi quel saldo su un task vero, non su esempi giocattolo. Rifattorizza un modulo che possiedi davvero o insegue un bug attraverso tre file, perché è l’unico modo per capire se lo strumento merita un posto nella tua settimana.

Quando il saldo va a zero, non c’è un paracadute. La fatturazione via Console è pay-as-you-go e non c’è alcun tier gratuito sotto Claude Code.

Opzione 2: Modelli gratuiti OpenRouter

OpenRouter è un gateway API davanti a qualche centinaio di modelli, e un numero rotante di questi non costa nulla da chiamare. Niente carta di credito, niente canone mensile, niente abbonamento.

Il motivo per cui questo si collega a Claude Code è che la CLI legge il suo endpoint da una variabile d’ambiente. Cambi la variabile, cambi dove vanno le richieste. OpenRouter esegue quella che chiama una "Anthropic Skin", un endpoint che accetta il formato Anthropic Messages e lascia passare intatti i blocchi di thinking e l’uso nativo degli strumenti, quindi non serve un proxy locale.

Sii chiaro su cosa ottieni, perché questi non sono modelli Claude. Tieni l’interfaccia di Claude Code, il loop agentico, l’editing dei file e gli slash command, mentre un Qwen o un Llama fa il ragionamento.

La documentazione di OpenRouter avverte che Claude Code è garantito solo con il provider first-party di Anthropic e "potrebbe non funzionare correttamente con altri provider". Preferisco citarlo piuttosto che far finta di niente.

Come funziona il redirect

Tre variabili fanno il lavoro:

• ANTHROPIC_BASE_URL punta a https://openrouter.ai/api invece che all’endpoint di Anthropic.

• ANTHROPIC_AUTH_TOKEN contiene la tua chiave OpenRouter ed è inviata come header Authorization: Bearer.

• ANTHROPIC_API_KEY deve essere impostata a stringa vuota esplicita; altrimenti, Claude Code potrebbe ripiegare sull’autenticazione contro Anthropic.

Puoi impostarle nel profilo della shell o in un file di impostazioni di Claude Code. Una cosa da evitare: un file .env di progetto non funzionerà, perché l’installer nativo non legge i file .env standard.

json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://openrouter.ai/api",
    "ANTHROPIC_AUTH_TOKEN": "sk-or-v1-your-openrouter-key",
    "ANTHROPIC_API_KEY": ""
  }
}

Dove metti quel file conta più di quanto sembri. Usa ~/.claude/settings.json per una configurazione globale, o .claude/settings.local.json per un singolo progetto, dato che Claude Code aggiunge quest’ultimo al tuo gitignore. 

Non inserire credenziali in .claude/settings.json di un progetto, perché quel file viene commitato e condiviso con chiunque cloni il repository.

Configurare Claude Code con OpenRouter

1. Installa Claude Code con l’installer nativo se non l’hai già fatto.

2. Crea un account gratuito su openrouter.ai e genera una chiave in Settings > Keys. Nessuna carta è richiesta per un account che chiama solo modelli gratuiti.

3. Scrivi la configurazione in ~/.claude/settings.json usando il blocco sopra, oppure esporta le stesse tre variabili nel profilo della shell.

4. Se hai mai effettuato l’accesso a Claude Code con un account Anthropic, esegui /logout nella CLI, poi chiudi e riapri. Una sessione in cache scavalca le variabili e si manifesta come errori confusi di modello non trovato.

5. Avvia claude e verifica dove stanno andando le richieste.

> /status
Auth token: ANTHROPIC_AUTH_TOKEN
Anthropic base URL: https://openrouter.ai/api

Le tue richieste dovrebbero comparire anche nella dashboard attività di OpenRouter entro pochi secondi, il modo più rapido per confermare che il redirect è attivo.

Scegliere un modello gratuito su OpenRouter

Gli ID dei modelli gratuiti terminano con :free, e la rosa cambia di continuo man mano che i provider aggiungono, rimuovono o riprezzano modelli. La collezione dei modelli gratuiti di OpenRouter mostra quali sono disponibili senza costi. openrouter/free è l’auto-router di OpenRouter per i modelli gratuiti. Sceglie ciò che è disponibile e adatto alla tua richiesta, mantenendo il setup funzionante quando singoli modelli escono di rotazione. Punto di partenza più semplice, ma la qualità varia molto.

Prezzi, ammontare dei crediti e rosa dei modelli gratuiti su OpenRouter cambiano con cadenza mensile, e alcuni sono cambiati mentre scrivevo. Controlla la pagina prezzi di Anthropic e il filtro “free” di OpenRouter prima di impegnarti su qualunque numero qui.

Poi ci sono i rate limit, che mordono più della scelta del modello. I modelli gratuiti consentono 20 richieste al minuto a prescindere dall’account e 50 richieste al giorno se non hai mai acquistato crediti. Acquista 10 $ di crediti una volta, mai più, e la quota giornaliera sale a 1.000 e resta lì anche dopo che il saldo torna a zero.

Cinquanta richieste al giorno sembrano gestibili finché non ricordi che una sessione agentica spende richieste come un collega loquace spende il tuo pomeriggio. Un task ragionevolmente coinvolto può consumare un terzo della quota giornaliera. Anche i tentativi falliti contano, quindi i retry alla cieca peggiorano la situazione.

Per indirizzare ruoli di modello specifici, Claude Code espone variabili separate per ciascun tier:

bash
export ANTHROPIC_DEFAULT_SONNET_MODEL="cohere/north-mini-code:free"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="cohere/north-mini-code:free"
export CLAUDE_CODE_SUBAGENT_MODEL="cohere/north-mini-code:free"

Refactor semplici, modifiche a singolo file e richieste di spiegazione reggono bene. Detto questo, il lavoro lungo multi-step degrada in modo evidente, e la failure mode è di solito nelle chiamate agli strumenti più che nella qualità del codice: il modello sceglie lo strumento sbagliato, interpreta male un risultato o va in loop.

Se vuoi un approccio più mirato al mix di modelli per task, la nostra guida al Claude Code Router copre in dettaglio il routing multi-modello.

Opzione 3: Modelli locali con Ollama

Ollama esegue modelli open sulla tua macchina. Niente chiavi API, niente rate limit e nessuna connessione internet necessaria una volta scaricati i pesi.

A gennaio 2026, Ollama ha aggiunto la compatibilità con l’API Anthropic Messages nella v0.14.0, rendendo pratico questo workflow. Prima serviva un proxy di traduzione in mezzo. Ora Claude Code parla direttamente con localhost.

Il costo non sparisce; si sposta sull’hardware — in particolare sulla banda della memoria, non solo sulla capacità. 

• Su Apple Silicon, il numero da guardare è la memoria unificata: 16 GB eseguono un modello ~14B come gpt-oss:20b, ma i modelli di coding classe 30B degni d’uso vogliono 32 GB o più quando aggiungi una finestra di contesto da 32K. 

• Su una macchina Windows o Linux, il valore rilevante è la VRAM della GPU, non la RAM di sistema — un modello che entra in RAM ma gira su CPU è troppo lento per il lavoro agentico, dove ogni task spara decine di chiamate.

Configurare Ollama con Claude Code

1. Installa Ollama. Su macOS e Linux, è curl -fsSL https://ollama.com/install.sh | sh, e su Windows scarichi l’installer da ollama.com ed esegui.

2. Scarica un modello per il coding. Sebbene non possa competere con i modelli Claude attuali, Qwen3-Coder è una scelta decente: ollama pull qwen3-coder.

3. Conferma che il modello è presente con ollama list.

4. Aumenta la lunghezza del contesto, perché è l’impostazione che si dimentica e poi si dà la colpa al modello. Ollama suggerisce almeno 32K token per Claude Code.

5. Punta Claude Code all’endpoint locale e scegli il modello.

bash
export OLLAMA_CONTEXT_LENGTH=32768
export ANTHROPIC_AUTH_TOKEN=ollama
export ANTHROPIC_BASE_URL=http://localhost:11434

claude --model qwen3-coder

Il token di auth è richiesto dal protocollo e ignorato da Ollama, quindi il suo valore non importa. Se preferisci rendere la configurazione permanente, le stesse tre chiavi vanno nel blocco env di ~/.claude/settings.json.

Due lacune vale la pena conoscerle prima di giudicare i risultati:

• La prompt cache di Anthropic non si applica, quindi ogni richiesta rielabora da zero il system prompt e l’intera cronologia della conversazione, il che qui è lento più che costoso.

• Il layer di compatibilità di Ollama ignora anche tool_choice, il campo che Claude Code usa occasionalmente per forzare una specifica tool call; quando serve, l’agente può scegliere lo strumento sbagliato e bloccarsi in loop.

Per una guida più approfondita su questo setup, abbiamo un tutorial dedicato su usare Claude Code con modelli locali Ollama, oltre a guide separate per eseguire in locale Qwen 3 e DeepSeek R1.

Reality check dell’hardware

Per la maggior parte degli sviluppatori, OpenRouter batte Ollama a meno che tu non abbia 32 GB o più di memoria unificata/VRAM, ti serva l’offline o tu voglia che il codice non lasci mai la macchina. Quest’ultima ragione è valida, ed è il motivo per cui non liquiderei questa via solo per le prestazioni.

Opzione 4: Il programma Claude for Open Source

Molte guide su questo tema si fermano a tre opzioni e si perdono quella che ti dà il prodotto vero, al tier più alto, per mezzo anno.

Anthropic ha lanciato Claude for Open Source a febbraio 2026 e lo ha ampliato a luglio. I maintainer e i contributor idonei ricevono sei mesi di Claude Max 20x, il piano da 200 $ al mese, gratuitamente. Include Claude Code, con ampio margine d’uso al top tier consumer.

I requisiti pubblicati sono più ampi di quanto si pensi:

• Maintainer di pacchetti con 500 o più repository dipendenti, 100 o più pacchetti dipendenti, o 200.000 o più download mensili combinati su npm, PyPI, crates.io, RubyGems o registri simili.
• Committer elencati su progetti di fondazioni o linguaggi riconosciuti come CPython, il team Rust, la TSC di Node.js, un PMC Apache, CNCF, Kubernetes, il kernel Linux, Django o Rails.
• Chiunque abbia scritto 100 o più pull request mergeate in repository non propri negli ultimi dodici mesi.
• Community builder il cui repository abbia attirato 20 o più contributor esterni unici con PR mergeate nell’ultimo anno.
• Maintainer di qualsiasi cosa con punteggio di criticality OpenSSF pari o superiore a 0,4.

La pagina di Anthropic invita esplicitamente anche i casi borderline a candidarsi e spiegare cosa regge silenziosamente l’ecosistema. Il programma è limitato a 10.000 destinatari ed è valutato in modo continuativo; si fa domanda tramite claude.com/contact-sales/claude-for-oss.

Una nota: questo copre l’abbonamento, non i crediti API. L’uso della tua ANTHROPIC_API_KEY è comunque fatturato separatamente, quindi è un piano personale, non qualcosa da puntare a una pipeline CI.

Scegliere l’opzione gratuita giusta per te

Due domande risolvono la questione. Per cosa vuoi Claude Code e quanto setup sei disposto a fare prima di annoiarti?

Tabella di confronto

Quale scegliere?

• Se non hai mai usato Claude Code e vuoi capire se vale 20 $ al mese, prendi i crediti API iniziali. È l’unica via che ti mostra il prodotto reale, e una dozzina di sessioni bastano per farti un’idea.
• Se vuoi accesso gratuito continuativo e non ti serve specificamente Claude, OpenRouter offre il miglior rapporto qualità/sforzo. Metti in conto una serata per il primo setup e aspettati di colpire il tetto giornaliero prima di quanto vorresti.
• Se ti serve l’offline, o il tuo datore ha opinioni su dove viaggia il codice sorgente, Ollama è la risposta, nonostante il conto hardware. Sotto i 16 GB di memoria unificata/VRAM, non ci proverei.
• Se mantieni qualcosa su cui altri costruiscono, controlla il grant open source prima di fare altro. Sei mesi al top tier fanno sparire la domanda.

Risoluzione problemi dei setup con redirect

Le opzioni 3 e 4 condividono una superficie di failure e gli stessi pochi problemi coprono gran parte dei casi. Dato che né Anthropic né i provider gateway possono fare debug della tua combinazione specifica, ecco cosa controllare per primo.

• Claude Code continua a chiedere il login. La CLI non ha credenziali proprie e un base URL raggiungibile non conta come tale. Un blocco env in .claude/settings.json del progetto si applica solo dopo il wizard di primo avvio, quindi imposta ANTHROPIC_AUTH_TOKEN in un punto letto prima: un export nella shell o ~/.claude/settings.json.

• Un avviso all’avvio nomina due fonti di credenziali. Una credenziale di gateway e un login salvato sono entrambi attivi. Esegui /logout per pulire il login salvato o rimuovi la variabile per tornare al login precedente.

• Errori 400 che citano campi non riconosciuti. Claude Code invia campi a endpoint in formato Anthropic che alcuni upstream rifiutano. Impostare CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 sopprime la maggior parte dei campi pre-release e chiarisce.

• Errori 400 che citano thinking o adaptive. Il modello upstream non accetta adaptive reasoning, che Claude Code richiede per i modelli Claude recenti. Di solito serve aggiornare l’upstream del gateway più che una fix lato client.

• Controllo remoto e dettatura vocale smettono di funzionare. Entrambi si basano su un’identità claude.ai e non sono disponibili mentre è impostata una credenziale di gateway. Dalla v2.1.196, il controllo remoto è disabilitato anche quando ANTHROPIC_BASE_URL punta a un host non Anthropic.

Quando qualcosa si comporta male e non sei sicuro quale layer lo causi, /status dentro la sessione ti dice quale base URL e quale fonte di credenziali sono effettivamente in uso. Quel singolo comando risolve più casi di qualunque quantità di re-export.

Considerazioni finali

Quattro strade per usare Claude Code gratis, nessuna perfetta, e i trade-off sono la parte interessante, non un ripensamento.

La mia raccomandazione è mirata. Se quello che vuoi è l’agente CLI di Claude Code e non una finestra di chat, inizia con i crediti API: impari di più da una sessione reale sul prodotto vero che da una serata a configurare un sostituto. Se si guadagna un posto nel tuo workflow, 20 $ al mese sono una voce difendibile. Se non lo fa, non hai perso nulla e ora sai perché.

Per il lungo periodo, OpenRouter è l’opzione gratuita più sostenibile e Ollama vince nel momento in cui privacy o accesso offline diventano non negoziabili piuttosto che nice-to-have.

Per le abitudini che separano una sessione utile da una frustrante, la nostra Claude Code Best Practices copre pianificazione, trasferimento del contesto e sviluppo guidato dai test su progetti reali. E se parti da zero, Claude Code 101 insegna le basi con lezioni interattive e strutturate che ti portano dalla prima installazione a un workflow funzionante.