> ## Documentation Index
> Fetch the complete documentation index at: https://docs.teamsoclo.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Cursor

> Sostituisci la Base URL di OpenAI in Cursor

<Steps>
  <Step title="Apri Impostazioni → Modelli">
    Premi `Ctrl + Shift + J` (macOS: `Cmd + Shift + J`) per aprire le Impostazioni di Cursor e seleziona la scheda **Models**.
  </Step>

  <Step title="Inserisci la Base URL e la chiave">
    Scorri fino a **OpenAI API Key**:

    1. Attiva **Override OpenAI Base URL**
    2. Incolla la Base URL:

    ```
    https://gpt.teamsoclo.site/v1
    ```

    3. Incolla la tua chiave API nel campo della chiave
    4. Clicca su **Verify**

    Una verifica riuscita significa che la connessione funziona.
  </Step>

  <Step title="Aggiungi il modello, disabilita i predefiniti">
    Clicca su **+ Add model** e digita il modello esatto del tuo pacchetto:

    ```
    gpt-5.6-sol
    ```

    Per il pacchetto Astra digita `gpt-astra`. Poi **disabilita tutti i modelli predefiniti** (gpt-4o, claude..., o1...) e mantieni solo quello che hai aggiunto.
  </Step>
</Steps>

<Warning>
  Disabilitare i predefiniti è obbligatorio. Se rimangono attivi, Cursor continua a inviare richieste al vero OpenAI con la tua chiave, riporta una chiave non valida e sospetterai della configurazione quando il problema è solo il modello selezionato.
</Warning>

<Warning>
  Un carattere sbagliato nel nome del modello fallisce immediatamente. Copia dalla [tabella dei modelli](/it/models) invece di digitarlo.
</Warning>

<Tip>
  Cursor invia molto contesto nascosto. Per risparmiare token, disattiva **Codebase Indexing** nelle Impostazioni e fai riferimento ai file esatti con `@file` invece di lasciarlo scansionare il progetto.
</Tip>

## Cosa non funziona

Il completamento con Tab e Composer Agent funzionano sull'infrastruttura propria di Cursor e ignorano la Base URL che hai impostato. La chiave si applica al pannello **Chat** e ai modelli che hai aggiunto.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.