Cursor-Editor einrichten

QCode.cc mit einer benutzerdefinierten Anthropic-/OpenAI-Base-URL + API-Key mit der Cursor-IDE verbinden – einschließlich Modellkonfiguration, Einschränkungen bei benutzerdefinierten Endpunkten und Fehlerbehebung

Zuletzt überprüft: 2026-09-18 · 📄 Gemäß offizieller Dokumentation (Cursor 3.21 (offizielle Download-Seite, golden channel, geprüft 2026-09); die Override-Felder basieren auf einer Antwort vom 2026-08-11 durch Cursor-Mitarbeiter im offiziellen Forum)

Auf einen Blick¶

Wo sich die Felder befinden und ein bekannter Bug¶

Der Ort, an dem Sie eine URL eingeben, ist Settings → Models → API Keys. Cursors BYOK-Hilfeseite (cursor.com/help/models-and-usage/api-keys) listet nur vier Schritte auf: Cursor Settings → Models öffnen, den Anbieter wählen (OpenAI, Anthropic, Google, Azure oder AWS Bedrock), den API-Key in das Textfeld einfügen, auf Save klicken — die Override-Felder werden dort nicht erwähnt. Die Felder existieren jedoch; der Cursor-Mitarbeiter deanrie hat sie im offiziellen Forum benannt:

„The fix for the OpenAI API Key and Override OpenAI Base URL fields, and other provider key fields, that didn't focus on mouse click has been merged and will ship in an upcoming 3.15 update. It's not in 3.15.6 yet. Once you update to a version newer than 3.15.6, please try again." (2026-08-11, Original-Thread)

Drei konkrete Punkte:

• Die Felder heißen Override OpenAI Base URL (der OpenAI-Zweig) und Override Anthropic Base URL (der Anthropic-Zweig), jeweils mit einem eigenen Aktivierungsschalter.
• 3.15.6 enthält eine bekannte Regression: Mit der Maus lassen sich diese Eingabefelder nicht fokussieren. Der offizielle Workaround besteht darin, den entsprechenden Schalter unter Settings → Models zu aktivieren und anschließend die Tab-Taste zu drücken, um den Fokus in das Feld zu verschieben — danach funktionieren Eingabe und Strg+V. Ein Rollback auf 3.14.27 funktioniert ebenfalls. Der Fix wird in einem Update nach 3.15.6 ausgeliefert, also aktualisieren Sie auf eine neuere Version als 3.15.6 und versuchen Sie es erneut.
• Dieselbe Seite stellt wörtlich fest: „Your API key is not stored on our servers. It is sent to our backend with every request because all requests are routed through Cursor's servers for final prompt building“ — selbst mit Ihrem eigenen Key laufen die Anfragen über Cursors Backend; der Editor kommuniziert nicht direkt mit Ihrem Modellanbieter.

Drei weitere Einschränkungen und ein Zeitrisiko:

• Auf Teams-/Enterprise-Tarifen gilt der Cursor Token Rate weiterhin, auch bei eigenem Key, und die OpenAI-BYOK-Beschreibung ist auf „Standard, non-reasoning chat models“ beschränkt.
• Um den gesamten Datenverkehr aus Cursors Backend herauszuhalten, benötigen Sie einen Client, der eine benutzerdefinierte Base URL unterstützt: Claude Code, Codex CLI, Cline, Zed und ähnliche.
• Zeitrisiko: In einer Erklärung vom 2026-08-28 schrieb OpenAI, dass sie „intend to wind down our contract providing OpenAI models to Cursor, with a proposed shutoff date of November 12, 2026“ — vorgeschlagen, aber noch nicht in Kraft. Cursor hat zum Stand 2026-09-18 keinen entsprechenden Hinweis veröffentlicht. Quelle: openai.com.

Cursor ist ein KI-nativer Editor, der auf VS Code aufbaut. Cursors Changelog ist nicht nach Versionsnummer organisiert, daher wiederholt diese Seite keine „Release X hat Feature Y“-Erzählungen; was wir bestätigen konnten, ist, dass die Download-Seite den golden channel 3.21 anbot. Dieser Leitfaden erklärt, wie Sie QCode.cc in Cursor einbinden — lesen Sie aber zuerst den nächsten Abschnitt, denn er entscheidet, ob dieser Ansatz für Sie überhaupt funktioniert.

Warum Cursor¶

• Agents Window (neu in v3): Mehrere KI-Agenten parallel in der Seitenleiste ausführen, ohne gegenseitige Beeinflussung
• Cursor Composer: Multi-File-Bearbeitung mit kontextbewusstem Refactoring, für größere Änderungen besser geeignet als Cursor Chat
• Inline Edit (Cmd+K): Code auswählen und inline eine Anweisung erteilen – der schnellste Iterationszyklus
• Basiert auf VS Code: Nutzt das gesamte VS Code-Erweiterungs-Ökosystem (einschließlich der Claude Code VS Code Extension)

Voraussetzungen¶

• Cursor installiert (macOS / Windows / Linux)
• Ein QCode.cc API-Key (beginnt mit cr_), verfügbar im Dashboard
• Derselbe API-Key funktioniert über alle QCode-Protokolle und alle drei Ingress-Domains (api / asia / us); Nutzer in Festlandchina sollten asia.qcode.cc bevorzugen

Verfügbare Modelle¶

Die folgende Tabelle listet die von uns auf QCode häufig genutzten Modell-IDs (live Liste und Preise unter qcode.cc/models); das sind genau die Werte, die Sie in Cursor eingeben. Feldpositionen und der 3.15.6-Eingabefehler werden im obigen Abschnitt behandelt.

Die Gemini-Stückpreise und etwaige Plan-Multiplikatoren sind wie auf qcode.cc/models angegeben – verwenden Sie nicht mündlich übermittelte „×2“. Die obige Tabelle ist die aktuelle Empfehlung; 4.x-IDs wie claude-sonnet-4-6, claude-opus-4-8 und claude-opus-4-7 bleiben verfügbar.

Konfigurationsschritte¶

Die beiden folgenden Pfade entsprechen den zwei Override-Feldern; Pfad A (OpenAI-Protokoll) bietet die beste Kompatibilität. Wenn die Eingabefelder keinen Fokus annehmen, verwenden Sie den Tab-Workaround oben oder aktualisieren Sie auf eine Version nach 3.15.6.

Pfad A: Custom OpenAI-kompatibler Endpunkt (empfohlen)¶

Verwenden Sie das OpenAI-Protokoll, um den /openai/v1-Pfad von QCode anzusprechen, der GPT-Modelle und die vier chinesischen Familien (GLM / Kimi / DeepSeek / Qwen) bedient.

🔴 Dieser Pfad kann weder Claude bedienen, noch Gemini. QCodes OpenAI-Endpunkt akzeptiert nur diese beiden Gruppen; eine claude-…- oder gemini-…-ID gibt model_not_available_on_endpoint zurück. Für Claude verwenden Sie den unten stehenden Pfad B. Siehe Endpunkte & API-Pfade.

1. Cursor-Einstellungen öffnen: Cmd + , (macOS) / Ctrl + , (Windows/Linux)
2. Models → nach ganz unten scrollen und Override OpenAI Base URL finden
3. Ausfüllen:

1. In der Models-Liste die gewünschten Modelle aktivieren (z. B. gpt-6-sol, gpt-6-luna, gpt-5.6-terra); für Modelle, die nicht aufgelistet sind, auf + Add model klicken und die Modell-ID manuell eingeben
2. Auf Verify klicken, um die Konnektivität zu testen; wenn die Prüfung bestanden ist, können Sie die Modelle über Cursor Chat / Composer nutzen

Die Base URL darf nicht mit einem abschließenden Slash enden. Eine QCode-Selbstprüfung gibt 401 zurück, was bedeutet, dass der Pfad korrekt ist und nur die Authentifizierung fehlt – das ist normal und bestätigt, dass der Endpunkt erreichbar ist.

Base-URL-Referenz pro Protokoll (derselbe Key funktioniert für alle):

Pfad B: Custom Anthropic-Endpunkt (natives Claude-Protokoll)¶

Wenn Sie das native Anthropic-Protokoll für Claude-Modelle verwenden möchten, lautet QCodes Anthropic-Base-URL https://api.qcode.cc/api (das SDK hängt automatisch /v1/messages an).

In den Cursor-Einstellungen unter Models → Anthropic API den QCode-Key eintragen und Override Anthropic Base URL mit der obigen Adresse aktivieren.

🔴 Die beiden Overrides interferieren miteinander. Wie von Nutzern berichtet: Sobald Override OpenAI Base URL gesetzt ist, leitet Cursor auch den Claude-Traffic an diesen OpenAI-Endpunkt um, und Claude-Modelle schlagen mit 422 fehl. Die Cursor-Dokumentation hält dieses Verhalten nicht fest – es ist eine Community-Beobachtung und kann sich mit Versionen ändern. Um Claude zu verwenden, setzen Sie nur das Anthropic-Override und lassen Sie das OpenAI-Override leer. Wenn Sie beide benötigen, verwenden Sie separate Cursor-Profile oder wechseln Sie bei Bedarf.

⚠️ Im Agent-Modus verwenden einige Funktionen den OpenAI-Responses-API-Stil, der im Anthropic-Protokollpfad in bestimmten Szenarien inkompatibel ist (typischerweise fehlgeschlagene Schema-Konvertierung für einige Tool-Aufrufe). Die Endpunkt-Schalter von Cursor ändern sich von Zeit zu Zeit, daher ist die offizielle Cursor-Dokumentation maßgeblich.

Welche Funktionen über einen eigenen Endpoint funktionieren¶

Cursor teilt seine KI-Funktionen in mehrere Kategorien ein, und ein eigener OpenAI-Endpoint deckt sie in unterschiedlichem Maße ab. Die folgende Tabelle ist eine praktische Einschätzung auf Basis aktueller Beobachtungen; Cursor wird häufig aktualisiert, daher gilt stets: Maßgeblich sind die offiziellen Cursor-Dokumentationen:

Kurz gesagt: Das Trio Chat / Composer / Inline Edit läuft auf einem QCode-Endpoint am zuverlässigsten; stark verwaltete Funktionen (Tab-Vervollständigung, Teile des Agenten-Workflows) bleiben möglicherweise auf Cursors eigenen Modellen. Dieser gesamte Abschnitt beruht auf Beobachtungen, nicht auf offizieller Dokumentation – folgen Sie den Ankündigungen von Cursor.

Ein typischer Arbeitsablauf¶

Sobald der Endpoint eingerichtet ist, sieht ein alltäglicher Composer-Ablauf ungefähr so aus:

1. Modell in Composer wählen (z. B. claude-sonnet-5 für die tägliche Arbeit, claude-opus-5 für umfangreiche Änderungen)
2. Composer mit Cmd + I öffnen und die zu bearbeitenden Dateien in den Kontextbereich ziehen
3. Das Ziel in natürlicher Sprache beschreiben, z. B. „Migrieren Sie die Zustandsverwaltung dieser Komponente von useState auf useReducer und behalten Sie die bestehenden Props bei“
4. Diff überprüfen und Block für Block Accept / Reject wählen
5. Für schnelle lokale Änderungen Inline Edit (Cmd + K) verwenden, statt jedes Mal Composer zu öffnen

Dieser gesamte Ablauf läuft über den von Ihnen konfigurierten QCode-Endpoint, und das Kontingent wird gemäß den Regeln unter Abrechnung abgerechnet.

Fallback-Endpoints¶

Die drei Domains sind unterschiedliche Einstiegspunkte in denselben Dienst, und derselbe API-Key funktioniert auf allen. Die vollständige Referenz finden Sie unter Endpoints und API-Pfade.

Bild-Eingabe vs. Bildgenerierung¶

• Bild-Eingabe (das Modell „sieht“ ein Bild): Cursor ermöglicht es Ihnen, Screenshots / Design-Mockups in die Konversation einzufügen oder einzuziehen, damit ein visionfähiges Modell sie lesen kann – z. B. eine Komponente aus einem UI-Sketch erstellen oder aus einem Fehler-Screenshot debuggen. Visionfähige Modelle bei QCode umfassen Claude Opus 5 / Sonnet 5 und GPT-5.x.
• Bildgenerierung (das Modell „zeichnet“): Das ist etwas anderes. Zum Generieren von Bildern nutzen Sie QCodes Modell gpt-image-2 über den dedizierten Bild-Endpoint – nicht innerhalb des Cursor-Editors. Siehe gpt-image-2 Bildgenerierung.

Zusammen mit Claude Code verwenden¶

Cursors integrierte KI steht nicht im Konflikt mit der eigenständigen Claude Code CLI – beide können parallel im selben Cursor-Fenster laufen:

• Cursor Chat / Composer: KI im Editor, die den in den Cursor-Einstellungen konfigurierten Endpoint nutzt
• Claude Code CLI: claude im integrierten Terminal von Cursor ausführen (Ctrl + `); it uses the CLI's own ANTHROPIC_BASE_URL-Umgebungsvariable

Claude Code aus dem integrierten Terminal auf QCode (Anthropic-Protokoll) verweisen:

export ANTHROPIC_BASE_URL="https://api.qcode.cc/api"
export ANTHROPIC_AUTH_TOKEN="cr_your_key"
claude

Beide Pfade authentifizieren sich unabhängig, aber wenn Sie auf beiden denselben QCode-API-Key verwenden, teilen sie sich das Kontingent (Details unter Abrechnung). Claude Codes Subagents und Automatisierung & CI/CD funktionieren in diesem Terminal direkt.

Einschränkungen und Hinweise¶

• Privacy Mode: Cursor sendet Code-Snippets standardmäßig an den konfigurierten Endpunkt. Wenn Sie den Privacy Mode in den Cursor-Einstellungen aktiviert haben, stellen Sie sicher, dass die API-Key-Konfiguration weiterhin den Zugriff auf QCode erlaubt; der Privacy Mode hat keinen Einfluss auf den ausgehenden Datenverkehr, er verhindert lediglich, dass Cursor Ihre Prompts selbst speichert
• Ein Cursor-Pro-Abo und ein QCode-API-Key sind zwei unabhängige Systeme — Cursor-Pro gewährt Ihnen das integrierte Kontingent von Cursor (mit dem eigenen Modellpool von Cursor), während der QCode-API-Key unseren Gateway-Pool nutzt. Sind beide aktiv, erfolgt das Routing gemäß der in Cursor konfigurierten Priorität
• Agents Window und Hintergrund-Agenten funktionieren am besten mit gängigen Anbietern (OpenAI-/Anthropic-Protokolle); selbst gehostete OSS-Modellserver liefern uneinheitliche Ergebnisse
• Der Override ist ein globaler Schalter: Das Ausfüllen der Override OpenAI Base URL leitet die standardmäßig das OpenAI-Protokoll nutzenden Anfragen an QCode um, und das Löschen stellt den Cursor-Standard wieder her. Gemäß den offiziellen Angaben durchlaufen die Anfragen jedoch weiterhin das Backend von Cursor für das Prompt-Building, sodass die Annahme „Nur der Datenverkehr wurde verlagert, nichts sonst hat sich geändert“ nicht zutrifft

Praxistipps¶

• Modell je Aufgabe wählen: Auf Pfad B (Anthropic, https://api.qcode.cc/api) bietet claude-sonnet-5 das beste Preis-Leistungs-Verhältnis für alltägliche Bearbeitungen und claude-opus-5 bewältigt große Refactorings; auf Pfad A (OpenAI) probieren Sie gpt-5.6-terra für reine Code-Vervollständigung und gpt-6-sol für allgemeine Aufgaben
• 1M-Tier für langen Kontext bevorzugen: Modelle mit 1M-Kontext wie claude-opus-5 / gpt-6-sol eignen sich für Composer-Änderungen, bei denen das gesamte Repository eingelesen wird
• Geld sparen: Setzen Sie ein Mittelklasse-Modell als Composer-Standard und wechseln Sie nur bei schwierigen Problemen manuell auf ein Flaggschiff-Modell
• Nächstgelegenen Endpunkt nutzen: In Festlandchina ist das Umschalten der Base URL auf https://asia.qcode.cc/openai/v1 in der Regel schneller
• Bei ungewöhnlichem Verhalten zuerst Verify klicken: Das Endpunktverhalten kann sich nach einem Cursor-Update ändern, daher einmal auf Verify klicken, bevor Sie andere Ursachen untersuchen

FAQ¶

Cursor meldet „API key not valid“¶

1. Prüfen Sie, ob der API-Key vollständig ist, mit cr_ beginnt und keine führenden oder nachgestellten Leerzeichen enthält
2. Klicken Sie in den Cursor-Einstellungen auf Verify, um die spezifische Fehlermeldung zu sehen
3. Testen Sie die Konnektivität über die Befehlszeile: bash curl -H "Authorization: Bearer YOUR_KEY" \ https://api.qcode.cc/openai/v1/models Lautet die Antwort eine JSON-Liste, sind sowohl Endpunkt als auch API-Key in Ordnung

Verify schlägt fehl, curl funktioniert aber¶

Dies ist in der Regel ein Abschluss-Slash in der Base URL oder ein fehlendes /v1 im Pfad. Stellen Sie sicher, dass Sie https://api.qcode.cc/openai/v1 (OpenAI-Protokoll) ohne abschließenden / eingegeben haben. Hinweis: Der Aufruf des Basis-Pfads mit Antwort 401 ist normal (Pfad korrekt, Authentifizierung fehlt) und bedeutet nicht, dass die Konfiguration falsch ist.

Composer kann keine Claude-Modelle nutzen¶

Composer verwendet standardmäßig das OpenAI-Protokoll, und QCodes OpenAI-Endpunkt akzeptiert keine Claude-Modelle — das Hinzufügen von claude-opus-5 zur Liste Models hilft nicht, da die Anfrage mit model_not_available_on_endpoint abgewiesen wird.

Nutzen Sie stattdessen Pfad B: Geben Sie unter Models → Anthropic API Ihren QCode-Key ein, aktivieren Sie Override Anthropic Base URL mit https://api.qcode.cc/api und löschen Sie Override OpenAI Base URL (andernfalls sendet Cursor Claude-Datenverkehr an den OpenAI-Endpunkt und erhält 422 zurück).

Inline Edit (Cmd+K) ist langsam¶

Cursors Cmd+K verwendet standardmäßig das eigene schnelle Modell von Cursor; ein Wechsel zu QCode leitet die Anfrage über die konfigurierte Base URL, sodass die Latenz bis zum ersten Token etwas höher ist als bei der Cursor-integrierten Option (ein zusätzlicher Hop). In den Einstellungen können Sie Cursor Tab auf dem Cursor-Standard belassen, während Chat / Composer über den QCode-Endpunkt geleitet wird.

Agents Window / Hintergrund-Agenten melden Fehler oder nutzen QCode nicht¶

Einige Agenten-Unterkapazitäten haben Anforderungen an die Modellquelle und erzwingen möglicherweise die Nutzung der in Cursor integrierten Modelle anstelle eines benutzerdefinierten Endpunkts. Dies ist auf Seiten von Cursor gewollt und variiert zwischen Versionen, daher richten Sie sich nach den offiziellen Cursor-Dokumenten; Sie können Chat / Composer auf QCode umstellen und die Agenten-Workflows auf dem Cursor-Standard belassen.

Das hinzugefügte Modell erscheint nicht im Dropdown¶

Stellen Sie sicher, dass Sie in der Liste Models das Modell sowohl aktiviert als auch seine ID korrekt über + Add model eingegeben haben (Groß-/Kleinschreibung beachten, keine überflüssigen Leerzeichen). Starten Sie Cursor nach der Änderung einmal neu, um die Liste zu aktualisieren.

Nächste Schritte¶

• VS Code Integration — Editor derselben Familie mit gemeinsamen Konfigurationsmustern
• Endpoints and API Paths — Vollständiges Referenzdokument für die drei Protokolle und drei Eingangsbereiche von QCode.cc
• gpt-image-2 Image Generation — Dedizierter Endpunkt für Bildgenerierung
• Subagents — Claude Code Subagent-Nutzung
• Automation & CI/CD — Headless-Workflows
• Claude Code Tutorial — Referenz zum CLI-Workflow
• Billing — Gemeinsame Kontingentregeln

Noch keinen API-Key? Wählen Sie einen Plan auf qcode.cc/pricing — ein Key funktioniert in Cursor, Claude Code und jedem Tool, das benutzerdefinierte Endpunkte unterstützt.