StartseiteAnleitung
Claude-Code-API für Cursor: Eigener Endpunkt
Suchst du eine Claude Code API für die Cursor-Einrichtung, die nicht von einem Anbieter abhängig ist? Cursor kann mit jedem OpenAI-kompatiblen Endpunkt kommunizieren, und diese Anleitung zeigt jede Einstellung, die du benötigst.
Aktualisiert

Was du einrichtest
Cursor ist ein Editor mit integrierten KI-Funktionen. Unter seinen Modelleinstellungen befindet sich ein Feld, mit dem du die OpenAI-Basis-URL durch deine eigene ersetzen kannst, sowie ein Feld für deinen eigenen Schlüssel. Dies ermöglicht es, Chat-Anfragen an jeden Dienst zu senden, der das OpenAI-Chat-Vervollständigungsformat unterstützt. Dieser Dienst tut dies, sodass Cursor ihn als Modell für Chat und Inline-Bearbeitungen verwenden kann.
Die Werte, die du eingibst, sind fest. Basis-URL: https://api.claudecodeapikey.com/v1. Modellname: uncensored. Schlüssel: der aus deinem Konto, gesendet als Bearer-Token. Auf Serverseite muss nichts weiter konfiguriert werden.
Sei dir dessen bewusst, was dies ist. Das Modell hinter dem Endpunkt ist ein Open-Weight-Modell eines unabhängigen Anbieters. Es ist kein Claude-Modell und nicht die offizielle API von Anthropic oder sonst jemandem. Wenn du hierher gekommen bist, weil du Claude selbst in Cursor erwartest, ist dies etwas anderes, und die abschließenden Abschnitte erklären, wie du beurteilen kannst, ob es für deine Arbeit ausreicht.
Bevor du Cursor öffnest
Bereite das zuerst vor, damit du nicht mittendrin stoppst.
- Erstelle ein Konto mit Google oder mit E-Mail und Passwort.
- Öffne die API-Schlüssel-Seite und erstelle einen Schlüssel. Die Schlüssel-Anleitung zeigt, wo sich jede Schaltfläche befindet.
- Fordere das Testguthaben über $0,50 an, wenn du testen möchtest, ohne zu bezahlen. Es ist ein Klick, benötigt keine Karte und gilt 7 Tage.
- Führe eine schnelle Überprüfung über ein Terminal durch, um zu bestätigen, dass der Schlüssel funktioniert, bevor du den Editor beschuldigst.
curl https://api.claudecodeapikey.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"Say ready."}]}'
Eine JSON-Antwort mit einer Nachricht bedeutet, dass Schlüssel und URL korrekt sind. Ein HTTP 401 bedeutet, dass der Schlüssel falsch ist oder ein Leerzeichen enthält. Behebe das hier, da die Fehlermeldungen von Cursor weniger spezifisch sind als die von curl.
Schritt-für-Schritt-Konfiguration in Cursor
Menünamen ändern sich zwischen Cursor-Versionen, also betrachte die folgenden Bezeichnungen als Richtlinie und suche nach der besten Übereinstimmung.
- Öffne die Einstellungen von Cursor und gehe zum Abschnitt Modelle.
- Finde das Feld für einen OpenAI-API-Schlüssel und füge deinen Schlüssel von diesem Dienst ein.
- Aktiviere die Option zum Überschreiben der OpenAI-Basis-URL und gib
https://api.claudecodeapikey.com/v1ein. Füge am Ende den Pfad/v1hinzu und entferne alle nachgestellten Pfade wie/chat/completions. - Verwende die Option, ein benutzerdefiniertes Modell hinzuzufügen, und gib genau
uncensoredein, kleingeschrieben. - Drücke die Schaltfläche Überprüfen oder Speichern neben dem Schlüsselfeld. Cursor sendet eine kleine Testanfrage.
- Öffne ein Chat-Fenster, wähle
uncensoredim Modell-Dropdown und sende einen kurzen Prompt.
Wenn der Verifikationsschritt fehlschlägt, der curl-Check aber bestanden wurde, prüfe, ob du die URL in das Base-URL-Feld und nicht in das Schlüssel-Feld eingegeben hast und ob deine Cursor-Version die Überschreibung nach einem Update nicht zurückgesetzt hat. Die Schnellstartanleitung enthält die aktuellen Schritte für diesen Editor.
Ein Detail ist wichtig zu wissen: Ein einzelnes Überschreiben gilt für den OpenAI-Anbieter-Slot. Wenn du über diesen Slot auch echte OpenAI-Modelle verwendest, werden diese jetzt ebenfalls zu diesem Endpunkt geleitet. Viele Nutzer behalten ein separates Cursor-Profil bei oder schalten das Überschreiben aus, wenn sie zurückwechseln möchten.
Test mit einem echten Coding-Prompt
Ein Gruß beweist wenig. Verwende einen Prompt, der Kontext und Anweisungen auslastet. Wähle eine Funktion in deinem Projekt, öffne den Chat und bitte um etwas Konkretes, z. B. das Hinzufügen einer Eingabevalidierung und eines Unit-Tests. Achte auf drei Dinge.
- Streaming. Die Antwort sollte Token für Token erscheinen. Der Endpunkt streamt über SSE, sodass eine lange Wartezeit gefolgt von einem Textblock darauf hindeutet, dass ein Proxy oder eine Einstellung puffert.
- Kontextnutzung. Füge zwei oder drei Dateien an und stelle eine Frage, die alle benötigt. Das Kontextfenster umfasst 100.000 Token, was viel Quellcode fasst, aber dein Editor entscheidet, wie viel er tatsächlich sendet.
- Anweisungsbefolgung. Bitte um eine reine Diff-Antwort oder ein strenges Ausgabeformat und prüfe, ob das Modell daran festhält. Open-Weight-Modelle unterscheiden sich hier, und du solltest es am ersten Tag kennenlernen.
Halte eine kurze Liste mit fünf echten Aufgaben aus deinem eigenen Repository bereit und führe sie erneut aus, wenn du eine Einstellung wie die Temperatur änderst. Die Beurteilung anhand deines eigenen Codes ist besser als jede allgemeine Aussage, einschließlich unserer.
Häufige Fehler beheben
401 oder ungültiger Schlüssel
Der Schlüssel ist falsch, in deiner Zwischenablage abgelaufen oder enthält Leerzeichen. Füge ihn erneut ein. Stelle sicher, dass das Autorisierungsschema Bearer ist, was Cursor für dich erledigt, wenn du das OpenAI-Schlüsselfeld verwendest.
404 oder Modell nicht gefunden
Fast immer ein Basis-URL-Problem. Ein fehlendes /v1 oder ein zusätzliches /chat/completions bricht den Pfad. Der Modellname muss ebenfalls uncensored sein, ohne Großbuchstaben oder Leerzeichen.
429 mit rate_limited oder concurrency
Du hast ein Limit erreicht. Der Test-Schlüssel erlaubt 2 parallele Anfragen und 60 pro Minute, ein regulärer Schlüssel 8 parallele und 300 pro Minute. Ein Editor kann mehrere Anfragen gleichzeitig senden, zum Beispiel Chat und Hintergrund-Bearbeitungen, und Streams belegen ihren Slot bis zum Ende. Der Fehlercode zeigt, welches Limit gilt: rate_limited ist das Limit pro Minute, concurrency ist zu viele gleichzeitig. Bei einer temporären Überlastung wird ebenfalls 429 mit Retry-After: 5 zurückgegeben, also ist fünf Sekunden warten und erneut versuchen korrekt.
Die Antwort bricht ab
Das Kontextfenster umfasst 100.000 Token, Prompt plus Vervollständigung. Ein sehr großer Anhang lässt wenig Platz für die Antwort. Sende weniger Dateien oder starte einen neuen Chat.
Funktionen, die nichts tun
Die API ist nur Text und bietet keine Embeddings. Wenn eine Cursor-Funktion ein Embedding-Modell oder eine Bild-Eingabe benötigt, funktioniert sie nicht über diesen Endpunkt.
Einstellungen, die sich lohnen, wenn es funktioniert
Nach dem ersten erfolgreichen Chat machen einige Anpassungen die tägliche Nutzung reibungsloser.
Senke die Temperatur für Bearbeitungsaufgaben. Wenn dein Editor sie verfügbar hat, sorgt ein Wert von etwa 0,2 für stabileren Code. Für Brainstorming erhöhe ihn. Achte außerdem darauf, wie viel Kontext du anhängst. Das Fenster ist großzügig, aber jede angehängte Datei wird als Input abgerechnet, daher halten das Schließen nicht relevanter Tabs und das Ausschließen von Build-Ordnern die Kosten niedrig und die Antworten fokussierter.
Wenn du die Agenten- oder Multi-Step-Modi nutzt, beachte die Unterstützung für Tool-Calls: Der Endpunkt akzeptiert tools und tool_choice und streamt tool_calls. Ob eine bestimmte Cursor-Funktion diese nutzt, hängt von der Version ab, also führe eine kleine Agenten-Aufgabe durch und lies nach, was passiert, bevor du ihr eine große Änderung vertraust. Schau dir außerdem ab und zu den X-Balance-USD-Header in einem Terminal-Test an, damit ein niedriger Kontostand dich mitten in der Arbeit nicht überrascht.
Den gleichen Schlüssel in Skripten verwenden
Ein Vorteil eines OpenAI-kompatiblen Endpunkts ist, dass der in Cursor eingestellte Schlüssel auch in Code funktioniert. Hier ist ein Node-Beispiel, praktisch für Build-Skripte oder Commit-Nachrichten-Tools.
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.claudecodeapikey.com/v1",
apiKey: process.env.API_KEY,
});
const out = await client.chat.completions.create({
model: "uncensored",
messages: [
{ role: "user", content: "Write a conventional commit message for: fixed null check in parser" },
],
});
console.log(out.choices[0].message.content);
Speichere den Schlüssel in einer Umgebungsvariable, nicht in einer Datei, die du committest. Jede Antwort enthält einen X-Balance-USD-Header, sodass ein Skript dich warnen kann, wenn das Guthaben niedrig wird.
Kosten und wann du bleiben solltest
Die Editor-Nutzung ist input-lastig, da jede Anfrage Datei-Kontext enthält. Bei $0,15 pro 1 Mio. Input-Token und $0,50 pro 1 Mio. Output-Token kostet eine Anfrage mit 15.000 Input-Token und 1.000 Output-Token 0,015 x $0,15 + 0,001 x $0,50 = $0,00225 + $0,0005 = $0,00275. Hundert davon kosten $0,275. Die Preisseite zeigt Aufladebeträge, beginnend bei $20, mit Boni ab $50.
Behalte deine bestehende Einrichtung, wenn du auf ein Modell eines bestimmten Anbieters für komplexe Refactorings angewiesen bist oder dein Workflow auf Funktionen setzt, die ein einfacher Chat-Endpunkt nicht bietet. Nutze diesen, wenn du einen niedrigen Preis pro Token, eine einfache API und weniger Inhaltsabweisungen bei rechtmäßigen Aufgaben möchtest. Viele Entwickler haben beide konfiguriert und wechseln je nach Aufgabe.
Weitere Anleitungen
Fragen und Antworten
Welche Base URL gebe ich in Cursor ein?
Gib https://api.claudecodeapikey.com/v1 einschließlich /v1 ein. Füge am Ende kein /chat/completions hinzu.
Welchen Modellnamen soll ich hinzufügen?
Füge ein benutzerdefiniertes Modell mit dem Namen uncensored in Kleinbuchstaben hinzu. Es ist die einzige Modell-ID, die die API bereitstellt.
Bekomme ich damit Claude-Modelle in Cursor?
Nein. Der Endpunkt bietet ein Open-Weight-Modell eines unabhängigen Anbieters an. Es handelt sich nicht um eine offizielle API von Anthropic oder einem anderen Anbieter.
Warum erhalte ich 429-Fehler im Editor?
Entweder hast du das Pro-Minuten-Limit überschritten oder du sendest zu viele Anfragen gleichzeitig. Ein Test-Schlüssel erlaubt 2 parallele und 60 pro Minute, ein Standard-Schlüssel 8 und 300.
Kann ich es ohne Bezahlung testen?
Ja. Neue Nutzer können $0,50 Testguthaben auf der API-Schlüssel-Seite beanspruchen. Es benötigt keine Karte und ist 7 Tage gültig.
Dein Schlüssel ist nur ein Formular entfernt
Erstelle ein Konto, kopiere den Schlüssel, ändere die Basis-URL. Das ist die gesamte Einrichtung.