Saltar para o conteúdo principal
Use este guia para executar o Codex CLI com o CometAPI como provider de modelo. Referências oficiais:
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

RequirementDetails
SOmacOS 12+, Linux (Ubuntu 20.04+ / Debian 10+), ou Windows 11 via WSL2
Node.js22+ (LTS recomendado)
Git2.23+ recomendado
Chave CometAPIObtenha 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.
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"

​
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

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