Usare Cursor con una free LLM API
Cursor può inviare richieste di chat alla tua chiave API OpenAI. Questa guida mostra come collegare quella chiave a modelli gratuiti tramite FreeLLMAPI. Indica anche i limiti. Cursor instrada ogni richiesta attraverso i propri server, e il completamento Tab usa sempre i modelli di Cursor.
Codice, nomi dei modelli ed etichette del catalogo in tempo reale sono mostrati in inglese.
Cosa funziona e cosa no
Leggi questa sezione prima di iniziare. Il supporto di Cursor per le chiavi proprie è più limitato rispetto alla maggior parte degli altri editor.
| Funzione di Cursor | Con la tua chiave | Fonte |
|---|---|---|
| Chat con un modello in stile OpenAI standard | Sì. Cursor documenta le chiavi OpenAI proprie per i modelli di chat standard, non di ragionamento. | Pagina di aiuto sulle chiavi API di Cursor |
| Completamento Tab | No. Cursor afferma che Tab continua a usare i modelli integrati di Cursor. | Pagina di aiuto sulle chiavi API di Cursor |
| Modalità agente e Composer | Non confermato. La documentazione di Cursor cita solo i modelli di chat. Verificalo con il tuo piano prima di farvi affidamento. | Non documentato |
| Richieste da localhost | No. Cursor invia tutte le richieste attraverso i propri server per costruire il prompt, quindi localhost sul tuo computer non fa parte del percorso. | Pagina di aiuto sulle chiavi API di Cursor |
Anche i piani sono importanti. La pagina dei prezzi di Cursor elenca i modelli di terze parti e le chiavi API proprie nei piani Premium, Super e Ultra. Indica che il piano Plus non ha chiavi API proprie. Per il piano Free, la pagina indica i modelli di terze parti come non disponibili. Verifica la pagina dei prezzi per il tuo piano prima di continuare.
localhost. Leggi Cline, Roo Code e Kilo Code con una free API.Passo 1: installa FreeLLMAPI e rendilo raggiungibile
FreeLLMAPI è open source e gira sul tuo computer in Docker. Installalo, poi aggiungi almeno due chiavi gratuite di provider nella pagina Keys.
Installa su macOS o Linux
curl -fsSL https://freellmapi.co/install.sh | bashCopia la chiave unificata dalla pagina Keys. Poi assegna al gateway un indirizzo HTTPS pubblico, perché i server di Cursor non possono raggiungere il tuo localhost. Usa un tunnel HTTPS affidabile o un server che controlli tu. La guida FreeLLMAPI per Cursor stampa questi passaggi:
Stampa la guida per Cursor
npx freellmapi setup-cursorQuesto comando non scrive alcun file. Cursor non ha un file di configurazione per questa impostazione, quindi inserisci i valori nelle impostazioni di Cursor.
Authorization, crea un token URL revocabile separatamente in Keys, Agents. Revocalo quando smetti.Passo 2: imposta la chiave e l'URL di base in Cursor
- Apri Cursor Settings.
- Apri Models.
- Trova il campo della chiave API OpenAI. Incolla la tua chiave unificata di FreeLLMAPI. Fai clic su Save.
- Attiva la sostituzione dell'URL di base OpenAI. La guida FreeLLMAPI chiama questa impostazione Override OpenAI Base URL.
- Inserisci il tuo indirizzo pubblico con
/v1alla fine, per esempiohttps://<your-tunnel-host>/v1. - Seleziona un modello nel selettore dei modelli e invia un breve messaggio di chat.
La documentazione sulla privacy di Cursor cita la sostituzione dell'URL di base compatibile con OpenAI. Cursor non documenta i passaggi esatti. Le etichette nella tua versione possono essere diverse.
Per verificare che le richieste arrivino al gateway, apri il log delle richieste nella dashboard. Ogni risposta ha anche un'intestazione X-Routed-Via che mostra il provider e il modello che hanno risposto.
Passo 3: scegli i modelli
Usa l'id di modello auto per lasciare che il router scelga un modello gratuito per ogni richiesta. Puoi anche usare un id del catalogo da GET /v1/models. La chat di Cursor invia il contesto dei file con ogni messaggio, quindi usa modelli con una finestra di contesto ampia. La tabella mostra oggi i modelli gratuiti con tool calling e almeno 128K di contesto.
| 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ì |
Mostrati 10 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.
Cursor documenta le chiavi OpenAI proprie per i modelli di chat non di ragionamento. I modelli di ragionamento possono fallire con la sostituzione. Se un modello fallisce, usa auto o un altro modello dalla tabella.
Rate limit e failover
Ogni piano gratuito ha limiti al minuto e al giorno. FreeLLMAPI conta l'uso di ogni chiave. Quando un provider invia un errore 429, il router invia la richiesta al modello successivo della tua catena di fallback. La chat continua e non devi cambiare impostazioni in Cursor.
- Aggiungi chiavi di quattro o più provider. Più provider danno più richieste al giorno.
- Usa
auto:fastper le domande brevi eauto:smartper le domande di codice difficili. - Apri una nuova chat per ogni compito. Una cronologia più corta invia meno token.
Risoluzione dei problemi
| Problema | Causa | Soluzione |
|---|---|---|
Cursor non riesce a connettersi a http://localhost:3001/v1 | Cursor invia le richieste dai propri server, non dal tuo computer | Usa un indirizzo HTTPS pubblico per il gateway |
| Nessuna opzione per una chiave propria | Il tuo piano di Cursor non include chiavi API proprie | Verifica la tabella dei piani nella pagina dei prezzi di Cursor |
401 "Invalid API key" | La chiave in Cursor non è la tua chiave unificata di FreeLLMAPI | Copia di nuovo la chiave unificata dalla pagina Keys |
| Il completamento Tab non usa il gateway | Cursor usa sempre i propri modelli per Tab | Nessuna soluzione. Usa Continue in VS Code per il completamento automatico gratuito |
| Messaggio di errore: "All models rate-limited after N attempts" | Tutte le chiavi della catena hanno raggiunto il limite | Aggiungi chiavi di più provider, oppure attendi le pause |
| I modelli integrati smettono di funzionare | La sostituzione dell'URL di base è ancora attiva | Disattiva la sostituzione |
Domande frequenti
Posso usare Cursor gratis con la mia chiave API?
La pagina dei prezzi di Cursor elenca le chiavi API proprie nei piani Premium, Super e Ultra, e indica che il piano Plus non ha chiavi proprie. Con un piano che include chiavi proprie, FreeLLMAPI fornisce alla chat modelli gratuiti, quindi il costo dell'inferenza è di $0.
Perché Cursor non si collega a localhost?
Cursor invia tutte le richieste attraverso i propri server per costruire il prompt. Quei server non possono raggiungere localhost sul tuo computer, quindi il gateway ha bisogno di un indirizzo HTTPS pubblico.
Il completamento automatico Tab di Cursor funziona con un'API personalizzata?
No. La documentazione di Cursor dice che le chiavi API personalizzate funzionano solo con i modelli di chat, e il completamento Tab continua a usare i modelli integrati di Cursor.
Qual è il modello gratuito migliore per Cursor?
Usa auto, oppure un modello con tool calling e almeno 128K di contesto dalla tabella di questa pagina. Cursor invia il contesto dei file con ogni messaggio, quindi una finestra di contesto ampia è importante.
Il mio codice viene inviato a Cursor quando uso la mia chiave?
Sì. Cursor afferma che le richieste passano dai suoi server per la costruzione finale del prompt. Zero Data Retention non si applica quando usi le tue chiavi.
Guide correlate
- AI gratuite in VS Code
- Cline, Roo Code e Kilo Code con un'API gratuita
- Continue con un'API LLM gratuita
- Migliori API gratuite per modelli di codice
- Base URL di API gratuite compatibili con OpenAI
Fonti
- Cursor help: API keys (verificato il 20 November 2026)
- Cursor docs: models and pricing (verificato il 20 November 2026)
- Cursor docs: privacy and data governance (verificato il 20 November 2026)
- FreeLLMAPI docs: clients and coding agents (verificato il 20 November 2026)
- FreeLLMAPI CLI generators (verificato il 20 November 2026)