Codex-Schnellstart
Installieren Sie Codex unter Windows, macOS oder Linux, verbinden Sie einen Modelflare-API-Schlüssel und prüfen Sie eine Responses-API-Anfrage.
Mit dieser Anleitung wird Codex mit Modelflare verbunden und die erste Anfrage ausgeführt. Verwenden Sie Option A für die automatisierte Einrichtung. Verwenden Sie Option B, um zuerst Codex zu installieren, und erstellen Sie dann jede erforderliche Datei selbst.
1. Erstellen Sie einen API-Schlüssel
Melden Sie sich bei der Modelflare-Konsole an, öffnen Sie API-Schlüssel und erstellen Sie einen Schlüssel, der auf gpt-5.6-sol zugreifen kann. Wählen Sie eine beliebige verfügbare, nicht standardmäßige Gruppe aus, in der das Modell aufgeführt ist. Es gibt keine einzelne erforderliche Gruppe.
Halten Sie den Schlüssel bereit. Sie können das Installationsprogramm verwenden oder dieselben Dateien manuell konfigurieren.
2. Wählen Sie eine Einrichtungsmethode
Option A: Führen Sie das Installationsprogramm aus
Noch unsicher im Terminal? Öffnen Sie zuerst die interaktive Einführung. Das ist nur eine visuelle Probe und ändert Ihren Computer nicht.
macOS oder Linux
Führen Sie diesen Befehl als Ihr normaler Benutzer aus:
curl -fsSL https://modelflare.dev/install/codex.sh | sh
Wenn Sie bereits als root auf einem VPS oder Container angemeldet sind, verwenden Sie:
curl -fsSL https://modelflare.dev/install/codex.sh | MODELFLARE_ALLOW_ROOT=1 sh
Fügen Sie sudo nicht auf einem normalen PC hinzu. Das Skript installiert oder aktualisiert Codex, sichert vorhandene Dateien, fragt nach Ihrem Modelflare-API-Schlüssel und schreibt die Anbieterkonfiguration unter ~/.codex.
Windows PowerShell
Öffnen Sie PowerShell als Ihr normaler Windows-Benutzer und führen Sie Folgendes aus:
irm https://modelflare.dev/install/codex.ps1 | iex
Das Installationsprogramm fragt nach einer Sprache und Ihrem Modelflare-API-Schlüssel, überprüft den Zugriff auf gpt-5.6-sol und sichert vorhandene Dateien, bevor sie geändert werden. Wenn der Vorgang abgeschlossen ist, fahren Sie mit Überprüfen der Verbindung fort.
Option B: Erstellen Sie jede Codex-Datei selbst
Verwenden Sie diese Option, wenn Sie das Setup-Skript Modelflare nicht ausführen möchten. Befolgen Sie die Schritte der Reihe nach und verwenden Sie bei jedem Schritt den Befehlsblock für Ihr Betriebssystem.
Option B erstellt zwei Dateien unter Ihrem .codex-Verzeichnis auf Benutzerebene: config.toml und auth.json.
Schritt 1: Installieren Sie die Codex-CLI
Windows PowerShell
irm https://chatgpt.com/codex/install.ps1 | iex
codex --version
Linux
curl -fsSL https://chatgpt.com/codex/install.sh | sh
codex --version
macOS
curl -fsSL https://chatgpt.com/codex/install.sh | sh
codex --version
Schritt 2: Erstellen Sie das Verzeichnis .codex und geben Sie es ein
Windows PowerShell
New-Item -ItemType Directory -Force "$HOME\.codex" | Out-Null
Set-Location "$HOME\.codex"
Linux
mkdir -p ~/.codex
cd ~/.codex
macOS
mkdir -p ~/.codex
cd ~/.codex
Schritt 3: config.toml erstellen
Windows PowerShell
$config = @'
cli_auth_credentials_store = "file"
model_provider = "modelflare"
model = "gpt-5.6-sol"
model_reasoning_effort = "xhigh"
disable_response_storage = true
model_supports_reasoning_summaries = true
[model_providers.modelflare]
name = "Modelflare"
base_url = "https://modelflare.dev/v1"
wire_api = "responses"
requires_openai_auth = true
'@
$utf8NoBom = New-Object System.Text.UTF8Encoding -ArgumentList $false
[System.IO.File]::WriteAllText(
(Join-Path (Get-Location) "config.toml"),
$config,
$utf8NoBom
)
Linux
cat > config.toml << 'EOF'
cli_auth_credentials_store = "file"
model_provider = "modelflare"
model = "gpt-5.6-sol"
model_reasoning_effort = "xhigh"
disable_response_storage = true
model_supports_reasoning_summaries = true
[model_providers.modelflare]
name = "Modelflare"
base_url = "https://modelflare.dev/v1"
wire_api = "responses"
requires_openai_auth = true
EOF
chmod 600 config.toml
macOS
cat > config.toml << 'EOF'
cli_auth_credentials_store = "file"
model_provider = "modelflare"
model = "gpt-5.6-sol"
model_reasoning_effort = "xhigh"
disable_response_storage = true
model_supports_reasoning_summaries = true
[model_providers.modelflare]
name = "Modelflare"
base_url = "https://modelflare.dev/v1"
wire_api = "responses"
requires_openai_auth = true
EOF
chmod 600 config.toml
Schritt 4: auth.json erstellen
Ersetzen Sie YOUR_MODELFLARE_API_KEY im JSON-Objekt durch den vollständigen API-Schlüssel, den Sie in der Modelflare-Konsole erstellt haben. Die Datei muss gültiges JSON bleiben und das Feld OPENAI_API_KEY verwenden; fügen Sie keinen auth-Befehl im Provider hinzu. Aktuelle Codex-Versionen benötigen für diesen API-Key-Pfad requires_openai_auth = true.
Windows PowerShell
$authJson = @'
${CODEX_MANUAL_AUTH_JSON}
'@
$utf8NoBom = New-Object System.Text.UTF8Encoding -ArgumentList $false
[System.IO.File]::WriteAllText(
(Join-Path (Get-Location) "auth.json"),
$authJson,
$utf8NoBom
)
Linux
cat > auth.json << 'EOF'
${CODEX_MANUAL_AUTH_JSON}
EOF
chmod 600 auth.json
macOS
cat > auth.json << 'EOF'
${CODEX_MANUAL_AUTH_JSON}
EOF
chmod 600 auth.json
Schritt 5: Starten Sie Codex
Windows PowerShell
Set-Location $HOME
New-Item -ItemType Directory -Force "my-codex-project" | Out-Null
Set-Location "my-codex-project"
codex --model gpt-5.6-sol
Linux
cd ~
mkdir -p my-codex-project
cd my-codex-project
codex --model gpt-5.6-sol
macOS
cd ~
mkdir -p my-codex-project
cd my-codex-project
codex --model gpt-5.6-sol
3. Überprüfen Sie die Verbindung
Wenn Sie das Installationsprogramm verwendet haben, schließen Sie alle bereits geöffneten Codex CLI-, IDE- oder Desktop-Sitzungen vollständig. Öffnen Sie ein neues Terminal, geben Sie ein Projektverzeichnis ein und führen Sie Folgendes aus:
codex --model gpt-5.6-sol
Nach Abschluss der Konfiguration können Sie auch die Codex App herunterladen.
Dann fragen Sie Codex:
Antworten Sie mit einem Satz, der das aktive Modell und den Anbieter bestätigt.
Eine normale Reaktion bedeutet, dass die Einrichtung abgeschlossen ist.
Häufige Probleme
| Symptom | Was zu tun ist |
|---|---|
| 401 | Kopieren Sie den API-Schlüssel erneut und bestätigen Sie, dass er nicht gelöscht oder deaktiviert wurde. |
| model_not_found | Bearbeiten Sie den API-Schlüssel und wählen Sie eine Gruppe aus, die auf gpt-5.6-sol zugreifen kann. |
| ChatGPT-Anmeldung erscheint | Beenden Sie jede Codex-Sitzung vollständig und öffnen Sie die CLI erneut. |
| codex wurde nicht gefunden | Öffnen Sie ein neues Terminal. Versuchen Sie unter Windows codex.cmd. |