APIMart in Codex CLI verwenden

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:

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
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:

npm (empfohlen)
Homebrew (macOS)

Global mit npm installieren – funktioniert auf allen Betriebssystemen:

npm install -g @openai/codex

Bei Berechtigungsproblemen sudo voranstellen (macOS / Linux).

macOS-Nutzer können auch mit Homebrew installieren:

brew install codex

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"
}

Feld	Beschreibung
`OPENAI_API_KEY`	Ihr 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

Feld	Beschreibung
`model`	Standard-Modell-ID – wählen Sie eine aus der Modellliste unten
`model_provider`	Standardanbieter – muss mit der ID innerhalb `[model_providers.xxx]` übereinstimmen
`name`	Anzeigename des Anbieters – kann angepasst werden
`base_url`	APIMart-OpenAI-kompatibler URL – fest auf `https://api.apimart.ai/v1`
`wire_api`	Wire-Protokoll – aktuelle Codex-Versionen erfordern `responses` (Responses API)
`requires_openai_auth`	Auf `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:

Modus	Beschreibung
Read Only	Nur Dateilesungen sind erlaubt – jede Änderung oder jeder Befehl erfordert Bestätigung
Auto	Kann Dateien lesen/schreiben und Befehle im Arbeitsverzeichnis ausführen (empfohlen)
Full Access	Fü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-ID	Stärken	Empfohlene Anwendungsfälle
`gpt-5.5`	Neuestes Flaggschiff, top Coding-Fähigkeit	Erste Wahl für Codex, komplexe Engineering-Aufgaben
`gpt-5.4`	Vorgängergeneration-Flaggschiff, sehr fähig	Komplexes Coding, Architekturdesign
`gpt-5.4-mini`	Leichtgewichtig, schnell, kosteneffizient	Tägliches Coding, schnelle Iteration
`gpt-5.3-codex`	Coding-Modell für Codex optimiert	Agentische Coding-Aufgaben
`gpt-5.2`	Stabil und ausgewogen	Routine-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:

Befehl	Beschreibung
`codex`	Interaktive UI betreten
`codex "task"`	Mit Anfangsanweisung starten
`codex exec "task"`	Nicht-interaktiver Modus – ausführen und beenden
`codex --model gpt-5.4`	Mit angegebenem Modell starten
`codex --version`	Versionsnummer anzeigen
`/model`	Modell innerhalb der interaktiven UI wechseln
`/approvals`	Genehmigungsmodus in der UI anpassen
`Ctrl + C`	Interaktive 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:

Stellen Sie sicher, dass sowohl config.toml als auch auth.json in ~/.codex/ liegen
Prüfen Sie, dass model_provider in config.toml auf apimart gesetzt ist
Prüfen Sie, dass auth.json gültiges JSON ist und der Schlüssel vollständig eingegeben wurde

Q2: 401 / 403 Fehler?

Statuscode	Bedeutung	Lösung
`401 Unauthorized`	Fehlender oder ungültiger API-Schlüssel	Prüfen Sie den Schlüssel in `auth.json` – sollte mit `sk-` beginnen
`403 Forbidden`	Unzureichende Berechtigung oder abgelaufener Schlüssel	Gehen 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?

Prüfen Sie Ihre Netzwerkverbindung
Stellen Sie sicher, dass base_url in config.toml korrekt ist
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:

In der interaktiven UI: Tippen Sie /model, um zu wechseln
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:

📚 APIMart-Dokumentationszentrum
💬 Discord-Community
🐦 Twitter @APIMart_
📧 Technischer Support: zhihong@apimart.ai

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!

Documentation Index

​Einführung

​Voraussetzungen

​Schritt 1: Codex CLI installieren

​Installation überprüfen

​Schritt 2: APIMart-API konfigurieren

​2.1 Konfigurationsverzeichnis finden

​2.2 API-Schlüssel konfigurieren

​2.3 Modellanbieter konfigurieren

​Schritt 3: Loslegen

​Konfiguration überprüfen

​Interaktiver Modus

​Genehmigungsmodi

​Modelle wechseln

​Unterstützte Modelle

​Häufige Befehle

​FAQ

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

​Q2: 401 / 403 Fehler?

​Q3: Verbindung fehlgeschlagen?

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

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

​Q6: Umgebungsvariablen statt auth.json verwenden?

​Q7: Wie wechsle ich Modelle?

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

​Support und Hilfe

Mit APIMart loslegen

Einführung

Voraussetzungen

Schritt 1: Codex CLI installieren

Installation überprüfen

Schritt 2: APIMart-API konfigurieren

2.1 Konfigurationsverzeichnis finden

2.2 API-Schlüssel konfigurieren

2.3 Modellanbieter konfigurieren

Schritt 3: Loslegen

Konfiguration überprüfen

Interaktiver Modus

Genehmigungsmodi

Modelle wechseln

Unterstützte Modelle

Häufige Befehle

FAQ

Q1: Nach dem Start erscheint ein ChatGPT-Anmeldebildschirm?

Q2: 401 / 403 Fehler?

Q3: Verbindung fehlgeschlagen?

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

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

Q6: Umgebungsvariablen statt auth.json verwenden?

Q7: Wie wechsle ich Modelle?

Q8: Wie prüfe ich Nutzung und Abrechnung?

Support und Hilfe