Home / Guide / Come usare Claude Code gratis

Come usare Claude Code gratis

Claude Code è un agente di programmazione di Anthropic. Ha bisogno di un'API Anthropic Messages. Questa guida mostra come collegare Claude Code a modelli gratuiti tramite FreeLLMAPI. Imposta due variabili d'ambiente. Non Le serve una chiave Anthropic.

Codice, nomi dei modelli ed etichette del catalogo in tempo reale sono mostrati in inglese.

Che cosa ottiene e che cosa non ottiene

Claude Code invia ogni richiesta a un'API nel formato di Anthropic. FreeLLMAPI parla quel formato su /v1/messages. Traduce ogni richiesta e la invia a un modello gratuito, per esempio Gemini, GPT-OSS, Qwen o GLM.

  • Ottiene: l'interfaccia di Claude Code, i suoi strumenti, le modifiche ai file e il ciclo dell'agente, su modelli gratuiti.
  • Non ottiene: i modelli Claude di Anthropic. Nessun provider offre gratis i modelli Claude tramite API. Legga C'è un'API Claude gratuita? per i dettagli.
  • Costo: 0 $ per l'inferenza. I livelli gratuiti hanno limiti di frequenza. FreeLLMAPI passa al provider successivo quando un limite blocca una richiesta.

Passo 1: installi FreeLLMAPI

FreeLLMAPI è open source. Funziona sul Suo computer in Docker. Le chiavi dei provider restano sul Suo computer.

macOS o Linux

curl -fsSL https://freellmapi.co/install.sh | bash

Apra la dashboard all'indirizzo http://localhost:3001. Aggiunga almeno due chiavi gratuite di provider nella pagina Keys. Google AI Studio e Groq danno ciascuno una chiave gratuita in circa un minuto. Copi la Sua chiave unificata dalla stessa pagina.

Passo 2: colleghi Claude Code

Il metodo più rapido è il comando di configurazione. Legge il catalogo in tempo reale, crea una copia di backup di ~/.claude/settings.json e aggiunge le impostazioni del gateway.

Un solo comando

npx freellmapi setup-claude --url http://localhost:3001 --api-key <unified-key>

Per configurarlo a mano, imposti due variabili d'ambiente e avvii Claude Code:

Configurazione manuale (macOS o Linux)

export ANTHROPIC_BASE_URL=http://localhost:3001
export ANTHROPIC_AUTH_TOKEN=<unified-key>
claude

Configurazione manuale (Windows PowerShell)

$env:ANTHROPIC_BASE_URL="http://localhost:3001"
$env:ANTHROPIC_AUTH_TOKEN="<unified-key>"
claude
Importante: usi ANTHROPIC_AUTH_TOKEN. Non usi ANTHROPIC_API_KEY. Se ANTHROPIC_API_KEY è impostata, Claude Code vede una credenziale in conflitto e non si avvia.

Per verificare che le richieste vadano al gateway, esegua npx freellmapi doctor. Ogni risposta ha anche un'intestazione X-Routed-Via. Questa intestazione mostra il provider e il modello che hanno risposto.

Passo 3: scelga i modelli per il lavoro con l'agente

Claude Code invia prompt lunghi. Una richiesta tipica ha un prompt di sistema grande, le definizioni degli strumenti e il contenuto dei file. Usi modelli con chiamate di strumenti e una grande finestra di contesto. I piccoli livelli gratuiti con pochi token al minuto falliscono su queste richieste.

Nella scheda Keys, Anthropic, associ ogni famiglia Claude (opus, sonnet, haiku) a auto oppure a un modello. Con auto, il router sceglie un modello gratuito per ogni richiesta. La tabella mostra i modelli gratuiti con chiamate di strumenti e almeno 128K di contesto, dal catalogo di oggi.

Modelli gratuiti per Claude Code: chiamate di strumenti e contesto 128K+
ModelloGratis suContestoLimiti gratuiti (offerta migliore)StrumentiVisione
GLM 5.3UnoRouter1M1 richieste/min
1 req/min per model
SìNo
GLM 5.3 FlashNVIDIA NIM, UnoRouter1M40 richieste/min
40 RPM
SìSì
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaSìSì
Qwen3.8 Flash NextAMD Radeon Cloud262KRecurring daily account allowanceSìNo
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring creditSìSì
Gemini 3.7 FlashGoogle AI Studio1M10 richieste/min
20 richieste/giorno
250,000 token/min
~3M
SìSì
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring creditSìSì
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 richieste/min
50 richieste/giorno
50 req/day account-wide (1,000 after a $10 purchase)
SìSì
DeepSeek V4 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 richieste/min
50 richieste/giorno
Shared rate limit
SìNo
Qwen3.8 27BElectronHub, Groq, OVH AI Endpoints262K30 richieste/min
250 richieste/giorno
70,000 token/min
~6M
SìSì
Gemini 3.6 FlashGoogle AI Studio1M10 richieste/min
20 richieste/giorno
250,000 token/min
~3M
SìSì
Qwen 3.8 27BCloudflare Workers AI262KShared 10k neurons/daySìSì

Mostrati 12 di 109 modelli gratuiti corrispondenti. Vedi tutti i modelli.

Dati in tempo reale dal catalogo FreeLLMAPI (versione 2026.11.19, verificato il 2026-11-19). I limiti gratuiti cambiano spesso. Il catalogo viene verificato ogni giorno.

Limiti di frequenza e come aiuta il failover

Un solo compito di Claude Code può inviare da 20 a 100 richieste. Un solo livello gratuito La ferma in fretta. Per esempio, una chiave gratuita di Gemini Flash consente poche richieste al giorno. FreeLLMAPI tiene il conto della quota di ogni chiave. Quando un provider invia un errore 429, il router prova il provider successivo del pool. La Sua sessione di Claude Code continua.

  • Aggiunga chiavi di quattro o più provider. Più chiavi danno più richieste al giorno.
  • Associ haiku a un modello piccolo e veloce. Claude Code lo usa per i compiti brevi in background.
  • Mantenga il contesto piccolo. Usi /clear tra un compito e l'altro per inviare meno token.

Risoluzione dei problemi

ProblemaCausaSoluzione
Claude Code chiede di accedereLe variabili d'ambiente non sono impostate in questa shellImposti ANTHROPIC_BASE_URL e ANTHROPIC_AUTH_TOKEN, poi avvii di nuovo claude
"Conflicting credential" (messaggio in inglese: credenziale in conflitto) oppure avvio non riuscitoANTHROPIC_API_KEY è impostataLa rimuova con unset ANTHROPIC_API_KEY
Errore 429 su ogni richiestaTutte le Sue chiavi di provider sono al limiteAggiunga chiavi di più provider nella pagina Keys
Le chiamate di strumenti falliscono oppure l'agente si fermaIl modello non supporta bene le chiamate di strumentiAssoci la famiglia a un modello della tabella qui sopra
Le richieste sono lentePrompt grandi su un modello gratuito lentoFissi un modello veloce, per esempio un modello Groq o Cerebras
Usa ognuno di questi modelli con una sola chiave. FreeLLMAPI è un router open source self-hosted che mette tutti questi piani gratuiti dietro un unico endpoint compatibile con OpenAI e passa al successivo quando uno raggiunge il limite di frequenza. Sfoglia il catalogo oppure inizia.

Domande frequenti

Claude Code è gratuito da usare?

Il programma Claude Code è gratuito da installare. Per funzionare ha bisogno di un'API di modello. Con FreeLLMAPI usa livelli gratuiti dei provider, quindi l'inferenza costa 0 $.

Ottengo gratis i veri modelli Claude?

No. Anthropic non offre un'API Claude gratuita. Claude Code funziona su altri modelli gratuiti, per esempio Gemini, GPT-OSS, Qwen o GLM, tramite l'endpoint nel formato Anthropic.

Perché usare ANTHROPIC_AUTH_TOKEN e non ANTHROPIC_API_KEY?

Claude Code invia ANTHROPIC_AUTH_TOKEN come token Bearer al Suo gateway. Se ANTHROPIC_API_KEY è impostata, Claude Code la tratta come una credenziale di prima parte e rifiuta di avviarsi.

Qual è il modello gratuito migliore per Claude Code?

Usi un modello con chiamate di strumenti e una finestra di contesto di 128K token o più. La tabella di questa pagina mostra i modelli gratuiti più forti che oggi rispettano entrambe le regole.

Funziona su Windows?

Sì. Imposti le due variabili in PowerShell con $env:ANTHROPIC_BASE_URL e $env:ANTHROPIC_AUTH_TOKEN, poi avvii claude.

Guide correlate

Fonti

Tutte le guide · Sfoglia tutti i modelli gratuiti