Codex CLI

Configure o OpenAI Codex CLI com o CometAPI: defina openai_base_url ou um provider personalizado em config.toml, armazene sua chave de API em auth.json e comece a programar com um modelo atual.

Use este guia para executar o Codex CLI com o CometAPI como provider de modelo.

Referências oficiais:

• Codex CLI README
• Codex Authentication
• Codex Advanced Configuration

A disponibilidade dos modelos muda com frequência. Os exemplos abaixo usam your-model-id — substitua por um ID de modelo atual adequado para programação na página de Models do CometAPI.

​

Pré-requisitos

Requirement	Details
SO	macOS 12+, Linux (Ubuntu 20.04+ / Debian 10+), ou Windows 11 via WSL2
Node.js	22+ (LTS recomendado)
Git	2.23+ recomendado
Chave CometAPI	Obtenha uma no CometAPI Dashboard (começa com sk-)

​

Instalar o Codex CLI

npm i -g @openai/codex

Ou via Homebrew:

brew install --cask codex

Verifique a instalação:

codex --version

​

Configurar o CometAPI

Há duas maneiras de direcionar o Codex para o CometAPI. Escolha a que melhor se adapta ao seu fluxo de trabalho.

Simple: openai_base_url

A opção mais fácil — redireciona o provider OpenAI integrado para o CometAPI com uma única linha. Não é necessário definir um provider personalizado.

Crie ~/.codex/config.toml:

model = "your-model-id"
openai_base_url = "https://api.cometapi.com/v1"

Named provider

Defina um provider nomeado cometapi. Útil quando você deseja alternar entre vários providers usando --profile ou model_provider.

Crie ~/.codex/config.toml:

model = "your-model-id"
model_provider = "cometapi"

[model_providers.cometapi]
name = "CometAPI"
base_url = "https://api.cometapi.com/v1"
env_key = "OPENAI_API_KEY"

env_key informa ao Codex qual variável de ambiente contém sua chave de API. O Codex lê o valor de OPENAI_API_KEY em tempo de execução — esta não é sua chave real.

​

Armazene sua chave de API

Crie ~/.codex/auth.json:

{
  "OPENAI_API_KEY": "sk-your-cometapi-key"
}

Substitua sk-your-cometapi-key pela sua chave real do CometAPI.

Este arquivo é obrigatório. Sem uma entrada válida OPENAI_API_KEY em auth.json, o Codex encerra com API key auth is missing a key.

​

Iniciar o Codex

cd your-project
codex

Na primeira execução, o Codex solicitará que você escolha um tema e confirme as configurações de segurança.

​

Substituir o modelo por sessão

Alterne para um modelo diferente em uma única execução sem editar config.toml:

codex --model your-model-id

​

Alternativa: variável de ambiente

Em vez de auth.json, exporte a chave diretamente:

export OPENAI_API_KEY="sk-your-cometapi-key"
codex

Isso define a chave apenas para a sessão atual do terminal. Para persistência, adicione a linha export a ~/.zshrc ou ~/.bashrc.

​

Solução de problemas

Symptom	Fix
API key auth is missing a key	Verifique se ~/.codex/auth.json contém "OPENAI_API_KEY": "sk-..."
O prompt de login aparece inesperadamente	Exclua o ~/.codex/auth.json antigo e recrie-o com sua chave do CometAPI
Modelo não encontrado	Consulte a página de Models para ver os modelos atualmente disponíveis
Tempo limite de conexão	Confirme se openai_base_url ou base_url é https://api.cometapi.com/v1 em config.toml
Problemas no Windows	O Codex exige WSL2 no Windows — CMD/PowerShell nativo não é compatível