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

# Cursor IDE

> Configura Cursor IDE per usare i modelli Venice tra cui Claude, GPT, DeepSeek e Qwen tramite un URL base compatibile con OpenAI e il prefisso di modello venice-.

[Cursor](https://www.cursor.com/) è un editor di codice basato su AI. Puoi usarlo con Venice AI per un accesso privato e senza restrizioni a un'ampia gamma di modelli.

<CardGroup cols={3}>
  <Card title="Paga per token" icon="coins">
    Nessun abbonamento. Paghi solo per ciò che usi
  </Card>

  <Card title="Tutti i modelli" icon="microchip">
    Accedi a Claude, GPT, DeepSeek, Llama e altri
  </Card>

  <Card title="Compatibile con OpenAI" icon="plug">
    Funziona tramite l'API compatibile con OpenAI di Venice
  </Card>
</CardGroup>

***

## Configurazione

<Steps>
  <Step title="Ottieni la tua API key">
    Genera una chiave da [venice.ai/settings/api](https://venice.ai/settings/api).
  </Step>

  <Step title="Configura Cursor">
    Apri **Cursor Settings** (icona dell'ingranaggio), scorri fino a **Models** e clicca su **Add Model**.

    Sotto **OpenAI Compatible**, inserisci:

    * **Override OpenAI Base URL**: `https://api.venice.ai/api/v1`
    * **OpenAI API Key**: la tua API key Venice
  </Step>

  <Step title="Aggiungi modelli">
    Nel campo del nome modello, digita l'ID del modello Venice e premi Invio. Aggiungi ciascun modello che vuoi usare. Ad esempio:

    * `minimax-m25`
    * `kimi-k2-5`
    * `venice-claude-opus-4-6` (vedi la [nota sul prefisso più sotto](#the-venice--model-prefix))

    Consulta il [catalogo modelli](/models/text) per tutti gli ID dei modelli disponibili.
  </Step>

  <Step title="Seleziona e verifica">
    Apri una nuova chat e usa il **selettore di modello in fondo alla chat** per scegliere uno dei modelli Venice appena aggiunti. Invia un messaggio di prova. Se ricevi una risposta, è tutto pronto.
  </Step>
</Steps>

***

## Il prefisso di modello `venice-`

<Warning>
  **I modelli Claude richiedono il prefisso `venice-` quando vengono usati in Cursor.**

  Cursor riscrive le richieste per i modelli `claude-*` nel formato nativo di Anthropic, che è incompatibile con Venice. Anteporre il prefisso `venice-` all'ID del modello impedisce questa riscrittura. Venice rimuove automaticamente il prefisso.
</Warning>

| Modello              | ID standard            | ID Cursor                     |
| -------------------- | ---------------------- | ----------------------------- |
| Claude Opus 4.6      | `claude-opus-4-6`      | `venice-claude-opus-4-6`      |
| Claude Opus 4.6 Fast | `claude-opus-4-6-fast` | `venice-claude-opus-4-6-fast` |
| Claude Sonnet 4.6    | `claude-sonnet-4-6`    | `venice-claude-sonnet-4-6`    |
| Claude Opus 4.5      | `claude-opus-4-5`      | `venice-claude-opus-4-5`      |
| Claude Sonnet 4.5    | `claude-sonnet-4-5`    | `venice-claude-sonnet-4-5`    |

<Info>
  I modelli non Claude (ad es. `minimax-m25`, `kimi-k2-5`, `zai-org-glm-5`) **non sono interessati** e funzionano senza il prefisso. Il prefisso `venice-` è sicuro da usare su qualsiasi modello, dato che Venice lo rimuove sempre, ma è richiesto solo per i modelli Claude in Cursor.
</Info>

***

## Risorse

<CardGroup cols={2}>
  <Card title="Documentazione API Venice" icon="book" href="/api-reference/api-spec">
    Riferimento completo dell'API
  </Card>

  <Card title="Catalogo modelli" icon="list" href="/models/text">
    Sfoglia i modelli disponibili
  </Card>
</CardGroup>