Codex Integration mit benutzerdefinierten CodingPlanX-Modellen

Verwenden Sie den CodingPlanX.ai API-Schlüssel, um die OpenAI Codex CLI zu konfigurieren

Codex Integrationskonfigurationsleitfaden

CodingPlanX.ai unterstützt nicht nur Claude Code, sondern auch die OpenAI Codex CLI. Nach dem Kauf eines Pakets teilen sich Claude Code und Codex das Paketkontingent, sodass Sie flexibel wählen können, welches Tool Sie verwenden möchten.

Codex CLI installieren

npm install -g @openai/codex

Installation überprüfen:

codex --version

Neueste Version: v0.114.0 (2026-03-11), unterstützt das Skills-System, die Hooks-Engine und andere neue Funktionen.

Verfügbare Modelle

Die folgenden Codex/GPT-Modelle können über CodingPlanX.ai verwendet werden:

Alle Modelle teilen sich das CodingPlanX.ai-Paketkontingent mit Claude Code.

Konfigurationsübersicht

Codex CLI erfordert die Konfiguration von zwei Dateien:

• ~/.codex/config.toml - Dienstkonfiguration
• ~/.codex/auth.json - Authentifizierungskonfiguration

---

Windows-Konfiguration

Schritt 1: Konfigurationsverzeichnis erstellen

mkdir %HOMEPATH%\.codex

Schritt 2: config.toml erstellen

Erstellen Sie die Konfigurationsdatei unter ~/.codex/config.toml:

model_provider = "crs"
model = "gpt-5.3-codex-spark"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.crs]
name = "crs"
base_url = "https://api.codingplanx.ai/v1"
wire_api = "responses"
requires_openai_auth = true
env_key = "CRS_OAI_KEY"

Schritt 3: auth.json erstellen

Erstellen Sie die Authentifizierungsdatei unter ~/.codex/auth.json:

{
  "OPENAI_API_KEY": "cr_xxxxxxxxxx"
}

Ersetzen Sie cr_xxxxxxxxxx durch Ihren CodingPlanX.ai API-Schlüssel.

Schritt 4: Umgebungsvariablen festlegen (Optional)

Wenn Sie es vorziehen, den Schlüssel über Umgebungsvariablen bereitzustellen:

# Temporäre Einstellung
$env:CRS_OAI_KEY = "cr_xxxxxxxxxx"

# Dauerhafte Einstellung
[System.Environment]::SetEnvironmentVariable("CRS_OAI_KEY", "cr_xxxxxxxxxx", [System.EnvironmentVariableTarget]::User)

Setzen Sie dann OPENAI_API_KEY in auth.json auf null.

---

macOS-Konfiguration

Schritt 1: Konfigurationsverzeichnis erstellen

mkdir -p ~/.codex

Schritt 2: config.toml erstellen

cat > ~/.codex/config.toml << 'EOF'
model_provider = "crs"
model = "gpt-5.3-codex-spark"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.crs]
name = "crs"
base_url = "https://api.codingplanx.ai/v1"
wire_api = "responses"
requires_openai_auth = true
env_key = "CRS_OAI_KEY"
EOF

Schritt 3: auth.json erstellen

cat > ~/.codex/auth.json << 'EOF'
{
  "OPENAI_API_KEY": "cr_xxxxxxxxxx"
}
EOF

Ersetzen Sie cr_xxxxxxxxxx durch Ihren CodingPlanX.ai API-Schlüssel.

Schritt 4: Umgebungsvariablen festlegen (Optional)

Wenn Sie es vorziehen, den Schlüssel über Umgebungsvariablen bereitzustellen:

# Temporäre Einstellung
export CRS_OAI_KEY="cr_xxxxxxxxxx"

# Dauerhafte Einstellung
echo 'export CRS_OAI_KEY="cr_xxxxxxxxxx"' >> ~/.zshrc
source ~/.zshrc

Setzen Sie dann OPENAI_API_KEY in auth.json auf null.

---

Linux-Konfiguration

Schritt 1: Konfigurationsverzeichnis erstellen

mkdir -p ~/.codex

Schritt 2: config.toml erstellen

cat > ~/.codex/config.toml << 'EOF'
model_provider = "crs"
model = "gpt-5.3-codex-spark"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.crs]
name = "crs"
base_url = "https://api.codingplanx.ai/v1"
wire_api = "responses"
requires_openai_auth = true
env_key = "CRS_OAI_KEY"
EOF

Schritt 3: auth.json erstellen

cat > ~/.codex/auth.json << 'EOF'
{
  "OPENAI_API_KEY": "cr_xxxxxxxxxx"
}
EOF

Ersetzen Sie cr_xxxxxxxxxx durch Ihren CodingPlanX.ai API-Schlüssel.

Schritt 4: Umgebungsvariablen festlegen (Optional)

Wenn Sie es vorziehen, den Schlüssel über Umgebungsvariablen bereitzustellen:

# Temporäre Einstellung
export CRS_OAI_KEY="cr_xxxxxxxxxx"

# Dauerhafte Einstellung (Bash)
echo 'export CRS_OAI_KEY="cr_xxxxxxxxxx"' >> ~/.bashrc
source ~/.bashrc

# Dauerhafte Einstellung (Zsh)
echo 'export CRS_OAI_KEY="cr_xxxxxxxxxx"' >> ~/.zshrc
source ~/.zshrc

Setzen Sie dann OPENAI_API_KEY in auth.json auf null.

---

Konfiguration überprüfen

Führen Sie nach Abschluss der Konfiguration die Codex CLI zur Überprüfung aus:

codex

Erfolgsindikatoren

• Codex kann normal starten und sich mit dem Dienst verbinden
• Kann normal Code generieren und KI-Antworten erhalten
• Netzwerkanfragen laufen über den CodingPlanX.ai Proxy-Dienst

Häufige Probleme

Konfigurationsdatei nicht gefunden

Problem: Codex meldet, dass die Konfigurationsdatei nicht gefunden werden kann

Lösung:

1. Überprüfen Sie, ob der Pfad zur Konfigurationsdatei korrekt ist
2. Bestätigen Sie, dass das Verzeichnis ~/.codex/ existiert
3. Bestätigen Sie, dass die Dateien config.toml und auth.json existieren

API-Schlüssel-Authentifizierung fehlgeschlagen

Problem: Umgebungsvariable ungültig oder API-Schlüssel falsch

Lösung:

1. Überprüfen Sie, ob die Umgebungsvariable CRS_OAI_KEY korrekt eingestellt ist
2. Überprüfen Sie, ob das Format des API-Schlüssels korrekt ist (beginnt mit cr_)
3. Bestätigen Sie, dass der Schlüssel nicht abgelaufen ist, besuchen Sie die Konsole zur Überprüfung

Netzwerkverbindungsproblem

Problem: Keine Verbindung zum CodingPlanX.ai-Dienst möglich

Lösung:

1. Überprüfen Sie, ob die Netzwerkverbindung normal ist
2. Überprüfen Sie, ob die Konfiguration von base_url https://api.codingplanx.ai lautet