Belangrijkste inzichten
- Terminal-native, geen chatbot: Claude Code draait direct op je lokale bestanden, indexeert je volledige projectstructuur en werkt via een machtigingssysteem waarbij je elke bestandswijziging en commando-uitvoering goedkeurt.
- Plan Mode voor complexe taken: Vertel Claude om zijn aanpak te plannen voordat hij wijzigingen aanbrengt -- het analyseert het probleem, schetst stappen, toont de redenering en wacht op jouw goedkeuring voordat het wordt uitgevoerd.
- Sonnet voor 80%, Opus for 20%: Gebruik Sonnet 4.6 voor dagelijkse taken (snel, kosteneffectief); schakel over naar Opus 4.6 voor complexe refactoring van meerdere bestanden, architecturale beslissingen of Agent Teams.
- CLAUDE.md verhoogt consistentie: Maak een projectspecifiek CLAUDE.md bestand met codeerconventies, voorkeuren voor de tech stack en testvereisten die Claude automatisch elke sessie leest.
Claude Code handleiding voor beginners: Volledige gids om aan de slag te gaan
Claude Code is de AI-codeerassistent die in je terminal leeft.
Gebouwd door Anthropic, maakt het direct verbinding met je codebase, begrijpt het je projectstructuur en schrijft het echte code op je machine — allemaal via een gesprek in natuurlijke taal. Sinds de algemene beschikbaarheid in mei 2025 is Claude Code uitgegroeid tot een van de meest gebruikte AI-ontwikkeltools, wat heeft bijgedragen aan het bereiken van meer dan $1 billion aan geannualiseerde omzet door Anthropic in november 2025.
Deze handleiding helpt je van nul naar productief. Geen eerdere ervaring met AI-tools vereist.
Inhoudsopgave
- Wat is Claude Code?
- Vereisten en installatie
- Je eerste sessie
- Overzicht van essentiële commando's
- Plan Mode: Denk na voordat je codeert
- CLAUDE.md instellen
- Praktijkvoorbeelden van workflows
- Kiezen tussen Sonnet 4.6 en Opus 4.6
- Tips om het meeste uit Claude Code te halen
Wat is Claude Code?
Claude Code is Anthropic's terminal-native AI-codeerassistent. In tegenstelling tot browser-gebaseerde chatbots of IDE extensies, draait het direct in je terminal en werkt het op je lokale bestanden.
Dit is wat het anders maakt:
- Diepgaand bewustzijn van de codebase — Claude indexeert je hele project en begrijpt hoe bestanden met elkaar verbonden zijn
- Interactief redeneren — het toont zijn denkproces en vraagt om jouw input op beslismomenten
- Lokale uitvoering — bewerkt bestanden en voert commando's uit op jouw machine, niet in een externe sandbox
- Machtigingssysteem — elke bestandswijziging en commando-uitvoering vereist jouw goedkeuring
Claude Code wordt aangedreven door Claude Opus 4.6 en Claude Sonnet 4.6, Anthropic's meest geavanceerde modellen. Het ondersteunt een standaard 200K context window, met een 1M token beta beschikbaar op Opus 4.6.
"Claude Code is geen chatbot. Het is een codeer-agent die toevallig communiceert via een gesprek."
Vereisten en installatie
Wat je nodig hebt
Zorg ervoor dat je voor de installatie beschikt over:
- Een Claude abonnement — minimaal Claude Pro ($20/month)
- Een terminal-applicatie — Terminal.app (macOS), je favoriete Linux terminal, of Windows Terminal
- Een ondersteund OS — macOS, Linux, of Windows 11
- Node.js — vereist voor de npm installatiemethode
Stap 1: Claude Code installeren
Open je terminal en voer uit:
npm install -g @anthropic-ai/claude-code
Als alternatief kun je installeren via het officiële script:
curl -fsSL https://claude.ai/install.sh | sh
Stap 2: De installatie verifiëren
claude --version
Je zou het huidige versienummer moeten zien. Als je een "command not found" fout krijgt, zorg er dan voor dat je Node.js bin directory in je PATH staat.
Stap 3: Navigeer naar je project
Claude Code werkt het beste wanneer het wordt gestart vanuit de root van je project:
cd ~/projects/my-app
claude
Dat is alles. Claude zal je project scannen en je bent klaar om te gaan.
Je eerste sessie
Wanneer je claude voor de eerste keer start binnen een project, gebeurt het volgende:
- Claude indexeert je projectbestanden en structuur
- Het opent een interactieve prompt waar je typt in natuurlijke taal
- Je stelt vragen of geeft instructies, en Claude antwoordt met code, bewerkingen of uitleg
Een eenvoudige eerste interactie
Probeer te beginnen met zoiets als dit:
> What does this project do? Summarize the tech stack and folder structure.
Claude zal door je bestanden scannen en je een gestructureerd overzicht geven van je project — de frameworks, de entry points, de belangrijkste modules.
Vervolg het met een echte taak:
> Add input validation to the signup form. Email should be validated and password needs at least 8 characters.
Claude zal:
- De relevante formuliercomponent vinden
- Je zijn plan voor de wijzigingen tonen
- Om je toestemming vragen voordat bestanden worden gewijzigd
- De bewerkingen toepassen en bevestigen wat er is veranderd
Jij behoudt de controle. Er gebeurt niets zonder jouw goedkeuring.
Overzicht van essentiële commando's
Dit zijn de commando's die je het vaakst zult gebruiken binnen een Claude Code sessie:
| Commando | Wat het doet |
|---|---|
claude | Start een nieuwe Claude Code sessie |
/help | Toon alle beschikbare commando's |
/plan | Activeer Plan Mode — Claude plant voordat hij uitvoert |
/clear | Wis de conversatie-context en begin opnieuw |
/cost | Toon token-verbruik en geschatte kosten voor de sessie |
/compact | Comprimeer de conversatie om context window ruimte te besparen |
Je hoeft slash-commando's niet uit je hoofd te leren om productief te zijn. Meestal typ je gewoon je verzoek in natuurlijke taal en Claude zoekt de rest uit.
Plan Mode: Denk na voordat je codeert
Plan Mode is een van de belangrijkste functies van Claude Code, vooral voor beginners.
Wanneer je Plan Mode activeert met /plan, verandert het gedrag van Claude:
- Het analyseert het probleem — leest relevante bestanden, traceert afhankelijkheden, identificeert getroffen gebieden
- Het schetst een stapsgewijs plan — wat het gaat veranderen, in welke volgorde en waarom
- Het toont de redenering — je ziet hoe Claude door het probleem heen denkt
- Het wacht op jouw goedkeuring — niets wordt uitgevoerd totdat jij "go" zegt
Wanneer Plan Mode te gebruiken
- Complexe refactoring — een module hernoemen die in tientallen bestanden wordt geïmporteerd
- Functies over meerdere bestanden — een nieuw API endpoint toevoegen dat routes, controllers, models en tests raakt
- Onbekende codebases — wanneer je de impact wilt begrijpen voordat je wijzigingen aanbrengt
- Leren — het lezen van Claude's redenering helpt je om je eigen codebase beter te begrijpen
Voorbeeld: Plan Mode in actie
> /plan
> Refactor the authentication module to use JWT tokens instead of session cookies.
Claude zal antwoorden met iets als:
Hier is mijn plan:
- Update
auth/middleware.jsom JWT tokens te verifiëren in plaats van de session store te controleren- Wijzig
auth/login.jsom een JWT te genereren en te retourneren bij een succesvolle login- Update
auth/logout.jsom token-invalidatie af te handelen- Pas de API client in
frontend/src/api.jsaan om tokens in de Authorization header te verzenden- Update 3 testbestanden om JWT-gebaseerde authenticatie-fixtures te gebruiken
Zal ik doorgaan?
Je beoordeelt het, stelt vragen, past het plan aan indien nodig, en keurt het vervolgens goed.
CLAUDE.md instellen
CLAUDE.md is een speciaal bestand dat Claude automatisch leest aan het begin van elke sessie. Zie het als een configuratiebestand voor hoe Claude zich in jouw project moet gedragen.
Maak je CLAUDE.md
Plaats het in de root van je project:
# Project: My SaaS App
## Tech Stack
- Next.js 14 with App Router
- TypeScript (strict mode)
- Tailwind CSS
- PostgreSQL with Prisma ORM
## Coding Conventions
- Use functional components with hooks (no class components)
- All functions must have TypeScript return types
- Use named exports, not default exports
- Write tests for all new utility functions
## Testing
- Run tests with: npm run test
- Use Vitest for unit tests
- Test files go in __tests__ directories next to source files
## Git
- Conventional commits: feat(), fix(), refactor()
- Always create a new branch for features
Waarom CLAUDE.md belangrijk is
Zonder CLAUDE.md doet Claude redelijke aannames over je conventies. Hiermee volgt Claude je exacte standaarden vanaf de eerste prompt. Dit is vooral waardevol in teams waar consistentie belangrijk is.
Praktijkvoorbeelden van workflows
Een productieprobleem oplossen
> Users are reporting that the dashboard takes 15 seconds to load.
> Check the API calls on the dashboard page and identify any performance bottlenecks.
Claude zal door de dashboard-component traceren, de API calls vinden, controleren op N+1 queries of ontbrekende indexen, en specifieke oplossingen voorstellen.
Een nieuwe functie toevoegen
> Add a dark mode toggle to the app. It should persist the user's preference
> in localStorage and apply on page load without a flash of unstyled content.
Claude zal identificeren waar de toggle-component moet worden toegevoegd, de thema-context instellen, de localStorage logica toevoegen en de initiële render correct afhandelen.
Legacy-code refactoren
> /plan
> This file uses callback-based async patterns. Refactor it to use async/await
> while keeping the same external API.
Claude plant de refactoring, toont welke functies veranderen en bevestigt dat er extern niets breekt voordat hij verder gaat.
Git-integratie
Claude Code werkt direct met Git. Je kunt het vragen om:
> Create a new branch called feat/dark-mode, commit the changes we just made,
> and open a pull request with a description of what was changed.
Claude maakt de branch aan, voegt de bestanden toe aan de staging area, schrijft een commit-bericht en gebruikt de GitHub CLI om een PR te openen — allemaal binnen je terminal-sessie.
Kiezen tussen Sonnet 4.6 en Opus 4.6
Claude Code geeft je toegang tot twee modellen. Het kiezen van de juiste bespaart je tijd en geld.
| Sonnet 4.6 | Opus 4.6 | |
|---|---|---|
| Snelheid | Snel | Langzamer |
| Kosten (API) | $3 / $15 per 1M tokens | $15 / $75 per 1M tokens |
| Best voor | De meeste dagelijkse codeertaken | Complexe architectuur, refactoring van meerdere bestanden |
| Context window | 200K tokens | 200K standaard, 1M beta |
| Agent Teams | Niet beschikbaar | Beschikbaar (alleen Opus) |
De 80/20-regel
Gebruik Sonnet 4.6 voor ongeveer 80% van je werk: functies schrijven, bugs oplossen, functies toevoegen, tests schrijven, code uitleggen. Het is snel, goedkoop en meer dan capabel genoeg.
Schakel over naar Opus 4.6 voor de moeilijkste 20%: grootschalige refactoring over veel bestanden, complexe architecturale beslissingen, Agent Teams voor parallel werk, of wanneer je de 1M token context window nodig hebt voor het analyseren van een grote codebase.
Tips om het meeste uit Claude Code te halen
1. Begin elk project met context. Voordat je in taken duikt, vraag Claude om samen te vatten wat het project doet. Dit helpt Claude een accuraat mentaal model op te bouwen en resulteert in betere code vanaf de eerste prompt.
> What does this project do? Walk me through the architecture.
2. Gebruik Plan Mode voor alles wat complex is.
Als een taak meer dan twee bestanden raakt, gebruik dan /plan. De investering vooraf in planning bespaart je onjuiste wijzigingen die moeilijker ongedaan te maken zijn.
3. Wees specifiek met je verzoeken.
In plaats van "maak de code beter", probeer "refactor de processPayment functie om mislukte Stripe betalingen af te handelen en probeer het maximaal 3 keer opnieuw met exponential backoff."
4. Gebruik /compact wanneer je contextlimieten bereikt.
Lange sessies stapelen context op. Wanneer Claude het overzicht over eerdere gesprekken begint te verliezen, voer dan /compact uit om de geschiedenis te comprimeren en ruimte vrij te maken.
5. Maak en onderhoud je CLAUDE.md.
Dit is het meest effectieve wat je kunt doen. Een goede CLAUDE.md elimineert herhalende correcties en houdt Claude in lijn met de standaarden van je team.
6. Controleer diffs voordat je ze goedkeurt. Claude's machtigingssysteem is er niet voor niets. Lees de voorgestelde wijzigingen, vooral bij onbekende codebases. Claude is krachtig maar niet onfeilbaar.
7. Gebruik Git-integratie voor schone workflows. Laat Claude de mechanische delen van Git afhandelen — branching, committing, het schrijven van PR-beschrijvingen — zodat jij je kunt concentreren op het beoordelen van de werkelijke codewijzigingen.
8. Koppel taken in een enkele sessie. Claude onthoudt de context binnen een sessie. Nadat je een functie hebt gebouwd, volg je direct op met "schrijf nu tests voor wat we net hebben toegevoegd" — Claude kent de code al.
Wat nu?
Je hebt nu alles wat je nodig hebt om Claude Code productief te gaan gebruiken. De leercurve is kort: de meeste ontwikkelaars vinden hun ritme binnen de eerste paar sessies.
Naarmate je meer op je gemak raakt, kun je deze geavanceerdere mogelijkheden verkennen:
- Agent Teams — start meerdere Claude instanties voor parallel werk aan grote projecten (alleen Opus 4.6)
- 1M token context window — analyseer enorme codebases in een enkele sessie (Opus 4.6 beta)
- Aangepaste slash-commando's — automatiseer herhalende workflows met projectspecifieke commando's
- CI/CD integratie — draai Claude Code als onderdeel van je build- en review-pipeline
