Multi-file projecten

Een HTML pagina bouwen met Claude is makkelijk. Maar hoe werkt het als je project 50, 100 of 500 bestanden heeft? In deze les leer je de strategieën die professionals gebruiken.

Hoe Claude door je project navigeert

Claude Code heeft toegang tot je hele projectmap. Het kan bestanden zoeken, lezen en bewerken. Maar het leest niet alles — dat zou te veel tokens kosten. In plaats daarvan:

1. Claude zoekt bestanden op basis van je vraag
2. Het leest alleen de relevante bestanden
3. Het houdt bij welke bestanden het al kent

Hoe werkt de authenticatie in dit project?

Claude zoekt naar bestanden met “auth”, “login”, “session” in de naam of inhoud, leest die, en geeft je een overzicht.

Refactoring over meerdere bestanden

Dit is waar Claude echt uitblinkt. Een rename of refactor die handmatig uren kost, doet Claude in minuten:

Hernoem de User interface naar Customer in het hele
project. Update alle imports, types en referenties.
De relevante bestanden zitten in src/types/,
src/api/ en src/components/.

Claude:

1. Vindt alle bestanden die User gebruiken
2. Bewerkt elk bestand systematisch
3. Updatet imports en referenties
4. Controleert of alles consistent is

Project planning met Claude

Voor een groot nieuw feature kun je Claude vragen om een plan te maken:

Ik wil een notificatie-systeem toevoegen aan mijn app.
Gebruikers moeten meldingen krijgen bij nieuwe berichten
en updates. Maak een implementatieplan met:
- Welke bestanden moeten worden aangemaakt
- Welke bestaande bestanden moeten worden aangepast
- In welke volgorde we dit moeten bouwen

Claude analyseert je bestaande code en maakt een concreet plan:

Plan:
1. Database: nieuwe notifications tabel (schema.prisma)
2. API: CRUD routes voor notifications (src/api/notifications/)
3. Service: notification logica (src/services/notification.ts)
4. Component: NotificationBell (src/components/)
5. Integratie: hook in bestaande message flow

Strategieën voor grote codebases

1. Werk in lagen

Begin bij de onderste laag en werk omhoog:

We bouwen het notificatie-systeem. Begin met het
database schema. Alleen het schema, nog geen API.

Na elke laag: review, test, commit.

2. Geef een kaart van je project

In CLAUDE.md:

## Structuur
- src/api/ — REST API routes
- src/services/ — Business logica
- src/components/ — React componenten
- src/hooks/ — Custom React hooks
- src/types/ — TypeScript types
- prisma/ — Database schema

3. Gebruik gerichte sessies

Eén sessie per onderdeel:

• Sessie 1: Database en migraties
• Sessie 2: API routes
• Sessie 3: Frontend componenten
• Sessie 4: Integratie en testen

Veelvoorkomende valkuilen

1. Alles tegelijk willen — Claude raakt de draad kwijt bij te veel gelijktijdige wijzigingen
2. Geen tests tussendoor — Test na elke laag, niet pas aan het einde
3. Context vergeten — Na /compact of een nieuwe sessie weet Claude niet meer wat je eerder deed. Geef een korte samenvatting
4. Geen Git checkpoints — Commit na elke werkende stap