Zum Hauptinhalt springen
Mit einem einzigen Capriole-AI-API-Schlüssel nutzen Sie GPT-6.2 Astra und GPT-6.2 Sol in Codex, bis zu 92% unter den offiziellen API-Preisen.

Was ist Codex

Codex ist der Coding-Agent von OpenAI für die Softwareentwicklung. Er kann Capriole AI über einen benutzerdefinierten Modellanbieter nutzen, der Anfragen an die Responses-kompatible API von Capriole AI sendet.

Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass Sie Folgendes haben:
  • Ein Capriole-AI-Konto (Hier registrieren)
  • Premium (USD 9 pro Monat, inklusive unbegrenztem Web-Chat) oder Team, denn API-Schlüssel gibt es nur mit einem dieser Pläne (Abonnieren)
  • Einen Capriole-AI-API-Schlüssel (Schlüssel abrufen)

Installation

Codex CLI

Installieren Sie Codex CLI mit dem offiziellen Installationsprogramm:
Oder installieren Sie es mit npm:
Prüfen Sie die Installation:

Codex-App

Laden Sie die App von OpenAI Codex herunter.

Konfiguration

Modellvalidierung

Codex CLI 0.169.1 besteht mit der folgenden Konfiguration eine Prüfung aus Dateilesen, Dateischreiben und abschließender Antwort über Capriole AI. Erstellen oder aktualisieren Sie ~/.codex/config.toml:
Was die einzelnen Einstellungen bewirken:
  • model ist das Standardmodell. Ändern Sie es mit /model in einer Sitzung oder mit --model auf der Befehlszeile.
  • model_provider wählt den darunter definierten Capriole-AI-Anbieter aus.
  • base_url enthält /v1, da Codex /responses selbst ergänzt.
  • wire_api = "responses" verwendet die Responses API, das einzige Protokoll, das Codex für benutzerdefinierte Anbieter unterstützt.
  • env_key liest Ihren Schlüssel aus der Umgebung und sendet ihn als Bearer-Token.

Codex ausführen

Setzen Sie Ihren API-Schlüssel und starten Sie Codex aus Ihrem Projektverzeichnis:
Für einen nicht interaktiven Lauf verwenden Sie codex exec:

Unterstützte Modelle

Codex nutzt die OpenAI-Modelle von Capriole AI über die Responses API. Verwenden Sie die folgenden nativen Modell-IDs mit der integrierten Modellauswahl und den Reasoning-Einstellungen von Codex. Sie benötigen kein eigenes model_catalog_json.
  • gpt-6.2-astra
  • gpt-6.2-sol
  • gpt-6-astra
  • gpt-6.1-sol
  • gpt-6-sol
  • gpt-6-luna
  • gpt-5.6-terra
  • gpt-5.6-luna
Verwenden Sie für gpt-6.2-astra und gpt-6.2-sol Codex 0.169.1 oder neuer und für gpt-6.1-sol Codex 0.159.2 oder neuer. Ältere Versionen enthalten keine Modell-Metadaten dafür und greifen auf allgemeine Einstellungen zurück. Die API akzeptiert auch IDs mit dem Präfix openai/ sowie openai-latest. Der Alias openai-latest folgt dem von Capriole AI empfohlenen OpenAI-Flaggschiff-Modell. Codex kann über denselben Anbieter auch xai/grok-4.7 ausführen, da Capriole AI Grok über die Responses API bereitstellt. Codex hat integrierte Metadaten nur für die nativen OpenAI-Modell-IDs. Für openai-latest und xai/grok-4.7 gibt es Model metadata ... not found aus und greift auf Ersatzeinstellungen zurück. Die Sitzung funktioniert trotzdem, für die besten Ergebnisse verwenden Sie jedoch eine native ID wie gpt-6.2-astra.

Fehlerbehebung

Warum gibt Codex einen Authentifizierungsfehler zurück?

Bestätigen Sie, dass CAPRIOLE_AI_API_KEY in derselben Shell exportiert ist, bevor Sie codex ausführen.

Warum findet Codex das Modell nicht?

Bestätigen Sie, dass model_provider = "capriole_ai" gesetzt ist und dass model eine der IDs aus dem Abschnitt „Unterstützte Modelle“ ist.

Warum schlagen Anfragen mit Endpunkt- oder Protokollfehlern fehl?

Bestätigen Sie, dass unter [model_providers.capriole_ai] base_url = "https://api.caprioletech.com/v1" und wire_api = "responses" gesetzt sind.

Warum ignoriert Codex den Capriole-AI-Anbieter?

Verwenden Sie keine reservierte integrierte Anbieter-ID wie openai; behalten Sie die benutzerdefinierte Anbieter-ID als capriole_ai bei.

Warum greifen Konfigurationsänderungen nicht?

Bestätigen Sie, dass ~/.codex/config.toml die aktive Benutzerkonfigurationsdatei ist, vertrauen Sie dem Projekt, bevor Sie sich auf eine projektspezifische .codex/config.toml stützen, und starten Sie Codex anschließend neu.

Hinweise

Zuletzt geändert am 18. November 2026