Dokumentation / Codex API

Codex CLI: API-Schlüssel und benutzerdefinierten Anbieter einrichten

Mit dieser Anleitung verbinden Sie Ihre lokale Arbeit in der Codex CLI mit AI Prime Tech. Sie benötigen ein Gateway-Konto, einen aktiven Schlüssel in der vorgesehenen Codex-Gruppe und ein Modell, das für diesen Schlüssel verfügbar ist. Beginnen Sie mit der Codex API-Übersicht wenn Sie noch eine Zugangsart auswählen.

1. Schlüssel und Gruppe prüfen

Erstellen Sie einen Schlüssel im Dashboard. Der vorausbezahlte GPT-Zugang verwendet die Codex Gruppe. Falls zeitlich begrenzter Codex-Zugang angeboten wird, verwenden Sie die für diesen Tarif angegebene Gruppe und die zugehörigen Bedingungen; Claude-Zugang ist separat. Überprüfen Sie die Modellliste für den Schlüssel, den Sie verwenden werden.

Setzen Sie den Schlüssel im aktuellen Terminal. Ersetzen Sie den Platzhalter lokal; nehmen Sie den Schlüssel nicht in einen Repository-Commit auf.

PowerShell

$env:AIPRIMETECH_API_KEY = "YOUR_GATEWAY_KEY"

bash oder zsh

export AIPRIMETECH_API_KEY="YOUR_GATEWAY_KEY"

Starten Sie ein Terminal oder einen Editor neu, das bzw. der vor dem Setzen seiner Umgebungsvariablen gestartet wurde, falls die Variable dort nicht verfügbar ist. Diese Beispiele setzen sie für den aktuellen Prozess und seine untergeordneten Prozesse.

2. Anbieter konfigurieren

Fügen Sie dies in Ihre benutzerspezifische Datei ein: ~/.codex/config.toml. Unter Windows lautet der entsprechende Pfad %USERPROFILE%\.codex\config.toml. Die Zugangsdaten des Anbieters gehören in die Benutzerkonfiguration, nicht in die folgende Datei eines Repositorys: .codex/config.toml.

model_provider = "aiprimetech"
model = "gpt-6.1-sol"

[model_providers.aiprimetech]
name = "AI Prime Tech"
base_url = "https://aiprimetech.io/v1"
env_key = "AIPRIMETECH_API_KEY"
wire_api = "responses"
supports_websockets = false

Verwenden Sie eine Anbieter-ID wie aiprimetech und stimmen Sie model_provider auf die zugehörige Tabelle ab. Die aktuelle Version von Codex verwendet das Responses-Protokoll. Die Basis-URL ist das folgende Stammverzeichnis des Gateways: /v1 ; Codex ergänzt den Anfragepfad. Diese Konfiguration verwendet HTTP/SSE als Transport.

3. Verbindung überprüfen

Führen Sie codex doctor aus, um Ihre CLI-Konfiguration zu prüfen. Starten Sie codex, verwenden Sie dann /status um Anbieter und Modell zu bestätigen. Fordern Sie eine kurze Antwort an, bevor Sie eine größere Aufgabe im Repository zulassen. Prüfen Sie, ob die Anfrage auf Ihrer Nutzungsseite bei AI Prime Tech erscheint.

Sie können die Modellliste des Schlüssels unabhängig von Codex prüfen:

Invoke-RestMethod -Uri "https://aiprimetech.io/v1/models" -Headers @{Authorization="Bearer $env:AIPRIMETECH_API_KEY"}

curl --fail-with-body https://aiprimetech.io/v1/models \
  -H "Authorization: Bearer $AIPRIMETECH_API_KEY"

Wenn der zurückgegebene Katalog Ihr Modell enthält, die Anfrage aber fehlschlägt, prüfen Sie den tatsächlichen Fehler und die aktuelle Verfügbarkeit der Gruppe. Eine aufgeführte ID allein ist kein erfolgreicher Inferenztest.

Ein optionales CLI-Profil vorhalten

Um diesen Anbieter nur für bestimmte CLI-Sitzungen auszuwählen, speichern Sie die obige Konfiguration in ~/.codex/aiprimetech.config.toml und starten Sie:

codex --profile aiprimetech

Ab Codex 0.134.0 verwenden CLI-Profile separate Dateien. Ältere [profiles.aiprimetech] Beispiele entsprechen nicht dem aktuellen Profilformat. Die IDE-Erweiterung verwendet die benutzerspezifische Konfiguration; prüfen Sie nach einem Neustart ihren aktiven Anbieter, statt davon auszugehen, dass der CLI-Profilwechsel auch dort übernommen wurde.

Modell auswählen

Verwenden Sie gpt-6.1-sol als Ausgangspunkt für die Programmierung, gpt-6-astra für anspruchsvolle Aufgaben oder gpt-6-luna für gezielte Arbeiten. gpt-6-sol ist eine separate ID für bestehende Sol-Workflows. Siehe Modelldetails und wie Sie sie vergleichen.

Fehlerbehebung

Symptom Prüfen Sie
Fehlende Umgebungsvariable Setzen Sie AIPRIMETECH_API_KEY im Prozess, der Codex startet.
401-Authentifizierungsfehler Vergewissern Sie sich, dass der Schlüssel aktiv ist, vollständig kopiert wurde und von diesem Gateway ausgestellt wurde.
403 oder nicht verfügbares Modell Überprüfen Sie die Schlüsselgruppe, den Zugriff über Ihren Tarif und die genaue Modell-ID.
404 oder eine HTML-Antwort Verwenden Sie https://aiprimetech.io/v1; entfernen Sie doppelte /v1 oder ein angehängtes /responses.
wire_api abgelehnt Verwenden Sie responses; alte chat Anbieterbeispiele sind veraltet.
Fehler bei Guthaben, Tarif oder Anfragelimit Lesen Sie die Fehlermeldung, prüfen Sie Ihr Konto und reduzieren Sie die Anzahl gleichzeitiger Vorgänge, bevor Sie es erneut versuchen.
Verbindung bricht während der Antwort ab Versuchen Sie eine kurze Anfrage, prüfen Sie die Netzwerk-/Proxy-Verbindung und notieren Sie die Anfrage-ID für den Support.

Claude und gehostete Codex-Funktionen

Für Claude über die Responses-Übersetzung des Gateways folgen Sie Claude mit Codex mit einem kompatiblen Schlüssel aus der Claude-Gruppe. Das GPT-Beispiel oben ist für den Zugriff über die Codex-Gruppe vorgesehen.

Der Gateway-Zugriff gewährt keine Berechtigungen für ChatGPT-Workspaces und keinen Zugriff auf die Codex-Cloud. Siehe den Vergleich der Anmeldeoptionen zur Abgrenzung der Produkte.

Referenzen