Felo APIs

Configuração do Claude Code e do Codex

Configure o Claude Code e o Codex para encaminhar chamadas de modelos pela Felo API Platform.

Este guia mostra como configurar clientes de agente para usar a LLM API do Felo API Platform. Use esta página quando quiser que o Claude Code ou o Codex encaminhem chamadas de modelo pelo Felo API Platform em vez de chamar um fornecedor de modelo diretamente.

Defina FELO_API_KEY com sua chave do Felo API Platform antes de usar qualquer um dos clientes.

export FELO_API_KEY="YOUR_API_KEY"

Caminhos de cliente compatíveis

Cliente ou superfície de API	Endpoint Felo recomendado	Exemplo de modelo	Observações
Claude Code	`POST /api/v1/messages`	`claude-sonnet-4-6`	O Claude Code usa o formato de rede Anthropic Messages.
Codex	`POST /api/v1/responses`	`gpt-5.6-sol`	Provedores personalizados do Codex devem usar a Responses API.
Chat Completions	`POST /api/v1/chat/completions`	`gpt-5.6-sol`	Use em SDKs ou integrações do lado do servidor. O suporte a Chat Completions no Codex está marcado como obsoleto na documentação do Codex.

Claude Code

O Claude Code deve usar o endpoint Messages compatível com Anthropic.

O Claude Code pode usar qualquer modelo publicado listado em Modelos e preços, incluindo o recém-disponível claude-sonnet-5:

claude --model claude-sonnet-5

Configuração do 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

A URL base da Anthropic omite /v1 de propósito, porque o Claude Code e o SDK da Anthropic acrescentam /v1/messages ao host de API configurado.

Configuração por arquivo de configurações

Use um arquivo de configurações do Claude Code quando quiser que o endpoint e o modelo valham sempre que claude iniciar. Mantenha as chaves de API no seu shell ou gerenciador de segredos em vez de fazer commit delas nas configurações do projeto.

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

Você também pode escolher o modelo para uma única sessão:

claude --model claude-sonnet-4-6

Codex

O Codex deve usar o endpoint Responses compatível com OpenAI. gpt-5.6-sol é o nível principal do GPT-5.6 para raciocínio complexo, codificação e fluxos com agentes.

Configuração do usuário

Adicione um provedor Felo à sua configuração do Codex no nível do usuário, em ~/.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"

A autenticação e a seleção de endpoint do Codex devem ficar na configuração do Codex no nível do usuário. O Codex ignora model_provider, model_providers e openai_base_url de arquivos .codex/config.toml no escopo do projeto.

Seleção de modelo pontual

Depois que o provedor Felo estiver configurado, você pode escolher o modelo para uma única execução na CLI:

codex --model gpt-5.6-sol

Para execuções não interativas:

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