Configurazione degli strumenti di IA
Claude Code
Configura Claude Code per instradare le chiamate ai modelli Anthropic-compatible tramite Felo API Platform.
Usa questa guida quando vuoi che Claude Code usi Felo API Platform invece di chiamare direttamente il fornitore del modello. Claude Code usa un endpoint Messages compatibile con Anthropic.
Preferisci non configurarlo a mano? Installa CC Switch, un'app desktop open source di terze parti che memorizza le impostazioni del provider di Claude Code e permette di passare dall'una all'altra con un clic. Aggiungi Felo come provider e potrai passare dall'API Felo al tuo abbonamento Claude senza modificare variabili d'ambiente. Il primo passaggio all'abbonamento usa il normale flusso di accesso di Claude Code; i passaggi seguenti spiegano come aggiungere Felo.
Configurare CC Switch
L'esempio seguente aggiunge Felo come provider di Claude Code. Gli stessi passaggi valgono per qualsiasi altro provider compatibile con Anthropic: cambiano solo endpoint, chiave e ID dei modelli.
- In CC Switch, seleziona Claude Code, clicca Add provider e scegli Custom Configuration.

- Inserisci un nome, incolla la chiave API Felo creata nella pagina Chiavi API di Felo API Platform e imposta API Endpoint su
https://openapi.felo.ai/api. L'URL del sito è facoltativo.

- Apri Advanced Options. Imposta Upstream Format su Anthropic Messages (Native) e lascia Auth Field su
ANTHROPIC_AUTH_TOKEN (Default). In Model Mapping, mappa Sonnet e Opus sul modello Felo che vuoi usare, per esempiogpt-6.1-sol.

- Clicca Add, abilita il provider e avvia Claude Code. Se la prima richiesta riesce, la configurazione è completa.
Per tornare al tuo abbonamento Claude, seleziona Claude Official in CC Switch e segui il flusso di accesso. Cambiare provider sostituisce solo endpoint, chiave e mappatura dei modelli: plugin, hook e impostazioni MCP restano invariati.
Configurazione consigliata
| Voce | Valore |
|---|---|
| Ideale per | Modifica dei repository, agenti di programmazione, ricerca su contesti lunghi e sviluppo orientato al terminale |
| Protocollo | API Messages compatibile con Anthropic |
| URL di base | https://openapi.felo.ai/api |
| Modello di esempio | claude-sonnet-4-6 |
| Chiave API | La tua FELO_API_KEY |
Configurare Claude Code
Per configurare Claude Code manualmente, crea una chiave nella pagina Chiavi API di Felo API Platform e imposta le variabili d'ambiente. 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.
export FELO_API_KEY="YOUR_API_KEY"
export ANTHROPIC_API_KEY="$FELO_API_KEY"
export ANTHROPIC_BASE_URL="https://openapi.felo.ai/api"
export ANTHROPIC_MODEL="claude-sonnet-4-6"File di impostazioni facoltativo
Usa un file di impostazioni quando vuoi che l'URL di base e il modello si applichino a ogni avvio di Claude Code. Tieni la chiave API nella tua shell o nel tuo gestore di segreti.
{
"env": {
"ANTHROPIC_BASE_URL": "https://openapi.felo.ai/api",
"ANTHROPIC_MODEL": "claude-sonnet-4-6"
}
}Puoi anche scegliere un modello per una singola sessione:
claude --model claude-sonnet-5Verificare la configurazione
Esegui un'attività semplice dopo aver salvato la configurazione:
claudeSe 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 |