# Claude Code con i modelli gratis: FreeLLMAPI

Da riccardobelli.com/freellmapi. Dati letti il 21 ottobre 2026.
Repo: https://github.com/tashfeenahmed/freellmapi (MIT)

## Quattro cose prima di installare

1. Le chiavi le prendi tu: un account gratuito per ogni fornitore.
2. Sotto non lavora Claude: Claude Code resta lo stesso, le risposte arrivano da modelli gratuiti di altri (GLM, Kimi, Qwen, Gemini Flash...).
3. Solo progetti tuoi: il README lo limita agli esperimenti personali. Molti piani gratuiti usano i dati per addestrare. Mai dati o codice di clienti.
4. Il biglietto (passaggio di consegne fra modelli) è spento di base: accendilo al passo 5.

## 1. Installa (Docker)

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

Apri http://localhost:3001 e crea l'account del pannello.
In alternativa l'app per Mac e Windows dalla pagina Releases della repo: gira su http://127.0.0.1:31415.

## 2. Collega i fornitori

Google AI Studio, Groq, OpenRouter, Cerebras. Incolla le chiavi nella pagina Keys, ordina la Fallback Chain, copia la chiave unica freellmapi-...
Lascia fuori Cohere.

## 3. Punta Claude Code su FreeLLMAPI

Mac e Linux:

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

Windows (PowerShell):

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

- ANTHROPIC_AUTH_TOKEN, mai ANTHROPIC_API_KEY: con quella Claude Code non parte.
- Indirizzo senza /v1.
- Vale solo per quel terminale.
- Con l'app: http://127.0.0.1:31415 al posto di http://localhost:3001.

Per renderlo permanente: `npx freellmapi setup-claude --url http://localhost:3001 --dry-run`, poi senza --dry-run.

## 4. Accendi il biglietto

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

## 5. Prima prova

```
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.
```