1. Projektübersicht
OpenCodex ist ein leichtgewichtiger lokaler Proxy, der Entwicklern ermöglicht, jedes große Sprachmodell — Claude, Gemini, Grok, GLM, DeepSeek, Kimi, Qwen, Ollama und mehr — über Coding-Assistenten wie Codex, Claude Code, Claude Desktop und Grok Build zu leiten, die sonst an einen einzigen Anbieter gebunden sind.
2. Hintergrund & Positionierung
Proprietäre Coding-Assistenten sind in der Regel fest mit einem Modellanbieter verdrahtet, was Entwickler dazu zwingt, einen einzigen Anbieter für ihren gesamten Workflow zu wählen, selbst wenn ein anderes Modell für eine bestimmte Aufgabe besser geeignet wäre. OpenCodex wurde entwickelt, um diese Bindung zu beseitigen: Es fungiert als universeller Adapter, der API-Anfragen zwischen Anbieterformaten übersetzt und dabei die Feature-Parität für Streaming-Antworten, Tool-Aufrufe, Reasoning-Tokens und Bildeingaben bewahrt.
Im Gegensatz zu einfachen API-Schlüssel-Wechslern oder Single-Provider-Wrappern konzentriert sich OpenCodex auf die Übersetzung auf Protokollebene (Konvertierung in das Responses-API-Format und zurück), Multi-Account-Pooling mit Kontingentbewusstsein und operative Werkzeuge (Web-Dashboard, Hintergrunddienstverwaltung, Health-Checks) — was es eher zu einem kleinen selbst gehosteten Gateway als zu einem Einweg-Skript macht.
3. Funktionskategorien
🔀 Modell-Routing — 40+ Anbieter, unbegrenzte Modelle
Leiten Sie jeden konfigurierten Anbieter und jedes Modell mit einfacher provider/model-Syntax. Repräsentative Beispiele: anthropic/claude-opus-5, OpenAI, Google, xAI und benutzerdefinierte OpenAI-kompatible Endpunkte. Zweck: Einem Coding-Assistenten ermöglichen, jedes Backend-Modell ohne Codeänderungen aufzurufen.
👥 Kontenverwaltung — Pooling über ChatGPT/Codex-Konten
Bündelt mehrere ChatGPT/Codex-Konten, verfolgt die Kontingentnutzung und behält die Thread-Affinität bei, sodass ein Gespräch mitten im Verlauf nicht das Konto wechselt. Enthält Auto-Routing-Richtlinien für geringste Nutzung, Round-Robin und Füllen-zuerst. Zweck: Durchsatz maximieren und Rate-Limit-Unterbrechungen über Konten hinweg vermeiden.
🛡️ Zuverlässigkeitsfunktionen — Failover und Redundanz
Gewichtete Round-Robin-"Kombos" und automatisches Failover über Modelle hinweg, plus Sub-Agent-Unterstützung, die dieselben Routing-Regeln erbt. Zweck: Coding-Sitzungen am Laufen halten, auch wenn ein Anbieter oder Konto nicht verfügbar wird.
🔑 Authentifizierung & Erweiterungen — OAuth- und Sidecar-Fähigkeiten
Native OAuth-Integration für xAI, Anthropic und Kimi, plus Websuche und Bildunterstützung für Nicht-OpenAI-Modelle über ChatGPT-Sidecars. Zweck: OpenAI-exklusive Funktionen (wie Bildverarbeitung oder Websuche) anderen Anbietern zugänglich machen.
⚙️ Betrieb — Dashboard und Dienstverwaltung
Web-Dashboard unter localhost:10100, systemd/launchd/Task-Scheduler-Dienstintegration und Health-/Readiness-Endpunkte. Zweck: OpenCodex als persistenten, überwachbaren lokalen Dienst ausführen und nicht als einmaligen CLI-Aufruf.
4. Hauptmerkmale
- Anbieterunabhängiges Routing — das zugrunde liegende Modell mit einem
provider/model-String austauschen, ohne Neukonfiguration auf Assistentenseite. - Übersetzung mit Feature-Parität — Streaming, Tool-Aufrufe, Reasoning-Tokens und Bilder bleiben bei Formatkonvertierungen zwischen Anbietern erhalten, nicht nur reiner Text.
- Kontingentbewusstes Konten-Pooling — verteilt die Last automatisch über mehrere ChatGPT/Codex-Konten mit konfigurierbaren Routing-Richtlinien.
- Speicherbegrenzte Zustandsverwaltung — byte-kontierte Speicher mit Verdrängungsrichtlinien, 60-Sekunden-Ablaufprüfungen und generationsbasierter Abgleich, um veraltete Daten zu vermeiden.
- Plattformübergreifende native Dienste — Installation als ordentlicher Hintergrunddienst auf macOS, Linux und Windows, nicht nur als Vordergrundprozess.
- Integriertes Web-Dashboard — Konfiguration von Anbietern, Konten und Kombos über eine lokale Benutzeroberfläche statt manueller Bearbeitung von Konfigurationsdateien.
5. Anwendungsfälle nach Rolle
Allgemeine Entwickler — Verwenden Sie das Modell, das zur Aufgabe passt (z. B. ein günstigeres Modell für Standardcode, ein stärkeres Modell für schwierige Fehler) im selben Coding-Assistenten, ohne Werkzeuge zu wechseln.
DevOps/SRE — Führen Sie OpenCodex als verwalteten Hintergrunddienst mit Health-/Readiness-Endpunkten zur Überwachung aus und nutzen Sie Failover-Kombos, um Coding-Assistenten während Anbieterausfällen verfügbar zu halten.
Projektmanager — Bündeln Sie Team-ChatGPT/Codex-Konten mit Kontingentverfolgung, um Nutzung und Kosten im Team ohne manuelle Koordination zu kontrollieren.
6. Erste Schritte
Finden Sie, was Sie brauchen
Durchsuchen Sie die Dokumentationsseite nach Anbieter-Setup-Anleitungen und Konfigurationsreferenz:
https://opencodex.me/
Installieren / Integrieren
npm install -g @bitkyc08/opencodex
ocx start # Startet Proxy + Dashboard
Erfordert Node 18+ (Bun-Runtime wird automatisch gebündelt). Leiten Sie dann eine Anfrage über einen Coding-Assistenten:
codex -m "anthropic/claude-opus-5" "Ihre Eingabe hier"
Mitwirken
Lesen Sie CONTRIBUTING.md im Repository und eröffnen Sie dann einen Pull-Request:
https://github.com/lidge-jun/opencodex/blob/main/CONTRIBUTING.md
7. Projektstruktur
opencodex/
├── bin/ # Binärdateien
├── dist/bin/ # Verteilte Binärdateien
├── docs/ # Dokumentationsdateien
├── docs-site/ # Quellcode der öffentlichen Dokumentationsseite
├── gui/ # Web-Dashboard-Oberfläche
├── readme/ # Lokalisierte README-Dateien
├── src/ # Quellcode
├── structure/ # Betreuerhinweise und Architektur
└── tests/ # Testsuite
src/ enthält die zentrale Proxy- und Übersetzungslogik; gui/ implementiert das lokale Web-Dashboard; docs-site/ betreibt die öffentliche Dokumentation unter opencodex.me.
8. Verwandtes Ökosystem
OpenCodex sitzt zwischen Coding-Assistenten (Codex, Claude Code, Claude Desktop, Grok Build) und LLM-Anbietern (OpenAI, Anthropic, Google, xAI und Open-Source-/selbst gehostete Optionen wie Ollama, DeepSeek, Qwen, GLM und Kimi). Es ergänzt Werkzeuge wie OpenRouter im Geiste — beide zielen darauf ab, Anbieterunterschiede zu abstrahieren — aber OpenCodex zielt speziell auf die lokale Integration mit Coding-Assistenten-CLIs und Desktop-Apps ab, statt ein gehostetes API-Gateway zu sein.
9. Lizenz
✅ Verwenden, kopieren, modifizieren, zusammenführen, veröffentlichen, verteilen und unterlizenzieren Sie die Software (MIT-Lizenz)
✅ Verwenden Sie sie für kommerzielle und private Projekte
❌ Machen Sie die Autoren für Schäden haftbar, die aus der Nutzung der Software entstehen
ℹ️ OpenCodex ist ein unabhängiges Projekt und steht in keiner Verbindung zu OpenAI, Anthropic oder anderen Modellanbietern; das Leiten von API-Datenverkehr über Drittanbieter-Proxys kann gegen die Nutzungsbedingungen einiger Anbieter verstoßen. Überprüfen Sie daher vor der Nutzung die Richtlinien jedes Anbieters
10. FAQ
F: Mit welchen Coding-Assistenten funktioniert OpenCodex?
A: Mit Codex, Claude Code, Claude Desktop und Grok Build über den lokalen Proxy, der mit ocx start gestartet wird.
F: Kann ich Modelle verwenden, die nicht von OpenAI stammen?
A: Ja — OpenCodex unterstützt 40+ Anbieter, darunter Anthropic, Google, xAI und Open-Source-Modelle wie DeepSeek, Qwen, GLM, Kimi und Ollama, ausgewählt mit provider/model-Syntax (z. B. anthropic/claude-opus-5).
F: Ist es sicher, mein Anbieterkonto über OpenCodex zu leiten?
A: Funktional ja, aber einige Anbieter können Konten einschränken, die Datenverkehr über Drittanbieter-Proxys leiten — überprüfen Sie die Nutzungsbedingungen jedes Anbieters, bevor Sie ein Konto verbinden.
F: Wie verwalte ich mehrere ChatGPT/Codex-Konten?
A: Verwenden Sie ocx account <...>, um Konten zu bündeln; OpenCodex verfolgt das Kontingent pro Konto und kann mit Richtlinien für geringste Nutzung, Round-Robin oder Füllen-zuerst automatisch routen.
F: Welche Plattformen werden unterstützt?
A: macOS (arm64/x64), Linux (x64/arm64) und Windows (x64), jeweils mit nativer Hintergrunddienstintegration (launchd, systemd, Task Scheduler).
11. Schnellzugriff
- Repository: https://github.com/lidge-jun/opencodex
- Offizielle Website / Dokumentation: https://opencodex.me/
- Mitwirkungsleitfaden: https://github.com/lidge-jun/opencodex/blob/main/CONTRIBUTING.md
- npm-Paket: https://www.npmjs.com/package/@bitkyc08/opencodex
12. Zusammenfassung
OpenCodex beseitigt die Single-Provider-Bindung beliebter Coding-Assistenten, indem es als lokaler, protokollübersetzender Proxy fungiert, der 40+ LLM-Anbieter mit vollständiger Feature-Parität unterstützt. Es ist am wertvollsten für Entwickler und Teams, die die Flexibilität wünschen, Modelle über Aufgaben hinweg zu mischen, mehrere Konten effizient zu bündeln und ihren Coding-Workflow widerstandsfähig gegen anbieterspezifische Ausfälle oder Kontingentlimits zu halten.