# Cursor

Usa Felo API Platform in Cursor tramite le impostazioni OpenAI-compatible personalizzate disponibili.

Usa questa guida quando la tua configurazione di Cursor supporta endpoint personalizzati compatibili con OpenAI o la sovrascrittura di provider esterni.

## Prima di iniziare

Ti serve una chiave di Felo API Platform. La stessa chiave funziona con i protocolli dei modelli, i client agente, Search, Web Fetch, PPT, Mindmap, LiveDocs, X Search, YouTube Subtitling, Landing Page e le API SuperAgent.

```bash
export FELO_API_KEY="YOUR_API_KEY"
```

## Configurazione consigliata

| Voce | Valore |
|------|-------|
| Ideale per | Programmazione con IA dentro un editor, domande sul repository e generazione di codice |
| Protocollo | Chat Completions compatibile con OpenAI |
| URL di base | `https://openapi.felo.ai/api/v1` |
| Modello di esempio | `claude-sonnet-4-6` |
| Chiave API | La tua `FELO_API_KEY` |

## Configurare Cursor

Imposta prima le variabili d'ambiente:

```bash
export FELO_API_KEY="YOUR_API_KEY"
export OPENAI_API_KEY="$FELO_API_KEY"
export OPENAI_BASE_URL="https://openapi.felo.ai/api/v1"
```

### Campi del client

| Campo | Valore |
|-------|-------|
| Tipo di provider | Provider personalizzato compatibile con OpenAI |
| Chiave API | La tua `FELO_API_KEY` |
| URL di base | `https://openapi.felo.ai/api/v1` |
| Modello | `claude-sonnet-4-6` |

Se la tua versione di Cursor non espone impostazioni per un URL di base personalizzato, usa Claude Code, Codex, OpenCode o un altro client che supporta provider personalizzati.

## Verificare la configurazione

Esegui un'attività semplice dopo aver salvato la configurazione:

```bash
Open Cursor and run a small chat or code edit after saving the provider settings.
```

Se lo strumento si avvia e risponde con il modello selezionato, la configurazione del provider è pronta.

## Risoluzione dei problemi

| Problema | Cosa controllare |
|-------|---------------|
| L'autenticazione non funziona | Verifica che la chiave sia copiata correttamente ed esportata come `FELO_API_KEY` |
| Lo strumento chiama il provider sbagliato | Controlla che il provider Felo sia selezionato per l'area di lavoro o la sessione corrente |
| Errore nell'URL di base | Usa `https://openapi.felo.ai/api/v1` per i client compatibili con OpenAI e `https://openapi.felo.ai/api` per i client compatibili con Anthropic |
| Modello non trovato | Scegli un modello presente nel tuo elenco di modelli Felo |
| Lo strumento ignora la configurazione locale | Sposta le impostazioni del provider nella configurazione a livello utente se il client lo richiede |

## Passi successivi

- [Per iniziare](https://openapi.felo.ai/it/docs/getting-started.md)
- [Riferimento LLM API](https://openapi.felo.ai/it/docs/guides/protocols.md)
- [Riferimento Chat API](https://openapi.felo.ai/it/docs/api-reference/chat.md)
- [Riferimento SuperAgent API](https://openapi.felo.ai/it/docs/api-reference/superagent.md)
