opencodex — proxy lokal untuk memakai LLM apa pun di Codex

Codex hanya mendukung model OpenAI. Kalau ingin memakai Claude? Atau ingin ngoding dengan GLM-5.2? Harus menunggu sampai OpenAI menambahkannya.

opencodex adalah proxy lokal yang menyelesaikan masalah ini. Ia berada di antara Codex dan penyedia LLM, lalu menerjemahkan protokol secara real-time. Streaming, pemanggilan alat, token reasoning, gambar — semuanya bekerja dua arah.

Aplikasi Codex, CLI, SDK
terdaftar dengan normal di pemilih model
dan dalam satu sesi, GPT maupun semua model yang terdaftar bisa digunakan

npm install -g @bitkyc08/opencodex  
ocx init      # pilih provider  
ocx start     # mulai proxy  
codex -m "anthropic/claude-opus-4-8" "Tolong perbaiki bug ini"  

Cara kerjanya

Codex hanya memakai protokol miliknya sendiri, Responses API (/v1/responses). Sebagian besar LLM tidak mengimplementasikan ini. opencodex menerjemahkannya lewat 5 adapter protokol (Anthropic Messages, Google Gemini, Azure, OpenAI passthrough, OpenAI-compatible Chat Completions). Lebih dari 40 provider sudah dibangun secara bawaan.

Model yang dirutekan akan muncul di pemilih model Codex seperti model native. Cukup tentukan dengan format provider/model.

Hal yang sulit saat membuatnya

Desain proxy relatif mudah diimplementasikan karena ada banyak open source,
tetapi untuk menghadirkan pengalaman native Codex, membongkar codex-rs menjadi hal yang wajib.

Pemetaan reasoning effort. Nama effort berbeda di tiap provider. GLM memakai "max", sementara Codex menyebutnya "xhigh". Kimi bahkan menolak parameter ini sama sekali. Akhirnya harus dibuat tabel konversi terpisah untuk tiap model.

Riwayat sesi. Codex menyimpan model_provider tiap thread di DB. Saat beralih ke opencodex, semua sesi lama jadi tidak terlihat. Solusinya adalah membuat migrator yang langsung membuka SQLite dan mengubah tag model_provider saat inject/restore. mtime file juga dipertahankan agar urutan resume tidak berantakan.

Sidecar. Model selain OpenAI tidak bisa melakukan pencarian web atau memahami gambar. Fitur ini kemudian dirutekan lewat sidecar gpt-5.4-mini melalui login ChatGPT, sehingga Claude atau GLM juga bisa melakukan pencarian web sungguhan.

Jika dimatikan, kembali seperti semula

Jika menjalankan ocx stop, pengaturan Codex, katalog, dan riwayat sesi semuanya dipulihkan ke keadaan asli. Tidak ada sisa. Hasil yang sama juga bisa didapat dari tombol Stop di dashboard atau ocx service uninstall.

Lisensi MIT. Native untuk macOS/Linux/Windows (tidak perlu WSL).

GitHub: https://github.com/lidge-jun/opencodex
npm: npm install -g @bitkyc08/opencodex