Codex CLI
Configure o OpenAI Codex CLI para usar o endpoint Model Gate Responses.
Codex CLI através do Model Gate
Codex usa o protocolo OpenAI Responses. Seu provedor base_url inclui /v1.
1. Instale o Codex
npm install -g @openai/codex
codex --version
Verifique as instruções oficiais atuais de instalação em https://developers.openai.com/codex/.
2. Configure o provedor
Editar:
-Linux ou MacOS: ~/.codex/config.toml - Janelas: %USERPROFILE%\.codex\config.toml
model = "gpt-5.4"
model_provider = "model_gate"
model_reasoning_effort = "high"
[model_providers.model_gate] name = "Model Gate" base_url = "https://api.model-gate.com/v1" wire_api = "responses" env_key = "MODEL_GATE_API_KEY" ```
wire_api = "responses" envia solicitações para /v1/responses.
3. Defina a chave API
Linux ou macOS
export MODEL_GATE_API_KEY="mg_live_..."
Para torná-lo permanente, adicione a exportação ao seu perfil shell ou gerenciador de segredos.
Windows PowerShell
[Environment]::SetEnvironmentVariable(
"MODEL_GATE_API_KEY",
"mg_live_...",
"User"
)
Abra um novo terminal após definir uma variável persistente.
4. Inicie o Codex
codex
Esforço de raciocínio
model_reasoning_effort = "low"
- low: mais rápido e mais curto. - medium: equilibrado. - high: mais completo para trabalhos complexos.
O modelo upstream deve suportar os controles de raciocínio solicitados.
Solução de problemas
| Problema | Resolução |
|---|---|
| Erro de autenticação | Confirmar MODEL_GATE_API_KEY é visível no mesmo terminal. |
| Codex usa OpenAI diretamente | Confirmar model_provider = "model_gate" e o nome da seção do provedor corresponde. |
| Ponto de extremidade não compatível | Confirmar wire_api = "responses" e base_url termina com /v1. |
| Modelo não encontrado | Consulta /v1/models e use um ID canônico ou alias habilitado. |
Não defina requires_openai_auth = true para este provedor: essa opção seleciona a autenticação da conta OpenAI em vez da autenticação personalizada env_key.