HomeGids
Claude Code API voor Cursor: Aangepaste endpoint-instelling
Op zoek naar een Claude Code API-setup voor Cursor die niet afhankelijk is van één leverancier? Cursor kan communiceren met elk OpenAI-compatibel endpoint, en deze handleiding toont elke instelling die je nodig hebt.
Bijgewerkt

Wat je instelt
Cursor is een editor met ingebouwde AI-functies. Onder de modelinstellingen zit een veld waarmee je de OpenAI base URL kunt vervangen door je eigen, samen met een plek om je eigen sleutel in te voeren. Dit maakt het mogelijk om chatverzoeken te sturen naar elke service die het OpenAI chat-completions-formaat volgt. Deze service doet dat, dus Cursor kan het gebruiken als het model achter chat en inline-aanpassingen.
De waarden die je gaat invoeren zijn vast. Base URL: https://api.claudecodeapikey.com/v1. Modelnaam: uncensored. Sleutel: die van je account, verzonden als een Bearer-token. Aan de serverkant hoeft niets anders geconfigureerd te worden.
Wees duidelijk over wat dit is. Het model achter het endpoint is een open-weight model van een onafhankelijke aanbieder. Het is geen Claude-model en niet de officiële API van Anthropic of iemand anders. Als je hier kwam in de verwachting Claude zelf in Cursor te vinden, is dit iets anders, en de afsluitende secties leggen uit hoe je kunt beoordelen of het goed genoeg is voor je werk.
Voordat je Cursor opent
Regel deze eerst, zodat je niet halverwege stopt.
- Maak een account aan met Google of met e-mail en wachtwoord.
- Open de API-sleutelpagina en maak een sleutel aan. De sleutelgids laat zien waar elke knop zit.
- Claim het $0,50 proeftegoed als je wilt testen zonder te betalen. Het is één klik, vereist geen creditcard en duurt 7 dagen.
- Voer een snelle controle uit vanaf een terminal om te bevestigen dat de sleutel werkt voordat je de editor de schuld geeft.
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."}]}'
Een JSON-antwoord met een bericht betekent dat de sleutel en URL goed zijn. Een HTTP 401 betekent dat de sleutel verkeerd is of een losse spatie bevat. Los dit hier op, omdat de foutmeldingen van Cursor minder specifiek zijn dan die van curl.
Stap-voor-stap configuratie in Cursor
Menu-namen verschillen tussen Cursor-versies, dus behandel de labels hieronder als een richtlijn en zoek naar de beste match.
- Open de instellingen van Cursor en ga naar het modelgedeelte.
- Zoek het veld voor een OpenAI API-sleutel en plak je sleutel van deze service.
- Schakel de optie in om de OpenAI base URL te overschrijven, en voer
https://api.claudecodeapikey.com/v1in. Voeg de/v1aan het einde toe en laat eventuele paden zoals/chat/completionsweg. - Gebruik de optie om een aangepast model toe te voegen, en typ
uncensoredexact, in kleine letters. - Druk op de knop voor verifiëren of opslaan naast het sleutelveld. Cursor stuurt een klein testverzoek.
- Open een chatpaneel, selecteer
uncensoredin het modelkeuzemenu en stuur een korte prompt.
Als de verificatiestap faalt maar de curl-controle slaagde, controleer dan of je de URL in het base URL-veld hebt getypt en niet in het sleutelveld, en of je Cursor-versie de overschrijving niet heeft gereset na een update. De quickstart houdt de huidige stappen bij voor deze editor.
Een detail dat de moeite waard is om te weten: een enkele overschrijving geldt voor het OpenAI-providerslot. Als je ook echte OpenAI-modellen via dat slot gebruikt, worden zij nu ook naar dit endpoint gerouteerd. Veel mensen houden een apart Cursor-profiel aan of schakelen de overschrijving uit als ze terug willen schakelen.
Test met een echte code-prompt
Een begroeting bewijst weinig. Gebruik een prompt die context en instructies gebruikt. Selecteer een functie in je project, open chat en vraag om iets concreets, zoals het toevoegen van invoervalidatie en een unit test. Let op drie dingen.
- Streaming. Het antwoord moet token voor token verschijnen. Het endpoint streamt via SSE, dus een lange wachttijd gevolgd door een tekstblok suggereert dat een proxy of instelling het buffert.
- Contextgebruik. Voeg twee of drie bestanden toe en stel een vraag die ze allemaal vereist. Het contextvenster is 100.000 tokens, wat veel broncode beslaat, maar je editor beslist hoeveel hij daadwerkelijk verstuurt.
- Instructievolging. Vraag om een antwoord met alleen een diff of een strikte uitvoerindeling en kijk of het model zich daaraan houdt. Open-weight modellen verschillen hierin, en je wilt het leren kennen op dag één.
Houd een korte lijst bij van vijf echte taken uit je eigen repository, en voer ze opnieuw uit telkens als je een instelling zoals de temperatuur wijzigt. Oordelen op basis van je eigen code is beter dan elke algemene claim, inclusief die van ons.
Veelgemaakte fouten oplossen
401 of ongeldige sleutel
De sleutel is verkeerd, verlopen uit je klembord, of heeft spaties eromheen. Plak hem opnieuw. Zorg ervoor dat het Authorization-schema Bearer is, wat Cursor voor je doet wanneer je het OpenAI-sleutelveld gebruikt.
404 of model niet gevonden
Bijna altijd een base URL-probleem. Een ontbrekende /v1 of een extra /chat/completions breekt het pad. De modelnaam moet ook uncensored zijn, zonder hoofdletters of spaties.
429 met rate_limited of concurrency
Je hebt een limiet bereikt. De proefsleutel staat 2 gelijktijdige verzoeken en 60 per minuut toe, en een volledige sleutel staat 8 gelijktijdige en 300 per minuut toe. Een editor kan meerdere verzoeken tegelijk afvuren, bijvoorbeeld chat plus achtergrondaanpassingen, en streams houden hun slot vast tot ze eindigen. De foutcode vertelt je welke limiet: rate_limited is verzoeken per minuut, concurrency is te veel tegelijk. Een tijdelijke overbelasting retourneert ook 429 met Retry-After: 5, dus vijf seconden wachten en opnieuw proberen is correct.
Het antwoord wordt afgekapt
Het venster is 100.000 tokens, prompt plus voltooiing. Een zeer grote bijlage laat weinig ruimte over voor het antwoord. Stuur minder bestanden, of start een nieuwe chat.
Functies die niets doen
De API is alleen tekst en biedt geen embeddings. Als een Cursor-functie een embedding-model of invoer van afbeeldingen nodig heeft, werkt deze niet via dit endpoint.
Instellingen die de moeite waard zijn om aan te passen zodra het werkt
Na de eerste succesvolle chat maken een paar aanpassingen dagelijks gebruik soepeler.
Verlaag de temperatuur voor bewerkingstaken. Als je editor dit toelaat, geeft een waarde rond 0,2 stabielere code. Voor brainstormsessies verhoog je deze waarde. Houd vervolgens in de gaten hoeveel context je koppelt. Het contextvenster is ruim, maar elk gekoppeld bestand wordt als input gefactureerd, dus sluit ongerelateerde tabbladen en sluit build-mappen uit om de kosten laag te houden en de antwoorden gerichter te maken.
Als je de agent- of meerstappenmodi gebruikt, onthoud dan de ondersteuning voor function calling: het endpoint accepteert tools en tool_choice en streamt tool_calls. Of een bepaalde Cursor-functie ze gebruikt, hangt af van de versie, dus voer een kleine agent-taak uit en lees wat er gebeurt voordat je erop vertrouwt voor een grote wijziging. Kijk tenslotte af en toe naar de X-Balance-USD header in een terminaltest, zodat een laag saldo je niet verrast midden in je werk.
Dezelfde sleutel gebruiken in scripts
Een voordeel van een OpenAI-compatibel endpoint is dat de sleutel die je in Cursor hebt ingesteld ook in code werkt. Hier is een Node-voorbeeld, handig voor build-scripts of commit-berichten-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);
Sla de sleutel op in een omgevingsvariabele, niet in een bestand dat je commit. Elk antwoord bevat een X-Balance-USD header, dus een script kan je waarschuwen wanneer het tegoed op raakt.
Kosten en wanneer je beter bij je huidige setup kunt blijven
Editorgebruik is inputzwaar omdat elk verzoek bestandscontext meeneemt. Bij $0,15 per 1M input tokens en $0,50 per 1M output tokens kost een verzoek met 15.000 input tokens en 1.000 output tokens 0,015 x $0,15 + 0,001 x $0,50 = $0,00225 + $0,0005 = $0,00275. Een honderdtal daarvan kost $0,275. De prijzenpagina toont top-up-bedragen, beginnend bij $20, met bonussen vanaf $50.
Houd je bestaande setup aan als je afhankelijk bent van het model van een specifieke leverancier voor ingrijpende refactors, of als je workflow afhankelijk is van functies die een eenvoudige chat-endpoint niet kan bieden. Gebruik deze als je een lage prijs per token wilt, een eenvoudige API en minder contentafwijzingen bij legaal werk. Veel ontwikkelaars houden beide geconfigureerd en schakelen per taak.
Meer handleidingen
Vragen en antwoorden
Welke base URL voer ik in in Cursor?
Voer https://api.claudecodeapikey.com/v1 inclusief de /v1 in. Voeg /chat/completions niet toe aan het einde.
Welke modelnaam moet ik toevoegen?
Voeg een aangepast model toe met de naam uncensored, in kleine letters. Dit is het enige model ID dat de API aanbiedt.
Krijg ik hiermee Claude-modellen in Cursor?
Nee. Het endpoint biedt één open-weight model van een onafhankelijke provider. Het is geen officiële API van Anthropic of een andere leverancier.
Waarom krijg ik 429-fouten in de editor?
Je hebt de limiet per minuut overschreden of je hebt te veel gelijktijdige verzoeken. Een proefsleutel staat 2 gelijktijdige en 60 per minuut toe, een volledige sleutel 8 en 300.
Kan ik het uitproberen zonder te betalen?
Ja. Nieuwe gebruikers kunnen $0,50 aan proeftegoed claimen op de API-sleutelpagina. Er is geen creditcard nodig en het is 7 dagen geldig.
Je sleutel is nog maar één formulier verwijderd
Maak een account aan, kopieer de sleutel, pas de base URL aan. Dat is de hele setup.