opencodex — Ein lokaler Proxy, mit dem sich in Codex jedes beliebige LLM nutzen lässt

Codex funktioniert nur mit OpenAI-Modellen. Du willst Claude verwenden? Du willst mit GLM-5.2 coden? Dann musst du warten, bis OpenAI es hinzufügt.

opencodex ist ein lokaler Proxy, der dieses Problem löst. Er sitzt zwischen Codex und dem LLM-Provider und übersetzt das Protokoll in Echtzeit. Streaming, Tool-Calling, Reasoning-Tokens, Bilder — alles funktioniert bidirektional.

In der Modellauswahl von
Codex-App, CLI und SDK
erscheint es ganz normal,
und innerhalb einer Sitzung lassen sich sowohl GPT als auch alle registrierten Modelle verwenden.

npm install -g @bitkyc08/opencodex  
ocx init      # Provider auswählen  
ocx start     # Proxy starten  
codex -m "anthropic/claude-opus-4-8" "Bitte behebe diesen Bug"  

Wie es funktioniert

Codex verwendet ausschließlich sein eigenes Protokoll namens Responses API (/v1/responses). Die meisten LLMs implementieren das nicht. opencodex übersetzt es mit fünf Protokoll-Adaptern (Anthropic Messages, Google Gemini, Azure, OpenAI passthrough, OpenAI-compatible Chat Completions). Mehr als 40 Provider sind standardmäßig integriert.

Geroutete Modelle erscheinen in der Codex-Modellauswahl wie native Modelle. Sie werden im Format provider/model angegeben.

Was beim Entwickeln schwierig war

Das Proxy-Design ließ sich dank vieler Open-Source-Projekte leicht umsetzen,
aber für ein natives Codex-Erlebnis war es unverzichtbar, codex-rs auseinanderzunehmen.

Mapping des reasoning effort. Je nach Provider heißen die Effort-Stufen anders. GLM verwendet "max", Codex nennt es "xhigh". Kimi lehnt diesen Parameter komplett ab. Deshalb mussten für jedes Modell eigene Umwandlungstabellen erstellt werden.

Sitzungsverlauf. Codex speichert den model_provider jedes Threads in der Datenbank. Wechselt man zu opencodex, sind alle bestehenden Sitzungen plötzlich unsichtbar. Deshalb wurde ein Migrator gebaut, der SQLite direkt öffnet und beim Inject/Restore den Tag model_provider ändert. Die Datei-mtime bleibt erhalten, damit die Reihenfolge beim Fortsetzen nicht durcheinandergerät.

Sidecar. Modelle, die nicht von OpenAI stammen, können keine Websuche oder Bilderkennung. Über einen ChatGPT-Login wurde diese Funktion über ein gpt-5.4-mini-Sidecar geroutet, sodass echte Websuche auch in Claude oder GLM funktioniert.

Nach dem Deaktivieren wieder wie zuvor

Wenn man ocx stop ausführt, werden Codex-Einstellungen, Katalog und Sitzungsverlauf vollständig auf den Originalzustand zurückgesetzt. Es bleiben keine Reste zurück. Dasselbe Ergebnis erhält man auch über den Stop-Button im Dashboard oder mit ocx service uninstall.

MIT-Lizenz. Nativ für macOS/Linux/Windows (WSL nicht erforderlich).

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