Cursor ist ein weit verbreiteter KI-Code-Editor. Neben dem integrierten Modellkontingent erlaubt er auch die Eingabe eines eigenen API-Keys und einer eigenen Base URL. Für Teams in China hat es Vorteile, Cursor an ein einheitliches OpenAI-kompatibles Gateway anzubinden: Der Zugriffspfad ist fest, die Abrechnung läuft zentral, und man kann zwischen Modellen wechseln.

Dieser Artikel folgt der praktischen Reihenfolge: Vorbereitung, Konfiguration, Prüfung, Grenzen und Einführung im Team. Die Menübezeichnungen können sich je nach Version unterscheiden; maßgeblich sind die Cursor Settings Ihrer Installation.

Hinweis: Cursor ist eine Marke von Anysphere, Inc. Dieser Artikel dient ausschließlich der technischen Erläuterung; es besteht weder eine Zugehörigkeit noch ein Vertretungsverhältnis zu Cursor/Anysphere. Oberfläche, Tarife und Abrechnungsregeln richten sich nach den Cursor-Seiten.

1. Zwei verschiedene „Cursor-APIs“ unterscheiden

Die erste ist die API, die Cursor selbst bereitstellt, etwa Cloud Agents und Verwaltungsschnittstellen. Der Key wird im Cursor-Konto erstellt und dient dem Aufruf der Cursor-Dienste. Die zweite ist „Bring Your Own Key“ (BYOK): Man hinterlegt in Cursor den Key eines Modellanbieters, sodass der Editor die Modelle über das eigene Konto aufruft. Dieser Artikel behandelt die zweite Variante.

Eine oft übersehene Voraussetzung: Cursor leitet Modellanfragen über seine eigenen Server weiter, nicht direkt vom lokalen Rechner. Die Base URL muss daher öffentlich erreichbar sein. Ein Gateway, das nur im Firmenintranet erreichbar ist, führt auf der Cursor-Seite in der Regel zu Timeouts. Die ZSQH AI Gateway ist ein öffentlicher Dienst und unterliegt dieser Einschränkung im Allgemeinen nicht.

2. Key, Base URL und Modellnamen vorbereiten

Vor dem Start braucht man drei Dinge: einen API-Key, eine kompatible Adresse und eine exakte Modell-ID.

  1. Öffnen Sie die Registrierungsseite der ZSQH AI Gateway, registrieren Sie sich und melden Sie sich in der Konsole an.
  2. Gehen Sie zu „API-Keys“, legen Sie einen neuen Key an und benennen Sie ihn nach dem Verwendungszweck, etwa cursor-arbeitsrechner.
  3. Legen Sie ein Ausgabenlimit und ein Ablaufdatum fest. Auch bei privaten Konten empfiehlt sich das, um ungewöhnlichen Verbrauch zu begrenzen.
  4. Kopieren Sie den Key und speichern Sie ihn im Passwortmanager. Die Konsole zeigt ihn in der Regel nur einmal vollständig an.
  5. Öffnen Sie die Seite Modellpreise und notieren Sie die benötigte Modell-ID. Preise und Modelle ändern sich; maßgeblich ist die aktuell angezeigte ID.

Die drei Konfigurationswerte sehen so aus:

Base URL: https://ai.zhongshangqihang.com/v1
API Key:  sk-... (in der Konsole erstellt, nur im Passwortmanager gespeichert)
Model:    Modell-ID laut aktueller Anzeige auf der Seite „Modellpreise“

Die Base URL ist die OpenAI-kompatible Adresse und endet auf /v1. Tragen Sie weder die Anthropic-Stammadresse noch zusätzlich /chat/completions ein, sonst entstehen leicht doppelte Pfade.

3. Die Konfiguration in Cursor eintragen

Der übliche Weg ist Cursor Settings → Models → API Keys. Je nach Version kommen Optionen hinzu oder entfallen, die Kernschritte sind aber ähnlich.

  1. Öffnen Sie die Cursor Settings; das Tastenkürzel ist meist Cmd/Ctrl + ,.
  2. Gehen Sie zu Models und klappen Sie den Bereich API Keys auf.
  3. Öffnen Sie OpenAI API Key, fügen Sie den eben erstellten Key ein und klicken Sie auf Save.
  4. Öffnen Sie Override OpenAI Base URL und tragen Sie https://ai.zhongshangqihang.com/v1 ein.
  5. Klicken Sie auf + Add Custom Model (in manchen Versionen + Add model), tragen Sie die Modell-ID aus der Preisliste ein und aktivieren Sie das Modell.
  6. Wählen Sie das Modell im Modellselektor des Dialogs aus und senden Sie eine einfache Anfrage.

Wenn Sie „Override OpenAI Base URL“ nicht finden, unterstützt Ihre Version oder Ihr Tarif das Umleiten OpenAI-kompatibler Anfragen an eine benutzerdefinierte Adresse nicht. Versuchen Sie dann nicht wiederholt dasselbe, sondern aktualisieren Sie die Version oder verwenden Sie eine Installation, die diesen Schalter bietet.

Der Modellname ist eine Routing-Kennung, keine Notiz. Groß- und Kleinschreibung, Bindestriche und Versionssuffix müssen mit dem Gateway übereinstimmen. Bei einem Tippfehler zeigt sich das meist als „Modell nicht gefunden“, 404 oder abgelehnte Anfrage.

4. Wie man Modelle auswählt

In Cursor lassen sich mehrere benutzerdefinierte Modelle anlegen. Ob eine Anfrage gelingt, hängt davon ab, ob das Gateway ein Modell mit demselben Namen anbietet und die entsprechende Aufrufart unterstützt.

Einsatzszenario Empfohlene Stufe Eintragung Hinweise
Alltägliche Fragen, kleine Änderungen Leichtes, schnelles Modell Modell-ID aus der Preisliste kopieren Niedrige Latenz, begrenzte Fähigkeit für komplexe Refactorings
Änderungen über mehrere Dateien, Agent Hauptmodell für Code Modell-ID aus der Preisliste kopieren Tool-Aufrufe müssen unterstützt werden
Architekturdesign, schwierige Fehlersuche Leistungsstarkes Modell Modell-ID aus der Preisliste kopieren Höhere Kosten, bedarfsweise einsetzen
Tab-Vervollständigung Integriertes Cursor-Modell Läuft nicht über den eigenen Key BYOK deckt die Vervollständigung nicht ab

Der Agent-Modus kann von der Responses API oder von Tool-Aufrufen abhängen. Ist das Gateway nur zu Chat Completions kompatibel, schlagen einzelne Agent-Funktionen fehl. Prüfen Sie in diesem Fall zuerst im normalen Dialog, ob es am Modell oder an der fehlenden Funktionskompatibilität liegt.

Außerdem laufen Auto, Composer und die Tab-Vervollständigung nicht zwangsläufig über Ihren Key. Laut Cursor-Hilfeseite verwendet die Tab-Vervollständigung immer die integrierten Modelle; auch der Auto-Modus kann von Cursor selbst geroutet werden. Betrachten Sie benutzerdefinierte Modelle als einen Kanal, der erst nach ausdrücklicher Auswahl greift.

5. Prüfen, ob die Konfiguration wirkt

Ob Cursor antwortet, reicht als Prüfung nicht aus, denn die Antwort kann über den integrierten Kanal kommen. Gehen Sie wie folgt vor:

  1. Öffnen Sie einen neuen, leeren Dialog, damit kein Verlauf stört.
  2. Wählen Sie im Modellselektor ausdrücklich das benutzerdefinierte Modell, nicht Auto.
  3. Senden Sie eine kurze Anfrage, etwa die Erklärung eines Codeblocks unter zehn Zeilen.
  4. Öffnen Sie Verbrauch oder Anfrage-Logs in der Gateway-Konsole und prüfen Sie, ob ein Eintrag mit gleicher Zeit, gleichem Modell und gleichem Key erscheint.
  5. Halten Sie das Ergebnis fest. Fehlt der Log-Eintrag, hat die Anfrage das Gateway nicht erreicht; prüfen Sie dann Base URL und Schalter.

Häufige Fehler lassen sich so zuordnen:

  • 401 oder 403: Key falsch, deaktiviert oder Kontingent aufgebraucht.
  • 404: Base-URL-Pfad falsch oder Modellname existiert nicht.
  • 429: Rate-Limit ausgelöst oder Ausgabenlimit des Keys erreicht.
  • Timeout: Endpunkt nicht erreichbar oder Netzwerkpfad gestört.
  • Nur der Agent schlägt fehl: möglicherweise fehlende Schnittstellenkompatibilität, nicht unbedingt ein Key-Problem.

6. Grenzen, die man kennen sollte

  • BYOK deckt vor allem Chat-Modelle ab; die Tab-Vervollständigung nutzt weiterhin die integrierten Cursor-Modelle.
  • Der Unterstützungsumfang für OpenAI-Keys unterscheidet sich je nach Version. Laut Cursor-Hilfeseite deckt der eigene OpenAI-Key nur Standard-Chatmodelle ohne Reasoning ab; Reasoning-Modelle und einige neue Funktionen sind möglicherweise nicht verfügbar.
  • Anfragen werden über Cursor-Server weitergeleitet; der benutzerdefinierte Endpunkt muss öffentlich erreichbar sein.
  • Für Anfragen mit eigenem Key gilt nicht zwangsläufig die Null-Datenhaltungsrichtlinie von Cursor; die Datenverarbeitung hängt vom Modellanbieter und Gateway ab. Teams mit harten Anforderungen an die Datenhaltung sollten vorher eine Bewertung durchführen.
  • Team- und Enterprise-Tarife können auch mit eigenem Key Plattformgebühren nach Cursor-Regeln berechnen; maßgeblich ist die Cursor-Abrechnungsseite.
  • Cursor aktualisiert sich schnell; Menünamen, unterstützte Modelle und Abrechnungsregeln können sich ändern.

7. Einführung im Team

  • Zuerst einen kleinen Pilotversuch starten: drei bis fünf Entwickler, ein einheitliches Hauptmodell, eine Woche Laufzeit.
  • Drei Datengruppen erfassen: Erfolgsquote der Anfragen, durchschnittliche Latenz und Verbrauch pro Person und Tag.
  • Im Gateway für jede Person einen eigenen Key anlegen und Kontingente pro Person setzen, keine gemeinsamen Keys verwenden.
  • Eine Modellzuordnungstabelle pflegen: Was in Cursor eingetragen wird, welches Modell im Gateway entspricht und worauf bei Fehlern umgeschaltet wird.
  • Die Konfiguration in der internen Dokumentation festhalten, einschließlich Base URL, Modell-IDs und Behandlung häufiger Fehler.
  • Nach Beobachtung der Kosten entscheiden, wer den eigenen Key nutzt und wer beim Tarifkontingent bleibt. Maßgeblich sind die Preise auf Modellpreise.
  • Bei Austritt, Rechnerwechsel oder Projektende den jeweiligen Key noch am selben Tag deaktivieren.

8. Sicherheitscheckliste

  • Ein Key pro Verwendungszweck, keine Wiederverwendung über Geräte hinweg.
  • Ausgabenlimit und Ablaufdatum setzen.
  • Keys nicht in Code, .env, Screenshots oder Tickets schreiben.
  • Keys auf gemeinsam genutzten Rechnern nicht dauerhaft speichern.
  • Regelmäßig rotieren; bei Verdacht auf Offenlegung zuerst deaktivieren, dann untersuchen.
  • Im Team einheitlich über das Gateway gehen und Anfrage-Logs für Audits aufbewahren.
  • Bei sensiblen Repositories vorher klären, ob Daten den lokalen Rechner verlassen und an welche Dienste sie fließen.

9. Häufige Fragen

Unterstützt Cursor beliebige OpenAI-kompatible Schnittstellen?

Nicht unbedingt. Entscheidend ist, ob die Cursor-Version „Override OpenAI Base URL“ anbietet und ob die Schnittstelle zu den tatsächlich aufgerufenen Pfaden und Parametern kompatibel ist. Prüfen Sie zuerst im normalen Dialog und testen Sie danach die Agent-Funktionen.

Warum wird trotz eigenem Key ein Abonnement verlangt?

Ein eigener Key schaltet nicht alle Funktionen frei. Einige Editor-Funktionen, Teamverwaltung und integrierte Modelle bleiben an den Tarif gebunden; maßgeblich sind die aktuellen Cursor-Tarifregeln.

Warum verbraucht die Tab-Vervollständigung meinen Key nicht?

Laut Cursor-Hilfeseite verwendet die Tab-Vervollständigung immer die integrierten Cursor-Modelle und läuft nicht über den eigenen Key. Das ist Produktdesign, kein Konfigurationsfehler.

Gehört in die Base URL die Stammadresse oder /v1?

Für das OpenAI-kompatible Protokoll die Adresse bis /v1. Hängen Sie nicht /chat/completions an, sonst entstehen doppelte Pfade und 404-Fehler.

Kann das Team einen gemeinsamen Key verwenden?

Technisch ja, empfehlenswert ist es nicht. Ein gemeinsamer Key lässt keine Zuordnung des Verbrauchs zu Personen zu und ist bei Offenlegung schwer zu lokalisieren. Ein Key pro Person mit Kontingenten und Logs ist sicherer.

Nächste Schritte

Registrieren Sie sich bei der ZSQH AI Gateway, erstellen Sie einen Key speziell für Cursor und tragen Sie Base URL sowie Modell wie beschrieben ein. Nach einem erfolgreichen normalen Dialog können Sie anhand der Modellpreise das Hauptmodell und die Kontingente anpassen.

Verwandte Artikel: