Pular para o conteúdo principal
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.

Por que as solicitações falham com erros de endpoint ou protocolo?

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