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 | bashApra 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>
claudeConfigurazione manuale (Windows PowerShell)
$env:ANTHROPIC_BASE_URL="http://localhost:3001"
$env:ANTHROPIC_AUTH_TOKEN="<unified-key>"
claudeANTHROPIC_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.
| Modello | Gratis su | Contesto | Limiti gratuiti (offerta migliore) | Strumenti | Visione |
|---|---|---|---|---|---|
| GLM 5.3 | UnoRouter | 1M | 1 richieste/min 1 req/min per model | Sì | No |
| GLM 5.3 Flash | NVIDIA NIM, UnoRouter | 1M | 40 richieste/min 40 RPM | Sì | Sì |
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | Sì | Sì |
| Qwen3.8 Flash Next | AMD Radeon Cloud | 262K | Recurring daily account allowance | Sì | No |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | Sì | Sì |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 richieste/min 20 richieste/giorno 250,000 token/min ~3M | Sì | Sì |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | Sì | Sì |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 richieste/min 50 richieste/giorno 50 req/day account-wide (1,000 after a $10 purchase) | Sì | Sì |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 richieste/min 50 richieste/giorno Shared rate limit | Sì | No |
| Qwen3.8 27B | ElectronHub, Groq, OVH AI Endpoints | 262K | 30 richieste/min 250 richieste/giorno 70,000 token/min ~6M | Sì | Sì |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 richieste/min 20 richieste/giorno 250,000 token/min ~3M | Sì | Sì |
| Qwen 3.8 27B | Cloudflare Workers AI | 262K | Shared 10k neurons/day | Sì | 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
haikua un modello piccolo e veloce. Claude Code lo usa per i compiti brevi in background. - Mantenga il contesto piccolo. Usi
/cleartra un compito e l'altro per inviare meno token.
Risoluzione dei problemi
| Problema | Causa | Soluzione |
|---|---|---|
| Claude Code chiede di accedere | Le variabili d'ambiente non sono impostate in questa shell | Imposti ANTHROPIC_BASE_URL e ANTHROPIC_AUTH_TOKEN, poi avvii di nuovo claude |
| "Conflicting credential" (messaggio in inglese: credenziale in conflitto) oppure avvio non riuscito | ANTHROPIC_API_KEY è impostata | La rimuova con unset ANTHROPIC_API_KEY |
| Errore 429 su ogni richiesta | Tutte le Sue chiavi di provider sono al limite | Aggiunga chiavi di più provider nella pagina Keys |
| Le chiamate di strumenti falliscono oppure l'agente si ferma | Il modello non supporta bene le chiamate di strumenti | Associ la famiglia a un modello della tabella qui sopra |
| Le richieste sono lente | Prompt grandi su un modello gratuito lento | Fissi un modello veloce, per esempio un modello Groq o Cerebras |
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
- Esiste un'API Claude gratuita?
- Migliori API gratuite per modelli di codice
- Usare Codex CLI con modelli gratuiti
- Cline, Roo Code e Kilo Code con un'API gratuita
- Rate limit delle Free LLM API
Fonti
- FreeLLMAPI docs: Anthropic and Claude clients (verificato il 20 November 2026)
- FreeLLMAPI CLI generators (verificato il 20 November 2026)
- Claude Code documentation: LLM gateway configuration (verificato il 20 November 2026)