OpenCodex: NordRouter na CLI do Codex

OpenCodex é um proxy local de terceiros para Codex e Claude Code. Ele aceita solicitações do Codex no formato da API de respostas e as traduz para OpenAI-compatível com /chat/completions, portanto, para o Codex é mais confiável do que conectar-se diretamente a NordRouter via /responses.

Quando você precisar

Use OpenCodex se desejar executar a CLI regular do Codex com modelos NordRouter. Para OpenCode, Cline, Roo Code e outros clientes, tal proxy não é necessário: eles se conectam diretamente a NordRouter.

OpenCodex não é um produto de NordRouter ou OpenAI. Código fonte e versões:lidge-jun/opencodex.

Instalação

Requer Node.js 18 ou posterior. Instale o OpenCodex globalmente:

As instruções foram testadas com a versão 2.7.31:

npm install -g @bitkyc08/opencodex@2.7.31

Crie um arquivo de configuração:

• Windows: %USERPROFILE%\.opencodex\config.json;
• macOS/Linux: ~/.opencodex/config.json.

{
  "port": 10100,
  "defaultProvider": "nordrouter",
  "providers": {
    "nordrouter": {
      "adapter": "openai-chat",
      "baseUrl": "https://nordrouter.com/v1",
      "authMode": "key",
      "apiKey": "${NORDROUTER_API_KEY}",
      "defaultModel": "anthropic/claude-sonnet-4.6"
    }
  }
}

Não cole a chave nas instruções ou na captura de tela

No exemplo, a chave é lida em NORDROUTER_API_KEY em vez de armazenada em JSON. OpenCodex é executado localmente, mas ainda tem acesso à sua chave de API e pode alterar a configuração do Codex. Instale-o apenas a partir do repositório especificado e do pacote npm.

Defina a chave API

PowerShell, apenas para a janela atual:

$env:NORDROUTER_API_KEY = "sk-nr-ВАШ-КЛЮЧ"

macOS/Linux, apenas para o terminal atual:

export NORDROUTER_API_KEY="sk-nr-ВАШ-КЛЮЧ"

Se o OpenCodex estiver sendo executado como um serviço em segundo plano, a variável deverá estar acessível a esse serviço, não apenas ao terminal atual.

Lançamento

ocx start

ocx start funciona no terminal atual e sincroniza os modelos quando iniciado. Deixe-o rodando e abra o Codex em um segundo terminal:

O painel OpenCodex está disponível localmente em http://localhost:10100. Por padrão, o proxy escuta apenas 127.0.0.1; não altere o endereço para 0.0.0.0, a menos que precise de acesso de outros dispositivos.

codex -m "nordrouter/anthropic-claude-sonnet-4.6"

Para modelos NordRouter, o ID de origem contém /. Na lista do Codex, o OpenCodex substitui / interno por -, então o modelo anthropic/claude-sonnet-4.6 aparece como nordrouter/anthropic-claude-sonnet-4.6. A solicitação para NordRouter inclui automaticamente o ID original.

Verificando e atualizando modelos

OpenCodex obtém a lista de modelos do endpoint seguro NordRouter /v1/models. Após alterar o diretório, execute:

ocx sync

Se os modelos não aparecerem:

1. verifique se a variável NORDROUTER_API_KEY está configurada no mesmo ambiente;
2. verifique a URL base - ela deve terminar exatamente em /v1;
3. execute ocx doctor e, em seguida, ocx sync;
4. primeiro verifique a chave com uma consulta regular deinício rápido.

O suporte para ferramentas, imagens e níveis de raciocínio depende do modelo selecionado. OpenCodex traduz o protocolo, mas não adiciona recursos ao modelo que ele não possui.

Como remover completamente o OpenCodex

ocx uninstall
npm uninstall -g @bitkyc08/opencodex

De acordo com a documentação do projeto, ocx uninstall interrompe o proxy local, remove o serviço e a correção, restaura a configuração original do Codex e exclui o diretório ~/.opencodex.

Conexão direta Codex CLI·Todos os programas