Cursor IDE

Verbinden Sie Cursor über die OpenAI-kompatible API und kurze Modellaliase mit Model Gate.

Cursor IDE durch Model Gate

Cursor verwendet den OpenAI-kompatiblen Endpunkt:

https://api.model-gate.com/v1

1. Erstellen Sie einen API-Schlüssel

Offen https://panel.model-gate.com/en/api-keys, erstellen Sie einen Schlüssel und kopieren Sie ihn sofort.

2. Konfigurieren Sie den Cursor

Offen Cursoreinstellungen.
Offen Modelle oder API-Schlüssel, abhängig von der installierten Cursor-Version.
Geben Sie den Model Gate-Schlüssel in das OpenAI-API-Schlüsselfeld ein.
Aktivieren Sie die OpenAI-Basis-URL-Überschreibung.
Legen Sie die Basis-URL auf Folgendes fest:

https://api.model-gate.com/v1

Fügen Sie ein benutzerdefiniertes Modell mit einem kurzen Model Gate-Alias hinzu. Der Cursor lehnt möglicherweise vollständige kanonische Modell-IDs ab oder schreibt sie neu. Verwenden Sie daher einen Alias wie ch-47 anstatt claude-opus-4.7.
Überprüfen Sie die Konfiguration und starten Sie einen neuen Chat.

Benutzerdefinierte API-Schlüssel in Cursor gelten für Standardfunktionen des Chat-Modells. Von Cursor gehostete Spezialfunktionen nutzen möglicherweise weiterhin die Cursor-Infrastruktur.

Modell-Aliase

Geben Sie unter Cursor beispielsweise den Modellalias an ch-47, anstelle der ursprünglichen Modell-ID wie z claude-opus-4.7. Cursor kann aufgrund seiner internen Modellnamenbeschränkungen vollständige Modellnamen ablehnen oder neu schreiben. Model Gate unterstützt daher vom Administrator verwaltete Aliase.

Die derzeit aktivierten Aliase sind unten aufgeführt:

Alias	Model
`ch-46`	`claude-opus-4-6`
`ch-46s`	`claude-sonnet-4-6`
`ch-47`	`claude-opus-4-7`
`ch-48`	`claude-opus-4-8`
`ch-g54`	`gpt-5.4`

Beispiel:

Cursor model: ch-47
Resolved model: claude-opus-4.7

Model Gate löst den Alias auf, bevor:

Überprüfung der Modellverfügbarkeit;
Benutzer- und offizielle Preise;
Nutzungskostenberechnung;
asynchrone Warteschlangen;
vorgelagerte Lieferung;
Speicherung des Anforderungsverlaufs.

Die Upstream-Antwort kann die kanonische Modell-ID enthalten.

Außerhalb des Cursors überprüfen

curl https://api.model-gate.com/v1/chat/completions \
  -H "Authorization: Bearer mg_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "ch-47",
    "messages": [{"role": "user", "content": "Reply with OK"}]
  }'

Fehlerbehebung

Problem	Auflösung
Der Cursor lehnt eine lange Modell-ID ab	Verwenden Sie einen aktivierten Kurzalias, der von angezeigt wird `/v1/models`.
Die Authentifizierung schlägt fehl	Geben Sie den Model Gate-Schlüssel erneut ein und überprüfen Sie ihn mit Curl.
Anfragen erreichen Model Gate nicht	Bestätigen Sie, dass die Basis-URL Folgendes enthält `/v1`.
Modell wurde nicht gefunden	Der Alias kann deaktiviert oder einem deaktivierten Modell zugeordnet sein.
Eine Cursor-Funktion ignoriert die benutzerdefinierte API	Testen Sie ein Standard-Chat-Modell; Nicht jede vom Cursor gehostete Funktion unterstützt benutzerdefinierte API-Schlüssel.

Aktuelle Dokumentation zum Cursor-API-Schlüssel: https://docs.cursor.com/settings/api-keys.