De eerste keer dat ik Claude Code opende, deed ik wat iedereen doet: een prompt intikken en kijken wat er gebeurt. Dat is vibe coding. Leuk voor een prototype. Onbruikbaar voor iets dat langer dan een week mee moet gaan.
Na 1500+ uur en 50.000+ regels productiecode heb ik een workflow die werkt. Het verschil tussen "AI erbij pakken" en "AI structureel inzetten" zit niet in het model — het zit in de setup.
Claude Code instellen: wat is het en wat kan het?
Claude Code is niet de chatbot die je kent van claude.ai. Het is een AI-agent die in je terminal draait en je hele project kent. Het verschil:
- Claude (chatbot): je stelt vragen in een browservenster. Elke sessie begint op nul.
- Claude Code: draait in je terminal, leest je bestanden, voert commando's uit, en onthoudt projectcontext via configuratiebestanden.
Denk aan het verschil tussen iemand bellen voor advies versus iemand op je kantoor hebben zitten die je systemen kent.
Installatie in 5 minuten
Vereisten
- macOS, Linux, of Windows (met WSL)
- Node.js 18+ (check met
node --version) - Een Claude-account (Max-abonnement of API-key)
Stap 1: Installeren
# macOS / Linux
npm install -g @anthropic-ai/claude-code
# Of via homebrew (macOS)
brew install claude-codeStap 2: Authenticeren
claude
# Volg de login-prompt — je browser opent voor OAuthStap 3: Je eerste project openen
cd ~/mijn-project
claudeDat is het. Claude Code scant nu je projectmap en begrijpt de structuur. Maar zonder configuratie is het alsof je een nieuwe medewerker aanzet zonder onboarding. Het werkt — maar niet goed.
De 3-laag configuratie: het fundament
Hier zit het verschil tussen amateurs en professionals. Claude Code heeft een hiërarchisch configuratiesysteem met drie niveaus:
Laag 1: ~/.claude/CLAUDE.md → Jouw persoonlijke voorkeuren (alle projecten)
Laag 2: project/CLAUDE.md → Projectspecifieke context en regels
Laag 3: project/.claude/rules/*.md → Domeinspecifieke regels (laden per pad)Laag 1: Globale CLAUDE.md (~/.claude/CLAUDE.md)
Dit is je persoonlijke werkstijl. Alles wat je in elk project wilt:
# Mijn Voorkeuren
## Werkwijze
- Geen TODO comments — maak alles af
- Geen mock data of placeholders
- Geen _v2 of _fixed bestanden — edit het origineel
- Verifieer de huidige datum voordat je tijdsgebonden claims maakt
## Code Stijl
- Python: type hints, docstrings bij publieke functies
- TypeScript: strict mode, geen any
- Altijd tests schrijven bij nieuwe functionaliteitLaag 2: Project CLAUDE.md (project root)
Dit is de onboarding voor je specifieke project. Schrijf het alsof je een nieuwe developer instrueert:
# MijnProject
## Wat is dit?
E-commerce platform voor vintage kleding. Next.js frontend, Supabase backend.
## Mapstructuur
- src/app/ — Next.js App Router pagina's
- src/components/ — React componenten (Radix UI)
- src/lib/ — Utility functies en Supabase client
- supabase/migrations/ — Database migraties
## Conventies
- Componenten in PascalCase
- API routes in src/app/api/
- Alle database queries via src/lib/supabase.ts (nooit direct)
- Tests in tests/ map (niet naast bronbestanden)
## Commando's
- `npm run dev` — lokale development server
- `npm run test` — tests draaien
- `npm run build` — productie buildBelangrijk: wees letterlijk. Schrijf niet "API-contracten moeten stabiel zijn." Schrijf: "Wijzig NOOIT de bestaande API-routes in src/app/api/ zonder dat de gebruiker dit expliciet goedkeurt."
Laag 3: Rules directory (.claude/rules/)
Rules zijn het geheime wapen. Ze laden automatisch wanneer Claude bestanden aanraakt in een specifiek pad:
# .claude/rules/frontend-rules.md
---
paths:
- "src/components/**"
- "src/app/**"
---
# Frontend Regels
- Gebruik alleen Radix UI componenten
- Geen inline styles — altijd Tailwind classes
- Elk component heeft een loading state
- Geen directe API-calls in componenten — gebruik server actions# .claude/rules/database-rules.md
---
paths:
- "supabase/**"
- "src/lib/supabase*"
---
# Database Regels
- Migraties altijd in supabase/migrations/
- Gebruik RLS policies voor elke tabel
- Geen raw SQL in applicatiecode — gebruik de Supabase clientHet voordeel: als Claude werkt in src/components/, laden de frontend-regels automatisch. Werkt het in supabase/migrations/, dan laden de database-regels. Geen overbodige context, altijd de juiste regels.
Settings: permissies en modellen
Naast CLAUDE.md heb je .claude/settings.json voor technische instellingen:
{
"permissions": {
"allow": [
"Read",
"Write",
"Edit",
"Bash(npm run test)",
"Bash(npm run build)"
]
},
"env": {
"NODE_ENV": "development"
}
}Hier bepaal je welke acties Claude automatisch mag uitvoeren (zonder elke keer toestemming te vragen) en welke environment variables beschikbaar zijn.
Tip: begin restrictief. Geef Claude alleen toestemming voor acties die je vertrouwt. Breid later uit als je comfortabel bent.
MEMORY.md: leren over sessies heen
Claude Code heeft een geheugen dat over sessies heen werkt. Het bestand MEMORY.md wordt automatisch gelezen bij elke nieuwe sessie (eerste 200 regels).
# Project Geheugen
## Patronen
- Tests draaien trager als de database niet lokaal draait
- De Supabase client in src/lib/supabase.ts moet altijd de service role key gebruiken voor server-side
- Build faalt op Vercel als je NEXT_PUBLIC_ prefix vergeet bij publieke env varsJe hoeft dit niet zelf bij te houden — Claude Code vult het automatisch aan met geleerde patronen. Maar je kunt het ook handmatig sturen: typ # vergeet dit nooit: altijd bun gebruiken in plaats van npm en Claude onthoudt het.
MCP Servers: de tools van je AI agent
MCP (Model Context Protocol) geeft Claude Code toegang tot externe tools. Zonder MCP is het een brein zonder handen. Met MCP kan het:
| MCP Server | Wat het doet | Wanneer je het nodig hebt |
|---|---|---|
| Filesystem | Bestanden lezen/schrijven buiten je project | Werken met meerdere projecten |
| Supabase | Database queries, migraties, edge functions | Elk project met een database |
| GitHub | PRs maken, issues beheren, code pushen | Elk project met Git |
| Brave Search | Web doorzoeken | Research, fact-checking |
| Playwright | Websites bezoeken en testen | E2E testing, scraping |
Configureer MCP servers in je project settings of globaal:
{
"mcpServers": {
"supabase": {
"command": "npx",
"args": ["-y", "@supabase/mcp-server"],
"env": {
"SUPABASE_ACCESS_TOKEN": "je-token-hier"
}
}
}
}Essentiële slash commands
Claude Code heeft ingebouwde commando's die je workflow versnellen:
| Command | Wat het doet |
|---|---|
/model | Wissel van model (Haiku voor snelle taken, Opus voor complexe) |
/clear | Context opschonen zonder sessie te sluiten |
Shift+Tab | Plan Mode: Claude bespreekt de aanpak zonder code te wijzigen |
Alt+T | Thinking mode aan/uit (dieper nadenken vs. sneller antwoorden) |
# | Snel iets opslaan in MEMORY.md |
Plan Mode is cruciaal. Gebruik het altijd voordat je een grote wijziging laat uitvoeren. Claude maakt een plan, jij keurt het goed, en pas dan voert het uit. Geen verrassingen.
Mijn setup: wat ik dagelijks gebruik
Na 1500+ uur is dit mijn workflow:
Globale CLAUDE.md: geen TODO's, geen mocks, geen duplicaatbestanden, altijd tests.
Per project: CLAUDE.md met mapstructuur, conventies, en expliciete do's en don'ts.
Rules: 5 domein-specifieke regelbestanden die per pad laden. Mijn content-project heeft regels voor LinkedIn, blog, email, en tone-of-voice die automatisch wisselen afhankelijk van waar ik werk.
MCP servers: Supabase, GitHub, Brave Search, Playwright, Filesystem, Perplexity, Notion — 8 servers in totaal.
Modellen: Opus voor architectuur en planning. Sonnet voor snelle implementatie. Haiku voor reviews en checks.
Het resultaat: Claude Code kent mijn projecten beter dan de meeste menselijke collega's zouden na een maand. Het houdt zich aan mijn standaarden. Het vergeet geen stappen. En het maakt geen slordigheidsfouten omdat het moe is op vrijdagmiddag.
Veelgemaakte fouten bij de setup
| Fout | Waarom het misgaat | Fix |
|---|---|---|
| Geen CLAUDE.md | Claude raadt maar wat | Schrijf een onboarding doc |
| Alles in CLAUDE.md proppen | Context overload, traag | Gebruik rules/ voor domein-specifiek |
| Geen plan mode | Claude maakt grote wijzigingen zonder overleg | Altijd Shift+Tab voor complexe taken |
| Te veel permissies | Claude wijzigt bestanden die je niet verwacht | Begin restrictief, breid uit |
| Secrets in CLAUDE.md | API keys lekken via Git | Gebruik .env en settings.json |
Volgende stap
Dit is deel 2 van een 5-delige serie. Je kent nu de basis — installatie, configuratie, en de 3-laag structuur.
In deel 3 gaan we dieper: hoe je CLAUDE.md, rules, en skills precies schrijft zodat Claude Code je bedrijf echt begrijpt.
- Deel 1: Van ChatGPT naar AI Agent: Waarom Claude Code je Volgende Stap is
- Deel 3: CLAUDE.md, Rules en Skills: Zo Configureer je AI die je Bedrijf Kent
- Deel 4: AI Skills Evalueren met de Skill Creator Plugin
- Deel 5: Mijn AI Development Stack: Tools, Workflow en Wat het Kost
Wil je dat iemand dit voor jouw project opzet? Plan een kennismakingsgesprek — ik help je van vibe coding naar productie.
Vincent van Deth
AI Strategy & Architecture
Met jarenlange ervaring in marketingstrategie en AI-architectuur help ik bedrijven om hun groeipotentieel te maximaliseren met data-gedreven inzichten en AI-automatisering.
Mijn expertise ligt in het ontwerpen van AI-agent workflows, het strategisch inzetten van multi-agent systemen en het verbeteren van processen door schaalbare, auditeerbare oplossingen.
Of het nu gaat om het verfijnen van je AI-strategie, het selecteren van de juiste modellen of het implementeren van governance voor AI-gestuurde processen — ik bied maatwerkadvies dat leidt tot meetbare resultaten.