Zum Hauptinhalt springen

​
Einführung

Codex CLI ist der quelloffene Terminal-Coding-Agent von OpenAI, der Dateien lesen und schreiben, Befehle ausführen, Bugs beheben und vollständige Programmieraufgaben direkt in der Kommandozeile erledigen kann. Durch die Anbindung über APIMart können Sie in Codex CLI frei mehrere Modelle verwenden – darunter GPT und Claude – mit flexiblerer und wettbewerbsfähigerer Preisgestaltung.

​
Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass Sie:
  1. Node.js installiert haben Laden Sie es von der Node.js-Website (empfohlen: neueste LTS, v20 oder neuer) herunter, um Codex CLI über npm zu installieren
  2. Einen APIMart-API-Schlüssel erhalten haben Melden Sie sich in der APIMart-Konsole an, um Ihren API-Schlüssel zu erhalten (beginnt mit sk-)
Tipp: Wenn Sie noch kein APIMart-Konto haben, registrieren Sie sich zuerst bei APIMart und holen Sie sich Ihren API-Schlüssel.

​
Schritt 1: Codex CLI installieren

Wählen Sie eine der folgenden Methoden zur Installation:
Global mit npm installieren – funktioniert auf allen Betriebssystemen:
npm install -g @openai/codex
Bei Berechtigungsproblemen sudo voranstellen (macOS / Linux).

​
Installation überprüfen

Führen Sie nach der Installation den folgenden Befehl zur Bestätigung aus: 
codex --version
Wird eine Versionsnummer ausgegeben, war die Installation erfolgreich.

​
Schritt 2: APIMart-API konfigurieren

Codex CLI verwaltet Modellanbieter über Konfigurationsdateien im Verzeichnis ~/.codex/. Alles, was wir tun müssen, ist einen benutzerdefinierten Anbieter hinzuzufügen, der auf APIMart verweist.

​
2.1 Konfigurationsverzeichnis finden

  • macOS / Linux: ~/.codex/
  • Windows: C:\Users\<username>\.codex\
Existiert das Verzeichnis nicht, führen Sie einmal codex im Terminal aus und drücken Sie Ctrl + C zum Beenden – es wird automatisch erstellt.

​
2.2 API-Schlüssel konfigurieren

Erstellen oder bearbeiten Sie im Konfigurationsverzeichnis die Datei auth.json und geben Sie Ihren APIMart-Schlüssel ein: 
{
  "OPENAI_API_KEY": "sk-xxxxxxxxxxxx"
}
FeldBeschreibung
OPENAI_API_KEYIhr APIMart-API-Schlüssel (beginnt mit sk-)

​
2.3 Modellanbieter konfigurieren

Erstellen oder bearbeiten Sie im Konfigurationsverzeichnis die Datei config.toml und fügen Sie den APIMart-Anbieter hinzu: 
# Default model
model = "gpt-5.5"
# Default provider — matches [model_providers.apimart] below
model_provider = "apimart"

# APIMart provider configuration
[model_providers.apimart]
name = "APIMart"
base_url = "https://api.apimart.ai/v1"
wire_api = "responses"
requires_openai_auth = true
FeldBeschreibung
modelStandard-Modell-ID – wählen Sie eine aus der Modellliste unten
model_providerStandardanbieter – muss mit der ID innerhalb [model_providers.xxx] übereinstimmen
nameAnzeigename des Anbieters – kann angepasst werden
base_urlAPIMart-OpenAI-kompatibler URL – fest auf https://api.apimart.ai/v1
wire_apiWire-Protokoll – aktuelle Codex-Versionen erfordern responses (Responses API)
requires_openai_authAuf true setzen, um sich mit dem Schlüssel aus auth.json zu authentifizieren
Nach dem Speichern beider Dateien starten Sie Codex CLI neu, damit die Änderungen wirksam werden.
Stellen Sie sicher, dass auth.json gültiges JSON und config.toml gültiges TOML ist. Verwenden Sie keine Vollbreite- / Smart-Quotes, sonst wird die Konfiguration nicht angewendet.

​
Schritt 3: Loslegen

​
Konfiguration überprüfen

Führen Sie in einem beliebigen Projektverzeichnis den folgenden Befehl aus, um zu bestätigen, dass alles eingerichtet ist: 
codex "Introduce yourself in one sentence"
Erhalten Sie eine KI-Antwort, funktioniert die Konfiguration. Bei einem Sign-in-Bildschirm oder 401/403-Fehlern siehe FAQ-Abschnitt unten.

​
Interaktiver Modus

Führen Sie codex direkt aus, um die interaktive Benutzeroberfläche zu betreten – ideal für vollständige Programmieraufgaben: 
codex
Beschreiben Sie darin, was Sie benötigen, in natürlicher Sprache, z. B.: 
Create an Express.js server with a JSON-returning health check endpoint
Codex analysiert Ihr Projekt, generiert Code, führt Befehle aus und fragt vor sensiblen Operationen nach Bestätigung.

​
Genehmigungsmodi

Beim ersten Start fragt Codex Sie nach einem Genehmigungslevel:
ModusBeschreibung
Read OnlyNur Dateilesungen sind erlaubt – jede Änderung oder jeder Befehl erfordert Bestätigung
AutoKann Dateien lesen/schreiben und Befehle im Arbeitsverzeichnis ausführen (empfohlen)
Full AccessFührt jede Operation ohne Bestätigung aus – mit Vorsicht zu verwenden
Wir empfehlen, mit Auto-Modus zu starten. Tippen Sie /approvals in der interaktiven UI, um ihn jederzeit zu ändern.

​
Modelle wechseln

Tippen Sie in der interaktiven UI /model, um schnell zu wechseln, oder ändern Sie das model-Feld in config.toml und starten Sie neu.

​
Unterstützte Modelle

Für Codex CLI werden die folgenden Modelle der GPT-5-Serie empfohlen:
Modell-IDStärkenEmpfohlene Anwendungsfälle
gpt-5.5Neuestes Flaggschiff, top Coding-FähigkeitErste Wahl für Codex, komplexe Engineering-Aufgaben
gpt-5.4Vorgängergeneration-Flaggschiff, sehr fähigKomplexes Coding, Architekturdesign
gpt-5.4-miniLeichtgewichtig, schnell, kosteneffizientTägliches Coding, schnelle Iteration
gpt-5.3-codexCoding-Modell für Codex optimiertAgentische Coding-Aufgaben
gpt-5.2Stabil und ausgewogenRoutine-Coding-Aufgaben
Tipps zur Modellauswahl: Die obige GPT-5-Serie passt am besten zu Codex CLI. Für das beste Erlebnis bevorzugen Sie gpt-5.5; gpt-5.3-codex ist speziell für die agentischen Coding-Szenarien von Codex optimiert.

​
Häufige Befehle

Häufig verwendete Befehle und Tastenkürzel in Codex CLI:
BefehlBeschreibung
codexInteraktive UI betreten
codex "task"Mit Anfangsanweisung starten
codex exec "task"Nicht-interaktiver Modus – ausführen und beenden
codex --model gpt-5.4Mit angegebenem Modell starten
codex --versionVersionsnummer anzeigen
/modelModell innerhalb der interaktiven UI wechseln
/approvalsGenehmigungsmodus in der UI anpassen
Ctrl + CInteraktive UI verlassen

​
FAQ

​
Q1: Nach dem Start erscheint ein ChatGPT-Anmeldebildschirm?

Wenn nach dem Start „Sign in with ChatGPT” oder Ähnliches erscheint, ist die Konfiguration nicht wirksam geworden. Fehlerbehebung:
  1. Stellen Sie sicher, dass sowohl config.toml als auch auth.json in ~/.codex/ liegen
  2. Prüfen Sie, dass model_provider in config.toml auf apimart gesetzt ist
  3. Prüfen Sie, dass auth.json gültiges JSON ist und der Schlüssel vollständig eingegeben wurde

​
Q2: 401 / 403 Fehler?

StatuscodeBedeutungLösung
401 UnauthorizedFehlender oder ungültiger API-SchlüsselPrüfen Sie den Schlüssel in auth.json – sollte mit sk- beginnen
403 ForbiddenUnzureichende Berechtigung oder abgelaufener SchlüsselGehen Sie zur Konsole, um den Schlüssel zu überprüfen
Stellen Sie außerdem sicher, dass base_url auf https://api.apimart.ai/v1 gesetzt ist, nicht auf die offizielle OpenAI-URL.

​
Q3: Verbindung fehlgeschlagen?

  1. Prüfen Sie Ihre Netzwerkverbindung
  2. Stellen Sie sicher, dass base_url in config.toml korrekt ist
  3. Wenn Sie hinter einem Proxy sind, stellen Sie sicher, dass er den Zugriff auf api.apimart.ai erlaubt

​
Q4: wire_api = "chat" wird nicht mehr unterstützt?

Aktuelle Codex-CLI-Versionen (0.84.0 und neuer) haben das chat-Protokoll entfernt. Aktualisieren Sie wire_api in config.toml auf responses: 
wire_api = "responses"
APIMart unterstützt die Responses API – starten Sie Codex nach der Änderung einfach neu.

​
Q5: Tool-Aufrufe oder Ausführungen schlagen fehl?

Stellen Sie sicher, dass wire_api in config.toml auf responses gesetzt ist. Wenn Sie weiterhin auf Kompatibilitätsprobleme stoßen, wechseln Sie zu einem empfohlenen Modell der GPT-5-Serie (z. B. gpt-5.5, gpt-5.3-codex) – sie passen zuverlässiger zu Codex CLI.

​
Q6: Umgebungsvariablen statt auth.json verwenden?

Sie können den Schlüssel auch über eine Umgebungsvariable konfigurieren. Ändern Sie den Anbieter-Block in config.toml zu: 
[model_providers.apimart]
name = "APIMart"
base_url = "https://api.apimart.ai/v1"
wire_api = "responses"
env_key = "APIMART_API_KEY"
Setzen Sie dann die Umgebungsvariable APIMART_API_KEY auf Ihren APIMart-Schlüssel. auth.json wird in diesem Setup nicht mehr benötigt.

​
Q7: Wie wechsle ich Modelle?

Zwei Wege:
  1. In der interaktiven UI: Tippen Sie /model, um zu wechseln
  2. Konfiguration bearbeiten: Ändern Sie das model-Feld in config.toml und starten Sie Codex CLI neu

​
Q8: Wie prüfe ich Nutzung und Abrechnung?

Melden Sie sich in der APIMart-Konsole an, um API-Aufruf-Statistiken, Token-Verbrauchsdetails und Kostentrends zu sehen.

​
Support und Hilfe

Wenn Sie bei der Verwendung von Codex CLI auf Probleme stoßen:

Mit APIMart loslegen

Registrieren Sie sich jetzt bei APIMart, holen Sie sich Ihren API-Schlüssel und erleben Sie einen Multi-Modell-Programmier-Assistenten in Codex CLI!