Cursor einrichten: API Key, Base URL und Modelle

Um Cursor mit BetterToken zu verbinden, benötigst du einen API Key. Gib die unten angegebene Base URL ein und wähle eine aktuelle Modell-ID aus dem model plaza.

Wichtige Einstellungen

Feld	Wert
API Key	BetterToken API Key
Base URL	https://bettertoken.ai/v1
Modell	Eine aktuelle Modell-ID aus dem model plaza

Voraussetzungen

• Die aktuelle Version des Tools ist installiert
• Ein BetterToken API Key: Registrieren und Key erstellen
• Eine Modell-ID aus dem model plaza

Registrieren und BetterToken API Key erhalten→

Du hast bereits ein Konto? Melde dich an, lade Guthaben auf und erstelle dann einen Schlüssel in der Konsole.

Weitere Voraussetzungen

• Cursor ist installiert (Cursor herunterladen)

Installation

Lade die aktuelle Version von der Cursor-Website herunter und installiere sie. Melde dich mit einem Cursor-Konto an, das eigene Modelle unterstützt, und fahre dann unten fort.

Cursor erlaubt die Konfiguration eigener Modelle nur in einem kostenpflichtigen Advanced-Tarif oder höher. Wenn dein Konto oder deine Clientversion keine Optionen für eigene Modelle, API Key oder Base URL anzeigt, prüfe zuerst deinen Cursor-Tarif und die Clientversion.

Die BYOK-Regeln von Cursor beschränken OpenAI-BYOK auf standardmäßige Chat-Modelle ohne Reasoning. Tab-Vervollständigungen verwenden weiterhin die integrierten Modelle von Cursor. Anfragen werden zur Prompt-Erstellung über das Cursor-Backend geleitet; der API Key wird mit jeder Anfrage gesendet und nach deren Abschluss nicht gespeichert. Für BYOK gelten die Datenschutzrichtlinien des gewählten Providers, nicht die Zero-Data-Retention-Richtlinie von Cursor.

Bei Teams- und Enterprise-Tarifen werden berechtigte BYOK-Anfragen weiterhin über die Cursor Token Rate auf die Cursor-Nutzung angerechnet. Der Modellanbieter berechnet die Modellkosten separat. Prüfe Teamguthaben, On-Demand-Nutzung und Ausgabenlimits: Anfragen können enden, wenn das Kontingent aufgebraucht ist. Für Einzelkonten gelten andere Nutzungsregeln; siehe die Tarifdetails.

Bekanntes Problem: Override OpenAI Base URL ist eine globale Einstellung. Wenn sie aktiviert ist, betrifft sie alle in Cursor konfigurierten API Keys, einschließlich der Anthropic- und GPT-Keys für die integrierten Cursor-Modelle. Die offizielle Cursor-Community hat dieses Verhalten bestätigt: Eine gesetzte Base URL wirkt sich auf alle API Keys und Modelle aus (Community-Thread).

Wenn die integrierten Claude- oder GPT-Modelle von Cursor nach dem Aktivieren von Override OpenAI Base URL nicht mehr funktionieren, deaktiviere Override OpenAI Base URL, sobald du BetterToken nicht verwendest. Cursor unterstützt derzeit keine separate Base URL pro Modell. Diese Funktion wird weiterhin als Feature Request verfolgt (Feature Request).

Manuelle Konfiguration

Nimm diese Einstellungen in der Cursor-Oberfläche vor. Du musst keine Konfigurationsdatei bearbeiten.

Cursor-Feld	Wert
Override OpenAI Base URL	Aktivieren
Base URL	https://bettertoken.ai/v1
OpenAI API Key	BetterToken API Key verwenden
Eigenes Modell	Eine vollständige Modell-ID eines unterstützten Anbieters

Konfiguration

Modelleinstellungen öffnen

Klicke in Cursor unten links auf Settings und öffne anschließend Models. Scrolle nach unten zu API Keys.

Base URL und API Key eingeben

Konfiguriere die Felder unter API Keys in dieser Reihenfolge:

1. Aktiviere Override OpenAI Base URL
2. Gib https://bettertoken.ai/v1 in das Feld Base URL ein
3. Füge deinen BetterToken API Key unter OpenAI API Key ein
4. Aktiviere den Schalter OpenAI API Key, nachdem URL und Key eingetragen sind

Trage den Key ein, bevor du den Schalter aktivierst. Dadurch zeigt Cursor den Bestätigungsdialog für die Authentifizierung an.

OpenAI API Key aktivieren

Klicke im Bestätigungsdialog auf Enable OpenAI API Key.

Modellliste aktualisieren und Modelle aktivieren

Klicke zurück unter Models rechts auf die Schaltfläche zum Aktualisieren, bevor du ein Modell auswählst. Warte, bis die Modellliste vollständig aktualisiert wurde.

Wähle nur Modelle des Anbieters aus, den der konfigurierte Endpunkt unterstützt. Wähle bei einem BetterToken API Key eine Modell-ID des unterstützten Anbieters im model plaza und aktiviere dann den Schalter für dieses Modell.

Zum Chat zurückkehren und Auto deaktivieren

Kehre nach der Konfiguration zum Cursor-Chat zurück und öffne die Modellauswahl unter dem Eingabefeld. Wenn Auto aktiviert ist, deaktiviere zuerst Auto.

Modell auswählen und Chat starten

Wähle das aktivierte Modell eines unterstützten Anbieters aus und starte den Chat.

Verbindung prüfen

Sende einen kurzen Testprompt. Wenn das Tool ohne Authentifizierungs- oder Modell-ID-Fehler antwortet, funktioniert die Verbindung. Starte das Tool nach einer Konfigurationsänderung vollständig neu.

Grenzen des Cursor CLI

Das offizielle Cursor CLI (cursor-agent) verwendet die Cursor-Kontoanmeldung: CURSOR_API_KEY ist ein Cursor Key und kein BetterToken API Key. --endpoint gibt die Adresse des Cursor-Dienstes an. Die offiziellen Referenzen zu Anmeldung und Parametern dokumentieren keine OpenAI-kompatible Base URL. Die BYOK-Konfiguration für die Desktop-App gilt nicht für Cursor CLI.

Modelle wechseln

Öffne die Modellauswahl oder ändere das Feld Model in der Konfiguration. Verwende die genaue Modell-ID aus dem model plaza und starte danach die aktuelle Sitzung neu.

Häufige Fehler

Fehler bei eigener API und API Key

Vergleiche deine Einstellungen vor dem Ändern von Modellen oder Keys mit der Konfiguration einer eigenen OpenAI API in Cursor.

Cursor zeigt keine Felder für Custom API, API Key oder Base URL

Prüfe deinen Cursor-Tarif und die Clientversion. Eigene Modelle sind nur in unterstützten kostenpflichtigen Tarifen verfügbar. Öffne nach dem Aktualisieren von Cursor erneut Settings → Models.

API Key kann nicht aktiviert oder geprüft werden

Gib die Base URL https://bettertoken.ai/v1 und den API Key ein, bevor du den Schalter OpenAI API Key aktivierst. Hänge kein /chat/completions an die Base URL an.

Modell fehlt nach der Aktualisierung

Bestätige, dass die gewählte Modell-ID vom unterstützten Anbieter stammt. Warte, bis die Aktualisierung abgeschlossen ist, und aktiviere nur ein Modell dieses Anbieters. Der model plaza zeigt die aktuellen IDs an.

Integrierte Cursor-Modelle funktionieren nicht mehr

Override OpenAI Base URL gilt global. Deaktiviere den Schalter, wenn du BetterToken nicht verwendest, damit Cursor wieder die eigene Base URL nutzt.

Chat wählt ein anderes Modell

Öffne die Modellauswahl und deaktiviere Auto. Wähle anschließend das aktivierte Modell manuell aus.

Verwandte Fragen

• Eigene OpenAI API in Cursor konfigurieren
• Cursor Rules, AGENTS.md und .cursorignore erklärt
• MCP in Cursor konfigurieren
• Claude Code oder Cursor für die lokale Entwicklung
• Eigenen Anbieter in Codex CLI konfigurieren
• OpenAI-kompatible API in Cline konfigurieren
• OpenAI-kompatible API im Vergleich zur Anthropic-kompatiblen API
• Alle unterstützten Tools vergleichen
• API-Fehler, Statuscodes und Ratenbegrenzungen

Technische Details

Protokoll, Endpunkt und interne Anbieterfelder

Diese Konfiguration verwendet https://bettertoken.ai/v1. Das Tool hängt den OpenAI-kompatiblen Endpunktpfad an. Füge weder /chat/completions noch /responses hinzu, sofern ein bestimmtes Feld dies nicht ausdrücklich verlangt.

Hinweise

• Kopieren Sie die genaue Model ID aus der model plaza.