Felo API PlatformFelo API Platform

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.

  1. In CC Switch, seleziona Claude Code, clicca Add provider e scegli Custom Configuration.
Scelta di Custom Configuration in CC Switch
  1. 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.
Inserimento dell'endpoint Felo e della chiave API in CC Switch
  1. 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 esempio gpt-6.1-sol.
Mappatura di Sonnet e Opus su un modello Felo in CC Switch
  1. 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

VoceValore
Ideale perModifica dei repository, agenti di programmazione, ricerca su contesti lunghi e sviluppo orientato al terminale
ProtocolloAPI Messages compatibile con Anthropic
URL di basehttps://openapi.felo.ai/api
Modello di esempioclaude-sonnet-4-6
Chiave APILa 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-5

Verificare la configurazione

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

claude

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

Risoluzione dei problemi

ProblemaCosa controllare
L'autenticazione non funzionaVerifica che la chiave sia copiata correttamente ed esportata come FELO_API_KEY
Lo strumento chiama il provider sbagliatoControlla che il provider Felo sia selezionato per l'area di lavoro o la sessione corrente
Errore nell'URL di baseUsa 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 trovatoScegli un modello presente nel tuo elenco di modelli Felo
Lo strumento ignora la configurazione localeSposta le impostazioni del provider nella configurazione a livello utente se il client lo richiede

Passi successivi