Zum Hauptinhalt springen

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

Verwenden Sie diese Anleitung, um Codex CLI mit CometAPI als model provider auszuführen. Offizielle Referenzen:
Für Codex müssen beide Dateien konfiguriert sein: ~/.codex/config.toml und ~/.codex/auth.json. Verwenden Sie für diese Integration kein Setup, das nur aus einer Base-URL besteht.

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

Erstellen oder bearbeiten Sie ~/.codex/config.toml mit dieser Provider-Konfiguration:
model_provider = "cometapi"
model = "gpt-5.5"

[model_providers.cometapi]
name = "CometAPI"
base_url = "https://api.cometapi.com/v1"
requires_openai_auth = true
Die Schlüssel model_provider und model müssen auf der obersten Ebene der Datei bleiben. Der Abschnitt [model_providers.cometapi] definiert den CometAPI-Endpunkt.
Wenn Sie Codex-Einstellungen über ein dotfiles-Repository verwalten, halten Sie die dotfiles-Kopie synchron mit ~/.codex/config.toml. Codex liest die Datei aus ~/.codex/config.toml.

Ihren API-Schlüssel speichern

Erstellen Sie ~/.codex/auth.json:
{
  "auth_mode": "apikey",
  "OPENAI_API_KEY": "sk-your-cometapi-key"
}
Ersetzen Sie sk-your-cometapi-key durch Ihren tatsächlichen CometAPI-Schlüssel.
Diese Datei ist erforderlich. auth_mode muss apikey sein, und OPENAI_API_KEY muss Ihren CometAPI-Schlüssel enthalten.

Codex starten

cd your-project
codex
Beim ersten Start fordert Codex Sie auf, ein Theme auszuwählen und die Sicherheitseinstellungen zu bestätigen.

Fehlerbehebung

SymptomLösung
API key auth is missing a keyKorrigieren Sie ~/.codex/auth.json. Sie muss "auth_mode": "apikey" und "OPENAI_API_KEY": "sk-..." enthalten
Anmeldeaufforderung erscheint unerwartetErstellen Sie ~/.codex/auth.json mit auth_mode auf apikey neu und starten Sie dann Codex neu
Codex verwendet weiterhin den standardmäßigen OpenAI-ProviderKorrigieren Sie ~/.codex/config.toml. model_provider muss cometapi sein
Anfragen erreichen CometAPI nichtKorrigieren Sie ~/.codex/config.toml. [model_providers.cometapi] muss requires_openai_auth = true enthalten
Verbindungs-Timeout oder falscher EndpunktKorrigieren Sie ~/.codex/config.toml. base_url muss https://api.cometapi.com/v1 sein
Modell nicht gefundenPrüfen Sie die Models-Seite auf verfügbare Modelle
Windows-ProblemeCodex erfordert WSL2 unter Windows — natives CMD/PowerShell wird nicht unterstützt