Fout 1: alles in één keer willen bouwen
De verleiding is groot om in één opdracht je hele app te beschrijven: inloggen, een dashboard, betalingen, e-mails en een beheeromgeving. De AI gaat dan aan de slag, maar het resultaat is vaak half af en lastig te controleren. Gaat er iets mis, dan weet je niet waar.
Bouw liever in kleine stappen. Begin met de kern van je idee, bijvoorbeeld één pagina die laat zien wat je app doet. Werkt dat, voeg dan het volgende onderdeel toe. Zo heb je steeds een werkende versie en zie je meteen waar een probleem ontstaat.
Fout 2: te grote of vage opdrachten geven
Een opdracht als 'maak het mooier' of 'voeg een klantensysteem toe' laat de AI veel raden. Dan krijg je iets, maar zelden wat je in je hoofd had. Hoe concreter je bent, hoe beter het resultaat.
Beschrijf wat je wilt zien, voor wie het is en wat er moet gebeuren. Bijvoorbeeld: 'Voeg op de homepage een formulier toe met naam, e-mail en bericht. Na verzenden zie je een bedankmelding.' Twijfel je hoe je iets moet formuleren, vraag de AI dan eerst om een plan voordat hij gaat bouwen.
Fout 3 tot en met 6: de klassiekers
- fout 3
Niet testen na elke stap
De AI zegt dat iets werkt, maar je hebt het niet zelf geprobeerd. Open je app na elke wijziging en klik alles even door. Fouten vind je het makkelijkst direct nadat ze ontstaan.
- fout 4
Geen versiebeheer gebruiken
Zonder versiebeheer kun je niet terug naar een versie die wel werkte. Bewaar je project met Git en GitHub, en sla een versie op elke keer dat iets goed werkt.
- fout 5
Geheime sleutels in je code zetten
Wachtwoorden en API-sleutels horen niet in je code, zeker niet als die op GitHub staat. Bewaar ze in een apart bestand dat niet wordt gedeeld, zoals een .env-bestand.
- fout 6
Toestemming blind goedkeuren
Claude Code vraagt toestemming voordat hij iets wijzigt of uitvoert. Lees kort wat hij van plan is. Snap je het niet, vraag dan om uitleg voordat je ja zegt.
Fout 7: foutmeldingen negeren of zelf gaan gokken
Een rode foutmelding ziet er eng uit, maar is eigenlijk nuttige informatie. Beginners proberen vaak zelf iets aan te passen of beginnen opnieuw. Dat kost tijd en maakt het soms erger.
Kopieer de volledige foutmelding en geef die aan de AI, samen met wat je deed toen het misging. Claude Code kan in de meeste gevallen zelf de oorzaak vinden en oplossen. Vraag er ook bij wat er mis was, dan leer je er meteen iets van.
Fout 8: direct online zetten zonder lokaal te testen
Het is verleidelijk om je app zo snel mogelijk live te zetten. Maar als je test op de echte website, zien bezoekers je fouten ook. Test daarom eerst op je eigen computer. Met npm run dev start je de app lokaal en bekijk je hem op localhost, terwijl alleen jij hem ziet. Gebruik daarbij een aparte testdatabase, zodat je proefgegevens niet tussen echte gegevens belanden.
Pas als alles lokaal werkt, zet je je project online. Doe dat via GitHub, zodat je altijd een opgeslagen versie hebt waar je naar terug kunt.
Let bij het online zetten ook op je geheime sleutels. Op je eigen computer staan ze in een apart bestand, maar je hostingpartij heeft ze ook nodig. Meestal stel je ze daar in via een instellingenscherm. Vraag Claude Code gerust hoe dat werkt bij de partij die jij gebruikt.
Een werkwijze die de meeste fouten voorkomt
- 1
Maak een plan
Schrijf in een paar zinnen op wat je wilt bouwen en knip het op in kleine onderdelen.
- 2
Geef één concrete opdracht
Vraag de AI om één onderdeel te bouwen en beschrijf precies wat je verwacht.
- 3
Test het resultaat
Open je app lokaal en probeer het uit, ook met rare invoer of een leeg formulier.
- 4
Sla een versie op
Werkt het? Bewaar een versie met Git. Zo kun je altijd terug.
- 5
Herhaal
Ga door naar het volgende onderdeel. Kleine stappen zijn op de lange termijn het snelst.
Veelgestelde vragen
Wat is de grootste fout bij vibe coding?
Te veel tegelijk willen bouwen in één opdracht. Bouw in kleine stappen en test na elke stap, dan voorkom je de meeste problemen.
Hoe voorkom ik dat de AI mijn werkende code kapotmaakt?
Gebruik versiebeheer met Git en sla een versie op zodra iets werkt. Gaat er daarna iets mis, dan ga je eenvoudig terug naar die versie.
Waar bewaar ik API-sleutels en wachtwoorden?
Niet in je code, maar in een apart bestand zoals een .env-bestand dat je niet deelt of op GitHub zet. Vraag Claude Code om dit voor je in te stellen.
Wat doe ik als ik een foutmelding krijg?
Kopieer de hele melding en geef die aan de AI, met wat je aan het doen was. Vraag ook om uitleg, zodat je begrijpt wat er misging.
Moet ik de code zelf controleren?
Je hoeft niet elke regel te lezen, maar je moet wel testen of je app doet wat je verwacht. Bij twijfel vraag je de AI om uit te leggen wat een stuk code doet.
Hoe weet ik of mijn app veilig genoeg is?
Vraag Claude Code om je project na te lopen op veelvoorkomende beveiligingsproblemen, zoals zichtbare sleutels of formulieren zonder controle. Gaat je app met gevoelige gegevens werken, laat dan ook iemand met ervaring meekijken.