Coding-Tools

OpenCodex

Verbinden Sie Codex über OpenCodex mit TokenLab unter Verwendung von modellspezifischem API-Routing

Lassen Sie meinen Agenten dies einrichten

Kopieren Sie diese Aufgabe in einen Agenten, der bereits auf Ihrem Computer läuft:

Read https://tokenlab.sh/docs/de/integrations/opencodex and help me connect OpenCodex to TokenLab.
Check my installed OpenCodex and Codex versions, active configuration, and running proxy first.
Preserve existing accounts, providers, models, and permissions. Back up files before changing them.
Have me enter the API key locally; never ask for, print, or paste it in chat.
Use the TokenLab preset and the selected model's documented API format.
Check configuration loading first. Explain the cost before running a small real request.
Match the reply with its TokenLab request record.

Funktionsweise der Verbindung

OpenCodex ist ein lokaler Proxy zwischen Codex und Modell-APIs. Diese Anleitung verwendet OpenCodex 2.73.0 und Codex CLI 0.149.0.

Die Chat Completions-Integration des TokenLab-Presets wurde in Version 2.72.0 veröffentlicht und vollständig verifiziert. Version 2.73.0 behält diese Integration bei und fügt modellspezifisches Responses- und Anthropic Messages-Routing hinzu. Die unten aufgeführten Routen wurden mit TokenLab anhand von gestreamtem Text sowie Round-Trips für Funktionsaufrufe und Ergebnisse überprüft.

Codex sendet Responses-Anfragen an den lokalen OpenCodex-Proxy. OpenCodex sendet dann die Anfrage des ausgewählten Modells an TokenLab. Eine Responses-Anfrage auf der lokalen Verbindung bedeutet nicht, dass das Modell über die Responses-API von TokenLab aufgerufen wird.

In Codex ausgewählte ModelleOpenCodex → TokenLab
gpt-6-astra, gpt-6.1-sol, gpt-6-sol, gpt-6-luna, grok-4.7, deepseek-v4.1-flash, deepseek-v4-pro, kimi-k3, glm-5.3Responses: POST /v1/responses
claude-opus-5, claude-opus-5-5, claude-sonnet-5, claude-sonnet-5-5, claude-fable-5, claude-fable-5-1Anthropic Messages: POST /v1/messages
gemini-3.8-flashChat Completions: POST /v1/chat/completions

Die Basis-URL des Presets lautet https://api.tokenlab.sh/v1. Lassen Sie diese unverändert: OpenCodex erstellt die passende Messages- oder Responses-URL selbst. Modelle außerhalb der aufgeführten Responses-Standards und des Claude-Routings verwenden den Chat-Adapter des Presets.

TokenLab unterstützt die native API von Gemini für Modelle, die diese deklarieren, aber das OpenCodex 2.73.0 TokenLab-Preset ruft Gemini über Chat Completions auf. Ändern Sie nicht den gesamten Provider auf Responses oder Gemini; dies würde auch Anfragen für Modelle ändern, die dieses Format nicht akzeptieren.

Installieren oder aktualisieren

Verwenden Sie Node.js 18 oder neuer für die npm-Installation:

npm install -g @bitkyc08/opencodex@2.73.0
ocx --version
codex --version

Codex muss ebenfalls installiert sein. OpenCodex bietet Installationsanweisungen und Anleitungen zur Codex-Verbindung. Native Windows-Installationen und WSL haben separate Konfigurationen; führen Sie das Setup und Codex in derselben Umgebung aus.

TokenLab hinzufügen

Erstellen Sie einen Schlüssel unter TokenLab API Keys. Befolgen Sie für das Terminal-Setup den Schnellstart, um TOKENLAB_API_KEY zu setzen, ohne den Wert in den Befehlsverlauf zu schreiben. Starten Sie OpenCodex von diesem Terminal aus; ein Hintergrunddienst benötigt die Variable in seiner eigenen Startumgebung.

Führen Sie für eine frische OpenCodex-Installation ocx init aus, wählen Sie TokenLab aus und geben Sie den Schlüssel lokal ein oder verwenden Sie die wörtliche Umgebungsreferenz ${TOKENLAB_API_KEY}. Überprüfen Sie die Codex-Verbindungs- und Autostart-Optionen des Assistenten, bevor Sie diese anwenden.

Fügen Sie bei einer bestehenden Installation das Preset hinzu, ohne andere Provider zu ersetzen:

ocx provider add tokenlab --api-key '${TOKENLAB_API_KEY}'

Die einfachen Anführungszeichen speichern eine Umgebungsvariablen-Referenz, nicht den Wert des Schlüssels. Dieser Befehl funktioniert auch in PowerShell. Wenn tokenlab bereits existiert, bearbeiten Sie diesen Provider im Dashboard, anstatt ihn mit --force zu überschreiben.

Sie können auch TokenLab in der Liste Add provider des Dashboards auswählen und den Schlüssel dort eingeben. OpenCodex speichert seine Konfiguration unter $OPENCODEX_HOME/config.json, normalerweise ~/.opencodex/config.json.

Starten Sie den Proxy, falls er noch nicht läuft, und öffnen Sie dann dessen Dashboard:

ocx start
ocx status
ocx gui

Überprüfen Sie auf der Provider-Seite die Basis-URL und die erkannten Modelle. Das Preset erkennt GET /v1/models?category=chat und behält Modelle mit tool-use-Fähigkeit bei. Bilder, Videos, Audio, Embeddings und Entscheidungsmodelle sind ausgeschlossen. Die Erkennung mit einem Schlüssel spiegelt die Modellberechtigungen und die Bereitstellungsrichtlinie dieses Schlüssels wider.

Führen Sie ocx sync aus, um Codex zu verbinden und dessen Modellkatalog zu aktualisieren, und starten Sie dann eine neue Codex-Sitzung. Dies ändert die Proxy-Verbindung und den Katalog von Codex; überprüfen Sie bestehende benutzerdefinierte Provider-Einstellungen und erstellen Sie ein Backup vor der Synchronisierung. Es ist nicht erforderlich, Ihr Konto oder Ihre Berechtigungsrichtlinie zu ersetzen.

Modell auswählen und Anfrage verifizieren

Wählen Sie den Eintrag tokenlab/<model-id> in der Modellauswahl von Codex oder wählen Sie ihn für einen CLI-Start aus:

codex -m "tokenlab/gpt-6.1-sol"

OpenCodex verwendet tokenlab/, um den Provider auszuwählen; die an TokenLab gesendete Modell-ID ist gpt-6.1-sol. Wählen Sie eine exakte, aktuell verfügbare ID aus Models.

Senden Sie für eine kleine Verbindungsprüfung:

Reply only with TOKENLAB_CONNECTION_OK. Do not use tools or modify files.

Diese Anfrage verwendet Ihr TokenLab-Guthaben. Überprüfen Sie die Antwort sowie das passende Modell, die Zeit und den Status unter Requests. Die Provider-Erkennung und ein erfolgreicher Start allein verifizieren noch nicht den Zugriff auf die Inferenz.

Streaming und Funktionsaufrufe funktionieren auf den Routen in der Tabelle. Bildeingaben und Thinking-Steuerungen hängen vom ausgewählten Modell ab: Überprüfen Sie dessen Fähigkeiten und verwenden Sie nur die Effort-Optionen, die OpenCodex für dieses Modell anbietet. Bildeingaben und Thinking-Anfragen wurden auf repräsentativen Modellen für die Responses- und Messages-Routen überprüft; die Gemini-Bildeingabe wurde auf der Chat-Route überprüft. Ein Modell, das Thinking unterstützt, legt nicht zwangsläufig Thinking-Text offen oder unterstützt jede Effort-Stufe.

Ein Responses-Modell auf Chat Completions beibehalten

Um den Chat-Pfad für eines der aufgeführten Responses-Modelle zu verwenden, fügen Sie einen modelAdapters-Eintrag in das bestehende providers.tokenlab-Objekt in der OpenCodex-Konfiguration ein. Dieses Beispiel behält gpt-6-astra für Codex auf Chat bei:

{
  "modelAdapters": {
    "gpt-6-astra": "openai-chat"
  }
}

Dies ist ein Beispiel für ein Provider-Feld, kein Ersatz für die vollständige Konfiguration. Behalten Sie andere Modell-Overrides, Anmeldeinformationen und Provider bei, starten Sie dann den Proxy neu und öffnen Sie eine neue Codex-Sitzung. Das Entfernen nur dieses Modelleintrags stellt dessen Responses-Standard wieder her.

Das Messages-Routing von Claude ist an den kanonischen TokenLab-Endpunkt gebunden. Der obige Chat-Override gilt für die Responses-Standards; er schaltet Claude nicht auf Chat um. Für einen Chat-nativen Client verwenden die aufgeführten Responses-Modelle bereits Chat ohne diesen Override. Siehe OpenCodex provider routing.

Bereitstellungsrichtlinie und andere TokenLab-Tools

Das Preset erzwingt keinen X-TokenLab-Delivery-Policy-Header. TokenLab verwendet den Standardwert der Bereitstellungsrichtlinie Ihres API-Schlüssels. Die Wahl zwischen Chat, Responses oder Messages ist unabhängig von der Wahl einer Bereitstellungsrichtlinie; siehe TokenLab provider settings.

TokenLab Skills fügen Integrationsanweisungen hinzu. Sie ändern nicht den Provider oder das API-Format des Hauptmodells.

JEV Auto in OpenCodex 2.73.0 verwendet das Entscheidungs-Backend von TypeSafe. Es bietet TokenLab nicht als dieses Backend an. Der Aufruf der System One API von TokenLab über MCP ist ein separater Vorgang; legen Sie keinen TokenLab-Schlüssel in das TypeSafe-Anmeldeinformationsfeld.

Bilder und Videos im selben Agenten generieren

Codex kann mit dem TokenLab MCP server auch Bilder und kurze Videos erstellen. Jede Generierung wird vom selben TokenLab-Guthaben bezahlt. OpenCodex routet nur Modellanfragen, und Codex selbst startet MCP-Server. Fügen Sie den Server in dem Terminal zu Codex hinzu, in dem TOKENLAB_API_KEY gesetzt ist:

codex mcp add \
  --env TOKENLAB_MCP_TOOL_PROFILE=core \
  --env TOKENLAB_API_KEY="$TOKENLAB_API_KEY" \
  tokenlab -- \
  npx -y @tokenlabai/mcp-server@0.6.48

MCP ändert nicht den Provider oder das API-Format des Hauptmodells. Führen Sie codex mcp list aus und überprüfen Sie, ob tokenlab aufgelistet ist. Versuchen Sie es dann in einer neuen Codex-Sitzung:

Call get_model_pricing for nano-banana-2, then use create_image with nano-banana-2 at 1k to make a photo of a matte black coffee mug on a white desk.

create_video gibt eine Aufgaben-ID zurück. Der Agent ruft get_task_status auf, bis das Video fertig ist.

Fehlerbehebung und Wiederherstellung Ihres Setups

  • TokenLab fehlt in der Auswahl: Überprüfen Sie ocx --version; diese Anleitung zielt auf 2.73.0 ab. Aktualisieren Sie den Katalog mit ocx sync und starten Sie eine neue Codex-Sitzung.
  • 401 oder fehlende Anmeldeinformationen: Überprüfen Sie, ob der Schlüssel aktiv und für den Prozess verfügbar ist, der OpenCodex ausführt. Eine Umgebungsvariable in einem anderen Terminal aktualisiert keinen bereits laufenden Dienst.
  • Modell fehlt: Überprüfen Sie die exakte ID, die Berechtigungen Ihres Schlüssels und die aktuelle Verfügbarkeit. Nicht-Chat-Modelle und Chat-Modelle ohne tool-use sind in diesem Preset nicht enthalten.
  • Nicht unterstützte Anfrage oder falscher Endpunkt: Vergleichen Sie das ausgewählte Modell mit der Routing-Tabelle und untersuchen Sie gespeicherte Adapter-Overrides. Das erforderliche Format ist tokenlab.accepted_request_formats unter model details; die Modellliste ist kein Ersatz für dieses Detailfeld. Claude und Gemini dürfen nicht an Responses gesendet werden, nur weil Codex lokal Responses verwendet.
  • Tools oder Bildeingabe schlagen fehl: Behalten Sie den ursprünglichen Fehler und die Request-ID. Überprüfen Sie die Fähigkeiten des Modells und die aktive OpenCodex-Route, bevor Sie Einstellungen ändern; entfernen Sie nicht den Gesprächsverlauf oder Tool-Ergebnisse, um einen Fehler zu verbergen.

Um das Routing von Codex über den Proxy zu stoppen, verwenden Sie ocx stop; OpenCodex stoppt den Proxy und stellt die native Codex-Verbindung wieder her. ocx restore stellt die native Verbindung wieder her, während der Proxy für andere Clients weiterläuft. Lesen Sie die OpenCodex CLI reference, bevor Sie eine Installation ändern, die von anderen Clients gemeinsam genutzt wird.

Auf dieser Seite