Cursor AI gebruiken: praktische handleiding met voorbeeldenLeestijd: maximaal 11 minuten

Cursor AI gebruiken wordt overzichtelijker wanneer je niet begint met “bouw alles”, maar met één duidelijke taak. In deze handleiding maak je een eenvoudige materiaalcalculator. Daarna pas je een bestaande functie aan, onderzoek je een fout en controleer je wat er werkelijk veranderd is.

Je hoeft voor deze oefening niet zelf alle code te schrijven. Wel blijf jij bepalen wat de uitkomst moet zijn. Dat is de rode draad: eerst begrijpen, dan wijzigen en daarna controleren.

Cursor AI gebruiken: wat heb je nodig?

Voor deze oefening heb je Cursor, een account, een browser en een lege projectmap nodig. Download de toepassing via de officiële Cursor-website, installeer haar en meld je aan. Open vervolgens een map voor je oefenproject. De officiële startgids adviseert eveneens om met een kleine taak te beginnen.

Noem de map bijvoorbeeld werkplaats-calculator. Open alleen deze map, niet meteen je volledige documentenverzameling.

Wil je eerst begrijpen wat voor programma je installeert? Lees dan wat Cursor AI is en hoe de editor werkt.

Ons voorbeeld is bewust klein. Een fictieve coördinator van een buurtwerkplaats wil berekenen hoeveel materiaal een workshop vraagt. Nu rekent zij aantallen steeds opnieuw uit. Ze wil een hulpmiddel dat deelnemers en materiaal per persoon vermenigvuldigt.

We bouwen geen administratiepakket. Er komen geen accounts, betalingen of persoonsgegevens in.

Stap 1: bepaal eerst wat een goede uitkomst is

Voordat je Cursor opent, schrijf je drie afspraken op:

• De gebruiker vult een aantal deelnemers en een hoeveelheid materiaal per persoon in.
• De calculator toont de totale hoeveelheid.
• Lege, negatieve en ongeldige invoer leveren een duidelijke melding op.

Voor deze oefening zijn deelnemers hele aantallen vanaf één. Materiaal per persoon mag een positief getal met decimalen zijn.

Dat onderscheid lijkt klein. Toch bepaalt het of “2,5 deelnemers” wordt geaccepteerd. Een AI kan zo’n regel niet uit jouw bedoeling afleiden als je haar nergens vastlegt.

Onze visie bij WegwijsAI: een goede eerste opdracht begint met een verwachte uitkomst, niet met een gewenste uitstraling.

Stap 2: laat Cursor een klein project maken

Open het Agent-paneel en geef deze opdracht:

Maak in deze lege projectmap een Nederlandstalige materiaalcalculator.

Gebruik alleen drie bestanden: index.html, style.css en script.js. Gebruik geen externe pakketten, koppelingen of accounts.

De gebruiker vult het aantal deelnemers en de hoeveelheid materiaal per persoon in. De calculator vermenigvuldigt beide waarden.

Deelnemers moeten een heel getal vanaf één zijn. Materiaal per persoon moet groter dan nul zijn. Accepteer bij materiaal zowel een komma als een punt als decimaalteken.

Toon bij ongeldige invoer een duidelijke Nederlandse melding. Rond het getoonde resultaat af op maximaal twee decimalen.

Maak de pagina bruikbaar op computer en telefoon. Geef invoervelden zichtbare labels.

Leg na afloop uit welke bestanden je hebt gemaakt en hoe ik de pagina lokaal open. Installeer niets en publiceer niets.

Agent kan bestanden onderzoeken, aanmaken en aanpassen. Bekijk daarom wat er gebeurt terwijl Cursor werkt, in plaats van alleen de eindmelding te lezen.

Sla de bestanden op. Open daarna index.html vanuit je bestandsbeheer in je browser. Deze oefening vraagt bewust geen installatie van aanvullende software.

Voer twaalf deelnemers en drie eenheden per persoon in. De verwachte uitkomst is 36. Dat is je eerste controle, niet meteen het bewijs dat alles werkt.

Stap 3: laat Cursor bestaande code uitleggen

Nu staat er een project dat je nog niet zelf kent. Laat Cursor eerst de samenhang beschrijven:

Onderzoek dit project zonder bestanden te wijzigen. Welk bestand bevat de invoervelden, waar wordt de berekening uitgevoerd en waar wordt ongeldige invoer gecontroleerd? Noem de concrete functies of onderdelen. Benoem ook wat je niet zeker weet.

Cursor kan de projectmap doorzoeken en relevante bestanden lezen. Dat helpt bij oriëntatie, maar betekent niet dat iedere afhankelijkheid automatisch goed wordt geïnterpreteerd.

Controleer of de genoemde bestanden bestaan. Open ze en zoek de aangewezen onderdelen op.

Tegenintuïtief inzicht: je eerste nuttige opdracht kan juist géén code opleveren. Een uitleg kan voorkomen dat je later het verkeerde onderdeel laat aanpassen.

Bij een bestaand werkproject voeg je nog een vraag toe:

Welke andere onderdelen gebruiken deze berekening? Welke bestaande controles moeten na een wijziging opnieuw worden uitgevoerd?

Zo maak je gevolgen zichtbaar voordat je iets verandert.

Stap 4: kies tussen vragen, plannen en bewerken

Niet iedere taak vraagt dezelfde aanpak.

Inline Edit is bedoeld voor gerichte aanpassingen aan geselecteerde code. Plan Mode onderzoekt de projectcontext en maakt een voorstel voordat de uitvoering begint.

Voor onze calculator voegen we een instelbaar reservepercentage toe. Gebruik eerst Plan Mode:

Maak een plan om een reservepercentage toe te voegen. Standaard is dit 10%. De gebruiker mag een percentage van 0 tot en met 100 invoeren. Toon de basishoeveelheid en de hoeveelheid inclusief reserve afzonderlijk. Benoem welke bestanden veranderen. Schrijf nog geen code.

Controleer het voorstel. Worden er opeens accounts of extra pakketten voorgesteld? Dan past het plan niet bij deze opdracht.

Stap 5: schrijf controleerbare vervolgprompts

Vergelijk deze drie opdrachten voor dezelfde uitbreiding.

Te vaag

Maak de calculator beter.

Je noemt geen probleem en geen grens. Daardoor moet Cursor zelf invullen wat “beter” betekent.

Duidelijker

Voeg een reservepercentage toe en toon het totaal inclusief reserve.

De functie is duidelijker, maar de toegestane invoer en bestaande werking ontbreken nog.

Controleerbaar

Voer het besproken plan uit. Voeg een reservepercentage van 0 tot en met 100 toe, standaard 10%. Behoud de bestaande invoercontrole. Toon basis en totaal afzonderlijk. Bij 12 deelnemers, 3 eenheden en 10% reserve verwacht ik 36 en 39,6. Voeg geen pakketten toe en verander geen andere functies.

De derde prompt is niet beter omdat hij langer is. Hij bevat een toetsbare afspraak.

Cursor adviseert voor grotere taken eveneens een afgebakend plan en voor wijzigingen een controle van het resultaat.

Wil je Cursor AI gebruiken zonder eindeloos bij te sturen? Beschrijf dan niet alleen wat erbij moet, maar ook wat behouden moet blijven.

Stap 6: onderzoek een fout voordat je laat repareren

Stel dat de invoer 2,5 niet als tweeënhalf wordt verwerkt. Dat is een oefenscenario, geen hier waargenomen Cursor-fout.

Stuur niet alleen “het werkt niet”. Geef de handelingen en verwachting:

Ik vul 12 deelnemers en 2,5 eenheden per persoon in. Ik verwacht een basishoeveelheid van 30. Onderzoek hoe de invoer wordt omgezet naar een getal. Leg de oorzaak uit voordat je iets wijzigt. Controleer ook invoer met een punt.

Waarom helpt dit? Je geeft Cursor een reproduceerbaar verschil tussen bedoeling en gedrag.

Vraag na de diagnose om een kleine reparatie:

Herstel alleen de verwerking van het decimaalteken. Behoud de controles voor lege invoer, negatieve waarden en hele deelnemersaantallen. Controleer daarna komma- en puntinvoer opnieuw.

Laat vervolgens aangeven welke controles werkelijk zijn uitgevoerd en welke alleen worden voorgesteld. “Tests toegevoegd” betekent niet automatisch “tests uitgevoerd”.

Ook geslaagde tests kunnen onvolledig zijn of verkeerd gedrag controleren. Daarom blijft eigen beoordeling nodig.

Stap 7: controleer wijzigingen en bewaar herstelpunten

Een veelvoorkomend misverstand: Cursor verandert niets totdat je alles accepteert. Agent kan bestanden direct opslaan. Bij automatisch herladen kunnen wijzigingen bovendien al worden uitgevoerd voordat je ze hebt nagekeken.

Werk daarom met Git: versiebeheer waarmee je veranderingen vastlegt en terugvindt.

De belangrijkste begrippen:

• Branch: een aparte werklijn voor een wijziging.
• Diff: het verschil tussen de oude en nieuwe code.
• Commit: een vastgelegd controlepunt.

Leg vóór een uitbreiding een werkende versie vast. Maak voor die uitbreiding een aparte branch. Controleer daarna in Source Control welke bestanden veranderd zijn.

Cursor adviseert kleine, logisch samenhangende wijzigingen en commits, zodat het nakijkwerk overzichtelijk blijft.

Vraag bij een onverwacht groot verschil:

Waarom zijn deze bestanden aangepast? Welke wijzigingen zijn noodzakelijk voor het reservepercentage en welke staan daar los van?

Laat geen verwijderingen of herstelacties uitvoeren waarvan je de gevolgen niet begrijpt. Bewaar je oorspronkelijke werk voordat je experimenteert.

Stap 8: test meer dan de normale invoer

Gebruik deze vaste controlelijst. De uitkomsten zijn verwachtingen, geen gemeten resultaten.

Controleer ook of je met de Tab-toets bij alle velden en de knop komt. Zijn labels leesbaar? Blijft de pagina op een smal scherm bruikbaar?

Tweede tegenintuïtieve inzicht: minder gewijzigde code kan meer waarde opleveren. Een kleine reparatie die je begrijpt, is soms nuttiger dan een complete herbouw die veel nakijkwerk vraagt.

Vraag Cursor daarnaast te zoeken naar dubbele berekeningen en onnodige extra onderdelen. AI-code kan werken en toch onderhoudsproblemen of ontbrekende randgevallen bevatten.

Voor een bredere beoordeling verwijzen we naar onze Cursor AI-review. Deze handleiding blijft bij de uitvoering.

Stap 9: leg terugkerende afspraken vast

Moet je steeds herhalen dat Cursor geen pakketten mag toevoegen? Maak er een projectregel van.

Cursor ondersteunt onder meer projectregels in .cursor/rules en een eenvoudiger instructiebestand AGENTS.md. Projectregels kunnen afhankelijk van hun instelling altijd of alleen in bepaalde situaties worden toegepast.

Voor onze oefening passen deze afspraken:

Houd dit project bij HTML, CSS en JavaScript zonder externe pakketten. Gebruik Nederlandse schermteksten. Behoud zichtbare veldlabels. Verander alleen onderdelen die bij de opdracht horen. Vermeld welke controles zijn uitgevoerd en welke niet.

Laat Cursor de regel op de juiste plek aanmaken en controleer daarna of zij bij volgende opdrachten wordt gevolgd.

Regels zijn instructies, geen garantie. De officiële documentatie adviseert ze gericht en praktisch te houden.

Stap 10: rond af zonder onnodige risico’s

Onze calculator heeft geen klantgegevens nodig. Houd dat zo tijdens het oefenen.

Controleer vóór werk aan bedrijfsprojecten de privacyinstellingen en de afspraken binnen je organisatie. Privacy Mode beperkt het gebruik van gegevens voor training, maar maakt Cursor niet tot een volledig lokale, offline toepassing. Verzoeken kunnen nog steeds via Cursor en modelaanbieders worden verwerkt.

Laat de standaardgoedkeuring voor gevoelige acties en terminalcommando’s niet zomaar los. Cursor noemt deze beschermingen zelf geen onfeilbare beveiligingsgrens.

Onze eindcheck:

• De afgesproken berekeningen kloppen.
• Ongeldige invoer wordt tegengehouden.
• Oude functies werken nog.
• De gewijzigde bestanden zijn bekeken.
• Een herstelpunt is vastgelegd.
• Niet-uitgevoerde controles zijn duidelijk benoemd.

Twijfel je of een code-editor past bij jouw taak? Gebruik dan onze keuzehulp om AI-tools te vergelijken.

Begin klein, maar controleer serieus

Cursor AI gebruiken draait niet om zo veel mogelijk code laten verschijnen. Het draait om een wijziging die je kunt uitleggen, testen en zo nodig terugdraaien.

Kun je dat met deze calculator? Voeg dan pas een volgende functie toe. Zo groeit niet alleen je project, maar ook je vermogen om het resultaat te beoordelen.

Dit artikel is geschreven en gecontroleerd door Maarten en Sanne van WegwijsAI.

FAQ

Kan ik Cursor AI gebruiken zonder programmeerkennis?

Je kunt beginnen met een klein oefenproject en opdrachten in gewone taal geven. Je hoeft niet iedere regel zelf te schrijven. Wel moet je kunnen controleren of de uitkomst klopt. De officiële startgids begint daarom met een kleine wijziging, uitleg van het project en controle van het resultaat.

Past Cursor mijn bestanden direct aan?

Agent kan bestanden in je werkruimte direct wijzigen en opslaan. Je hoeft niet iedere bestandswijziging vooraf goed te keuren. Gebruik daarom versiebeheer, controleer de verschillen en behoud de standaardbescherming voor gevoelige acties.

Wat is het verschil tussen Plan Mode en Inline Edit?

Plan Mode onderzoekt eerst de aanpak voor een wijziging en maakt een voorstel voordat de uitvoering begint. Inline Edit is bedoeld om een geselecteerd stukje code gericht te veranderen. Kies dus op basis van de omvang en onzekerheid van je taak.