Felo APIs

Configurazione di Claude Code e Codex

Configura Claude Code e Codex per instradare le chiamate ai modelli tramite Felo API Platform.

Questa guida mostra come configurare i client agente per usare la LLM API di Felo API Platform. Usa questa pagina quando vuoi che Claude Code o Codex instradino le chiamate ai modelli attraverso Felo API Platform invece di chiamare direttamente il fornitore di un modello.

Imposta FELO_API_KEY con la tua chiave di Felo API Platform prima di usare uno dei due client.

export FELO_API_KEY="YOUR_API_KEY"

Percorsi client supportati

Client o superficie API	Endpoint Felo consigliato	Modello di esempio	Note
Claude Code	`POST /api/v1/messages`	`claude-sonnet-4-6`	Claude Code usa il formato di rete Anthropic Messages.
Codex	`POST /api/v1/responses`	`gpt-5.6-sol`	I provider personalizzati di Codex dovrebbero usare la Responses API.
Chat Completions	`POST /api/v1/chat/completions`	`gpt-5.6-sol`	Da usare dagli SDK o dalle integrazioni lato server. Il supporto di Codex per Chat Completions è deprecato nella documentazione di Codex.

Claude Code

Claude Code dovrebbe usare l'endpoint Messages compatibile con Anthropic.

Claude Code può usare qualsiasi modello pubblicato elencato in Modelli e prezzi, compreso il nuovo claude-sonnet-5:

claude --model claude-sonnet-5

Configurazione della shell

export ANTHROPIC_API_KEY="$FELO_API_KEY"
export ANTHROPIC_BASE_URL="https://openapi.felo.ai/api"
export ANTHROPIC_MODEL="claude-sonnet-4-6"

claude

L'URL di base Anthropic omette intenzionalmente /v1, perché Claude Code e l'SDK Anthropic aggiungono /v1/messages all'host API configurato.

Configurazione tramite file di impostazioni

Usa un file di impostazioni di Claude Code quando vuoi che endpoint e modello si applichino a ogni avvio di claude. Tieni le chiavi API nella tua shell o nel tuo gestore di segreti invece di committarle nelle impostazioni del progetto.

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://openapi.felo.ai/api",
    "ANTHROPIC_MODEL": "claude-sonnet-4-6"
  }
}

Puoi anche scegliere il modello per una singola sessione:

claude --model claude-sonnet-4-6

Codex

Codex dovrebbe usare l'endpoint Responses compatibile con OpenAI. gpt-5.6-sol è il livello di punta GPT-5.6 per ragionamento complesso, programmazione e workflow agentici.

Configurazione utente

Aggiungi un provider Felo alla configurazione Codex a livello utente in ~/.codex/config.toml.

model_provider = "felo"
model = "gpt-5.6-sol"

[model_providers.felo]
name = "Felo API Platform LLM API"
base_url = "https://openapi.felo.ai/api/v1"
env_key = "FELO_API_KEY"
wire_api = "responses"

L'autenticazione dell'endpoint Codex e la scelta dell'endpoint devono risiedere nella configurazione Codex a livello utente. Codex ignora model_provider, model_providers e openai_base_url nei file .codex/config.toml con ambito di progetto.

Scelta del modello per una singola esecuzione

Dopo aver configurato il provider Felo, puoi scegliere il modello per una singola esecuzione CLI:

codex --model gpt-5.6-sol

Per esecuzioni non interattive:

codex exec --model gpt-5.6-sol "Review this change"