OpenCodex: NordRouter w Codex CLI

OpenCodex to zewnętrzny lokalny serwer proxy dla Codex i Claude Code. Akceptuje żądania Codexu w formacie Responses API i tłumaczy je na OpenAI-kompatybilny /chat/completions, więc w przypadku Codexu jest to bardziej niezawodne niż bezpośrednie połączenie z NordRouter przez /responses.

Kiedy tego potrzebujesz

Użyj OpenCodex, jeśli chcesz uruchomić zwykły interfejs CLI Codex z modelami NordRouter. W przypadku OpenCode, Cline, Roo Code i innych klientów taki serwer proxy nie jest potrzebny: łączą się bezpośrednio z NordRouter.

OpenCodex nie jest produktem NordRouter ani OpenAI. Kod źródłowy i wydania:lidge-jun/opencodex.

Instalacja

Wymaga Node.js 18 lub nowszego. Zainstaluj OpenCodex globalnie:

Instrukcje zostały przetestowane z wersją 2.7.31:

npm install -g @bitkyc08/opencodex@2.7.31

Utwórz plik konfiguracyjny:

• 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"
    }
  }
}

Nie wklejaj klucza do instrukcji lub zrzutu ekranu

W tym przykładzie klucz jest odczytywany z NORDROUTER_API_KEY, a nie przechowywany w formacie JSON. OpenCodex działa lokalnie, ale nadal ma dostęp do Twojego klucza API i może zmieniać konfigurację Codexu. Zainstaluj go tylko z określonego repozytorium i pakietu npm.

Ustaw klucz API

PowerShell, tylko dla bieżącego okna:

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

macOS/Linux, tylko dla bieżącego terminala:

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

Jeśli OpenCodex działa jako usługa w tle, zmienna musi być dostępna dla tej usługi, a nie tylko dla bieżącego terminala.

Uruchom

ocx start

ocx start działa w bieżącym terminalu i synchronizuje modele po uruchomieniu. Pozostaw to uruchomione i otwórz Kodeks w drugim terminalu:

Panel OpenCodex jest dostępny lokalnie pod adresem http://localhost:10100. Domyślnie serwer proxy nasłuchuje tylko 127.0.0.1; nie zmieniaj adresu na 0.0.0.0, chyba że potrzebujesz dostępu z innych urządzeń.

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

W przypadku modeli NordRouter identyfikator źródła zawiera /. Na liście Kodeksu OpenCodex zastępuje wewnętrzny / -, więc model anthropic/claude-sonnet-4.6 pojawia się jako nordrouter/anthropic-claude-sonnet-4.6. Żądanie do NordRouter automatycznie zawiera oryginalny identyfikator.

Sprawdzanie i aktualizacja modeli

OpenCodex pobiera listę modeli z bezpiecznego punktu końcowego NordRouter /v1/models. Po zmianie katalogu uruchom:

ocx sync

Jeśli modele się nie pojawią:

1. sprawdź, czy zmienna NORDROUTER_API_KEY jest ustawiona w tym samym środowisku;
2. sprawdź Base URL - powinien kończyć się dokładnie na /v1;
3. wykonaj ocx doctor, następnie ocx sync;
4. najpierw sprawdź klucz za pomocą zwykłego zapytania zszybki start.

Obsługa narzędzi, obrazów i poziomów rozumowania zależy od wybranego modelu. OpenCodex tłumaczy protokół, ale nie dodaje do modelu możliwości, których nie posiada.

Jak całkowicie usunąć OpenCodex

ocx uninstall
npm uninstall -g @bitkyc08/opencodex

Zgodnie z dokumentacją projektu ocx uninstall zatrzymuje lokalne proxy, usuwa usługę i podkładkę, przywraca pierwotną konfigurację Codexu oraz usuwa katalog ~/.opencodex.

Bezpośrednie połączenie Codex CLI·Wszystkie programy