> ## Documentation Index > Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt > Use this file to discover all available pages before exploring further. # OpenCodex > Verbinden Sie Codex über OpenCodex mit TokenLab mit modellspezifischem API-Routing ## Diesen Schritt von Ihrem Agenten einrichten lassen Kopieren Sie diese Aufgabe an einen Agenten, der bereits auf Ihrem Computer ausgeführt wird: ```text theme={null} Read https://docs.tokenlab.sh/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](https://github.com/lidge-jun/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](https://github.com/lidge-jun/opencodex/releases/tag/v2.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. | In Codex ausgewählte Modelle | OpenCodex → 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.3` | Responses: `POST /v1/responses` | | `claude-opus-5`, `claude-opus-5-5`, `claude-sonnet-5`, `claude-sonnet-5-5`, `claude-fable-5`, `claude-fable-5-1` | Anthropic Messages: `POST /v1/messages` | | `gemini-3.8-flash` | Chat Completions: `POST /v1/chat/completions` | 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: ```bash theme={null} npm install -g @bitkyc08/opencodex@2.73.0 ocx --version codex --version ``` Codex muss ebenfalls installiert sein. OpenCodex bietet Anleitungen zur [Installation](https://opencodex.me/getting-started/installation/) und zum [Verbinden mit Codex](https://opencodex.me/getting-started/quickstart/). 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](https://tokenlab.sh/dashboard/api?tab=keys). Folgen Sie für die Einrichtung im Terminal dem [Schnellstart](/de/quickstart), 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: ```bash theme={null} ocx provider add tokenlab --api-key '${TOKENLAB_API_KEY}' ``` 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: ```bash theme={null} ocx start ocx status ocx gui ``` Ü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/` in der Modellauswahl von Codex oder wählen Sie ihn für einen einzelnen CLI-Start aus: ```bash theme={null} codex -m "tokenlab/gpt-6.1-sol" ``` 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](https://tokenlab.sh/de/models). Senden Sie für eine kurze Verbindungsprüfung Folgendes: ```text theme={null} Reply only with TOKENLAB_CONNECTION_OK. Do not use tools or modify files. ``` Diese Anfrage verbraucht Ihr TokenLab-Guthaben. Überprüfen Sie die Antwort und das zugehörige Modell, den Zeitpunkt und den Status unter [Anfragen](https://tokenlab.sh/dashboard/runs?section=requests). 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: ```json theme={null} { "modelAdapters": { "gpt-6-astra": "openai-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](https://opencodex.me/guides/providers/#3-api-key-catalog). ## 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](/de/guides/tokenlab-provider). Fügen Sie den [TokenLab MCP-Server](/de/integrations/tokenlab-mcp-server) für weitere API-Tools hinzu oder [TokenLab Skills](/de/integrations/coding-agent-skill) 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](/de/api-reference/systemone/create-decision) 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](/de/api-reference/models/get-model); 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](https://opencodex.me/reference/cli/), bevor Sie eine von anderen Clients gemeinsam genutzte Installation ändern.