Codex (OpenAI CLI)

Neue lokale Codex-Aufgaben über die gestreamte Responses API von OneProvider ausführen.

Codex, Coding-Agent als CLI und Desktop-App

Was funktioniert

Unterstützt gestreamte Antworten, Funktionsaufrufe, lokale Tools wie apply_patch und die Verbrauchserfassung. Das betrifft neue lokale Aufgaben in CLI, Desktop-App und IDE; die Codex-Cloud-Chats bleiben unverändert.

Einschränkung des Clients

Starten Sie Codex nach dem Wechsel des Providers neu und legen Sie eine neue lokale Aufgabe an. Bestehende Aufgaben behalten Modell und Provider, mit denen sie gestartet wurden.

Einrichtung

1. Codex installieren oder prüfen

   Gibt codex --version bereits eine Version aus, machen Sie weiter. Andernfalls installieren Sie die aktuelle CLI.

   npm install --global @openai/codex
   codex --version

2. Eigenen Schlüssel verfügbar machen

   Erstellen Sie einen eigenen OneProvider-Schlüssel und exportieren Sie ihn in derselben Terminalsitzung, die Codex startet.

   export ONEPROVIDER_API_KEY="sk-your-key-here"

3. Eigenen Provider hinzufügen

   Öffnen Sie ~/.codex/config.toml (Desktop: Settings → Configuration → Open config.toml) und ergänzen Sie den OneProvider-Provider.

   model_provider = "oneprovider"
   model = "gpt-6.1-sol"
   [model_providers.oneprovider]
   name = "OneProvider"
   base_url = "https://api.oneprovider.dev/v1"
   env_key = "ONEPROVIDER_API_KEY"
   wire_api = "responses"

4. Neu starten und neue lokale Aufgabe testen

   CLI-Nutzer führen einen schreibgeschützten Testlauf aus. Desktop-Nutzer müssen die App vollständig beenden, neu öffnen und eine neue lokale Aufgabe starten.

   codex

Verbindung prüfen

Anfrage im Dashboard bestätigen

Die abgeschlossene Anfrage sollte das gewählte Modell, /v1/responses, den Token-Verbrauch und den abgebuchten Betrag zeigen.

Verbindungsdaten

Protokoll

responses

Endpoint

https://api.oneprovider.dev/v1

Schlüsselsicherheit

Nutzen Sie einen eigenen Schlüssel mit begrenztem Umfang. Eine unter macOS über das Dock geöffnete Desktop-App erbt die Umgebungsvariablen des Terminals möglicherweise nicht; verwenden Sie die befehlsbasierte Keychain-Authentifizierung von Codex, statt das Geheimnis in die config.toml zu schreiben.

Welches Modell wählen

Setzen Sie model in derselben config.toml unterhalb von model_provider. gpt-6.1-sol ist die Frontier-Stufe für schwierige agentische Aufgaben, gpt-6.1-terra der ausgewogene Standard für den Alltag und gpt-5.6-luna die günstige Stufe für hohes Volumen und schnelle Aufgaben. Codex spricht die Responses API, wählen Sie also GPT-IDs von der Modellseite ; die Preise stehen auf der Preisseite .

Häufige Fehler und Lösungen

401 oder „missing credentials“

ONEPROVIDER_API_KEY ist für Codex nicht sichtbar. Exportieren Sie die Variable in dem Terminal, das Codex startet. Eine über das Dock geöffnete Desktop-App erbt sie unter macOS nicht: Nutzen Sie die befehlsbasierte Authentifizierung über den Schlüsselbund (Keychain).

404

base_url muss https://api.oneprovider.dev/v1 mit /v1 lauten, und wire_api muss "responses" sein.

Codex nutzt weiterhin das alte Modell oder den alten Provider

Bestehende Aufgaben behalten den Provider, mit dem sie gestartet wurden. Starten Sie Codex neu und legen Sie eine neue lokale Aufgabe an.

„You've hit your usage limit“ oder Codex fordert mich zur Anmeldung bei ChatGPT auf

Das ist das Limit eines ChatGPT-Abos: Die Anfrage ging an ChatGPT, der OneProvider-Provider ist also nicht aktiv. Setzen Sie model_provider = "oneprovider" ganz oben in die config.toml, oberhalb jeder [Tabelle] (keine intelligenten Anführungszeichen), beenden Sie Codex vollständig und starten Sie eine neue lokale Aufgabe. Melden Sie sich dann mit codex logout bei ChatGPT ab (Desktop-App: in deren Einstellungen) und starten Sie codex in dem Terminal, in dem ONEPROVIDER_API_KEY exportiert ist: Mit aktivem Provider funktioniert es allein mit dem Schlüssel. Schnelltest: codex -c model_provider=oneprovider. wire_api akzeptiert nur "responses".

429 „Insufficient balance“

Das Guthaben oder das Limit des Schlüssels ist aufgebraucht. Laden Sie Guthaben auf; Wiederholungen helfen nicht.

FAQ

Ändert das die Codex-Cloud-Chats?

Nein, nur neue lokale Aufgaben in CLI, Desktop-App und IDE.

Brauche ich ein OpenAI-Konto?

Nein, der OneProvider-Schlüssel ersetzt es für lokale Aufgaben.

Kann ich Claude-Modelle in Codex nutzen?

Codex nutzt die Responses API mit GPT-IDs. Für Claude verwenden Sie Claude Code .

Wo prüfe ich die Kosten?

Auf der Seite „Verbrauch“ im Dashboard: Jede Anfrage zeigt das Modell, /v1/responses und den abgebuchten Betrag.

Kurze Antworten

Welche base URL verwende ich?

Claude Code und die Anthropic-SDKs verwenden https://api.oneprovider.dev. OpenAI-SDKs und OpenAI-kompatible Clients verwenden https://api.oneprovider.dev/v1. Ein Schlüssel funktioniert an beiden Adressen; die Modellliste finden Sie auf der Modellseite , die Preise auf der Preisseite .

Wie authentifiziere ich mich?

Senden Sie den unveränderten sk-…-Schlüssel in x-api-key oder Authorization: Bearer: nur eines von beiden, nie beide. Bewahren Sie den Schlüssel in einer Umgebungsvariable auf, nicht in einer Datei, die ins Repository committet wird. Mehr zur Authentifizierung .

Wo bekomme ich einen Schlüssel?

Öffnen Sie Ihr Konto im Telegram-Bot @oneprovider_robot oder auf app.oneprovider.dev, laden Sie das Guthaben auf und tippen Sie auf „Schlüssel ausstellen“. Jeder Schlüssel kann ein eigenes Ausgabenlimit haben. Konto & API-Schlüssel .

Was bedeuten 401, 404 und 429?

401: Der Schlüssel fehlt, ist falsch geschrieben oder steht im falschen Header; fügen Sie den ganzen Schlüssel ohne Anführungszeichen und Leerzeichen ein. 404: meist eine falsche base URL, zum Beispiel ein fehlendes oder doppeltes /v1. 429 mit „Insufficient balance“: Das Guthaben des Kontos oder das Ausgabenlimit des Schlüssels ist aufgebraucht – laden Sie auf, statt es erneut zu versuchen; jedes andere 429 ist ein Rate-Limit, warten Sie dann die Zeit aus Retry-After ab. Details: Fehlercodes und Fehlerbehebung .

Warum brechen Streams ab oder werden zurückgesetzt?

VPN- und VLESS-Proxys puffern SSE oft oder stören die HTTP/2-Aushandlung. OneProvider hat keine regionalen Beschränkungen und puffert keine Streams – schalten Sie den Proxy aus und versuchen Sie es erneut.

Wohin wende ich mich, wenn das nicht reicht?

Schreiben Sie @Oneproviderhelpbot auf Telegram oder öffnen Sie „Support“ im Web-Konto – mit HTTP-Statuscode und genauer Fehlermeldung. So arbeitet der Support .