Home / Guide / Usare Cursor con una free LLM API

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 CursorCon la tua chiaveFonte
Chat con un modello in stile OpenAI standardSì. Cursor documenta le chiavi OpenAI proprie per i modelli di chat standard, non di ragionamento.Pagina di aiuto sulle chiavi API di Cursor
Completamento TabNo. Cursor afferma che Tab continua a usare i modelli integrati di Cursor.Pagina di aiuto sulle chiavi API di Cursor
Modalità agente e ComposerNon confermato. La documentazione di Cursor cita solo i modelli di chat. Verificalo con il tuo piano prima di farvi affidamento.Non documentato
Richieste da localhostNo. 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.

Nota: se vuoi un agente gratuito nell'editor senza vincoli di piano, usa Cline, Roo Code o Kilo Code in VS Code. Questi si collegano direttamente a 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 | bash

Copia 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-cursor

Questo comando non scrive alcun file. Cursor non ha un file di configurazione per questa impostazione, quindi inserisci i valori nelle impostazioni di Cursor.

Sicurezza: un URL pubblico permette a chiunque abbia la tua chiave unificata di usare le tue quote gratuite. Non condividere mai la chiave. Se il tuo tunnel non può inviare un'intestazione 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

  1. Apri Cursor Settings.
  2. Apri Models.
  3. Trova il campo della chiave API OpenAI. Incolla la tua chiave unificata di FreeLLMAPI. Fai clic su Save.
  4. Attiva la sostituzione dell'URL di base OpenAI. La guida FreeLLMAPI chiama questa impostazione Override OpenAI Base URL.
  5. Inserisci il tuo indirizzo pubblico con /v1 alla fine, per esempio https://<your-tunnel-host>/v1.
  6. 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.

Importante: la sostituzione è globale finché è attiva. Disattivala prima di tornare ai provider integrati di Cursor.

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.

Modelli gratuiti per la chat di Cursor: tool calling e contesto di 128K+
ModelloGratis suContestoLimiti gratuiti (offerta migliore)StrumentiVisione
GLM 5.3UnoRouter1M1 richieste/min
1 req/min per model
SìNo
GLM 5.3 FlashNVIDIA NIM, UnoRouter1M40 richieste/min
40 RPM
SìSì
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaSìSì
Qwen3.8 Flash NextAMD Radeon Cloud262KRecurring daily account allowanceSìNo
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring creditSìSì
Gemini 3.7 FlashGoogle AI Studio1M10 richieste/min
20 richieste/giorno
250,000 token/min
~3M
SìSì
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring creditSìSì
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 richieste/min
50 richieste/giorno
50 req/day account-wide (1,000 after a $10 purchase)
SìSì
DeepSeek V4 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 richieste/min
50 richieste/giorno
Shared rate limit
SìNo
Qwen3.8 27BElectronHub, Groq, OVH AI Endpoints262K30 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:fast per le domande brevi e auto:smart per le domande di codice difficili.
  • Apri una nuova chat per ogni compito. Una cronologia più corta invia meno token.

Risoluzione dei problemi

ProblemaCausaSoluzione
Cursor non riesce a connettersi a http://localhost:3001/v1Cursor invia le richieste dai propri server, non dal tuo computerUsa un indirizzo HTTPS pubblico per il gateway
Nessuna opzione per una chiave propriaIl tuo piano di Cursor non include chiavi API proprieVerifica la tabella dei piani nella pagina dei prezzi di Cursor
401 "Invalid API key"La chiave in Cursor non è la tua chiave unificata di FreeLLMAPICopia di nuovo la chiave unificata dalla pagina Keys
Il completamento Tab non usa il gatewayCursor usa sempre i propri modelli per TabNessuna 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 limiteAggiungi chiavi di più provider, oppure attendi le pause
I modelli integrati smettono di funzionareLa sostituzione dell'URL di base è ancora attivaDisattiva la sostituzione
Usa ognuno di questi modelli con una sola chiave. FreeLLMAPI è un router open source self-hosted che mette tutti questi piani gratuiti dietro un unico endpoint compatibile con OpenAI e passa al successivo quando uno raggiunge il limite di frequenza. Sfoglia il catalogo oppure inizia.

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

Fonti

Tutte le guide · Sfoglia tutti i modelli gratuiti