Freunde einladen und kostenlose Tokens verdienen!Mehr erfahren

🚀 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:

  1. Cursor ist installiert: Stellen Sie sicher, dass Sie die neueste Version von Cursor installiert haben.
  2. API Key (Schlüssel): z. B. sk-xxxxxxxxxxxxxxxxxxxxxxxx.
  3. Base URL (Schnittstellenadresse): Ihre benutzerdefinierte API-Proxy-Adresse.
    • Hinweis: Muss normalerweise mit /v1 enden, z. B. https://api.codingplanx.ai/v1.
  4. Modellname (Model Name): Der Standardname des Modells, das Sie verwenden möchten (z. B. gpt-4o, claude-3-5-sonnet, deepseek-chat usw.).

⚙️ Detaillierte Konfigurationsschritte

Schritt 1: Cursor-Einstellungen öffnen

  1. Starten Sie den Cursor-Editor.
  2. 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 + ,

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

  1. Scrollen Sie auf der Seite „Models“ nach unten und suchen Sie den Bereich OpenAI API Key.
  2. Fügen Sie Ihren benutzerdefinierten API Key in das Eingabefeld ein.
  3. 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).
  4. ⚠️ Wichtiger Hinweis: Stellen Sie sicher, dass die Schalter für den offiziellen Cursor Tab von 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:

  1. Suchen Sie unter dem Eingabefeld für den OpenAI API Key die Option Override OpenAI Base URL (OpenAI-Basis-URL überschreiben).
  2. 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
  3. 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:

  1. Scrollen Sie ganz nach oben auf der Models-Seite und suchen Sie den Bereich Model Names.
  2. Klicken Sie auf + Add Model (Modell hinzufügen).
  3. Geben Sie den Namen Ihres Modells genau ein (z. B. deepseek-chat) und drücken Sie zur Bestätigung die Eingabetaste.
  4. 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:

  1. Kehren Sie zur Code-Bearbeitungsoberfläche zurück.
  2. Drücken Sie Strg + L (Windows) oder Cmd + L (macOS), um das Chat-Fenster auf der rechten Seite aufzurufen.
  3. 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-4o oder deepseek-chat).
  4. Senden Sie eine einfache Begrüßung, z. B.: "Wer bist du? Bitte nenne mir deine Modellversion."
  5. Wenn die KI normal und schnell antworten kann, herzlichen Glückwunsch, die Konfiguration war erfolgreich! 🎉

❓ Fehlerbehebung / Häufig gestellte Fragen (FAQ)

FehlersymptomMögliche UrsacheLösung
Verbindungs-Timeout / 404 Not FoundFormat 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 werdenDie 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!