Com uma única API key da Capriole AI, você usa GPT-6.2 Astra e GPT-6.2 Sol no Codex pagando até 92% menos que os preços oficiais da API.
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:
- Uma conta Capriole AI (Cadastre-se aqui)
- Um plano Premium (USD 9 por mês, também inclui chat na web ilimitado) ou um plano Team, necessário para a API key (Assine)
- Uma API key da Capriole AI (Obtenha sua key)
Instalação
Codex CLI
Instale o Codex CLI com o instalador oficial:
Ou instale com npm:
Verifique a instalação:
Codex app
Baixe o aplicativo em OpenAI Codex.
Configuração
Validação dos modelos
O Codex CLI 0.169.1 passa nas verificações de leitura de arquivo, escrita de arquivo e resposta final pela Capriole AI com a configuração abaixo.
Crie ou atualize ~/.codex/config.toml:
O que cada configuração faz:
model é o modelo padrão. Altere-o com /model em uma sessão ou com --model na linha de comando.
model_provider seleciona o provedor Capriole AI definido logo abaixo.
base_url inclui /v1, porque o próprio Codex adiciona /responses.
wire_api = "responses" usa a API Responses, o único protocolo que o Codex suporta para provedores personalizados.
env_key lê sua key do ambiente e a envia como Bearer token.
Executar Codex
Defina sua API key e inicie o Codex no diretório do projeto:
Para uma execução não interativa, use codex exec:
Modelos suportados
O Codex usa os modelos OpenAI da Capriole AI pela API Responses. Use os IDs de modelo nativos abaixo com o seletor de modelos e as configurações de raciocínio integrados do Codex. Você não precisa de um model_catalog_json personalizado.
gpt-6.2-astra
gpt-6.2-sol
gpt-6-astra
gpt-6.1-sol
gpt-6-sol
gpt-6-luna
gpt-5.6-terra
gpt-5.6-luna
Use o Codex 0.169.1 ou posterior com gpt-6.2-astra e gpt-6.2-sol, e o 0.159.2 ou posterior com gpt-6.1-sol. Versões anteriores não incluem os metadados desses modelos e usam configurações genéricas.
A API também aceita as formas com o prefixo openai/ e openai-latest. O alias openai-latest acompanha o modelo principal da OpenAI recomendado pela Capriole AI.
O Codex também pode executar xai/grok-4.7 pelo mesmo provedor, porque a Capriole AI oferece o Grok na API Responses.
O Codex só tem metadados integrados para os IDs de modelo nativos da OpenAI. Para openai-latest e xai/grok-4.7, ele exibe Model metadata ... not found e usa configurações de fallback. A sessão continua funcionando, mas use um ID nativo, como gpt-6.2-astra, para ter os melhores resultados.
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 é um dos IDs listados em Modelos suportados.
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 integrado 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 novembro de 2026