Zum Hauptinhalt springen
Verwenden Sie diesen Leitfaden, um Codex CLI mit CometAPI als model provider auszuführen. Offizielle Referenzen:
Die Modellverfügbarkeit ändert sich häufig. Die folgenden Beispiele verwenden your-model-id — ersetzen Sie diese Angabe durch eine aktuelle, fürs Programmieren geeignete model ID von der CometAPI Models-Seite.

​
Voraussetzungen

AnforderungDetails
OSmacOS 12+, Linux (Ubuntu 20.04+ / Debian 10+) oder Windows 11 über WSL2
Node.js22+ (LTS empfohlen)
Git2.23+ empfohlen
CometAPI-SchlüsselErhalten Sie einen im CometAPI Dashboard (beginnt mit sk-)

​
Codex CLI installieren

npm i -g @openai/codex
Oder über Homebrew: 
brew install --cask codex
Überprüfen Sie die Installation: 
codex --version

​
CometAPI konfigurieren

Es gibt zwei Möglichkeiten, Codex auf CometAPI zu verweisen. Wählen Sie die Variante, die zu Ihrem Workflow passt.
Die einfachste Option — leiten Sie den integrierten OpenAI-provider mit einer einzigen Zeile an CometAPI um. Es ist nicht nötig, einen benutzerdefinierten provider zu definieren.Erstellen Sie ~/.codex/config.toml:
model = "your-model-id"
openai_base_url = "https://api.cometapi.com/v1"

​
Ihren API-Schlüssel speichern

Erstellen Sie ~/.codex/auth.json: 
{
  "OPENAI_API_KEY": "sk-your-cometapi-key"
}
Ersetzen Sie sk-your-cometapi-key durch Ihren tatsächlichen CometAPI-Schlüssel.
Diese Datei ist zwingend erforderlich. 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 Sie auf, ein Theme auszuwählen und die Sicherheitseinstellungen zu bestätigen.

​
Modell pro Sitzung überschreiben

Wechseln Sie für einen einzelnen Lauf zu einem anderen Modell, ohne config.toml zu bearbeiten: 
codex --model your-model-id

​
Alternative: Umgebungsvariable

Exportieren Sie den Schlüssel statt über auth.json direkt: 
export OPENAI_API_KEY="sk-your-cometapi-key"
codex
Dadurch wird der Schlüssel nur für die aktuelle Terminalsitzung gesetzt. Für dauerhafte Speicherung fügen Sie die export-Zeile zu ~/.zshrc oder ~/.bashrc hinzu.

​
Fehlerbehebung

SymptomLösung
API key auth is missing a keyStellen Sie sicher, dass ~/.codex/auth.json "OPENAI_API_KEY": "sk-..." enthält
Login-Aufforderung erscheint unerwartetLöschen Sie die veraltete ~/.codex/auth.json und erstellen Sie sie mit Ihrem CometAPI-Schlüssel neu
Modell nicht gefundenPrüfen Sie die Models-Seite auf verfügbare Modelle
Verbindungs-TimeoutBestätigen Sie, dass openai_base_url oder base_url in config.toml auf https://api.cometapi.com/v1 gesetzt ist
Windows-ProblemeCodex erfordert WSL2 unter Windows — natives CMD/PowerShell wird nicht unterstützt