Claude Code con
i modelli gratis

Si chiama FreeLLMAPI e ha la licenza MIT. Ogni laboratorio di AI regala un piano gratuito: qualche milione di token al mese, qualche migliaio di richieste al giorno. Da solo ognuno serve a poco. Sommati fanno circa 7,4 miliardi di token al mese: 34 fornitori, 474 famiglie di modelli su 635 punti d'accesso gratuiti.

FreeLLMAPI gira sul tuo computer e mette tutto dietro un indirizzo solo. A ogni richiesta sceglie il modello migliore che ha ancora quota. Quando un fornitore ti blocca per i limiti passa da solo al successivo. Le chiavi restano sul tuo computer, cifrate.

Il router è gratis. Esiste un abbonamento da 19 dollari l'anno che ti porta i modelli nuovi il giorno stesso: senza, arrivano 30 giorni dopo. Per iniziare non ti serve.

1. Le chiavi le prendi tu. FreeLLMAPI non ti regala niente di suo. Per ogni fornitore apri un account gratuito, crei la chiave e la incolli nel pannello. Più fornitori colleghi, più quota hai.
2. Sotto non lavora Claude. Claude Code resta lo stesso programma, con gli stessi comandi. Le risposte però arrivano da modelli gratuiti di altri: GLM, Kimi, Qwen, Gemini Flash e simili. I migliori hanno le quote giornaliere più basse, quindi verso sera il livello scende. Le quote si azzerano a mezzanotte UTC.
3. Solo progetti tuoi. Il README lo dice chiaro: è per esperimenti personali e per imparare. Molti piani gratuiti usano quello che mandi per addestrare i modelli. Google lo scrive nei termini della quota gratuita di Gemini. Aggiunge anche che le richieste possono essere lette da persone. Mai dati o codice di clienti.
4. Il biglietto va acceso. Quando cambia modello a metà conversazione, FreeLLMAPI può lasciare al nuovo un riassunto di quello che stavate facendo. Di base è spento: lo accendi al passo 05.

Due strade. Se vuoi il biglietto del passo 05, prendi la prima.

Con Docker, su Mac, Linux e Windows con WSL. Ti serve Docker installato e acceso. Il comando crea la cartella ~/freellmapi, genera la chiave di cifratura e avvia tutto.

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

Poi apri http://localhost:3001 nel browser e crei l'account del pannello, con email e password. Resta tutto sul tuo computer.

Con l'app, su Mac e Windows. Scarichi l'installer dalla pagina delle versioni su GitHub: per Mac scegli arm64 se hai un processore Apple, x64 se hai un Intel. L'app vive nella barra in alto, non chiede password e gira su http://127.0.0.1:31415.

Parti da quattro fornitori che hanno un piano gratuito e una chiave in due clic:

1. Google, da Google AI Studio.
2. Groq, dalla console di Groq.
3. OpenRouter, dalle impostazioni di OpenRouter.
4. Cerebras, dal cloud di Cerebras.

Nel pannello vai alla pagina delle chiavi (Keys) e incolli ognuna sul suo fornitore. Nella catena di riserva (Fallback Chain) decidi l'ordine in cui provarli. In cima alla pagina delle chiavi trovi la tua chiave unica, quella che inizia con freellmapi-. Con l'app la copi anche dal menu nella barra, alla voce Copy Key.

Lascia fuori Cohere: la revisione dei termini fatta dagli autori stessi lo sconsiglia, perché i suoi termini vietano l'uso personale.

Apri un terminale nuovo e lancia queste tre righe con la tua chiave unica. Con l'app al posto di http://localhost:3001 scrivi http://127.0.0.1:31415.

export ANTHROPIC_BASE_URL=http://localhost:3001
export ANTHROPIC_AUTH_TOKEN=freellmapi-la-tua-chiave
claude

$env:ANTHROPIC_BASE_URL="http://localhost:3001"
$env:ANTHROPIC_AUTH_TOKEN="freellmapi-la-tua-chiave"
claude

1. Usa ANTHROPIC_AUTH_TOKEN. Se nel terminale c'è anche ANTHROPIC_API_KEY, Claude Code la prende per una chiave Anthropic in conflitto e non parte.
2. L'indirizzo è senza /v1. Claude Code aggiunge da solo il resto del percorso.
3. Vale solo per quel terminale. Chiudi la finestra e Claude Code torna sul tuo account normale. Così il tuo abbonamento Claude resta separato.
4. Opus, Sonnet e Haiku diventano modelli gratuiti. Quando Claude Code chiede uno di quei nomi, FreeLLMAPI sceglie un modello gratuito. Se vuoi fissarne uno lo fai nella pagina delle chiavi, sezione Anthropic.

Vuoi che sia sempre così, senza variabili? Questo comando ti mostra cosa cambierebbe nella configurazione di Claude Code:

npx freellmapi setup-claude --url http://localhost:3001 --dry-run

Rilanciato senza --dry-run fa il backup e scrive. Da lì tutte le sessioni passano da FreeLLMAPI.

Una conversazione resta sullo stesso modello per 30 minuti. Se nel frattempo quel modello finisce la quota, FreeLLMAPI passa al successivo. Il nuovo modello però non sa di stare continuando il lavoro di un altro.

Il biglietto risolve questo. Al cambio aggiunge un messaggio breve al nuovo modello: stai prendendo il posto di un altro, non ricominciare da capo, non rifare le domande già fatte. Sotto mette il riassunto degli ultimi scambi. Si accende con una riga nel file di configurazione dell'installazione con Docker:

cd ~/freellmapi
echo "FREELLMAPI_CONTEXT_HANDOFF=on_model_switch" >> .env
docker compose up -d --force-recreate

I messaggi per il riassunto restano in memoria per tre ore e non vengono scritti da nessuna parte. Il biglietto passa solo quello che è passato da FreeLLMAPI: quello che il modello vecchio teneva per sé si perde.

Comincia da un lavoro facile da controllare, su un progetto tuo. Se il risultato ti torna, alzi il livello.

Leggi questo progetto e scrivi un README.md che spieghi cosa fa, come si installa e come si lancia.
Non toccare nessun altro file.

Scrivi i test per [il file, per esempio src/utils/prezzi.ts] e falli girare.
Se un test non passa, dimmi se l'errore è nel test o nel codice prima di correggere qualcosa.

Nel pannello di FreeLLMAPI vedi quale modello ha risposto a ogni richiesta. Se un modello ti delude, lo sposti in fondo alla catena.

1. Scegli il progetto. Uno tuo, senza dati di altre persone.
2. Installa con Docker. È la strada che ti lascia accendere il biglietto.
3. Collega quattro fornitori. Google, Groq, OpenRouter e Cerebras bastano per partire.
4. Lancia Claude Code con le due variabili. In un terminale a parte, così il tuo account Claude resta pulito.
5. Accendi il biglietto e fai la prima prova con il README.

FreeLLMAPI è anche il primo dei cinque plugin senza cui non usare Claude Code. Gli altri quattro risolvono sicurezza, memoria, dati e configurazione.

Installazione, variabili per Mac, Linux e Windows, il biglietto e i due prompt. Tienilo a portata di mano la prima volta che lo configuri.