Gemini CLI con endpoint personalizzato e modelli gratuiti
Gemini CLI è l'agente di programmazione open source di Google per il terminale. Può inviare le sue richieste a un URL base personalizzato. Questa guida punta Gemini CLI a FreeLLMAPI, che serve l'API Gemini nativa su /v1beta. Le tue richieste vanno poi al tuo pool di piani gratuiti dei provider, che può includere chiavi gratuite dell'API Gemini.
Codice, nomi dei modelli ed etichette del catalogo in tempo reale sono mostrati in inglese.
La modifica del 2026 al piano gratuito di Gemini CLI
Leggi prima questo. Google ha cambiato l'uso gratuito di Gemini CLI nel 2026. La pagina delle quote di Gemini CLI dice: «Unpaid tier and Google One users: Gemini CLI was replaced by Antigravity CLI on June 18th, 2026.»
L'annuncio di Google dice che Gemini CLI resta disponibile tramite chiavi API Gemini a pagamento e per i clienti enterprise.
- Accesso Google nel piano gratuito: non più servito da Gemini CLI per gli account consumer.
- Chiave API Gemini con URL base personalizzato: il riferimento di configurazione di Gemini CLI documenta ancora
GOOGLE_GEMINI_BASE_URL. Con questa variabile, Gemini CLI invia le sue richieste all'URL che imposti, non a Google. - Chiavi API Gemini gratuite: Google AI Studio elenca ancora un piano gratuito per l'API Gemini. FreeLLMAPI può usare queste chiavi, insieme alle chiavi di altri provider.
Questa guida usa il secondo metodo. FreeLLMAPI risponde alle richieste e invia ciascuna a un modello gratuito del tuo pool.
Passo 1: installa FreeLLMAPI e Gemini CLI
Installa entrambi
curl -fsSL https://freellmapi.co/install.sh | bash
npm install -g @google/gemini-cliApri http://localhost:3001. Aggiungi almeno due chiavi di provider gratuiti nella pagina Keys. Una chiave gratuita di Google AI Studio è una buona prima chiave. Copia la tua chiave unificata dalla stessa pagina.
Passo 2: punta Gemini CLI al gateway
Imposta due variabili d'ambiente e avvia Gemini CLI. L'URL base è l'origine del server, senza /v1beta. Gemini CLI aggiunge da solo il percorso dell'API.
macOS o Linux
export GOOGLE_GEMINI_BASE_URL=http://localhost:3001
export GEMINI_API_KEY=<unified-key>
geminiWindows PowerShell
$env:GOOGLE_GEMINI_BASE_URL="http://localhost:3001"
$env:GEMINI_API_KEY="<unified-key>"
geminiQuando Gemini CLI chiede un metodo di autenticazione, seleziona Use Gemini API key. Per salvare la scelta, impostala in ~/.gemini/settings.json:
~/.gemini/settings.json
{
"security": {
"auth": {
"selectedType": "gemini-api-key"
}
}
}GEMINI_API_KEY. Una segnalazione su Gemini CLI riporta che la versione 0.44.x fallisce con «Invalid auth method selected» quando si usa GOOGLE_API_KEY con GOOGLE_GEMINI_BASE_URL. Se GOOGLE_API_KEY è impostata, rimuovila con unset GOOGLE_API_KEY.Passo 3: mappa i nomi dei modelli Gemini su modelli gratuiti
Gemini CLI chiede nomi di modelli Gemini, per esempio gemini-2.5-flash. FreeLLMAPI non invia questi nomi direttamente a Google. Li risolve tramite la mappa delle famiglie Gemini nella scheda Keys, Agents. Mappa ogni famiglia (Pro, Flash e Flash-Lite) su Auto o su un modello fisso del catalogo.
- Con Auto, il router sceglie un modello gratuito per ogni richiesta. Quando un provider invia un errore 429, prova il successivo.
- Anche gli ID del catalogo funzionano come nomi di modelli. Avvia Gemini CLI con
gemini -m <catalog-id>, oppure impostaGEMINI_MODEL. - Gemini CLI è un agente con strumenti. Mappa le famiglie su modelli con chiamate di strumenti e una finestra di contesto ampia.
La prima tabella mostra i modelli Gemini gratuiti del catalogo di oggi. La seconda tabella mostra altri modelli gratuiti che puoi mappare su una famiglia Gemini.
| Modello | Gratis su | Contesto | Limiti gratuiti (offerta migliore) | Strumenti | Visione |
|---|---|---|---|---|---|
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | Sì | Sì |
| Gemini Flash (latest alias) | Google AI Studio | - | 10 richieste/min 20 richieste/giorno 250,000 token/min ~3M | Sì | Sì |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 richieste/min 20 richieste/giorno 250,000 token/min ~3M | Sì | Sì |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 richieste/min 20 richieste/giorno 250,000 token/min ~3M | Sì | Sì |
| Gemini 3.5 Flash | Google AI Studio | 1M | 10 richieste/min 20 richieste/giorno 250,000 token/min ~3M | Sì | Sì |
| Gemini 3.8 Live | Google AI Studio | - | 10 richieste/min 20 richieste/giorno 250,000 token/min ~3M | Sì | Sì |
| Gemini 3.8 Live Extended Thinking | Google AI Studio | - | 10 richieste/min 20 richieste/giorno 250,000 token/min ~3M | Sì | Sì |
| Gemini 3.5 Flash Lite | Google AI Studio | 1M | 15 richieste/min 20 richieste/giorno 250,000 token/min ~3M | Sì | Sì |
Mostrati 8 di 14 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.
| 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ì |
| 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ì |
| 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ì |
Mostrati 8 di 104 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 del piano gratuito di Gemini
La pagina dei limiti di frequenza di Google dice che i limiti si applicano per progetto, non per chiave API. Più chiavi nello stesso progetto non danno più quota. Google dice anche che i limiti non sono garantiti e che puoi vedere i limiti attuali in Google AI Studio. I modelli in anteprima hanno limiti più bassi.
Una chiave gratuita di Gemini Flash consente poche richieste al giorno. Un singolo task di Gemini CLI può inviare molte richieste. Aggiungi chiavi di altri provider, così il router può continuare quando la quota Gemini si esaurisce. La superficie nativa supporta generateContent, streamGenerateContent con ?alt=sse, countTokens e l'elenco dei modelli.
FreeLLMAPI accetta la chiave nell'intestazione x-goog-api-key, come token Bearer o nel parametro di query ?key= di Gemini. Preferisci un'intestazione, perché una chiave in un URL può finire nella cronologia della shell e nei log dei proxy.
Risoluzione dei problemi
| Problema | Causa | Soluzione |
|---|---|---|
| Gemini CLI apre un login Google | Il tipo di autenticazione non è impostato su Gemini API key | Seleziona Use Gemini API key, oppure imposta security.auth.selectedType |
| «Invalid auth method selected» | GOOGLE_API_KEY è usata con un URL base personalizzato | Usa GEMINI_API_KEY e rimuovi GOOGLE_API_KEY |
| Le richieste vanno a Google, non al gateway | GOOGLE_GEMINI_BASE_URL non è impostata in questa shell | Esporta la variabile, poi avvia di nuovo gemini |
404 sulle chiamate ai modelli | L'URL base include /v1beta | Usa solo l'origine http://localhost:3001 |
| Le chiamate di strumenti falliscono | La famiglia Gemini è mappata su un modello con chiamate di strumenti deboli | Mappa la famiglia su un modello delle tabelle sopra |
| «All models rate-limited after N attempts» | Tutte le chiavi sono al limite | Aggiungi chiavi di altri provider, oppure attendi i cooldown |
Domande frequenti
Gemini CLI è ancora gratuito?
Google ha terminato l'uso gratuito di Gemini CLI con login Google per gli utenti non a pagamento e per gli utenti Google One il 18 giugno 2026. La CLI supporta ancora un URL base personalizzato, quindi può funzionare su un gateway gratuito come FreeLLMAPI.
Come uso Gemini CLI con un endpoint personalizzato?
Imposta GOOGLE_GEMINI_BASE_URL sull'origine dell'endpoint e GEMINI_API_KEY sulla sua chiave, poi seleziona Use Gemini API key. L'endpoint deve parlare l'API Gemini nativa su /v1beta.
Gemini CLI può usare modelli che non sono Gemini?
Sì, tramite FreeLLMAPI. Il gateway mappa i nomi di famiglia Gemini Pro, Flash e Flash-Lite su Auto o su qualsiasi modello del catalogo, per esempio un modello Qwen o GLM.
Quali sono i limiti del piano gratuito dell'API Gemini?
Google fissa i limiti per progetto, non per chiave, e mostra i valori attuali in Google AI Studio. La tabella di questa pagina mostra i modelli Gemini gratuiti di oggi e i loro limiti dal catalogo FreeLLMAPI.
Perché ottengo «Invalid auth method selected»?
Una segnalazione su Gemini CLI riporta questo errore nella versione 0.44.x quando si usa GOOGLE_API_KEY con GOOGLE_GEMINI_BASE_URL. Usa GEMINI_API_KEY e rimuovi GOOGLE_API_KEY.
Guide correlate
- free gemini api
- Quota Gemini API superata (429 RESOURCE_EXHAUSTED)
- Come usare Claude Code gratis
- Usare Codex CLI con modelli gratuiti
- Migliori API gratuite per modelli di codice
Fonti
- Gemini CLI docs: configuration reference (verificato il 20 November 2026)
- Gemini CLI docs: authentication (verificato il 20 November 2026)
- Gemini CLI docs: quota and pricing (verificato il 20 November 2026)
- Google Developers Blog: transitioning Gemini CLI to Antigravity CLI (verificato il 20 November 2026)
- Gemini CLI issue 27550: auth with a custom base URL (verificato il 20 November 2026)
- Google AI Studio: rate limits (verificato il 20 November 2026)
- FreeLLMAPI docs: native Gemini API (verificato il 20 November 2026)