Skip to main content
OpenAIs Codex CLI ist ein KI-Coding-Assistent, der in Ihrem Terminal läuft. Durch das Setzen zweier Umgebungsvariablen können Sie Codex-CLI-Anfragen über Flatkey leiten, um kompatible GPT-, Claude-, Gemini- und andere Textmodelle zu nutzen, sofern diese über Flatkey verfügbar sind.

​
Voraussetzungen

  • Codex CLI installiert: npm install -g @openai/codex
  • Ein Flatkey-Konto mit einem API-Schlüssel — hier erhalten Sie einen

​
Konfiguration

Setzen Sie die folgenden Umgebungsvariablen, bevor Sie Codex CLI ausführen:
Oder fügen Sie sie zu Ihrem Shell-Profil (~/.bashrc, ~/.zshrc) hinzu, um die Einstellung dauerhaft zu machen:
~/.zshrc

​
Konfiguration mit CC Switch

CC Switch ist ein Desktop-Konfigurationsmanager für Coding-Assistenten von Drittanbietern. Es ist kein Flatkey-Produkt, und Flatkey ist keine integrierte Voreinstellung. Die folgenden Schritte folgen der aktuellen CC Switch-Benutzeroberfläche. Die oben beschriebene manuelle Methode mit OPENAI_BASE_URL und OPENAI_API_KEY und CC Switch sind alternative Möglichkeiten, Codex zu konfigurieren. Für einen eindeutigen CC-Switch-Test entfernen Sie nur veraltete OPENAI_BASE_URL- oder OPENAI_API_KEY-Werte, die auf einen anderen Anbieter oder Schlüssel verweisen. Von Ihrer Shell übernommene Werte können den in CC Switch aktivierten Anbieter überschreiben oder mit ihm in Konflikt geraten.

​
1. CC Switch installieren

Laden Sie CC Switch von ccswitch.io oder dem offiziellen GitHub-Repository herunter. Installieren Sie es für Ihr Betriebssystem und öffnen Sie dann die App.

​
2. Öffnen Sie das Codex-Anbieter-Panel

Wählen Sie Codex in CC Switch aus. Dadurch wird das Anbieter-Panel geöffnet, das die Konfiguration steuert, die von neuen Codex-Sitzungen verwendet wird. Öffnen Sie das Codex-Anbieter-Panel und wählen Sie die Schaltfläche „Anbieter hinzufügen“ in CC Switch aus

​
3. Flatkey als benutzerdefinierten Anbieter hinzufügen

Wählen Sie Custom Provider und fügen Sie einen Anbieter mit diesen Werten hinzu: Geben Sie die aktuellen Flatkey-Anbieterfelder in CC Switch ein
Behandeln Sie Ihren API-Schlüssel als vertraulich. Nehmen Sie ihn nicht in Screenshots oder exportierte oder geteilte Anbieterkonfigurationen auf. Falls er offengelegt wird, widerrufen oder erneuern Sie den Schlüssel in Flatkey und ersetzen Sie ihn dann in CC Switch.
Flatkey unterstützt die Responses-API nativ. Local Routing in CC Switch ist für diese Einrichtung nicht erforderlich, lassen Sie es also deaktiviert.

​
4. Modell konfigurieren

Suchen Sie Flatkey im Codex-Anbieter-Panel in CC Switch und klicken Sie dann auf Edit. Um das von neuen Codex-Sitzungen verwendete Modell zu ändern, setzen Sie Default Model auf eine exakte Modell-ID aus dem Flatkey Model Directory. Verwenden Sie keinen Anzeigenamen und raten Sie keine ID. Zum Beispiel können Sie eines dieser Textgenerierungsmodelle in das Feld Default Model von CC Switch eingeben:
Um weitere Modelle in CC Switch hinzuzufügen oder zu bearbeiten und sie im /model-Menü der Codex CLI anzuzeigen, verwenden Sie Model Mapping:
  1. Klicken Sie auf Fetch Models, um verfügbare Modelle von Flatkey zu laden. Falls das benötigte Modell fehlt, klicken Sie auf Add Model.
  2. Bearbeiten Sie den Menu Display Name der Zuordnung. Dies ist die im /model-Menü angezeigte Bezeichnung.
  3. Setzen Sie Actual Request Model auf die exakte ID aus dem Model Directory, z. B. claude-sonnet-4-6 oder gemini-2.5-flash. Codex sendet diese ID in Anfragen, nicht die Menübezeichnung.
Model Mapping steuert den Eintrag im /model-Menü und die zugehörige Anfrage-ID. Es sorgt nicht dafür, dass ein inkompatibles Modell mit Codex funktioniert. Nach dem Ändern einer Zuordnung folgen Sie den unten stehenden Schritten, um den Anbieter zu speichern und Codex neu zu starten, bevor die aktualisierte Modellliste wirksam wird. Nachdem Sie Flatkey gespeichert und aktiviert haben, verwenden neue Codex-Sitzungen das in CC Switch festgelegte Default Model. Um es nur für einen Befehl zu überschreiben, übergeben Sie dieselbe exakte ID:
Wählen Sie ein Textgenerierungsmodell, das über Flatkey verfügbar und mit dem Codex-Anfrageformat kompatibel ist. Verwenden Sie keine Bild-, Audio- oder Embedding-Modelle mit Codex CLI. Betrachten Sie nach dem Senden einer Anfrage die Flatkey Usage Logs als maßgeblich für das tatsächlich verwendete Modell. Weitere Modelle abrufen oder hinzufügen und ihre Codex-CLI-Modellzuordnungen konfigurieren

​
5. Flatkey speichern und aktivieren

Speichern Sie den Anbieter und aktivieren Sie dann Flatkey im Codex-Anbieter-Panel. Bestätigen Sie, dass Flatkey der aktive Anbieter ist, bevor Sie Codex starten. Bestätigen Sie, dass der Flatkey-Codex-Anbieter verwendet wird

​
6. Neu starten und überprüfen

Beenden Sie die bestehende Codex-Sitzung und deren Prozess. Schließen Sie das spezifische Terminalfenster oder den Tab, in dem Codex ausgeführt wurde, nicht unbeteiligte Terminals. Öffnen Sie ein neues Terminal, das keine veralteten relevanten OPENAI_BASE_URL- oder OPENAI_API_KEY-Werte übernimmt. Wechseln Sie in ein kleines oder leeres Verzeichnis und starten Sie eine neue Codex-Sitzung. Geben Sie /model ein, bestätigen Sie, dass das hinzugefügte oder bearbeitete Modell erscheint, und wählen Sie das gewünschte Modell aus. Senden Sie dann eine minimale Anfrage. Überprüfen Sie eine neue Codex-CLI-Sitzung mit einer minimalen OK-Antwort Öffnen Sie dann die Flatkey Usage Logs und bestätigen Sie die tatsächliche Anfrage. Überprüfen Sie deren Modell, Eingabe- und Ausgabe-Tokens, Latenz und Kosten.
Eine Agenten-Anfrage kann Systemprompts, Tool-Definitionen, Konversationsverlauf, Dateien und Befehlsergebnisse enthalten. Verwenden Sie für Konnektivitätsprüfungen einen kleinen Kontext, damit die Token-Anzahl und die Kosten leicht überprüfbar bleiben.

​
Zurück zu einem anderen Anbieter wechseln

Öffnen Sie das Codex-Anbieter-Panel in CC Switch, wählen Sie den gewünschten Anbieter aus und aktivieren Sie ihn. Beenden Sie bestehende Codex-Sitzungen und -Prozesse und öffnen Sie dann ein neues Terminal, das keine veralteten relevanten OPENAI_BASE_URL- oder OPENAI_API_KEY-Werte übernimmt. Starten Sie eine neue Sitzung.

​
CC Switch Fehlerbehebung

​
Codex CLI ausführen

Sobald die Umgebungsvariablen gesetzt sind, verwenden Sie Codex wie gewohnt:
oder im interaktiven Modus:
Alle Anfragen werden über Flatkey geleitet und gegen Ihr Prepaid-Guthaben zu den vergünstigten Flatkey-Tarifen abgerechnet.

​
Manuelle Einrichtung der Umgebungsvariablen überprüfen

Dieser Abschnitt gilt nur für die manuelle Methode mit OPENAI_BASE_URL und OPENAI_API_KEY. Wenn Sie Codex mit CC Switch konfiguriert haben, folgen Sie stattdessen dem obigen Abschnitt Neu starten und überprüfen. Führen Sie für die manuelle Methode einen Codex-Befehl aus und prüfen Sie die Usage Logs. Sie sollten die Anfrage mit Modell und Token-Anzahl protokolliert sehen. Falls keine Anfrage erscheint, bestätigen Sie, dass beide Variablen in der aktuellen Shell-Sitzung korrekt gesetzt sind.
Nutzen Sie die 200-$-Aufladestufe für den besten effektiven Tarif bei anhaltender Codex-Nutzung — der gestaffelte Bonus senkt die Kosten auf bis zu 50 % des offiziellen GPT-Preises.

​
Fehlerbehebung bei der manuellen Einrichtung der Umgebungsvariablen

Die folgende Tabelle gilt nur für die manuelle Methode mit OPENAI_BASE_URL und OPENAI_API_KEY. Wenn Sie Codex mit CC Switch konfiguriert haben, verwenden Sie den obigen Abschnitt CC Switch Fehlerbehebung.