Опенкодекс: NordRouter в Кодекс CLI

OpenCodex є локальним проксим для Кодекса і Клод Коду. Він приймає запити Кодекса в форматі API-отчетів і переводить їх на OpenAI-compatible /chat/completions, тому для Кодекса це більш надійне пряме підключення до NordRouter через /responses.

Коли це потрібно, то це потрібно.

Використовуйте OpenCodex, якщо ви хочете запустити звичайний Codex CLI з моделями NordRouter. Для OpenCode, Cline, Roo Code і інших клієнтів такий прокси не потрібен: вони підключаються до NordRouter безпосередньо.

OpenCodex не є продуктом NordRouter або OpenAI.lidge-jun/opencodex.

Установка

Потрібно Node.js 18 або новітні.

Інструкція перевірена з версією 2.7.31::

npm install -g @bitkyc08/opencodex@2.7.31

Створюйте файл конфігурації:

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

Не вставляйте ключ у інструкцію або скриншот.

У прикладі ключ читається з NORDROUTER_API_KEY, а не зберігається в JSON. OpenCodex працює локально, але все одно отримує доступ до вашого API-ключа і може змінити конфігурацію Codex.

Задайте API-ключ

PowerShell, тільки для поточного вікна:

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

MacOS/Linux, тільки для поточного терміналу:

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

Якщо OpenCodex запущується як фоновий сервіс, переменна повинна бути доступна саме цій сервісі, а не тільки поточному терміналу.

Запуск Запуск

ocx start

ocx start працює в поточному терміналі і при запуску сама синхронізує моделі.

Панель OpenCodex доступна локально на http://localhost:10100. По замовчуванням прокси слухає тільки 127.0.0.1; не змінюйте адресу на 0.0.0.0, якщо вам не потрібен доступ з інших пристроїв.

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

У моделях NordRouter вихідний ID містить /. У списку Codex OpenCodex замінює внутрішній / на -, тому модель anthropic/claude-sonnet-4.6 відображається як nordrouter/anthropic-claude-sonnet-4.6.

Проверка і оновлення моделей

OpenCodex отримує список моделей з захищеного кінцевого пункту NordRouter /v1/models. Після зміни каталогу виконайте:

ocx sync

Якщо моделі не з'явилися:

1. Перевірте, що змінна NORDROUTER_API_KEY задана в тому ж середовищі;
2. Перевірте базовий URL, він повинен закінчитися прямо на /v1;
3. Виконайте ocx doctor, а потім ocx sync;
4. Спочатку перевіріть ключ звичайним запитом з.швидкий старт..

Підтримка інструментів, зображень і рівня розсуддя залежить від обраної моделі.OpenCodex перекладає протокол, але не додає моделі можливостей, яких у нього немає.

Як повністю видалити OpenCodex

ocx uninstall
npm uninstall -g @bitkyc08/opencodex

Згідно з документацією проекту, ocx uninstall зупиняє локальний прокси, видаляє сервіс і shim, відновлює початкову конфігурацію Codex і видаляє каталог ~/.opencodex.

Пряма підключення до Кодекс CLI·Всі програми