# Roo Code

Configura Roo Code con un fornitore di modelli compatibile con Felo.

Usa questa guida quando Roo Code richiede impostazioni per un provider personalizzato.

## 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 | Agenti di programmazione in VS Code, modifica dei repository, esecuzione di comandi e pianificazione delle attività |
| Protocollo | Endpoint compatibile con OpenAI o con Anthropic |
| URL di base | `https://openapi.felo.ai/api/v1` |
| Modello di esempio | `claude-sonnet-4-6` |
| Chiave API | La tua `FELO_API_KEY` |

## Configurare Roo Code

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` |

Usa l'URL di base compatibile con Anthropic `https://openapi.felo.ai/api` solo se Roo Code è configurato in modalità Anthropic.

## Verificare la configurazione

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

```bash
Open Roo Code and ask it to inspect the current repository.
```

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)
