OpenCodex: NordRouter di Codex CLI

OpenCodex adalah proksi lokal pihak ketiga untuk Codex dan Claude Code. Ia menerima permintaan Codex dalam format Responses API dan menerjemahkannya ke OpenAI-kompatibel dengan /chat/completions, jadi untuk Codex lebih dapat diandalkan daripada menghubungkan langsung ke NordRouter melalui /responses.

Saat Anda membutuhkannya

Gunakan OpenCodex jika Anda ingin menjalankan Codex CLI reguler dengan model NordRouter. Untuk OpenCode, Cline, Roo Code dan klien lain, proxy seperti itu tidak diperlukan: mereka terhubung ke NordRouter secara langsung.

OpenCodex bukan produk NordRouter atau OpenAI. Kode sumber dan rilis:lidge-jun/opencodex.

Instalasi

Membutuhkan Node.js 18 atau lebih baru. Instal OpenCodex secara global:

Instruksi telah diuji dengan versi 2.7.31:

npm install -g @bitkyc08/opencodex@2.7.31

Buat file konfigurasi:

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

Jangan tempelkan kunci ke dalam petunjuk atau tangkapan layar

Dalam contoh, kuncinya dibaca dari NORDROUTER_API_KEY dan bukan disimpan di JSON. OpenCodex berjalan secara lokal, namun masih memiliki akses ke kunci API Anda dan dapat mengubah konfigurasi Codex. Instal hanya dari repositori dan paket npm yang ditentukan.

Tetapkan kunci API

PowerShell, hanya untuk jendela saat ini:

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

macOS/Linux, hanya untuk terminal saat ini:

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

Jika OpenCodex berjalan sebagai layanan latar belakang, variabel harus dapat diakses oleh layanan tersebut, bukan hanya terminal saat ini.

Peluncuran

ocx start

ocx start berfungsi di terminal saat ini dan menyinkronkan model saat diluncurkan. Biarkan berjalan dan buka Codex di terminal kedua:

Panel OpenCodex tersedia secara lokal di http://localhost:10100. Secara default, proksi hanya mendengarkan 127.0.0.1; jangan mengubah alamat menjadi 0.0.0.0 kecuali Anda memerlukan akses dari perangkat lain.

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

Untuk model NordRouter, ID sumber berisi /. Dalam daftar Codex, OpenCodex menggantikan / internal dengan -, sehingga model anthropic/claude-sonnet-4.6 muncul sebagai nordrouter/anthropic-claude-sonnet-4.6. Permintaan ke NordRouter otomatis menyertakan ID asli.

Memeriksa dan memperbarui model

OpenCodex mendapatkan daftar model dari titik akhir aman NordRouter /v1/models. Setelah mengubah direktori, jalankan:

ocx sync

Jika model tidak muncul:

1. periksa apakah variabel NORDROUTER_API_KEY diatur di lingkungan yang sama;
2. periksa URL Dasar - URL tersebut harus berakhir tepat di /v1;
3. jalankan ocx doctor, lalu ocx sync;
4. pertama-tama periksa kuncinya dengan permintaan reguler darimulai cepat.

Dukungan untuk alat, gambar, dan tingkat penalaran bergantung pada model yang dipilih. OpenCodex menerjemahkan protokol, tetapi tidak menambahkan kemampuan yang tidak dimilikinya pada model.

Cara menghapus OpenCodex sepenuhnya

ocx uninstall
npm uninstall -g @bitkyc08/opencodex

Menurut dokumentasi proyek, ocx uninstall menghentikan proxy lokal, menghapus layanan dan shim, memulihkan konfigurasi Codex asli dan menghapus direktori ~/.opencodex.

Koneksi langsung Codex CLI·Semua program