Codex CLI

Responses-Provider und Shell-API-Schlüssel für Codex CLI einrichten.

Installation und Vorbereitung

  1. Installieren Sie Node.js und dann die offizielle Codex CLI mit dem Befehl unten. Führen Sie in einem neuen Terminal codex --version aus.
  2. Erstellen Sie einen Schlüssel unter routerra.ai → API-Schlüssel. Wählen Sie aus den Modellen eine exakte ID mit Responses-API- und Werkzeugunterstützung; reine Chat-Completions-Modelle funktionieren hier nicht.
npm install -g @openai/codex
codex --version

TOML-Provider definieren

  1. Bearbeiten Sie ~/.codex/config.toml (Windows: %USERPROFILE%\.codex\config.toml) und fügen Sie das TOML ohne doppelte Provider-Tabelle ein. model_provider muss zu routerra passen; env_key enthält den Variablennamen, nicht das Geheimnis. Ersetzen Sie YOUR_MODEL_ID.
  2. Setzen Sie ROUTERRA_API_KEY in der Shell, die codex startet. Die Variable gilt nur dort; speichern Sie sie bei Bedarf im Shell-Profil. Dieser Provider nutzt seinen eigenen Schlüssel statt einer ChatGPT-Anmeldung. Starten Sie Codex nach TOML-Änderungen neu.
model = "YOUR_MODEL_ID"
model_provider = "routerra"

[model_providers.routerra]
name = "routerra.ai"
base_url = "https://routerra.ai/v1"
env_key = "ROUTERRA_API_KEY"
wire_api = "responses"

Mit Provider-Schlüssel starten

Bei fehlender Variable hat Codex ROUTERRA_API_KEY nicht geerbt; starten Sie es aus dieser Shell. Bei /responses-404 prüfen Sie URL und Protokoll: genau ein /v1 und wire_api = "responses". Funktioniert Text, aber keine Dateiliste, wählen Sie ein Modell mit Werkzeugen. Prüfen Sie die Anfrage im routerra.ai-Verbrauch; ein erfolgreicher CLI-Start bestätigt die Route noch nicht.

export ROUTERRA_API_KEY="YOUR_API_KEY"
codex

Für Windows PowerShell:

$env:ROUTERRA_API_KEY = "YOUR_API_KEY"
codex