Claude Code: zo bouw je een app met AI, en hier gaat het mis
Wij bouwen burgmedia.eu met Claude Code, ook de tools en dit artikel. Wat het is, hoe je ermee begint en waar je moet opletten.
Wat Claude Code is
Claude Code is de programmeerassistent van Anthropic. Hij werkt in een map op je eigen computer: hij leest de bestanden, maakt nieuwe aan en past ze aan als je daarom vraagt.
Dat is het verschil met een chat zoals ChatGPT of claude.ai. Daar krijg je code in het gesprek en moet je hem zelf kopiëren, opslaan en bij elke wijziging opnieuw plakken. Bij één bestand gaat dat. Bij een app met tien bestanden raak je het overzicht kwijt.
Je gebruikt hem als extensie in VS Code, de gratis editor van Microsoft. Voor elke wijziging laat hij in rood en groen zien wat er weggaat en wat erbij komt, en vraagt hij of het mag. Hij zit bij het Pro-abonnement van Claude, dat in oktober 2026 ongeveer 20 euro per maand kost.
Hoe wij ermee werken
Het zware werk in de tools op burgmedia.eu doet open source, zoals FFmpeg voor video en pdf-lib voor PDF's. De rest schreven we met Claude Code: de schermen, de knoppen, de foutmeldingen en de Engelse versies.
Het belangrijkste bestand in onze projectmap is CLAUDE.md. Claude Code leest het aan het begin van elk gesprek. Er staat in hoe de site in elkaar zit, waar wat staat en welke regels gelden. Twee regels eruit:
Een agent zet dus nooit iets live en verandert nooit een prijs.
Wijzig je `main.css` of `main.js`, hoog dan de `?v=` in alle links op.
Werk dat vaak terugkomt, leggen we vast als skill: een vaste werkwijze in een eigen map, met de stappen en controles erbij. We hebben er zes, onder andere voor een nieuwe tool, een case en een blogartikel. Dit artikel is met die laatste gemaakt, en een script controleerde daarna of de Engelse vertaling compleet was.
Je eerste app in een uur
- Neem Claude Pro en zet in de privacy-instellingen uit dat je gesprekken gebruikt worden om Claude te trainen.
- Installeer VS Code en daarin de extensie Claude Code. Kijk of de maker Anthropic is, want er staan namaakversies tussen.
- Maak een lege map voor je project en open die in VS Code.
- Vraag iets kleins: "Maak een pagina waarop ik een bedrag invul en die laat zien hoeveel btw erin zit bij 21 procent."
Binnen een minuut staat er een bestand in je map dat je in je browser opent. Daarna vraag je per bericht om één verandering, en test je elke keer voordat je de volgende vraagt.
Bij alles wat groter is, druk je eerst op Shift en Tab. Dan staat Claude Code in de planstand: hij leest en schrijft een plan, maar verandert niets. Een plan aanpassen kost een zin, een gebouwde app aanpassen een middag.
Waar het misgaat
De AI kiest zelf waarmee hij bouwt. Zeg je niets, dan krijg je wat hij het vaakst heeft gezien. Draait je website op gewone hosting met PHP, dan heb je niets aan een app in Node.js. Eén zin in CLAUDE.md over waar het moet draaien voorkomt dat.
Lange gesprekken raken in de war. Na tientallen berichten vergeet de AI soms een afspraak van het begin, of draait hij een eerdere verbetering terug. Laat dan het belangrijkste in CLAUDE.md zetten, typ /clear en begin opnieuw. Je bestanden blijven staan.
Alles in je map gaat naar Anthropic. Wat Claude Code leest, wordt naar hun servers gestuurd. Zet dus geen klantbestanden of wachtwoorden in je projectmap en test met verzonnen gegevens.
Het werkt, dus het klopt. Een rekenhulp die er goed uitziet, kan verkeerd rekenen. Vraag de AI in gewone taal uit te leggen hoe de berekening werkt. Klopt die uitleg niet met wat je bedoelde, dan klopt de app ook niet.
Wanneer je het beter laat bouwen
Een rekenhulp voor je site, een urenlijst voor je eigen team of een voorraadlijst voor de werkplaats kun je zo zelf maken. Gaat het om betalingen, inloggen voor klanten of persoonsgegevens, dan is een fout duur. Dan laat je het bouwen of in elk geval nakijken door iemand die de code kan lezen.
Ook bij ons zet de AI niets live. Hij schrijft en controleert, en een mens drukt op de knop.
Wil je het stap voor stap leren? De cursus App maken met AI begint met zeven gratis lessen.