ein lokaler Provider-Proxy für OpenAI Codex und Claude Code
Universeller Anbieter-Proxy für OpenAI Codex und Claude Code, verwenden Sie jedes LLM (Claude, Gemini, Grok, DeepSeek, Ollama…) mit Codex CLI, App, SDK und Claude Code.
Auf einen Blick
- Was ist das?
- Ein TypeScript-Proxy, der die Responses-API von Codex in Provider-Protokolle übersetzt, mit Kontopool, Modell-Routing und sauberer Deinstallation.
- Für wen ist es gedacht?
- opencodex ist ein MIT-lizenzierter lokaler Proxy, der die Responses-API von Codex in mehrere Provider-Protokolle übersetzt, einen ChatGPT-Kontopool mit Affinität und Failover verwaltet und beim Stoppen die ursprüngliche Codex-Konfiguration wiederherstellt. Ob ein bestimmter Anbieter nutzbar ist, hängt von dessen Bedingungen und Preview-Gates ab; das README überlässt diese Entscheidung ausdrücklich dem Nutzer.
- Darf ich es kommerziell nutzen?
- Ja. MIT ist eine freizügige Lizenz: Sie dürfen darauf aufbauende Software nutzen, verändern und verkaufen, solange Sie die Urheberrechts- und Lizenzhinweise beibehalten.
- Wird es noch gepflegt?
- Ja. Die letzten Commits kamen vor 1 Tag.
- In welcher Sprache ist es geschrieben?
- Hauptsächlich TypeScript, laut der Sprachstatistik von GitHub.
Die Antworten beruhen auf den GitHub-Daten des Projekts (zuletzt abgeglichen am 15. September 2026) und auf unserer Analyse. Sie sind keine Rechtsberatung.
TIEFGEHENDE OPEN-SOURCE-ANALYSE
Wie opencodex Codex und Claude Code umleitet
opencodex ist ein lokaler TypeScript-Proxy für OpenAI Codex und Claude Code. Er sitzt zwischen dem Codex-Client und einem LLM-Anbieter und übersetzt die Responses-API-Aufrufe, die Codex sendet, in das Protokoll des gewählten Anbieters. Laut README funktioniert die Übersetzung bidirektional für Streaming, Tool-Aufrufe, Reasoning-Tokens und Bilder. Fünf Protokoll-Adapter decken Anthropic Messages, Google Gemini, Azure OpenAI, OpenAI Responses Passthrough und alle OpenAI-kompatiblen Chat-Completions-Endpunkte ab, zusammen mehr als 40 integrierte Anbieter. Für Claude Code startet der Befehl `ocx claude` den Proxy mit aktivierter Modell-Erkennung. Das README enthält keine Benchmark-Zahlen oder Nutzerzahlen, daher werden diese hier nicht bestätigt.
Für opencodex prüfst du hier Installationsbefehl und Abhängigkeiten anhand des README-Einstiegs und des dort genannten Projektbefehls. Beobachte die konkrete Ausgabe oder Dateistruktur und halte Version, Eingabe und Ergebnis fest; Aussagen zu Leistung, Stabilität oder aktueller Pflege bleiben offen, wenn das README sie nicht belegt.
Installation und die zwei wichtigsten Befehle
Der Schnellstart für Menschen im README besteht aus zwei Befehlen: `npm install -g @bitkyc08/opencodex` und `ocx start`. Das startet den Proxy und öffnet ein Web-Dashboard unter `http://localhost:10100`. Für einen Agent-Workflow schreibt `ocx init` interaktiv `~/.opencodex/config.json` und verbindet Codex, startet den Proxy aber nicht. Headless-Befehle wie `ocx provider add` und `ocx combo set` kommunizieren mit einem laufenden Proxy und beenden sich mit einem Nicht-Null-Status, wenn sie nicht erreichbar sind. `ocx status`, `ocx doctor` und `ocx health` melden den Ausführungsstatus. Node 18 oder höher ist erforderlich. Das README sagt, dass Bun während `npm install` automatisch gebündelt wird, sodass keine separate Bun-Installation nötig ist. Die Installation funktioniert nativ auf macOS, Linux und Windows, unter Windows ohne WSL.
Für opencodex prüfst du hier Eingabeformat und erzeugte Ausgabe anhand des README-Einstiegs und des dort genannten Projektbefehls. Beobachte die konkrete Ausgabe oder Dateistruktur und halte Version, Eingabe und Ergebnis fest; Aussagen zu Leistung, Stabilität oder aktueller Pflege bleiben offen, wenn das README sie nicht belegt.
Provider-Auswahl, Modell-Routing und Reasoning-Aufwand
Modelle werden als `provider/model` angegeben. Beispiele im README sind `codex -m "anthropic/claude-opus-5"`, `codex -m "google/gemini-3-pro"` und `codex -m "ollama/llama3"`. Wenn das Provider-Präfix weggelassen wird, leitet opencodex an den Standard-Provider weiter oder gleicht den Modellnamen automatisch ab, zum Beispiel `claude-*` an Anthropic und `gpt-*` an OpenAI. Geroutete Modelle erscheinen im Modellwähler der Codex App mit Steuerung für Reasoning-Aufwand. Das README erklärt, dass `ultra` dieselbe Bedeutung wie upstream Codex hat: Es aktiviert maximales Reasoning und aktive Multi-Agent-Delegation auf dem Client, und die tatsächliche Anfrage wird als `max` gesendet. `ultra` wird nur von Anbietern beworben, die über die Konfiguration `reasoningEfforts` opt-in. GPT-5.6 Sol/Terra/Luna werden als Katalog-Einträge für OpenAI-API-Key- und OpenRouter-Presets angelegt, aber die tatsächliche Verfügbarkeit folgt dem upstream Preview-Gate; opencodex bereitet nur Routing- und Katalog-Metadaten vor.
Für opencodex prüfst du hier Konfigurationsdateien und Standardwerte anhand des README-Einstiegs und des dort genannten Projektbefehls. Beobachte die konkrete Ausgabe oder Dateistruktur und halte Version, Eingabe und Ergebnis fest; Aussagen zu Leistung, Stabilität oder aktueller Pflege bleiben offen, wenn das README sie nicht belegt.
ChatGPT-Kontopool: Affinität, Kontingente und Failover
Für die Codex-Authentifizierung kann opencodex einen Pool von ChatGPT- und Codex-Konten verwalten. Bestehende Threads behalten ihr Startkonto, sodass lange SSH-, tmux- oder Mobile-Sitzungen mitten im Gespräch nicht das Konto wechseln. Wenn die automatische Umschaltung aktiviert ist, vergleichen neue Sitzungen das am stärksten ausgelastete der 5-Stunden-, Wochen- und 30-Tage-Kontingentfenster und leiten an ein geeignetes Konto mit geringerer Nutzung weiter. Das Dashboard aktualisiert alle Kontingente auf einmal, und Anfrageprotokolle kennzeichnen Pool-Traffic mit nicht-PII-Kontonummern. Token-Fehler sind fail-closed: Sie zeigen eine erneute Authentifizierung an, anstatt stillschweigend auf eine andere Anmeldedaten zurückzufallen, während 429-Kontingentantworten das Konto in eine Abkühlphase versetzen und ein Failover auf ein anderes geeignetes Poolkonto ermöglichen. Es gibt auch einen Modus `openai-apikey`, der das Kontorouting vollständig umgeht und einen API-Schlüssel oder einen Schlüsselpool verwendet. Das README gibt weder an, wie viele Konten ein Pool enthalten kann, noch nennt es konkrete Kontingentschwellen.
Für opencodex prüfst du hier Fehlerverhalten und Protokolle anhand des README-Einstiegs und des dort genannten Projektbefehls. Beobachte die konkrete Ausgabe oder Dateistruktur und halte Version, Eingabe und Ergebnis fest; Aussagen zu Leistung, Stabilität oder aktueller Pflege bleiben offen, wenn das README sie nicht belegt.
Konfiguration, Remote-Zugriff und Deinstallation
Die Konfiguration liegt unter `~/.opencodex/config.json`. Wenn die Datei ungültiges JSON enthält, sichert opencodex sie als `config.json.invalid-<timestamp>` und startet mit Standardwerten, sodass die Originaldatei nicht stillschweigend verloren geht. Standardmäßig bindet der Proxy an `127.0.0.1` ohne separate Authentifizierung. Wenn Sie `"hostname": "0.0.0.0"` setzen, um ihn im LAN zu öffnen, verlangt opencodex ein Bearer-Token, das über `OPENCODEX_API_AUTH_TOKEN` gesetzt wird, und verwendet es für Admin-APIs und Datenpfade; ohne diese Variable wird der Start abgelehnt. Das README sagt, dass der Token-Vergleich in konstanter Zeit erfolgt, um Timing-Angriffe zu reduzieren. `ocx uninstall` stoppt den Proxy, entfernt installierte Dienste und Shim, stellt Codex-Konfiguration/-Katalog/-Verlauf wieder her und löscht `~/.opencodex`. Es gibt zwei Autostart-Optionen: OS-Dienstverwaltung (launchd, systemd, Task Scheduler) für Dauerbetrieb oder einen Codex-Shim, der bei jedem `codex`-Aufruf `ocx ensure` ausführt. Das README beschreibt auch eine Neuzuordnung des Resume-Verlaufs, die alte OpenAI-Threads während der Proxy-Nutzung erhält und sie beim Stoppen zurückgibt.
Für opencodex prüfst du hier Version und Wartungszustand anhand des README-Einstiegs und des dort genannten Projektbefehls. Beobachte die konkrete Ausgabe oder Dateistruktur und halte Version, Eingabe und Ergebnis fest; Aussagen zu Leistung, Stabilität oder aktueller Pflege bleiben offen, wenn das README sie nicht belegt.
Lizenz, Garantie und Provider-Bedingungen
Das Repository ist unter der MIT-Lizenz veröffentlicht. Der Lizenzauszug erlaubt das Verwenden, Kopieren, Modifizieren, Zusammenführen, Veröffentlichen, Verteilen, Unterlizenzieren und Verkaufen von Kopien und stellt die Software wie besehen ohne jegliche Garantie bereit, einschließlich der Garantien der Handelsüblichkeit, der Eignung für einen bestimmten Zweck und der Nichtverletzung von Rechten. Das README ergänzt, dass opencodex ein unabhängiges Community-Projekt ist und weder von OpenAI, Anthropic noch anderen Anbietern unterstützt oder gebilligt wird. Es warnt, dass einige Anbieter, insbesondere Anthropic, Konten sperren oder einschränken können, die API-Traffic über Drittanbieter-Proxys leiten, und legt die Verantwortung, die Nutzungsbedingungen des Anbieters zu prüfen, in die Hände des Nutzers. Das README und die Lizenz begründen keine Support-Zusage, keine Betriebszeitgarantie und keine Produktionsreife-Behauptung, abgesehen von dem konstanten Token-Vergleich, der für den LAN-Modus beschrieben wird.
Für opencodex prüfst du hier Dateipfade und Berechtigungen anhand des README-Einstiegs und des dort genannten Projektbefehls. Beobachte die konkrete Ausgabe oder Dateistruktur und halte Version, Eingabe und Ergebnis fest; Aussagen zu Leistung, Stabilität oder aktueller Pflege bleiben offen, wenn das README sie nicht belegt.
Redaktionelles Fazit
opencodex ist ein MIT-lizenzierter lokaler Proxy, der die Responses-API von Codex in mehrere Provider-Protokolle übersetzt, einen ChatGPT-Kontopool mit Affinität und Failover verwaltet und beim Stoppen die ursprüngliche Codex-Konfiguration wiederherstellt. Ob ein bestimmter Anbieter nutzbar ist, hängt von dessen Bedingungen und Preview-Gates ab; das README überlässt diese Entscheidung ausdrücklich dem Nutzer.
Community-Notizen