OpenAI Codex CLI

O agente de codificação em terminal oficial da OpenAI. Como ele fala a API padrão da OpenAI, as mesmas duas variáveis de ambiente desbloqueiam todas as ferramentas compatíveis com OpenAI do ecossistema — uma vez que o Codex funciona, Aider / Continue / LangChain / a CLI openai pura também funcionam.

Antes de começar

Crie uma chave API em Console → API Keys. Copie-a imediatamente — ela é exibida apenas uma vez.

Passo 1 — Definir as variáveis de ambiente

# ~/.zshrc (or equivalent)
export OPENAI_BASE_URL="https://synthorai.io/v1"
export OPENAI_API_KEY="sk-..."   # your Synthorai key

⚠

A base URL compatível com OpenAI deve terminar em /v1. Ao contrário do SDK da Anthropic, o SDK da OpenAI não o adiciona automaticamente. Um erro comum é colar https://synthorai.io; as requisições atingirão então /chat/completions (404) em vez de /v1/chat/completions.

Passo 2 — Envie sua primeira requisição

# Open a new shell so env vars take effect, then:
codex exec -m gpt-5.4-mini "refactor this function for readability" < src/foo.py

# Or for long reasoning-heavy tasks:
codex exec -m gpt-5.3-codex "implement unit tests for bar()"

A mesma configuração funciona para o openai CLI, os SDKs Python/Node, Aider e qualquer outra ferramenta compatível com OpenAI — todos leem OPENAI_BASE_URL e OPENAI_API_KEY.

Modelos recomendados

Parâmetro	Tipo	Descrição
`gpt-5.3-codex`	`coding`	Otimizado para geração de código. Escolha padrão para o Codex CLI.
`gpt-5.4`	`reasoning`	Raciocínio principal. Use para refatorações em nível de arquitetura.
`gpt-5.4-mini`	`fast`	Rápido, barato e ainda muito capaz. Boa escolha padrão para tarefas curtas.
`gpt-5.4-nano`	`cheapest`	A opção mais barata da OpenAI. Use para edições pequenas e classificação.

Solução de problemas

"404 Not Found" em /chat/completions — seu OPENAI_BASE_URL está sem o /v1 sufixo. Correção: export OPENAI_BASE_URL="https://synthorai.io/v1".

"Ainda atingindo api.openai.com" — as novas variáveis de ambiente só se aplicam a novos shells. Abra um novo terminal, ou source seu perfil.

"Modelo não encontrado" — curl $OPENAI_BASE_URL/models -H "Authorization: Bearer $OPENAI_API_KEY" para ver a lista exata disponível para o seu workspace.

Substituição por projeto — se você não quiser essas variáveis globalmente, coloque-as em um projeto .envrc (com direnv) ou uma função por shell.

Veja como os quatro níveis se comparam em preço na model price comparison.