🚀 Cursor mit benutzerdefinierten CodingPlanX-Modellen integrieren
> Einführung: Cursor ist ein bei Entwicklern sehr beliebtes KI-Programmiertool mit integrierten leistungsstarken Großmodellen. Aber manchmal müssen wir aufgrund von Netzwerkbeschränkungen, Kostenkontrolle (Verwendung von Drittanbieter-APIs oder günstigeren Modellen wie DeepSeek) oder Unternehmens-Intranet-Bereitstellungen eine benutzerdefinierte API-URL und einen API Key konfigurieren. > > Dieses Tutorial führt Sie Schritt für Schritt durch die einfache Konfiguration.
📋 Vorbereitungen
Bevor Sie mit der Konfiguration beginnen, stellen Sie bitte sicher, dass Sie die folgenden Informationen bereit haben:
- Cursor ist installiert: Stellen Sie sicher, dass Sie die neueste Version von Cursor installiert haben.
- API Key (Schlüssel): z. B.
sk-xxxxxxxxxxxxxxxxxxxxxxxx. - Base URL (Schnittstellenadresse): Ihre benutzerdefinierte API-Proxy-Adresse.
- Hinweis: Muss normalerweise mit
/v1enden, z. B.https://api.codingplanx.ai/v1.
- Hinweis: Muss normalerweise mit
- Modellname (Model Name): Der Standardname des Modells, das Sie verwenden möchten (z. B.
gpt-4o,claude-3-5-sonnet,deepseek-chatusw.).
⚙️ Detaillierte Konfigurationsschritte
Schritt 1: Cursor-Einstellungen öffnen
- Starten Sie den Cursor-Editor.
- Klicken Sie auf das Zahnradsymbol ⚙️ in der oberen rechten Ecke oder verwenden Sie die Tastenkombination, um die Einstellungen zu öffnen:
- Windows / Linux:
Strg+, - macOS:
Cmd+,
- Windows / Linux:
Schritt 2: Auf die Models (Modelle) Konfigurationsseite gehen
Suchen Sie in der linken Navigationsleiste des Einstellungsfensters die Registerkarte Models (Modelle) und klicken Sie darauf.
Schritt 3: API Key konfigurieren
- Scrollen Sie auf der Seite „Models“ nach unten und suchen Sie den Bereich
OpenAI API Key. - Fügen Sie Ihren benutzerdefinierten API Key in das Eingabefeld ein.
- Klicken Sie rechts auf die Schaltfläche
Verify(Überprüfen). (Wenn die Überprüfung zu diesem Zeitpunkt fehlschlägt, ist das kein Problem, da wir die URL noch nicht konfiguriert haben). - ⚠️ Wichtiger Hinweis: Stellen Sie sicher, dass die Schalter für den offiziellen
Cursor Tabvon Cursor und andere kostenpflichtige Abonnements entsprechend eingestellt sind (Wenn Sie kostenlose Drittanbieter-APIs nutzen, wird empfohlen, die offiziellen Modellschalter zu deaktivieren).
Schritt 4: Base URL konfigurieren (Standard-Schnittstelle überschreiben)
Dies ist der wichtigste Schritt, der bestimmt, wohin Ihre Anfragen gesendet werden:
- Suchen Sie unter dem Eingabefeld für den
OpenAI API Keydie OptionOverride OpenAI Base URL(OpenAI-Basis-URL überschreiben). - Erweitern Sie diese Option und geben Sie Ihre benutzerdefinierte Schnittstellenadresse in das Feld ein.
> 💡 Beispiel für die Eingabe:
> - CodingplanX AI:
https://api.codingplanx.ai/v1 - Nach der Eingabe müssen Sie unbedingt die Eingabetaste (Enter) drücken, um die Einstellungen zu speichern.
Schritt 5: Benutzerdefinierten Modellnamen hinzufügen (Optional, aber empfohlen)
Wenn das von Ihnen verwendete Modell nicht in der Standardliste von Cursor enthalten ist (z. B. deepseek-coder), müssen Sie es manuell hinzufügen:
- Scrollen Sie ganz nach oben auf der Models-Seite und suchen Sie den Bereich
Model Names. - Klicken Sie auf
+ Add Model(Modell hinzufügen). - Geben Sie den Namen Ihres Modells genau ein (z. B.
deepseek-chat) und drücken Sie zur Bestätigung die Eingabetaste. - Schalten Sie den Schalter vor dem soeben hinzugefügten Modell ein, und es wird empfohlen, andere Modelle, die Sie nicht verwenden, zu deaktivieren, um eine falsche Auswahl zu vermeiden.
✅ Test und Validierung
Nach Abschluss der Konfiguration müssen wir testen, ob sie wirksam ist:
- Kehren Sie zur Code-Bearbeitungsoberfläche zurück.
- Drücken Sie
Strg + L(Windows) oderCmd + L(macOS), um das Chat-Fenster auf der rechten Seite aufzurufen. - Klicken Sie unten im Chat-Fenster auf den aktuell angezeigten Modellnamen und wechseln Sie zu dem Modell, das Sie gerade konfiguriert haben (z. B.
gpt-4ooderdeepseek-chat). - Senden Sie eine einfache Begrüßung, z. B.:
"Wer bist du? Bitte nenne mir deine Modellversion." - Wenn die KI normal und schnell antworten kann, herzlichen Glückwunsch, die Konfiguration war erfolgreich! 🎉
❓ Fehlerbehebung / Häufig gestellte Fragen (FAQ)
| Fehlersymptom | Mögliche Ursache | Lösung |
|---|---|---|
| Verbindungs-Timeout / 404 Not Found | Format der Base URL ist falsch. | Überprüfen Sie, ob der URL das Suffix /v1 fehlt oder fälschlicherweise /chat/completions hinzugefügt wurde. Das korrekte Format sollte https://xxx.com/v1 lauten. |
| Model not found (Modell nicht gefunden) | Der angeforderte Modellname wird in Ihrem API-Kanal nicht unterstützt. | Überprüfen Sie, ob der in Cursor ausgewählte Modellname exakt mit dem von Ihrem API-Anbieter unterstützten Namen übereinstimmt (Groß-/Kleinschreibung beachten). |
| Authentication failed (Authentifizierung fehlgeschlagen) | API Key ist falsch eingegeben oder das Guthaben reicht nicht aus. | Überprüfen Sie, ob der Key vollständig kopiert wurde (keine überflüssigen Leerzeichen), und prüfen Sie das Kontoguthaben im Backend Ihres API-Anbieters. |
| Cursor Tab (Code-Vervollständigung) kann nicht verwendet werden | Die Inline-Code-Vervollständigung (Copilot) von Cursor verwendet ein unabhängiges Modell. | Die Drittanbieter-API kann nur die Funktionen Chat und Cmd+K übernehmen. Die Cursor Tab-Vervollständigungsfunktion ist normalerweise weiterhin auf offizielle Cursor-Dienste angewiesen oder erfordert spezielle Konfigurationen zur Unterstützung von FIM-Modellen. |
> 📝 Fazit: > Die Beherrschung der Konfiguration benutzerdefinierter APIs senkt nicht nur die Kosten für die Nutzung von KI-gestützter Programmierung drastisch, sondern ermöglicht es Ihnen auch, frei zwischen verschiedenen hochmodernen Großmodellen zu wechseln. Wenn Sie dieses Tutorial hilfreich fanden, teilen Sie es gerne mit Ihren Entwicklerfreunden!