Cursor ist einer der am weitesten verbreiteten KI-Code-Editoren. Er bringt eigene Modellkontingente mit, unterstützt aber auch die Eingabe eines eigenen API Key und einer eigenen Base URL. Für Teams in China hat ein eigenes Gateway drei Vorteile: stabilerer Zugang, einheitliche Abrechnung und jederzeit wechselbare Modelle.
Dieser Artikel erklärt die Konfiguration der benutzerdefinierten API in Cursor, typische Fallstricke und die Wahl zwischen „Abo“ und „eigenem Key“.
Cursor wird häufig aktualisiert; Bezeichnungen im Einstellungsmenü können sich ändern. Dieser Artikel beschreibt den üblichen Stand im Oktober 2026; maßgeblich sind die Settings Ihrer aktuellen Version.
1. Zwei Nutzungsarten von Cursor verstehen
1.1 Cursor-eigene Kontingente
Sofort einsatzbereit, Abrechnung nach Cursor-Tarif. Geeignet für Privatnutzer, die wenig Aufwand und kein großes Volumen haben.
1.2 Eigener API Key
In Cursor werden Key und Base URL einer OpenAI-kompatiblen Drittanbieter-Schnittstelle eingetragen; die Aufrufkosten laufen über das eigene API-Konto. Geeignet, wenn:
- der Zugang zur offiziellen Schnittstelle aus China instabil ist;
- das Team einheitliche Abrechnung und Kontingente wünscht;
- bestimmte Modelle vorgegeben oder mehrere Anbieter gewechselt werden sollen;
- die Cursor-Nutzung in die unternehmensweite Kostenverwaltung einfließen soll.
Hinweis: Auch mit eigenem Key können einzelne Cursor-Funktionen einen gültigen Tarif voraussetzen. Maßgeblich sind die aktuelle Cursor-Version und die Tarifregeln.
2. API Key vorbereiten
- ZSQH AI Gateway öffnen und anmelden.
- „API-Schlüssel“ aufrufen und einen neuen Key anlegen, Name etwa
cursor-arbeitsrechner. - Obergrenze und Ablaufzeit setzen.
- Key kopieren und im Passwortmanager speichern.
- In der Wallet aufladen und das Guthaben prüfen.
Als Base URL verwenden:
https://ai.zhongshangqihang.com/v1
Das ist die OpenAI-kompatible Adresse. Die benutzerdefinierte API in Cursor ruft üblicherweise nach dem OpenAI-Protokoll auf; tragen Sie daher nicht die Anthropic-Stammasdresse ein.
3. Konfiguration in Cursor
Der Menüpfad unterscheidet sich leicht je Version, üblicherweise:
Cursor Settings → Models → OpenAI API Key
Vorgehen:
- Cursor-Einstellungen öffnen (Tastenkürzel meist
Cmd/Ctrl + ,). - Den Bereich Models oder OpenAI API Key suchen.
- „Override OpenAI Base URL“ oder einen ähnlichen Schalter aktivieren.
- Base URL
https://ai.zhongshangqihang.com/v1eintragen. - API Key
sk-...eintragen. - In der Modellliste die gewünschten Modellnamen hinzufügen, etwa
gpt-5oderclaude-sonnet-4-5. - Speichern, einen neuen Dialog öffnen und das benutzerdefinierte Modell testen.
Wenn Cursor „API Key invalid“ meldet:
- Prüfen, ob der Key vollständig kopiert wurde.
- Prüfen, ob die Base URL auf
/v1endet. - Prüfen, ob ausreichend Guthaben vorhanden ist.
- Prüfen, ob der Modellname im aktuellen Konto verfügbar ist.
4. Modellwahl
In Cursor lassen sich die Aufgaben in drei Gruppen teilen:
| Aufgabe | Empfohlenes Modell | Grund |
|---|---|---|
| Tägliche Vervollständigung, kleine Bugfixes | Leichtes/schnelles Modell | Niedrige Latenz, niedrige Kosten |
| Refactoring über mehrere Dateien, komplexe Agents | Claude Sonnet / GPT-Hauptmodell | Stabileres Codeverständnis und Tool-Nutzung |
| Schwieriges Reasoning, Architekturentwurf | Opus / leistungsstärkere Stufe | Höhere Fähigkeit, höhere Kosten |
Modellnamen richten sich ausschließlich nach der Seite Modellpreise. Die Modellauswahl in Cursor zeigt möglicherweise nur bekannte Namen; erscheint ein benutzerdefiniertes Modell nicht, lässt es sich manuell hinzufügen oder ein kompatibler Modellalias wählen.
5. Abo oder eigener Key: Was ist günstiger?
Eine pauschale Antwort gibt es nicht; es kommt auf das Volumen an. Zur Schätzung:
- Ermitteln, wie viele Anfragen pro Tag mit welcher Kontextgröße gesendet werden.
- Preis und Kontingent des Cursor-Tarifs prüfen.
- Mit der API-Preisseite die Tokenkosten für dasselbe Volumen schätzen.
- Stabilität, Zugriffsgeschwindigkeit und Abrechnungsverwaltung mit einbeziehen.
Erfahrungswerte:
- Geringes Volumen, nur ein Modell: Ein Tarif ist oft unkomplizierter.
- Hohes Volumen, viele Modellwechsel, mehrere Teammitglieder: eigener Key plus Gateway ist meist besser kontrollierbar.
- Stabiler Zugang aus China: Der Wert des Gateways übersteigt oft den Unterschied beim Einzelpreis.
Konkrete Preise richten sich nach den Modellpreisen und der offiziellen Tarifseite von Cursor.
6. Häufige Probleme und Fehlersuche
| Symptom | Mögliche Ursache | Vorgehen |
|---|---|---|
| 401 | Key falsch, abgelaufen, Base URL falsch | Key neu kopieren; /v1 prüfen |
| 404 | Pfad in der Base URL doppelt | Nur bis /v1 eintragen, ohne /chat/completions |
| Modell nicht verfügbar | Modellname falsch oder nicht freigeschaltet | Modellname von der Preisseite kopieren |
| Timeout | Netz oder Proxy | Netz prüfen, direkt/über Proxy wechseln |
| Guthaben reicht nicht | Nicht aufgeladen oder Kontingent erschöpft | Aufladen; Key-Kontingent prüfen |
| Antwort abgeschnitten | Kontext- oder Ausgabelimit | Kontext reduzieren oder Ausgabelimit erhöhen |
7. Sicherheitsempfehlungen
- Für Cursor einen eigenen Key anlegen, nicht gemeinsam mit Produktionsdiensten nutzen.
- Eine Obergrenze setzen, damit Hintergrundanfragen der IDE nicht zu viel verbrauchen.
- Keys auf gemeinsam genutzten Rechnern nicht dauerhaft speichern.
- Bei Austritt oder Rechnerwechsel alte Keys löschen.
- Im Team ein einheitliches Gateway und Keys pro Mitglied verwenden, um die Prüfung zu erleichtern.
8. Für welche Teams es passt
- Agenturen und Outsourcing-Teams: ein Key pro Projekt, Kosten pro Projekt abrechnen.
- Start-ups: einheitlicher Zugang, jederzeit wechselbare Modelle, keine Bindung an einen Anbieter.
- Unternehmensentwicklung: Mitglieder, Kontingente, Logs und Abrechnung zentral verwalten.
- Einzelentwickler: stabilerer Zugang aus China, bequemere Zahlung.
Nächste Schritte
Registrieren Sie sich zuerst beim ZSQH AI Gateway, erstellen Sie einen dedizierten cursor-Key und tragen Sie ihn gemäß diesem Artikel in Cursor ein. Nach erfolgreichem Test das Hauptmodell anhand der Modellpreise anpassen.
Weiterlesen:
