O que é Codex
O Codex é o agente de programação da OpenAI para desenvolvimento de software. Ele pode usar a Capriole AI por meio de um provedor de modelo personalizado configurado para enviar solicitações à API compatível com Responses da Capriole AI.
Pré-requisitos
Antes de começar, confira se você tem:
Instalação
Codex CLI
Codex app
Baixe o aplicativo em OpenAI Codex.
Configuração
Crie ou atualize ~/.codex/config.toml:
Executar Codex
Defina sua API key e inicie o Codex:
Modelos suportados
O Codex suporta os modelos OpenAI da Capriole AI pela API Responses. Use openai-latest em configurações novas para a Capriole AI rotear o Codex ao modelo principal OpenAI que recomendamos, sem alterar a configuração.
openai-latestopenai/gpt-5.6-terraopenai/gpt-5.6-lunaopenai/gpt-5.5openai/gpt-5.4-mini
Solução de problemas
Por que o Codex retorna um erro de autenticação?
Confirme que CAPRIOLE_AI_API_KEY está exportada no mesmo shell antes de executar codex.
Por que o Codex não encontra o modelo?
Confirme que model_provider = "capriole_ai" está definido e que model é openai-latest ou um ID de modelo OpenAI suportado pela Capriole AI.
Confirme que base_url = "https://api.caprioletech.com/v1" e wire_api = "responses" estão definidos em [model_providers.capriole_ai].
Por que o Codex ignora o provedor Capriole AI?
Não use um ID de provedor interno reservado, como openai; mantenha o ID do provedor personalizado como capriole_ai.
Por que as mudanças de configuração não se aplicam?
Confirme que ~/.codex/config.toml é o arquivo de configuração ativo do usuário, confie no projeto antes de depender do .codex/config.toml no escopo do projeto e reinicie o Codex.
Observações
Última modificação em 18 de agosto de 2026
