Codex CLI

Configure um provedor Responses e uma chave de API no shell para Codex CLI.

Instalação e preparação

  1. Instale o Node.js e depois a CLI oficial do Codex com o comando abaixo. Execute codex --version em um novo terminal.
  2. Crie uma chave em routerra.ai → Chaves de API. Escolha em Modelos um ID exato com suporte a Responses e ferramentas; modelos exclusivos de Chat Completions não funcionam nesta configuração.
npm install -g @openai/codex
codex --version

Definir o provedor TOML

  1. Edite ~/.codex/config.toml (Windows: %USERPROFILE%\.codex\config.toml) e mescle o TOML sem duplicar tabelas do provedor. model_provider deve corresponder a routerra; env_key contém o nome da variável, não o segredo. Substitua YOUR_MODEL_ID.
  2. Defina ROUTERRA_API_KEY no shell que inicia codex. A variável vale apenas nesse shell; salve-a no perfil se necessário. Este provedor usa sua própria chave em vez do login ChatGPT. Reinicie o Codex após editar o TOML.
model = "YOUR_MODEL_ID"
model_provider = "routerra"

[model_providers.routerra]
name = "routerra.ai"
base_url = "https://routerra.ai/v1"
env_key = "ROUTERRA_API_KEY"
wire_api = "responses"

Iniciar com a chave do provedor

Variável ausente significa que o Codex não herdou ROUTERRA_API_KEY; inicie-o daquele terminal. Um 404 em /responses exige conferir URL e protocolo: apenas um /v1 e wire_api = "responses". Se texto funciona mas listar arquivos falha, escolha um modelo com ferramentas. Confira a solicitação no uso do routerra.ai; iniciar a CLI não verifica o roteamento.

export ROUTERRA_API_KEY="YOUR_API_KEY"
codex

Para Windows PowerShell:

$env:ROUTERRA_API_KEY = "YOUR_API_KEY"
codex