Skip to main content

​
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 usa os modelos OpenAI da Capriole AI pela API Responses. Use os IDs 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. Só é possível chamar modelos compatíveis com a Capriole AI.
  • gpt-6-astra
  • gpt-6.1-sol
  • gpt-6-sol
  • gpt-6-luna
  • gpt-5.6-terra
  • gpt-5.6-luna
  • gpt-5.5
Use o Codex 0.159.2 ou posterior com gpt-6.1-sol. Versões anteriores não incluem os metadados desse modelo e usam configurações genéricas. A API também aceita os IDs com o prefixo openai/ e openai-latest. O alias openai-latest acompanha o modelo principal da OpenAI recomendado pela Capriole AI.

​
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.

​
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 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 30 de setembro de 2026