OpenAI Codex CLI

OpenAIs Codex CLI ist ein Coding-Agent für das Terminal. Er liest und bearbeitet Dateien in Ihrem Projekt und führt Befehle auf Ihrem Rechner aus. Das Modell dahinter kann bei DeutschlandGPT laufen: Sie richten Codex auf die Platform API aus und melden es mit einem API-Schlüssel an.

Wir haben die folgenden Schritte mit Codex CLI 0.166.0 getestet. Codex ändert sich schnell; verhält sich eine spätere Version anders, prüfen Sie deren Release Notes auf Änderungen an openai_base_url, codex login und Profilen.

Bevor Sie beginnen

1. Ein API-Schlüssel. Legen Sie unter API-Schlüssel einen an, wie im Schnellstart beschrieben. Ein eigener Schlüssel für Codex, zum Beispiel codex, hält die Nutzung unterscheidbar, und ein Ausgabenlimit darauf begrenzt, was der Agent ausgeben kann.
2. Guthaben. In einem Prepaid-Workspace laufen Anfragen nur, solange Guthaben vorhanden ist.
3. Ein Modell mit Tool-Aufrufen. Codex erledigt alles über Tool-Aufrufe. Modelle listet die genauen Modell-IDs, die Ihr Schlüssel nutzen kann.

Codex einrichten

Codex hat einen eingebauten Provider namens openai. Richten Sie diesen Provider auf DeutschlandGPT aus, statt einen eigenen Provider anzulegen. Nur so können Sie mit OpenAI begonnene Sitzungen weiterführen (siehe unten).

1. Tragen Sie die Base URL oben in ~/.codex/config.toml ein, außerhalb jedes [Abschnitts]:

   TOML

   Kopieren

   openai_base_url = "https://api.deutschlandgpt.de/v2"
   model = "<modell-id>"
   

   Eine selbst gehostete Instanz nutzt https://<ihre-domain>/platform-api/api/v2.

2. Hinterlegen Sie Ihren API-Schlüssel in Codex. Der Befehl liest den Schlüssel von der Standardeingabe:

   BASH

   Kopieren

   echo "<ihr API-Schlüssel>" | codex login --with-api-key
   

   In PowerShell: "<ihr API-Schlüssel>" | codex login --with-api-key.

3. Starten Sie Codex wie gewohnt mit codex.

• Nur die hinterlegte Anmeldung zählt. Für den eingebauten Provider openai sendet Codex den mit codex login gespeicherten Schlüssel. Die Umgebungsvariable OPENAI_API_KEY wird dafür nicht genutzt.
• Vorher mit einem OpenAI-API-Schlüssel angemeldet? codex login --with-api-key ersetzt diese Anmeldung. Solange der alte Schlüssel gespeichert ist, sendet Codex ihn an DeutschlandGPT, und jede Anfrage scheitert mit 401.
• Modelle anderer Hersteller funktionieren auch. Bei einer Modell-ID, die Codex nicht kennt, etwa einem Claude- oder Mistral-Modell, meldet Codex Model metadata for … not found. Defaulting to fallback metadata. Die Anfrage geht trotzdem an das eingestellte Modell.
• Die erste Anfrage einer Sitzung kann einige Sekunden länger dauern. Codex versucht zuerst eine WebSocket-Verbindung, die die Platform API nicht anbietet, und wechselt dann selbst zu HTTPS.

Ältere Sitzungen

Mit OpenAI begonnene Sitzungen können Sie mit ihrem vollständigen Verlauf auf einem DeutschlandGPT-Modell weiterführen.

codex resume                 # aus der Liste wählen
codex resume <sitzungs-id>   # oder direkt fortsetzen

Codex speichert jede Sitzung mit dem Namen des Providers, auf dem sie lief, nicht mit der URL. Eine mit OpenAI begonnene Sitzung ist als openai gespeichert. Codex setzt eine Sitzung nur unter demselben Provider-Namen fort und listet sie nur dort. Weil die Einrichtung oben den Provider openai behält und nur seine Adresse ändert, erscheinen alle mit OpenAI begonnenen Sitzungen und lassen sich hier weiterführen. Neue Sitzungen werden ebenfalls als openai gespeichert; Sie können die Adresse also später wieder auf OpenAI stellen und sie dort fortsetzen.

Lief eine alte Sitzung auf einer Modell-ID, die DeutschlandGPT nicht anbietet, wählen Sie beim Fortsetzen ein Modell, etwa codex resume <sitzungs-id> -m <modell-id>, oder wechseln Sie in der Sitzung mit /model.

Stattdessen ein Profil nutzen

Um zwischen OpenAI und DeutschlandGPT zu wechseln, legen Sie die beiden Zeilen aus config.toml stattdessen in ein Profil. Codex 0.166 hält jedes Profil in einer eigenen Datei, zum Beispiel ~/.codex/deutschlandgpt.config.toml:

openai_base_url = "https://api.deutschlandgpt.de/v2"
model = "<modell-id>"

Starten Sie Codex mit codex --profile deutschlandgpt oder codex resume --profile deutschlandgpt. Ohne --profile spricht Codex wieder mit OpenAI. Ein Abschnitt [profiles.<name>] in config.toml wird zusammen mit --profile nicht mehr akzeptiert; Codex bricht mit einer Meldung ab, die sagt, wohin er gehört.

Codex speichert nur eine Anmeldung, der Schlüssel aus codex login gilt also für beide Seiten. Führen Sie codex login beim Wechsel erneut aus.

Fehlerbehebung

• This chat uses openai, but your current provider is … (modelProviderMismatch): Codex läuft auf einem selbst angelegten Provider. Entfernen Sie ihn aus der Konfiguration und nutzen Sie openai_base_url wie oben beschrieben.
• Die Fortsetzen-Liste ist leer: dieselbe Ursache. Die Liste zeigt nur Sitzungen des Providers, den Codex gerade nutzt.
• 401 mit Malformed api key: Codex sendet noch eine alte OpenAI-Anmeldung. Führen Sie codex login --with-api-key mit Ihrem DeutschlandGPT-Schlüssel aus.
• 401 mit Session expired or invalid: Codex sendet gar keinen Schlüssel. Hinterlegen Sie einen mit codex login --with-api-key; OPENAI_API_KEY allein reicht nicht.
• 404 mit Model … not found: Nutzen Sie eine Modell-ID genau so, wie Modelle sie listet, in config.toml oder mit -m.
• 402: Der Workspace hat kein Guthaben mehr, oder ein Monats- oder Schlüssellimit ist erreicht. Siehe Abrechnung.