Codex CLI: eigener Schlüssel statt Abonnement

Codex ist kein Vorschlags-Tool im Editor, sondern ein eigenständiger Ausführender. Sie formulieren die Aufgabe in Worten, er entscheidet selbst, welche Dateien er liest, welche Befehle er ausführt und was er ändert. Er verfügt über etwa ein Dutzend Tools: Befehlsausführung, Lesen von Dateien, Führen eines Arbeitsplans, Anforderung von Klärungen beim Benutzer, Generierung von Unteragenten für Teilaufgaben.

Zwei Betriebsmodi. Interaktiv – codex ohne Argumente, ein Dialog im Terminal mit Anzeige jedes Schritts. Nicht-interaktiv – codex exec «Aufgabe», ein einmaliger Durchlauf bis zum Ergebnis: praktisch in Skripten und CI.

Sicherheit ist integriert: Standardmäßig arbeitet der Agent in einer Sandbox und fragt vor Änderungen um Bestätigung. Das Kontrollniveau wird in der Konfiguration festgelegt – von „alles nachfragen“ bis hin zu einem vollständig autonomen Durchlauf mit Schreibrechten im Arbeitsverzeichnis.

Eine weitere Besonderheit ist der Dialogzustand. Codex verlangt vom Server nicht, sich etwas zu merken: Er hält den gesamten Verlauf bei sich und sendet ihn bei jedem Schritt vollständig mit. Für Sie bedeutet das, dass der Schriftverkehr nicht beim Modellanbieter verbleibt und ein Wechsel des Endpunkts die begonnene Sitzung nicht unterbricht.

Der Unterschied zu Claude Code und anderen Terminal-Agenten ist genau das Protokoll. Codex kommuniziert mit dem Modell über die Responses API, wo der Schriftverkehr nicht als flache Nachrichtenliste, sondern als Element-Feed beschrieben wird: Text, Tool-Aufruf, Ergebnis des Aufrufs, Reasoning-Block. Dem Tool verleiht dies ein strengeres Dialogmodell, Ihnen die Notwendigkeit eines Endpunkts, der dieses Protokoll versteht.

Codex speichert Einstellungen in ~/.codex/config.toml. Ein eigener Anbieter wird durch den Block [model_providers.*] beschrieben, und das Schlüsselfeld ist wire_api: Ohne dieses versucht Codex, Chat Completions zu sprechen, und baut den Agentenzyklus nicht auf.

# ~/.codex/config.toml
model_provider = "joingonka"
model = "deepseek-ai/DeepSeek-V4-Flash-0731"

[model_providers.joingonka]
name = "JoinGonka Gateway"
base_url = "https://gate.joingonka.ai/v1"
env_key = "JOINGONKA_API_KEY"
wire_api = "responses"

Der Schlüssel wird nicht in die Datei geschrieben: env_key benennt die Umgebungsvariable, aus der Codex ihn bezieht. Der Variablenname ist spezifisch, nicht OPENAI_API_KEY – so beeinträchtigt diese Konfiguration nicht Ihre anderen Tools, die mit OpenAI arbeiten.

export JOINGONKA_API_KEY=jg-ihr-schluessel

Das Feld model legt das Standardmodell fest, und model_provider bestimmt, welcher der beschriebenen Blöcke verwendet wird. Beide können zum Zeitpunkt des Starts überschrieben werden, sodass eine Konfigurationsdatei problemlos mehrere Anbieter bedienen kann: Arbeits-, Test- und Reserveumgebung.

Der Schlüssel wird nach der Registrierung im persönlichen Bereich ausgegeben, dort können Sie auch Guthaben und Verbrauch einsehen. Wenn Sie die allgemeine Konfiguration nicht ändern möchten, kann derselbe Block einmalig über -c übergeben werden: codex -c model_provider=joingonka …. Um mehrere unabhängige Konfigurationen zu pflegen, geben Sie das Einstellungsverzeichnis über die Variable CODEX_HOME an.

Der schnellste Weg, um sicherzustellen, dass die Verbindung funktioniert, ist ein einmaliger Testlauf:

codex exec "Antworte in einer Zeile: Was ist 17*3?"

Im Header der Antwort gibt Codex an, mit wem er arbeitet: model, provider: joingonka, den Sandbox-Modus und die Sitzungs-ID. Wenn dort Ihr Anbieter steht und unten eine Antwort eintrifft, ist die Verbindung aktiv.

Als Nächstes sollten Sie das Hauptfeature prüfen, für das Codex installiert wird: die Dateiverarbeitung. Legen Sie eine kleine Datei mit einem offensichtlichen Fehler im Verzeichnis ab und bitten Sie darum, diesen zu finden:

codex exec "Lies calc.py und sag in einem Satz, ob es einen Fehler gibt."

Der Agent sollte selbstständig das Lesewerkzeug aufrufen, die Datei öffnen und sachlich antworten – unter Angabe der Zeile. Wenn dies geschieht, ist der vollständige Agentenzyklus (Anfrage → Werkzeugaufruf → Ergebnis → Antwort) über das Gateway korrekt konfiguriert.

Wenn etwas schiefgelaufen ist, lässt sich die Diagnose meist direkt aus der Meldung ablesen:

Die erste Anfrage in der Sitzung kann einige Sekunden dauern: Codex sendet einen umfangreichen System-Prompt und eine Beschreibung aller Werkzeuge, und der Netzknoten muss den Task entgegennehmen. Nachfolgende Antworten kommen schneller.

Alle Modelle des Netzwerks sind zum gleichen Preis verfügbar, daher geht es bei der Wahl um das Verhalten und nicht um das Budget. Unten ist das Ergebnis eines Live-Durchlaufs derselben Aufgabe (Lesen einer Datei und Fehlersuche) über Codex mit jedem der Modelle.

Die Standardempfehlung ist DeepSeek V4 Flash: Die Agentenarbeit stößt schnell an Kontextgrenzen, und 380K Token bieten genug Kapazität, um viele Dateien gleichzeitig im Gedächtnis zu behalten. Wenn Sie extrem kurze Antworten wünschen, wählen Sie Kimi K2.6. Das Modell lässt sich mit einer Zeile model in der Konfiguration oder mit dem Flag -c model=… ohne Dateiänderung wechseln.

Die aktuelle Liste der Netzwerkmodelle ist immer unter GET https://gate.joingonka.ai/v1/models abrufbar.

Agentenwerkzeuge verbrauchen Token anders als ein Chat: Codex fügt jeder Ihrer Aussagen einen System-Prompt und eine Beschreibung aller Werkzeuge hinzu und führt dann einen mehrstufigen Dialog mit dem Modell. Bei einem Live-Durchlauf der einfachen Aufgabe „Lese eine Datei und finde den Fehler“ wurden etwa 18.000 bis 20.000 Token verbraucht. Dies ist ein angemessener Preis für die Autonomie, und genau deshalb ist der Preis pro Token entscheidend.

Über das JoinGonka Gateway kosten Token $0.0047 pro Million beim Input und $0.014 pro Million beim Output – der Preis ist für alle Netzwerkmodelle gleich und wird auf dieser Seite aus der Live-Quelle bezogen.

Zum Vergleich – wie kostenpflichtige Optionen bei Codex selbst und bei Wettbewerbern strukturiert sind:

Die Abrechnung erfolgt nach tatsächlichem Verbrauch, ohne monatliches Abonnement und ohne Anfragelimits: Es gibt keine 5-Stunden-Fenster, „Prompt“-Limits oder Multiplikatoren zu Spitzenzeiten. Das Guthaben wird mit Kryptowährung aufgeladen; Saldo und täglicher Verbrauch sind im persönlichen Bereich einsehbar. Eine detaillierte Analyse der Wirtschaftlichkeit finden Sie im Artikel über die günstigste AI API.

Die Dialoghistorie wird von Codex selbst verwaltet. Es sendet sie bei jeder Anfrage vollständig mit und verlangt nicht vom Server, sich etwas zu merken – und wir speichern keine Chats. Ihr Code und Ihre Prompts verbleiben nach der Antwort nicht auf dem Gateway.

Websuche ist aktiv. Codex kündigt bei jeder Anfrage ein Suchwerkzeug an und das Gateway akzeptiert es: Die Suche erfolgt auf unserer Seite, die Ergebnisse werden in die Antwort des Modells eingefügt.

Werkzeuge sind lokal, nicht in der Cloud. Codex führt Befehle aus und liest Dateien lokal auf Ihrem Computer, daher hängt der Zugriff auf das Projekt nicht vom Modellanbieter ab.

Sandbox. Unter Linux verwendet Codex bubblewrap, um die ausgeführten Befehle zu isolieren. Wenn es nicht im System vorhanden ist, warnt Codex und verwendet eine integrierte Kopie – dies hat keinen Einfluss auf die Funktionalität, aber das Paket ist bequemer über den Standard-Manager zu installieren.

Wenn Sie mit Bildern arbeiten müssen – Screenshots der Benutzeroberfläche, Schemata auf Fotos –, verwenden Sie für solche Aufgaben ein Tool mit einem Modell, das über Vision-Fähigkeiten verfügt: Im Gonka Netzwerk sind die Modelle textbasiert. Für Code, Befehle und Dateien ist dies jedoch keine Einschränkung.

Andere Terminal-Agenten, falls Codex nicht geeignet ist: Der API-Schnellstart zeigt, wie man in wenigen Minuten ein kompatibles Tool anschließt.