Claude Code Meesterschap Deel 1: Aan de Slag

Stel je voor: je staart naar een enorme legacy codebase, honderden bestanden diep, en iemand vraagt je om "even een kleine feature toe te voegen." Je zou uren kunnen besteden aan het traceren van imports, het begrijpen van patronen, en het uitzoeken waar alles met elkaar verbonden is. Of je zou claude kunnen typen in je terminal en het vragen om de architectuur in gewoon Nederlands uit te leggen.

Dat is de belofte van Claude Code — een AI pair programmer die niet alleen je code aanvult, maar je hele project daadwerkelijk begrijpt en taken autonoom kan uitvoeren. Laten we je opzetten.

De Productiviteitskloof is Echt

Hier is iets dat niemand hardop wil zeggen: als je geen tools zoals Claude Code gebruikt, loop je nu al achter.

De developers die dit doorhebben opereren op 10-100x de productiviteit van degenen die dat niet doen. Dat is geen hype. Dat is wat er gebeurt als je complete features in een uur kunt shippen in plaats van een dag, als je architectuur kunt refactoren in minuten in plaats van weken, als je complexe bugs kunt debuggen door een AI duizenden bestanden in seconden te laten lezen.

Terwijl sommige developers handmatig door codebases aan het traceren zijn, zijn anderen al klaar en bezig met de volgende taak. Terwijl sommigen documentatie lezen, hebben anderen al geshipt. Terwijl sommigen regel voor regel debuggen, hebben anderen het opgelost en zijn verder.

Deze gids is alles wat ik heb geleerd in een jaar dagelijks Claude Code gebruik. Elke hack die me uren bespaarde. Elke workflow die mijn output vermenigvuldigde. Elke mindset-shift die het verschil maakte tussen frustratie en flow.

Als je een solo developer bent, gaat dit je carrière veranderen. Als je een team leidt, gaat dit je hele organisatie veranderen. De kloof wordt snel groter. Laten we zorgen dat je aan de goede kant staat.

Wat is Claude Code Precies?

Claude Code is Anthropic's agentische codeerassistent die in je terminal leeft. In tegenstelling tot traditionele code completion tools die de volgende paar karakters suggereren, kan Claude Code:

• Je hele codebase navigeren - Het leest, begrijpt, en legt verbanden over honderden bestanden
• Multi-step taken uitvoeren - "Refactor deze module naar TypeScript" is niet zomaar een suggestie; Claude doet het daadwerkelijk
• Git workflows afhandelen - Commits, branches, PR-beschrijvingen — allemaal via natuurlijke taal
• Overal draaien - Terminal, VS Code, JetBrains, of zelfs direct op GitHub via @claude mentions

Zie het minder als een autocomplete en meer als een heel enthousiaste junior developer die 1000x sneller typt dan jij, je hele codebase in seconden kan lezen, en eindeloos geduld heeft om dingen uit te leggen.

Hier is de valkuil: LLM's (large language models, grote taalmodellen) denderen vrolijk door zonder vangrails als je ze laat. De developers die het meeste uit Claude Code halen zijn niet alleen goed in prompting — ze zijn goed in het opzetten van structuur die al die snelheid kanaliseert naar iets nuttigs in plaats van chaotisch.

Voordat Je Installeert

Je hebt een van deze twee dingen nodig:

Optie A: Claude Pro of Max Abonnement

Als je al betaalt voor Claude Pro ($20/maand) of Max ($100/maand), ben je gedekt. Claude Code-gebruik zit inbegrepen, en je authenticeert door simpelweg in te loggen op je Claude-account.

Optie B: Anthropic API Key

Liever pay-as-you-go (betalen per gebruik)? Maak een account aan op console.anthropic.com, voeg billing toe, en genereer een API key. Je betaalt alleen voor wat je gebruikt.

Pro tip: Als je zowel een API key ingesteld hebt als omgevingsvariabele ÉN een Claude-abonnement hebt, krijgt de API key voorrang — wat betekent dat je per token wordt belast in plaats van je abonnement te gebruiken. Draai /status in Claude Code om te verifiëren welke authenticatiemethode actief is.

Systeemvereisten:

• Node.js 18 of hoger (check met node --version)
• macOS, Linux, of Windows

Installatie

De npm-installatiemethode is deprecated (verouderd). Hier zijn de officiële manieren om Claude Code te installeren:

macOS of Linux (Aanbevolen):

Curl -fsSL https://claude.ai/install.sh | bash

Homebrew (macOS/Linux):

Brew install --cask claude-code

Windows (PowerShell):

Irm https://claude.ai/install.ps1 | iex

Windows (WinGet):

Winget install Anthropic.ClaudeCode

Na installatie updatet Claude Code automatisch op de achtergrond. Homebrew- en WinGet-gebruikers moeten handmatig updaten met brew upgrade claude-code of winget upgrade Anthropic.ClaudeCode.

Eerste Keer Starten

Navigeer naar een willekeurige projectmap en draai:

Claude

Wat er vervolgens gebeurt hangt af van je setup:

1. Browser opent voor authenticatie
2. Log in met je Claude-account of Anthropic console-inloggegevens
3. Autoriseer Claude Code om toegang te krijgen tot je account
4. Een speciale "Claude Code" workspace wordt automatisch aangemaakt voor gebruikstracking

Dat is het. Je bent binnen.

Het Eerste Wat Je Moet Doen

Draai dit commando meteen:

/terminal-setup

Dit installeert terminalsnelkoppelingen waarmee je Shift + Enter kunt gebruiken voor meerregelige invoer. Zonder dit zit je vast aan alles op één regel typen — wat snel vervelend wordt als je gedetailleerde prompts schrijft.

Waarom dit belangrijk is: Stel je voor dat je een complexe bug probeert uit te leggen op één regel versus dat je je gedachten over meerdere alinea's kunt structureren. Meerregelige invoer transformeert hoe effectief je met Claude kunt communiceren.

Twee Manieren van Werken

Interactieve Modus (Je Dagelijkse Driver)

Claude

Opent een REPL-sessie (Read-Eval-Print Loop) waar je een gesprek voert. Claude behoudt context gedurende de hele sessie, onthoudt wat je besproken hebt, en kan complexe multi-step taken afhandelen.

Gebruik dit voor:

• Nieuwe features bouwen
• Lastige bugs debuggen
• Code reviews en refactoring
• Onbekende codebases verkennen

Plan Mode (Denk Voor Je Handelt)

Druk twee keer op Shift+Tab voordat je je bericht stuurt om Plan Mode te activeren. In deze read-only modus kan Claude je codebase verkennen, benaderingen onderzoeken, en oplossingen voorstellen — maar geen bestanden wijzigen.

Gebruik dit voor:

• Architectuurbeslissingen vóór implementatie
• Onbekende code begrijpen
• Verschillende benaderingen van een probleem evalueren
• Complexe refactoring waarbij je eerst het plan wilt zien

Plan Mode wordt diepgaand behandeld in Deel 2: Het Mentale Model.

One-Shot Modus (Snelle Vragen)

Claude -p "je vraag hier"

Draait een enkel commando en sluit af. Geen interactieve sessie, gewoon vraag → antwoord → klaar.

Gebruik dit voor:

• Snelle lookups: claude -p "wat doet de auth middleware?"
• Geautomatiseerde scripts: claude -p "lijst alle TODO comments" >> todos.txt
• CI/CD pipelines: claude -p "genereer changelog van recente commits"

Essentiële Commando's

Zodra je in een interactieve sessie zit, regelen deze slash-commando's het gedrag van Claude:

/help — Toont alle beschikbare commando's inclusief custom commando's. Gebruik wanneer je een commando vergeten bent of nieuwe features wilt ontdekken.

/clear — Wist de gespreksgeschiedenis. Gebruik dit vaak! Begin fris tussen ongerelateerde taken om tokens te besparen.

/compact — Comprimeert de gesprekscontext. Gebruik wanneer de context lang wordt maar je wat geschiedenis wilt behouden.

/model — Schakel tussen Opus, Sonnet of Haiku. Opus voor complex redeneren, Haiku voor snelle taken, Sonnet voor balans.

/config — Opent instellingenconfiguratie. Gebruik voor het aanpassen van permissies, defaults en voorkeuren.

/status — Toont huidige status en authenticatiemethode. Gebruik om te verifiëren welk account/API key gebruikt wordt.

/cost — Toont tokengebruik. Houd je verbruik in de gaten.

/context — Bekijk wat er in Claude's huidige context zit. Helpt je begrijpen wat Claude nu "weet".

/vim — Activeer vim-stijl bewerken. Als je een vim-gebruiker bent, voel je je meteen thuis.

/init — Initialiseer of update CLAUDE.md. Draai na grote features of refactors om de projectcontext actueel te houden.

Sessiebeheer Commando's

/terminal-setup — Installeer Shift+Enter snelkoppeling voor meerregelige invoer.

/allowed-tools — Configureer welke tools Claude mag gebruiken (bestandstoegang, bash, etc.).

/hooks — Stel automatiseringshooks in voor bepaalde events.

/mcp — Beheer Model Context Protocol servers.

/agents — Maak en beheer subagenten voor parallelle taken.

/install-github-app — Stel GitHub Actions-integratie in voor @claude mentions.

Sessiebeheer Vanuit de Terminal

Soms moet je verdergaan waar je gebleven was:

# Ga verder met je laatste sessie precies waar je stopte
Claude -c

# Blader door en selecteer uit recente sessies
Claude -r

De -r flag is bijzonder handig wanneer je beseft "wacht, ik was twee dagen geleden bezig met die auth-bug en Claude had iets uitgezocht." Je kunt terug naar dat exacte gesprek springen.

Je Eerste Echte Taak

Hier is een goede manier om je setup te testen. Navigeer naar een willekeurig project en draai:

Claude

Typ dan:

Leg de architectuur van dit project uit. Wat zijn de hoofdcomponenten
en hoe zijn ze verbonden? Waar zou ik kijken als ik een nieuw
API endpoint wil toevoegen?

Claude scant je codebase, identificeert patronen, en geeft je een gestructureerd overzicht. Dit is oprecht een van de beste manieren om in te werken in elk onbekend project — of het nu een nieuwe baan is, een open-source bijdrage, of je eigen code van zes maanden geleden.

Het Permissiesysteem

Claude past niet zomaar stilletjes je bestanden aan. Voordat er wijzigingen worden gemaakt, zie je prompts zoals:

Claude wants to edit src/auth.ts
Allow? [y]es / [n]o / [a]lways allow for this file

Je opties:

• y - Sta deze specifieke actie toe
• n - Blokkeer het
• a - Sta dit type actie altijd toe (geen prompts meer voor soortgelijke operaties)

Mijn aanbeveling: Begin met y voor alles totdat je de gedragspatronen van Claude begrijpt. Zodra je het vertrouwt voor bepaalde operaties (zoals het bewerken van testbestanden), schakel over naar a om je workflow te versnellen.

Geavanceerde permissies: Voor fijnmazige controle met allow/deny lijsten, geautomatiseerde hooks, en teamwijde permissiebeleiden, zie Instellingenconfiguratie in Deel 3.

IDE-Integratie

Claude Code werkt native met meerdere IDE's:

VS Code — Zoek "Claude Code" in Extensions (Cmd/Ctrl+Shift+X). Volledige integratie met inline diffs en multi-tab gesprekken.

Cursor — Handmatige VSIX-installatie kan nodig zijn. Gebaseerd op VS Code, werkt prima eenmaal geïnstalleerd.

Windsurf — Vergelijkbare setup als Cursor. VS Code fork die VSIX-extensies ondersteunt.

JetBrains — Plugin beschikbaar. Werkt met IntelliJ, WebStorm, PyCharm, en andere JetBrains IDE's.

Belangrijk: De VS Code-extensie is geen vervanging voor de CLI — het is een launcher die een mooiere interface biedt. De eigenlijke Claude Code draait nog steeds als dezelfde engine onder de motorkap. Je kunt meerdere instanties parallel draaien over verschillende delen van je codebase.

De Mindset-Shift: Structuur Maakt Snelheid Mogelijk

Dit is wat developers die van Claude Code houden scheidt van degenen die het frustrerend vinden: de succesvolle developers behandelen het alsof ze samenwerken met een zeer capabele maar zeer enthousiaste junior developer.

Die junior dev typt ongelofelijk snel, wordt nooit moe, en kan je hele codebase in seconden absorberen. Maar hij dendert ook vrolijk door zonder vangrails als je hem laat. De praktijken die AI-ondersteund programmeren laten werken zijn niet nieuw — het zijn dezelfde dingen die ervaren developers al jaren doen. Ze worden alleen cruciaal nu.

Git is Je Vangnet

Commit regelmatig, in kleine stukjes. Als Claude ontspoort, kun je gewoon git checkout . doen of terugkeren naar een bekende goede staat. Zie commits als save points in een videogame.

Dit klinkt basic, maar het verandert alles. Als je weet dat je altijd kunt terugdraaien, ben je vrij om Claude te laten experimenteren. Als je het niet zeker weet, aarzel je, ga je micromanagen, en verlies je het grootste deel van het snelheidsvoordeel.

Als je wat roestig bent met Git, zijn de officiële GitHub docs oprecht uitstekend om mee te beginnen.

Plan Voordat Je Prompt

Schrijf op wat je aan het bouwen bent voordat je begint met prompting. Een simpel markdown-document met je doelen, architectuurbeslissingen en beperkingen doet wonderen. Houd het in je repo zodat Claude ernaar kan verwijzen.

En serieus — gebruik Plan Mode. Het staat letterlijk in de naam. Als je Claude vraagt om iets te plannen, stelt het verduidelijkende vragen, stelt dan een plan voor en geeft je de optie om het te accepteren. Als je om welke reden dan ook niet tevreden bent, zeg nee en vertel Claude wat je gewijzigd wilt hebben. Itereer zoveel als je nodig hebt.

Dit dwingt jou om na te denken, en geeft het LLM cruciale context. Shift+Tab twee keer, dan "ontwerp een loginformulier" is oneindig beter dan "bouw me een loginformulier."

Breek Grote Taken Op in Issues

In plaats van "hé Claude, bouw me een user auth systeem," breek het op in discrete stukken: "Maak User model," "Voeg sessiebeheer toe," "Bouw loginformulier." Eén PR per issue.

Maak GitHub issue templates (feature request, bug report — deze twee dekken 90% van de gevallen) en check ze in onder versiebeheer. GitHub gebruikt ze automatisch wanneer iemand een issue aanmaakt via de UI.

Zodra je een solide plan hebt en het begrijpt, vraag Claude om een GitHub issue aan te maken met je template. Of als je een groot plan hebt, vraag Claude om het op te breken in kleinere, beheersbare stukken, en maak dan issues van de onderdelen waar je je comfortabel bij voelt.

Tests Eerst (Ja, Echt)

Vraag Claude om tests te schrijven vóór de implementatie. Klinkt contra-intuïtief, maar het dwingt het LLM om helder na te denken over wat "klaar" er uitziet — en het geeft je een vangnet. Als tests niet slagen, is er iets mis met de implementatie.

Dit heet TDD (Test-Driven Development, testgedreven ontwikkeling), of "van rood naar groen gaan" gebaseerd op de typische CLI-kleuren voor falende vs. slagende tests. Het is niet alleen goede praktijk — het is hoe je Claude eerlijk houdt.

Linters Vangen "Creatieve" Keuzes

ESLint, Prettier, Rubocop, markdownlint, yamllint — wat bij je stack past. Stel ze in met Git pre-commit hooks. Dit vangt veel van de stilistische keuzes die LLM's maken die niet bij je codebase passen.

Voorbeeld: Claude houdt ervan om de lege regel tussen een header en een opsommingslijst over te slaan in markdown-bestanden. Geen idee waarom. Maar standaardpraktijk is om die wel te zetten. Dus installeer je markdownlint, stel je regelvoorkeuren in via een configuratiebestand, draai het op alle markdown-bestanden die Claude aanraakt, en probleem opgelost.

CLAUDE.md: De Handleiding van Je Project

Maak een CLAUDE.md-bestand in je projectroot met je codeerstandaarden, voorkeuren en projectcontext. Claude leest het automatisch aan het begin van elke sessie.

Maak het echter niet te groot. LLM's hebben verrassend slecht kortetermijngeheugen vergeleken met de willekeurige dingen die ze schijnbaar uit de lucht kunnen trekken over gebeurtenissen van 300 jaar geleden (bedankt, trainingsdata). Houd het gefocust op je voorkeuren en belangrijke projectdetails.

Draai /init na elke grote feature-implementatie of refactor om CLAUDE.md actueel te houden. Claude vertelt je of er iets toe te voegen of bij te werken is, of zegt gewoon "ziet er goed uit, geen wijzigingen nodig."

Veelvoorkomende Beginnerfouten (En Hoe Je Ze Vermijdt)

1. /terminal-setup overslaan

Je zult je afvragen waarom je gedetailleerde prompts zo beknopt aanvoelen. Draai het gewoon.

2. Nooit /clear gebruiken

Elk bericht dat je stuurt bevat alle vorige context. Na het afronden van een taak, begin met een schone lei. Je tokenrekening zal je dankbaar zijn.

3. Te vaag zijn

"Fix de bug" vs "Fix de null pointer exception in auth.ts op regel 42 waar user.id wordt benaderd vóór de null check" — een van deze levert betere resultaten op.

4. Claude vragen om code te wijzigen die het niet gelezen heeft

Laat Claude altijd eerst analyseren. "Lees de auth-module en leg uit hoe sessies werken" vóór "herschrijf de sessieafhandeling."

5. Enorme taken in één prompt dumpen

"Herschrijf de hele applicatie in TypeScript" is overweldigend. Breek het op: "Converteer de user-module naar TypeScript, dan doen we auth daarna."

6. /status niet checken

Als je je afvraagt waarom je gefactureerd wordt terwijl je een abonnement hebt, check welke authenticatiemethode actief is.

7. Plan Mode overslaan

"Gewoon bouwen" voelt sneller. Is het niet. Shift+Tab twee keer en neem vijf minuten om te plannen — het bespaart uren aan werk ongedaan maken dat de verkeerde kant op ging.

8. Geen vangnet

Als je niet regelmatig commit, ben je één slechte generatie verwijderd van een frustrerende middag. Commit vóór grote wijzigingen. Commit na succesvolle wijzigingen. Commits zijn gratis.

Wat Volgt

Je hebt nu Claude Code geïnstalleerd en begrijpt niet alleen de commando's, maar de mindset die AI-ondersteund programmeren laat werken. Structuur en vangrails zijn geen beperkingen — ze zijn wat de snelheid daadwerkelijk nuttig maakt in plaats van chaotisch.

In Deel 2: Het Mentale Model duiken we in hoe Claude Code daadwerkelijk "denkt" — het begrijpen van context windows, tool-gebruik, en hoe je je prompts structureert om consistent betere resultaten te krijgen. Deze kennis transformeert Claude van een soms-behulpzame assistent naar een betrouwbare engineering partner.