Configuração de ferramentas de IA

Codex

Configure a Codex CLI com um provedor de modelos personalizado da Felo.

Use este guia quando quiser que o Codex CLI use o Felo API Platform para chamadas de modelo, mantendo o fluxo normal de terminal do Codex.

Antes de começar

Você precisa de uma chave do Felo API Platform. A mesma chave funciona em protocolos de modelo, clientes de agente e nas APIs Search, Web Fetch, PPT, Mindmap, LiveDocs, X Search, YouTube Subtitling, Landing Page e SuperAgent.

export FELO_API_KEY="YOUR_API_KEY"

Configuração recomendada

Item	Valor
Ideal para	fluxos de codificação na CLI, revisão de código, alterações em repositórios e automação não interativa
Protocolo	API Responses compatível com OpenAI
URL base	`https://openapi.felo.ai/api/v1`
Exemplo de modelo	`gpt-5.6-sol`
Chave de API	Sua `FELO_API_KEY`

Configure o Codex

Defina primeiro as variáveis de ambiente:

export FELO_API_KEY="YOUR_API_KEY"

Configuração do Codex no nível 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"
base_url = "https://openapi.felo.ai/api/v1"
env_key = "FELO_API_KEY"
wire_api = "responses"

As configurações de provedor do Codex devem ficar na configuração no nível do usuário. Não coloque chaves de API em arquivos de projeto.

Para uma verificação não interativa, execute:

codex exec --model gpt-5.6-sol "Review this repository and list the main files"

Verifique a configuração

Execute uma tarefa pequena depois de salvar a configuração:

codex --model gpt-5.6-sol

Se a ferramenta iniciar e responder com o modelo selecionado, a configuração do provedor está pronta.

Solução de problemas

Problema	O que verificar
A autenticação falha	Confirme que a chave foi copiada corretamente e exportada como `FELO_API_KEY`
A ferramenta chama o provedor errado	Verifique se o provedor Felo está selecionado no workspace ou na sessão atual
Erro de URL base	Use `https://openapi.felo.ai/api/v1` para clientes compatíveis com OpenAI e `https://openapi.felo.ai/api` para clientes compatíveis com Anthropic
Modelo não encontrado	Escolha um modelo que apareça na sua lista de modelos Felo
A ferramenta ignora a configuração local	Mova as configurações de provedor para a configuração no nível do usuário se o cliente exigir isso