Come usare FreeLLMAPI con Claude Code, passo per passo

Cosa ti serve

• Claude Code già installato (qui la guida ufficiale).
• Node.js 20 o più recente, da nodejs.org. Se hai installato Claude Code con npm ce l'hai già.
• Un account Google.

1. Scarica e apri l'app

Vai sulla pagina dei download e prendi il file giusto per il tuo computer:

• Windows: FreeLLMAPI-Setup-….exe
• Mac con chip Apple (M1, M2, M3…): il .dmg con arm64 nel nome
• Mac con processore Intel: il .dmg con x64 nel nome

Installala come un programma qualsiasi e aprila. Niente account, niente password. Compare solo una piccola icona: in alto a destra sul Mac, vicino all'orologio su Windows.

2. Prendi una chiave gratuita da Google

FreeLLMAPI lavora con le chiavi gratuite dei vari fornitori di AI. Io partirei da quella di Google, perché ti basta l'account che hai già.

Apri aistudio.google.com/apikey, entra e clicca Create API key. Copia la chiave che ti mostra, quella che inizia con AIza.

3. Incollala nell'app

Clicca l'icona di FreeLLMAPI e scegli Apri il pannello. Da lì vai su Chiavi (Keys, se l'app ti esce in inglese) e premi Aggiungi chiave. Come fornitore scegli Google AI Studio, incolla e salva.

Il pallino verde accanto a Google AI Studio vuol dire che la chiave funziona.

Più chiavi metti, più modelli ha a disposizione quando uno arriva al limite. Groq, OpenRouter e Cerebras hanno anche loro un piano gratuito, e quando li selezioni nel modulo trovi il link Ottieni chiave API. Per iniziare ne basta una.

4. Copia la tua chiave FreeLLMAPI

Attenzione, questa è un'altra chiave. È quella che userai d'ora in poi, al posto di tutte le altre. Clicca l'icona e premi Copia chiave: inizia con freellmapi-.

Nello stesso menu dovresti vedere anche "In esecuzione su 127.0.0.1:31415". Tieni d'occhio quel numero finale, ti serve tra un attimo.

5. Avvia Claude Code passando da FreeLLMAPI

Apri il terminale nella cartella del tuo progetto e lancia:

npx freellmapi launch --url http://localhost:31415

Ti chiede la chiave: incolla quella del passaggio 4 e premi invio. Si apre Claude Code, uguale a sempre. Cambia quello che c'è dietro.

Se al passaggio 4 avevi un numero diverso da 31415, cambialo anche nel comando.

6. Fai una prova

Chiedigli una cosa semplice, tipo spiegarti cosa fa un file del progetto. Per sapere chi ti ha risposto, apri il menu dell'icona: sotto Ultimo modello trovi il nome. E quando un fornitore esaurisce la quota, la richiesta successiva passa da sola al modello dopo.

Per tornare a Claude normale

Chiudi e riapri Claude Code con il solito claude. Il comando del passaggio 5 non scrive nulla nei tuoi file di configurazione, vale solo per quella sessione.