Codex CLI

Richte OpenAI Codex CLI mit CometAPI ein: Konfiguriere openai_base_url oder einen benutzerdefinierten Provider in config.toml, speichere deinen API-Schlüssel in auth.json und beginne mit dem Coden mit einem aktuellen Modell.

Verwende diese Anleitung, um Codex CLI mit CometAPI als Modell-Provider auszuführen.

Offizielle Referenzen:

• Codex CLI README
• Codex Authentication
• Codex Advanced Configuration

Die Modellverfügbarkeit ändert sich häufig. Die folgenden Beispiele verwenden your-model-id — ersetze sie durch eine aktuelle, fürs Coding geeignete Modell-ID von der CometAPI Models page.

​

Voraussetzungen

Anforderung	Details
Betriebssystem	macOS 12+, Linux (Ubuntu 20.04+ / Debian 10+) oder Windows 11 über WSL2
Node.js	22+ (LTS empfohlen)
Git	2.23+ empfohlen
CometAPI-Schlüssel	Hol dir einen im CometAPI Dashboard (beginnt mit sk-)

​

Codex CLI installieren

npm i -g @openai/codex

Oder über Homebrew:

brew install --cask codex

Überprüfe die Installation:

codex --version

​

CometAPI konfigurieren

Es gibt zwei Möglichkeiten, Codex auf CometAPI zu verweisen. Wähle die Variante, die am besten zu deinem Workflow passt.

Einfach: openai_base_url

Die einfachste Option — leite den integrierten OpenAI-Provider mit einer einzigen Zeile zu CometAPI um. Es ist nicht nötig, einen benutzerdefinierten Provider zu definieren.

Erstelle ~/.codex/config.toml:

model = "your-model-id"
openai_base_url = "https://api.cometapi.com/v1"

Benannter Provider

Definiere einen benannten cometapi-Provider. Nützlich, wenn du zwischen mehreren Providern mit --profile oder model_provider wechseln möchtest.

Erstelle ~/.codex/config.toml:

model = "your-model-id"
model_provider = "cometapi"

[model_providers.cometapi]
name = "CometAPI"
base_url = "https://api.cometapi.com/v1"
env_key = "OPENAI_API_KEY"

env_key teilt Codex mit, welche Umgebungsvariable deinen API-Schlüssel enthält. Codex liest den Wert von OPENAI_API_KEY zur Laufzeit — das ist nicht dein tatsächlicher Schlüssel.

​

Deinen API-Schlüssel speichern

Erstelle ~/.codex/auth.json:

{
  "OPENAI_API_KEY": "sk-your-cometapi-key"
}

Ersetze sk-your-cometapi-key durch deinen tatsächlichen CometAPI-Schlüssel.

Diese Datei ist verpflichtend. Ohne einen gültigen OPENAI_API_KEY-Eintrag in auth.json beendet sich Codex mit API key auth is missing a key.

​

Codex starten

cd your-project
codex

Beim ersten Start fordert Codex dich auf, ein Theme auszuwählen und die Sicherheitseinstellungen zu bestätigen.

​

Modell pro Sitzung überschreiben

Wechsle für einen einzelnen Durchlauf zu einem anderen Modell, ohne config.toml zu bearbeiten:

codex --model your-model-id

​

Alternative: Umgebungsvariable

Anstelle von auth.json kannst du den Schlüssel direkt exportieren:

export OPENAI_API_KEY="sk-your-cometapi-key"
codex

Dadurch wird der Schlüssel nur für die aktuelle Terminal-Sitzung gesetzt. Für dauerhafte Speicherung füge die export-Zeile zu ~/.zshrc oder ~/.bashrc hinzu.

​

Fehlerbehebung

Symptom	Lösung
API key auth is missing a key	Stelle sicher, dass ~/.codex/auth.json "OPENAI_API_KEY": "sk-..." enthält
Login-Aufforderung erscheint unerwartet	Lösche die veraltete ~/.codex/auth.json und erstelle sie mit deinem CometAPI-Schlüssel neu
Modell nicht gefunden	Prüfe die Models page auf aktuell verfügbare Modelle
Zeitüberschreitung bei der Verbindung	Bestätige, dass openai_base_url oder base_url in config.toml auf https://api.cometapi.com/v1 gesetzt ist
Windows-Probleme	Codex benötigt WSL2 unter Windows — natives CMD/PowerShell wird nicht unterstützt