OpenAI-Modelle in Cursor: 12. November, BYOK und Codex

Für unterstützte lokale Anfragen in Chat und Agent kannst du OpenAI-Modelle in Cursor mit einem eigenen API-Schlüssel (BYOK) weiterverwenden. Wähle die Codex-IDE-Erweiterung für den Coding-Agenten oder den Zugang über ein berechtigtes ChatGPT-Abonnement. Nutze ein kompatibles Gateway, wenn dein Team dort bereits den Modellzugang und die Abrechnung verwaltet.

Diese Wege haben unterschiedliche Anforderungen an Konten und unterschiedliche Funktionsgrenzen. Prüfe sie, bevor du API-Guthaben kaufst oder deinen Endpunkt änderst.

Der 12. November ist weiterhin ein vorgeschlagener Termin

Stand 2026-10-27 ist der 12. November 2026 weiterhin ein vorgeschlagener Termin für das Vertragsende. Laut OpenAIs aktueller Anleitung zu Cursor müssen beide Unternehmen den endgültigen Termin noch bestätigen. Cursor könnte den Zugang auch früher beenden.

Für die Planung sind zwei Zeitpunkte relevant:

2026-08-28: Nach der Übernahme von Cursor durch SpaceX kündigte OpenAI die beabsichtigte Vertragsbeendigung an. OpenAI schlug den 12. November vor und erklärte, künftige Modelle nicht mehr über diese Vereinbarung bereitzustellen.
Stand 2026-10-27: Die Hilfeseite von OpenAI bezeichnet den Termin weiterhin als Vorschlag. Sie nennt BYOK, die Codex-Erweiterung und kompatible Gateways als alternative Zugangswege.

OpenAI begründete die Entscheidung mit Bedenken, ob seine Nutzungsbedingungen eingehalten würden. Das ist die von OpenAI genannte Begründung. Für deine Umstellung ist die Vereinbarung entscheidend, über die Cursor selbst Zugang zu OpenAI-Modellen erhält.

Richte eine Alternative ein, bevor du dich auf den vorgeschlagenen Termin verlässt. Diese Anleitungen erhalten unterstützte Arbeitsweisen im Editor, aber nicht sämtliche Cursor-Funktionen.

Prüfe zuerst Tarif, Funktionen und Abrechnung

Cursors eigene BYOK-Funktion unterstützt geeignete lokale Anfragen in Chat und Agent. Sie gilt nicht für Tab, Auto, Cloud oder Background Agents, Automations, Cursor CLI und Cursor API/SDK. Die Codex-Erweiterung ändert nichts an diesen Cursor-Funktionen.

Auch dein Tarif muss BYOK erlauben. Stand 2026-10-27 schließt die aktuelle Tarifdokumentation von Cursor persönliche API-Schlüssel bei Cursor Plus ausdrücklich aus. Die BYOK-Hilfe nennt Premium, Super, Ultra und bestimmte ältere Tarife. Prüfe die Berechtigungen deines bestehenden Tarifs, bevor du wechselst.

In einem Enterprise-Workspace kann ein Administrator persönliche Schlüssel einschränken. Die Einstellungen liegen unter Team Settings → Models → Personal API Keys (BYOK). Ein Gateway, das du über die OpenAI-Felder einrichtest, benötigt ebenfalls die Berechtigung für OpenAI BYOK.

Die Abrechnung erfolgt je nach Zugangsweg getrennt:

Zugangsweg	Konto oder Kontingent für die Modellnutzung
OpenAI-Schlüssel in Cursor	Dein OpenAI-API-Konto
Codex mit ChatGPT-Anmeldung	Das enthaltene Kontingent deines berechtigten ChatGPT-Tarifs und gegebenenfalls zusätzliche Credits
Codex mit einem OpenAI-API-Schlüssel	Dein OpenAI-API-Konto
Gateway in Cursor	Dein Konto beim Gateway oder Hosting-Anbieter

API-Gebühren fallen getrennt von den Abonnements für Cursor und ChatGPT an. Ein ChatGPT-Abonnement stellt kein Guthaben für die OpenAI API bereit.

Bei Teams und Enterprise musst du eine weitere Gebühr berücksichtigen. Stand 2026-10-27 beträgt die Cursor Token Rate für gebührenpflichtige BYOK-Anfragen USD $0.25 pro Million Tokens. Sie gilt zusätzlich zu den Anbietergebühren für Eingabe-, Ausgabe- und gecachte Tokens. Tarife für Einzelpersonen zahlen diese Gebühr nicht. Die aufgeführten Modellausnahmen gelten auch für BYOK.

„Lokal“ bezeichnet hier die Arbeit in der Desktop-App. Laut Cursors BYOK-Dokumentation laufen die Anfragen weiterhin über Cursors Backend, das den Prompt zusammenstellt. Cursors Richtlinie Zero Data Retention gilt nicht für BYOK. Prüfe, wie dein Anbieter die Daten verarbeitet.

Weg 1: Hinterlege deinen eigenen OpenAI-API-Schlüssel

Wähle diesen Weg, wenn du Cursors eigene Oberfläche für Chat und Agent mit einem unterstützten OpenAI-Modell nutzen möchtest.

Cursor dokumentiert OpenAI BYOK derzeit für normale Chatmodelle ohne Reasoning. Ein neueres Reasoning-Modell wird nicht dadurch unterstützt, dass du seine ID hinzufügst. Wähle ein Modell, das sowohl dein aktueller Client als auch dein API-Konto unterstützen.

Folge den OpenAI-Anweisungen zur Einrichtung in Cursor:

Richte die Abrechnung für dein OpenAI-API-Konto ein.
Erstelle deinen eigenen Schlüssel auf der Seite für OpenAI-API-Schlüssel.
Öffne Cursor Settings → Models und suche die Einstellungen für den OpenAI-API-Schlüssel.
Falls du zuvor ein Gateway eingerichtet hast, deaktiviere Override OpenAI Base URL, bevor du deinen offiziellen OpenAI-Schlüssel verwendest.
Füge den Schlüssel in OpenAI API Key ein und klicke auf Save. Aktiviere Use OpenAI API Key, falls dieser Schalter angezeigt wird.
Aktiviere ein unterstütztes OpenAI-Modell in der Modellliste.
Öffne einen neuen lokalen Chat, deaktiviere Auto und wähle dieses Modell ausdrücklich aus.
Sende Reply with exactly: connection-ok.

Als Ergebnis solltest du eine Antwort in Cursor Chat erhalten. Prüfe die API-Nutzung im zugehörigen Projekt, um festzustellen, welchem Konto die Anfrage zugeordnet wurde. Teste anschließend die benötigte Agent-Aktion mit dem kleinen Bearbeitungstest weiter unten.

Weg 2: Installiere die Codex-IDE-Erweiterung

Wähle Codex, wenn du dessen Coding-Agenten benötigst oder ein berechtigtes ChatGPT-Abonnement innerhalb von Cursor verwenden möchtest. Codex hat eine eigene Oberfläche und nutzt nicht Cursors eigene OpenAI-Modellauswahl.

Zu den berechtigten ChatGPT-Tarifen gehören Plus, Pro, Business, Edu und Enterprise, abhängig von den Workspace-Berechtigungen. Prüfe die aktuelle Codex-Verfügbarkeit nach Tarif. ChatGPT Plus und Cursor Plus sind unterschiedliche Abonnements.

Öffne die offizielle Seite zur Codex-IDE-Erweiterung.
Wähle unter Install or enable Codex die Option Cursor und schließe die Installation ab.
Öffne ein lokales Projekt und wähle das Codex-Symbol in der Activity Bar.
Fehlt das Symbol, öffne die Command Palette und führe Codex: Open Codex Sidebar aus.
Wähle Sign in with ChatGPT und melde dich im Browser an. Für API-Abrechnung wählst du Use API Key, gibst deinen OpenAI-Schlüssel ein und bestätigst mit OK.
Öffne eine Quelldatei und füge eine ausgewählte Funktion dem Prompt-Kontext von Codex hinzu.
Bitte Codex, die Funktion und einen Grenzfall zu erklären, ohne Dateien zu bearbeiten.

Lies die Antwort im Codex-Gespräch und vergleiche sie mit dem ausgewählten Code. Prüfe die Verbindung über die Modell- und Kontoeinstellungen von Codex selbst.

Für die Agent-Einstellungen wählst du das Zahnradsymbol in der Seitenleiste und dann Codex Settings. OpenAIs Referenz zu den Erweiterungseinstellungen trennt diese Optionen von den Editor-Einstellungen. Sie konfigurieren nicht Cursors eigene Models-Seite.

Die Authentifizierungsdokumentation bestätigt, dass die Anmeldung mit API-Schlüssel über dein OpenAI-Platform-Konto abgerechnet wird. Sie unterstützt lokale Codex-Arbeit. Funktionen, die einen ChatGPT-Workspace oder Cloud-Zugang benötigen, können weiterhin fehlen.

Wenn du diesen Weg wählst, sende weitere Aufgaben im Codex-Panel. Eingaben in Cursor Chat verwenden weiterhin die separate Cursor-Konfiguration.

Weg 3: Verbinde ein OpenAI-kompatibles Gateway

Wähle ein Gateway, wenn es das Konto, das Modell und das API-Format bietet, die du für deine Arbeit in Cursor benötigst. OpenAI nennt Amazon Bedrock, Azure und weitere kompatible Anbieter als mögliche Wege.

Azure und Bedrock haben anbieterspezifische Einstellungen. Die folgenden Schritte gelten für einen eigenen OpenAI-kompatiblen Endpunkt. Nutze für Zugangsdaten und Modellnamen die Bereitstellungsanleitung deines Anbieters.

Für OpenRouter findest du die einzelnen Schritte in der separaten Anleitung zur Verbindung von Cursor mit OpenRouter.

Besorge dir den API-Schlüssel, die dokumentierte Base URL und die genaue Modell-ID deines Anbieters.
Prüfe, ob der Anbieter das API-Format und die Tools unterstützt, die dein ausgewähltes Cursor-Modell benötigt.
Öffne Cursor Settings → Models → API Keys.
Aktiviere im OpenAI-Bereich Override OpenAI Base URL und trage die Base URL des Anbieters ein.
Trage den Gateway-Schlüssel in OpenAI API Key ein. Aktiviere Use OpenAI API Key und speichere die Einstellungen.
Füge die genaue Modell-ID des Anbieters hinzu oder aktiviere sie.
Starte Cursor neu, öffne einen neuen lokalen Chat, deaktiviere Auto und wähle das Modell.
Sende die kurze Verbindungsanfrage und prüfe anschließend den Nutzungsnachweis beim Anbieter.

Der Cursor-Support dokumentiert diese Optionen in seiner Anleitung für selbst hinzugefügte Modelle. Verwende die Modell-ID des Endpunkts einschließlich erforderlicher Präfixe. Ein Anzeigename von einem anderen Anbieter kann einen anderen Zugangsweg bezeichnen.

Die Cursor-Anleitung von BetterToken nennt beispielsweise https://www.bettertoken.ai/v1 und deinen eigenen BetterToken-API-Schlüssel. Im aktuellen Katalog war am 2026-10-27 gpt-6-luna aufgeführt. Das bestätigt den Katalogeintrag, aber nicht die Kompatibilität mit Cursors eigenen Funktionen. Prüfe vor der Auswahl den API-Modus und die Tool-Unterstützung des Modells. Beachte dabei Cursors dokumentierte Einschränkung für Reasoning-Modelle.

Behalte im Feld Base URL von BetterToken /v1 bei. Hänge weder /chat/completions noch /responses an. Das sind Ressourcenpfade, wie die API-Referenz erklärt.

Prüfe die Überschreibung, wenn du zu von Cursor bereitgestellten Modellen zurückkehrst. Im Support-Thread zum Routing in Cursor bestätigte der Support, dass sie auch integrierte OpenAI-Modelloptionen betrifft. Deaktiviere sie, wenn du wieder Cursors eigenen Zugangsweg verwenden möchtest. Die Auswahl eines vertrauten GPT-Namens allein wechselt den Endpunkt nicht.

Prüfe den vollständigen Bearbeitungsablauf

Teste die benötigte Aktion, bevor du eine Programmiersitzung auf den neuen Zugangsweg umstellst. Eine kurze Antwort bestätigt die grundlegende Verbindung, aber nicht die Funktion der Bearbeitungswerkzeuge.

Öffne einen temporären Projektordner. Sende im lokalen Agent von Cursor oder in der Codex-Seitenleiste diesen Prompt:

Create cursor-route-check.txt containing this single line:
connection-ok

Use your file-editing tool, then read the file back.
Do not use a shell command to create or modify the file.
Stop after confirming its contents.

Erwartet wird eine Datei mit connection-ok sowie ein abgeschlossener Ablauf aus Bearbeiten und erneutem Lesen. Prüfe die Datei selbst. Bei API-Schlüssel- oder Gateway-Zugriff kontrollierst du zusätzlich das protokollierte Modell und die Nutzung beim Anbieter.

Wenn Textantworten funktionieren, die Bearbeitung aber scheitert, prüfe zuerst die Tool-Kompatibilität, bevor du den Schlüssel ersetzt. In einem Cursor-Support-Thread vom Juli 2026 fand Harm Alhusen die Ursache fehlgeschlagener Bearbeitungen in seinem Proxy: Er verwarf custom_tool_call-Antworten. Der Cursor-Support erklärte, dass benutzerdefinierte OpenAI-Tools auf dem gesamten Weg von Anfrage und Antwort erhalten bleiben müssen.

Dieser Bericht beschreibt einen konkret diagnostizierten Integrationsfehler. Er erklärt nicht jede abgebrochene Agent-Aufgabe. Kann dein benötigtes Modell den Test über Cursors eigene BYOK-Funktion nicht abschließen, probiere Codex mit einem unterstützten Konto und Modell.

Wähle die Fehlerbehebung passend zum Symptom

Wähle anhand des Symptoms die nächste Prüfung. Wenn du alle Einstellungen gleichzeitig änderst, lassen sich Routingfehler schwerer eingrenzen.

Symptom	Prüfung und nächster Schritt
Die Felder für API-Schlüssel oder Base URL fehlen	Prüfe deinen Cursor-Tarif und Client. Bitte bei Enterprise den Administrator, Einschränkungen für persönliche Schlüssel zu prüfen. Öffne Models erneut, sobald der Zugriff freigegeben ist.
Die Authentifizierung scheitert	Prüfe, ob der Schlüssel zum Anbieter des eingestellten Endpunkts gehört und die API-Abrechnung aktiv ist. Speichere die korrigierte Kombination und wiederhole eine kurze Anfrage.
`AI Model Not Found` oder `Model name is not valid`	Prüfe die genaue Modell-ID des Anbieters und die Berechtigung für OpenAI BYOK. Prüfe auch, ob der Schalter für den Schlüssel aktiv ist. Starte nach der Korrektur einen neuen Chat.
`You've reached your monthly usage limit` bei einem Gateway	Prüfe neben dem Anbieterguthaben auch die Ausgabenlimits deines Cursor-Teams. Anfallende Cursor-Tokengebühren können BYOK-Anfragen des Teams weiterhin stoppen.
Ein integriertes GPT-Modell scheitert nach Aktivierung der Überschreibung	Deaktiviere die Überschreibung, bevor du Cursors eigenen Zugangsweg testest, solange das Modell dort noch verfügbar ist.
Eine Antwort beginnt, aber Tools oder Bearbeitungen scheitern	Prüfe für dieses Modell das Protokoll und die Verarbeitung von Tool-Aufrufen. Wiederhole den Test mit der Testdatei, nachdem du die Anbieter- oder Client-Konfiguration korrigiert hast.

Der Austausch mit dem Cursor-Support vom September und Oktober 2026 dokumentiert mehrere dieser Fehler bei Berechtigungen und Ausgabenlimits. Das sind sinnvolle Prüfungen, aber kein Beleg dafür, dass dein Problem dieselbe Ursache hat.

Scheitert die Anfrage weiterhin, notiere Cursor-Version, ausgewählte Modell-ID, Endpunkt-Host, Zeitstempel und Anfrage-ID. Teile keine Zugangsdaten oder privaten Prompt-Inhalte in Diagnoseinformationen.