Skip to main content

​
Diesen Schritt von Ihrem Agenten einrichten lassen

Kopieren Sie diese Aufgabe an einen Agenten, der bereits auf Ihrem Computer ausgeführt wird:

​
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 2.72.0 veröffentlicht und End-to-End 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 gestreamtem Text sowie Function-Call/Result-Roundtrips mit TokenLab getestet. Codex sendet Responses-Anfragen an den lokalen OpenCodex-Proxy. OpenCodex sendet die Anfrage des ausgewählten Modells dann an TokenLab. Eine Responses-Anfrage über die lokale Verbindung bedeutet nicht, dass das Modell über die Responses-API von TokenLab aufgerufen wird. Die Basis-URL des Presets lautet https://api.tokenlab.sh/v1. Ändern Sie diese nicht: 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 Gemini-API für Modelle, die diese deklarieren, aber das TokenLab-Preset von OpenCodex 2.73.0 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 unterstützen.

​
Installieren oder aktualisieren

Verwenden Sie Node.js 18 oder höher für die npm-Installation:
Codex muss ebenfalls installiert sein. OpenCodex bietet Anleitungen zur Installation und zum Verbinden mit Codex. Natives Windows und WSL verfügen über getrennte Konfigurationen; führen Sie das Setup und Codex in derselben Umgebung aus.

​
TokenLab hinzufügen

Erstellen Sie einen Schlüssel unter TokenLab-API-Schlüssel. Folgen Sie für die Einrichtung im Terminal dem Schnellstart, um TOKENLAB_API_KEY festzulegen, ohne dessen Wert im Befehlsverlauf zu speichern. Starten Sie OpenCodex über dieses Terminal; ein Hintergrunddienst benötigt die Variable in seiner eigenen Startumgebung. Führen Sie bei einer neuen OpenCodex-Installation ocx init aus, wählen Sie TokenLab und geben Sie den Schlüssel lokal ein oder verwenden Sie die literale Umgebungsreferenz ${TOKENLAB_API_KEY}. Überprüfen Sie die Optionen des Assistenten für die Codex-Verbindung und den Autostart, bevor Sie sie anwenden. Fügen Sie bei einer bestehenden Installation das Preset hinzu, ohne andere Provider zu ersetzen:
Die einfachen Anführungszeichen speichern eine Umgebungsvariablenreferenz und nicht den Wert des Schlüssels. Dieser Befehl funktioniert auch in PowerShell. Wenn tokenlab bereits vorhanden ist, bearbeiten Sie diesen Provider im Dashboard, anstatt ihn mit --force zu überschreiben. Sie können auch TokenLab in der Liste Provider hinzufügen des Dashboards auswählen und den Schlüssel dort eingeben. OpenCodex speichert seine Konfiguration unter $OPENCODEX_HOME/config.json, standardmäßig ~/.opencodex/config.json. Starten Sie den Proxy, falls er noch nicht läuft, und öffnen Sie anschließend dessen Dashboard:
Überprüfen Sie auf der Provider-Seite die Basis-URL und die erkannten Modelle. Das Preset fragt GET /v1/models?category=chat ab und behält Modelle mit der Funktion tool-use bei. Bilder-, Video-, Audio-, Embedding- und Entscheidungsmodelle sind ausgeschlossen. Die Erkennung mit einem Schlüssel spiegelt die Modellberechtigungen und die Delivery-Policy 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 vorhandene Einstellungen für benutzerdefinierte Provider und erstellen Sie vor der Synchronisierung ein Backup. Es ist nicht erforderlich, Ihr Konto oder Ihre Berechtigungsrichtlinie zu ersetzen.

​
Ein Modell auswählen und eine Anfrage überprüfen

Wählen Sie den Eintrag tokenlab/<model-id> in der Modellauswahl von Codex oder wählen Sie ihn für einen einzelnen CLI-Start aus:
OpenCodex verwendet tokenlab/, um den Provider auszuwählen; die an TokenLab gesendete Modell-ID lautet gpt-6.1-sol. Wählen Sie eine exakte, aktuell verfügbare ID aus Modelle. Senden Sie für eine kurze Verbindungsprüfung Folgendes:
Diese Anfrage verbraucht Ihr TokenLab-Guthaben. Überprüfen Sie die Antwort und das zugehörige Modell, den Zeitpunkt und den Status unter Anfragen. Die Provider-Erkennung und ein erfolgreicher Start allein überprüfen noch keinen Inferenz-Zugriff. Streaming und Function Calling funktionieren auf den in der Tabelle aufgeführten Routen. Bildeingabe 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. Bildeingabe- und Thinking-Anfragen wurden an repräsentativen Modellen für die Responses- und Messages-Routen getestet; die Gemini-Bildeingabe wurde auf ihrer Chat-Route getestet. Ein Modell, das Thinking unterstützt, gibt nicht notwendigerweise Thinking-Text aus oder unterstützt jede Aufwandstufe.

​
Ein Responses-Modell auf Chat Completions belassen

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 Konfiguration von OpenCodex ein. Dieses Beispiel belässt gpt-6-astra für Codex auf Chat:
Dies ist ein Beispiel für ein Provider-Feld und kein Ersatz für die vollständige Konfiguration. Behalten Sie andere Modell-Overrides, Anmeldedaten und Provider bei, starten Sie den Proxy neu und öffnen Sie eine neue Codex-Sitzung. Wenn Sie nur diesen Modell-Eintrag entfernen, wird der standardmäßige Responses-Modus wiederhergestellt. Das Messages-Routing von Claude ist an den kanonischen TokenLab-Endpunkt gebunden. Das obige Chat-Override gilt für die Responses-Standards; es stellt Claude nicht auf Chat um. Für einen chat-nativen Client verwenden die aufgeführten Responses-Modelle auch ohne dieses Override bereits Chat. Siehe OpenCodex Provider-Routing.

​
Delivery-Policy und andere TokenLab-Tools

Das Preset erzwingt keinen X-TokenLab-Delivery-Policy-Header. TokenLab verwendet den Standardwert für die Delivery-Policy Ihres API-Schlüssels. Die Auswahl von Chat, Responses oder Messages erfolgt unabhängig von der Auswahl einer Delivery-Policy; siehe TokenLab Provider-Einstellungen. Fügen Sie den TokenLab MCP-Server für weitere API-Tools hinzu oder TokenLab Skills für Integrationsanweisungen. Diese ändern weder den Provider noch das API-Format des Hauptmodells. JEV Auto in OpenCodex 2.73.0 verwendet das Decision-Backend von TypeSafe. TokenLab wird dafür nicht als Backend angeboten. Der Aufruf der System One API von TokenLab über MCP ist eine separate Operation; geben Sie keinen TokenLab-Schlüssel in das TypeSafe-Anmeldedatenfeld ein.

​
Fehlerbehebung und Wiederherstellung Ihres Setups

  • TokenLab fehlt in der Auswahl: Überprüfen Sie ocx --version; diese Anleitung bezieht sich auf 2.73.0. Aktualisieren Sie den Katalog mit ocx sync und starten Sie eine neue Codex-Sitzung.
  • 401 oder fehlende Anmeldedaten: Überprüfen Sie, ob der Schlüssel aktiv ist und für den Prozess verfügbar ist, der OpenCodex ausführt. Eine Umgebungsvariable in einem anderen Terminal aktualisiert einen bereits ausgeführten Dienst nicht.
  • Modell fehlt: Überprüfen Sie die genaue ID, die Berechtigungen Ihres Schlüssels und die aktuelle Verfügbarkeit. Nicht-Chat-Modelle sowie 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 überprüfen Sie gespeicherte Adapter-Overrides. Das erforderliche Format ist tokenlab.accepted_request_formats in den Modell-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 die ursprüngliche Fehlermeldung und die Request-ID bei. Überprüfen Sie die Fähigkeiten des Modells und die aktive OpenCodex-Route, bevor Sie Einstellungen ändern; löschen Sie nicht den Konversationsverlauf oder Tool-Ergebnisse, um einen Fehler zu verbergen.
Um das Routing von Codex über den Proxy zu beenden, verwenden Sie ocx stop; OpenCodex beendet 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-Referenz, bevor Sie eine von anderen Clients gemeinsam genutzte Installation ändern.