Zum Hauptinhalt springen
Verwende diese Anleitung, um Codex CLI mit CometAPI als Modell-Provider auszuführen. Offizielle Referenzen:
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

AnforderungDetails
BetriebssystemmacOS 12+, Linux (Ubuntu 20.04+ / Debian 10+) oder Windows 11 über WSL2
Node.js22+ (LTS empfohlen)
Git2.23+ empfohlen
CometAPI-SchlüsselHol 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.
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"

​
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

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