Saltar para o conteúdo principal
O Codex CLI (@openai/codex) é o agente de codificação de terminal da OpenAI. Versões recentes falam a OpenAI Responses API.
Protocolo: OpenAI Responses API
  • Base URL: https://api.orcarouter.ai/v1 (inclui /v1)
  • wire_api: deve ser "responses" — as builds atuais do Codex removeram o antigo valor "chat"
  • O OrcaRouter implementa /v1/responses, então funciona imediatamente

Instalação

npm install -g @openai/codex

Configuração

Edite ~/.codex/config.toml:
model = "orcarouter/auto"
model_provider = "orcarouter"

[model_providers.orcarouter]
name = "OrcaRouter"
base_url = "https://api.orcarouter.ai/v1"
wire_api = "responses"
env_key = "ORCA_KEY"
Depois exporte a chave a que a configuração se refere:
export ORCA_KEY="sk-orca-..."

Execução

codex exec --skip-git-repo-check "Reply with exactly: OK"

Notas

  • Os nomes de modelos usam o formato vendor/model; orcarouter/auto é o mais simples.
  • No Windows, o Codex roda sob o WSL2.
Extensão do VS Code: a extensão oficial do Codex da OpenAI executa o CLI dentro do editor e compartilha o mesmo ~/.codex/config.toml — sem configuração de endpoint separada no editor. (O Codex dentro do GitHub Copilot é um produto diferente que usa a própria conta do Copilot e não pode fazer BYOK para o OrcaRouter.)

Ativar thinking / raciocínio

Defina model_reasoning_effort em config.toml (minimal / low / medium / high / xhigh; padrão medium), ou escolha-o no menu /model em uma sessão interativa.