Cursor + Gonka AI — LLM economico per la codifica

Per connettere Cursor a Gonka, hai bisogno di una API-key dal JoinGonka Gateway — il nostro gateway per la rete decentralizzata.

1. Vai su gate.joingonka.ai/register e crea un account.
2. Al momento della registrazione, riceverai automaticamente un bonus di 3M token gratuiti — sufficienti per migliaia di richieste AI.
3. Nel pannello di controllo (Dashboard), vai nella sezione API Keys e clicca su Create Key.
4. Copia la chiave — inizia con jg-, ad esempio: jg-abc123def456.

La chiave funziona con qualsiasi client compatibile con OpenAI: Claude Code, Aider, Continue.dev e, naturalmente, Cursor.

Sicurezza: la chiave viene mostrata una sola volta al momento della creazione. Conservala in un luogo sicuro. Se la perdi, creane una nuova e disattiva quella vecchia nella Dashboard.

Importante: per lavorare con la propria API-key (BYOK) è necessario un piano Cursor Pro o superiore — nel piano gratuito di Cursor, l'override della chiave non è attualmente supportato.

Apri Cursor e vai nelle impostazioni:

1. Settings → Models (oppure Ctrl+, → Models)
2. Nel campo OpenAI API Key inserisci la tua chiave jg-xxx.
3. Abilita Override OpenAI Base URL e inserisci: https://gate.joingonka.ai/v1
4. Nell'elenco dei modelli aggiungi: MiniMaxAI/MiniMax-M2.7
5. Seleziona questo modello come principale per Chat, Composer e Autocomplete.

Verifica: apri Cursor Chat (Ctrl+L) e scrivi una richiesta qualsiasi, ad esempio: «Scrivi una funzione di ordinamento in Python». Se appare una risposta, tutto è configurato correttamente.

Consigli per l'ottimizzazione:

• Per Chat e Composer utilizza lo stesso modello — MiniMax M2.7 comprende bene il contesto del codice; per logiche complesse passa a GLM-5.3 Flash, per repository di grandi dimensioni a DeepSeek V4 Flash.
• Abilita lo streaming per una risposta più rapida — la risposta inizia ad apparire immediatamente, senza attendere la generazione completa.
• Se hai bisogno di un formato di risposta diverso, utilizza il System Prompt nelle impostazioni di Cursor per una configurazione precisa.

Possibili errori:

• 401 Unauthorized — verifica che la chiave inizi con jg- e sia attiva nella Dashboard.
• 404 Not Found — assicurati che la Base URL sia esattamente https://gate.joingonka.ai/v1 (con /v1 alla fine).
• Timeout — la prima richiesta può richiedere 5-10 secondi a causa dell'avvio a freddo del nodo nella rete. Le successive saranno più veloci.
• Il modello integrato di Cursor ha smesso di rispondere — finché l'interruttore Override OpenAI Base URL è attivo, Cursor invia all'endpoint tutte le richieste della famiglia OpenAI, inclusi i suoi modelli integrati. Disattiva l'interruttore durante il lavoro con i modelli Cursor e riattivalo per i modelli della rete.

Avvertenza: Chat e modalità Agent vengono reindirizzate al tuo endpoint; l'autocompletamento Cursor Tab funziona sui modelli proprietari di Cursor e non passa attraverso API di terze parti — questo è un limite di Cursor stesso, non del gateway.

Suggerimento. Il comando npx @joingonka/setup --tool cursor stamperà i valori pronti per questi campi — base URL, chiave, ID modello e i suoi limiti reali: finestra di contesto e limite di risposta — e verificherà con una richiesta live che il gateway li accetti. Cursor si configura solo tramite UI — non esiste un file da modificare in sicurezza, quindi i valori vanno inseriti manualmente.

Cursor consuma attivamente token: autocompletamento, Chat, Composer, refactoring — tutto questo sono richieste a LLM. Durante lo sviluppo tipico (4-6 ore al giorno) vengono consumati 3-10M di token al giorno. Confrontiamo i costi:

Risparmio: in un mese di sviluppo attivo, JoinGonka Gateway farà risparmiare $750—1,000 rispetto a OpenAI/Anthropic. Per un team di 5 sviluppatori — $3,750—5,250 al mese.

Allo stesso tempo, la qualità delle risposte dei modelli della rete è paragonabile a GPT-5.5 e Claude nelle attività di coding: generazione di funzioni, refactoring, scrittura di test, spiegazione del codice. Tutti supportano il tool calling nativo, il che li rende adatti anche per scenari di agenti.

Parametri del modello: MiniMax M2.7 supporta una finestra di contesto di 200K token, mentre DeepSeek V4 Flash e GLM-5.3 Flash ne hanno una più estesa. La lunghezza massima della risposta tramite Gateway è di 8192 token per MiniMax M2.7 e GLM-5.3 Flash, 32768 per DeepSeek V4 Flash, il che è più che sufficiente per chat e modifiche al codice. Lista dei modelli disponibili: GET https://gate.joingonka.ai/v1/models.