Buscar documentação...

Comece a digitar para buscar documentação

Codex
Codex CLI

Guia de configuração OpenAI Codex CLI

Guia passo a passo para instalar e configurar Codex CLI com UnoRouter no Windows, macOS e Linux.

Visao geral

O OpenAI Codex CLI e um agente de codificacao baseado em terminal que le, escreve e executa codigo a partir da sua linha de comando. Aponte-o para o UnoRouter como um provedor compativel com OpenAI personalizado e use todos os modelos disponiveis com uma unica chave de API.

Configuracao rapida

Coloque esses valores no cliente. Sua chave e preenchida automaticamente quando voce esta conectado.

text
URL base: https://api.unorouter.ai/v1
Chave da API: YOUR_API_KEY

Entre para preencher automaticamente sua chave API

Compatibilidade

Chat CompletionsAPI ResponsesStreamingChamada de ferramentas

Configuracao passo a passo

  1. 1
    Instalar a CLI do Codex

    Instale a CLI do Codex globalmente com npm.

  2. 2
    Configurar o provedor de modelo

    Edite `~/.codex/config.toml` para apontar o Codex para o UnoRouter. Defina o ID do seu modelo e adicione um provedor personalizado com a URL base do UnoRouter usando a wire API responses.

    toml
    # ~/.codex/config.toml
    model = "YOUR_MODEL_ID"
    
    [model_providers.custom]
    base_url = "https://api.unorouter.ai/v1"
    wire_api = "responses"

    Entre para preencher automaticamente sua chave API

  3. 3
    Adicionar sua chave de API

    Escreva sua chave de API do UnoRouter em `~/.codex/auth.json` para que o Codex autentique cada requisição.

    json
    // ~/.codex/auth.json
    {
      "OPENAI_API_KEY": "YOUR_API_KEY"
    }

    Entre para preencher automaticamente sua chave API

  4. 4
    Iniciar o Codex

    Execute `codex` no diretório do seu projeto e comece a programar.

powershell
$env:OPENAI_BASE_URL="https://api.unorouter.ai/v1"
$env:OPENAI_API_KEY="YOUR_API_KEY"

codex

Entre para preencher automaticamente sua chave API

Modelos recomendados

Modelos gratuitos que funcionam bem aqui. Cole qualquer id de modelo no cliente.

gemini-flash-lite-latestmistral-vibe-cli-latestallam-2-7bgemini-3.1-flash-liteglm-4.5-air

Pontos de atencao

  • Se o Codex relatar um endpoint não suportado, confirme que `wire_api` está definido como `responses` e que a URL base termina em `/v1`.
  • Um 401 significa que a chave em `~/.codex/auth.json` está ausente ou desatualizada. Cole uma chave nova do seu painel do UnoRouter e execute novamente.
Gerar chave APIModelos