Usar sua chave no Codex CLI

Configure um provedor de modelo personalizado em ~/.codex/config.toml com wire_api = responses, e escolha um modelo.

O Codex é o agente de programação da OpenAI (CLI e desktop). Ele aceita provedores de modelo personalizados — aponte um provedor para o OLETOKEN e ele usa sua chave e sua cota de modelos do OLETOKEN.

Antes de começar

Você já criou uma chave de API e guardou a chave completa.
Você escolheu um ID de modelo na vitrine de modelos.
Node.js e npm estão instalados.

Configuração

Um provedor personalizado deve ficar no ~/.codex/config.toml no nível do usuário. model_provider e model_providers em um .codex/config.toml de projeto são ignorados.

model = "gpt-5.6-terra"
model_provider = "oletoken"

[model_providers.oletoken]
name = "OleToken"
base_url = "https://<your-base-url>/v1"
env_key = "OLETOKEN_API_KEY"
wire_api = "responses"

Campo	Significado
`model`	ID do modelo padrão
`model_provider`	Aponta para o provedor definido abaixo
`base_url`	Endereço compatível com OpenAI, incluindo `/v1` (o Codex chama `{base_url}/responses`)
`env_key`	Nome da variável de ambiente que guarda a chave — a chave em si não fica no arquivo
`wire_api`	Hoje só `responses` é suportado

Exporte a chave e inicie:

export OLETOKEN_API_KEY="YOUR_API_KEY"   # adicione a ~/.zshrc ou ~/.bashrc para manter permanente
npm i -g @openai/codex
codex

A janela Início rápido na página de chaves de API oferece o download do mesmo script já preenchido com sua chave, seu modelo e sua Base URL: ele acrescenta o que estiver faltando e, se o config.toml já tiver model / model_provider, apenas imprime o bloco para você mesclar em vez de reescrever seu arquivo.

Solução de problemas

Sintoma	Causa e solução
401	`OLETOKEN_API_KEY` não foi exportada ou tem valor errado — o `env_key` apenas nomeia a variável, a chave precisa existir no ambiente
404	Falta `/v1` no `base_url`
Provedor ignorado	A configuração está em um `.codex/config.toml` de projeto; mova para `~/.codex/config.toml`
Model not found	O ID não está listado neste site; copie-o da vitrine de modelos
Saldo insuficiente	Adicione créditos primeiro

O wire_api só suporta responses, então o Codex envia requisições para {base_url}/responses — confirme que sua Base URL expõe esse endpoint (um 401 sem chave significa que a rota existe).