opencodex — Codex’te herhangi bir LLM kullanmanızı sağlayan yerel proxy

Codex yalnızca OpenAI modellerini destekliyor. Claude kullanmak istiyorsanız? GLM-5.2 ile kod yazmak istiyorsanız? OpenAI bunu ekleyene kadar beklemeniz gerekiyor.

opencodex bu sorunu çözen yerel bir proxy. Codex ile LLM sağlayıcısı arasına girerek protokolü gerçek zamanlı çeviriyor. Streaming, araç çağrıları, reasoning token’ları, görseller — hepsi iki yönlü çalışıyor.

Codex uygulaması, CLI ve SDK
içindeki model seçicide düzgün şekilde kayıtlı görünür
ve tek bir oturum içinde hem GPT’yi hem de kayıtlı modellerin tamamını kullanabilirsiniz.

npm install -g @bitkyc08/opencodex  
ocx init      # sağlayıcı seç  
ocx start     # proxy’yi başlat  
codex -m "anthropic/claude-opus-4-8" "이 버그 고쳐줘"  

Nasıl çalışıyor

Codex yalnızca Responses API (/v1/responses) adlı kendi protokolünü kullanıyor. Çoğu LLM bunu uygulamıyor. opencodex bunu 5 protokol adaptörüyle çeviriyor: Anthropic Messages, Google Gemini, Azure, OpenAI passthrough ve OpenAI-compatible Chat Completions. Varsayılan olarak 40’tan fazla sağlayıcı yerleşik geliyor.

Yönlendirilen modeller, Codex model seçicisinde yerel modeller gibi görünür. provider/model biçiminde belirtmeniz yeterli.

Geliştirirken zor olanlar

Proxy tasarımı birçok açık kaynak örneği sayesinde uygulaması kolaydı,
ama Codex’in native deneyimini korumak için codex-rs’i parçalayıp analiz etmek şarttı.

reasoning effort eşlemesi. Sağlayıcıların effort adları farklı. GLM max kullanırken Codex buna xhigh diyor. Kimi ise bu parametreyi tamamen reddediyor. Model bazında ayrı dönüşüm tabloları oluşturmak gerekti.

Oturum geçmişi. Codex her thread’in model_provider bilgisini DB’ye kaydediyor. opencodex’e geçince mevcut oturumların hiçbiri görünmüyor. Bu yüzden SQLite’ı doğrudan açıp inject/restore sırasında model_provider etiketini değiştiren bir migrator yazıldı. Devam etme sırası bozulmasın diye dosya mtime bilgisi de korundu.

Sidecar. OpenAI dışındaki modeller web araması veya görsel anlama yapamıyor. Bu özellikleri ChatGPT girişi üzerinden gpt-5.4-mini sidecar’a yönlendirerek, Claude veya GLM ile de gerçek web araması yapılabilir hale getirildi.

Kapatınca her şey eski haline döner

ocx stop çalıştırıldığında Codex ayarları, katalog ve oturum geçmişi tamamen özgün haline geri yükleniyor. Geride hiçbir iz kalmıyor. Dashboard’daki Stop düğmesi veya ocx service uninstall da aynı sonucu veriyor.

MIT lisansı. macOS/Linux/Windows üzerinde native çalışır (WSL gerekmez).

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