Debugging met AI

Bugs zijn onvermijdelijk. Maar met Claude Code als debugging partner los je ze sneller op. Het verschil zit in hoe je het probleem presenteert.

Bugs beschrijven aan Claude

Hoe beter je beschrijving, hoe sneller de oplossing. Gebruik dit format:

Er is een bug in de checkout pagina.

Wat ik verwacht: Na het klikken op "Bestellen" wordt de
bestelling opgeslagen en zie ik een bevestigingspagina.

Wat er gebeurt: De pagina herlaadt en de bestelling
wordt niet opgeslagen. In de console zie ik:
"TypeError: Cannot read property 'id' of undefined"

Stappen om te reproduceren:
1. Ga naar /checkout
2. Vul het formulier in
3. Klik op "Bestellen"

Foutmeldingen samen lezen

Plak de foutmelding direct in Claude:

Ik krijg deze error als ik de app start:

Error: ENOENT: no such file or directory, open
'/app/config/database.json'
    at Object.openSync (node:fs:603:3)
    at readFileSync (node:fs:471:35)
    at loadConfig (/app/src/config.ts:12:22)
    at main (/app/src/index.ts:5:18)

Wat gaat er mis en hoe los ik het op?

Claude leest de error, analyseert de stack trace, en:

1. Legt uit wat de error betekent
2. Wijst naar het specifieke bestand en regelnummer
3. Stelt een oplossing voor

Stack traces analyseren

Stack traces vertellen je precies waar de fout optreedt. Claude is er een meester in:

Analyseer deze stack trace en vertel me waar het misgaat:

Unhandled Promise Rejection: TypeError: res.json is not
a function
    at handleLogin (/app/src/api/auth.ts:45:12)
    at processTicksAndRejections (node:internal/process)
    at async /app/src/middleware/errorHandler.ts:8:5

Claude identificeert:

• Waar: auth.ts, regel 45
• Wat: res.json bestaat niet — waarschijnlijk is res niet het verwachte Express response object
• Waarom: Mogelijk een middleware die het response object overschrijft

Systematisch debuggen

Voor hardnekkige bugs die niet meteen duidelijk zijn:

De app is traag bij het laden van de productpagina.
Het duurt soms 10+ seconden. Ik weet niet waar het
aan ligt. Kun je systematisch onderzoeken wat de
oorzaak is?

Check:
1. De database queries in src/api/products.ts
2. De data fetching in src/pages/product/[id].tsx
3. Of er onnodige re-renders zijn in de componenten

Claude onderzoekt elk punt en rapporteert:

Gevonden: In src/api/products.ts worden bij elke
request ALLE reviews opgehaald (1000+), ook al toon
je er maar 10. Oplossing: voeg pagination toe.

Log analyse

Je kunt ook logbestanden delen:

Hier zijn de laatste 50 regels van mijn server logs.
Er gaat iets mis met de WebSocket verbinding:

[Log output hier plakken]

Wat zie je?

Debugging checklist

Als je vastzit, doorloop dit rijtje met Claude:

1. Reproduceer — Kun je de bug consistent reproduceren?
2. Isoleer — In welk bestand of welke functie zit het probleem?
3. Begrijp — Wat zou er moeten gebeuren vs wat gebeurt er?
4. Hypothese — Wat is de meest waarschijnlijke oorzaak?
5. Test — Pas de fix toe en test
6. Verifieer — Is het probleem echt opgelost?

Laten we systematisch debuggen. De bug is: [beschrijf].
Begin bij stap 1: kun je de relevante code lezen en
een hypothese vormen over de oorzaak?