Claude Code: de complete handleiding

Claude Code: De Complete Handleiding voor AI-Powered Development (2025)

Claude Code is Anthropic's krachtige AI-programmeerassistent die je hele workflow transformeert. In deze uitgebreide handleiding leer je alles: van installatie tot geavanceerde technieken die je productiviteit vertienvoudigen.

Wat is Claude Code?

Claude Code is een agentic command-line interface (CLI) tool ontwikkeld door Anthropic, de makers van Claude AI. Het is geen simpele autocomplete tool zoals GitHub Copilot - het is een volwaardige AI-agent die je hele codebase begrijpt, zelfstandig taken kan uitvoeren, en complexe wijzigingen kan doorvoeren over meerdere bestanden.

De kracht van Claude Code zit in de agentic mode: Claude denkt actief mee, neemt initiatief, en voert taken uit alsof er een ervaren developer naast je zit. Het leest je bestanden, begrijpt de context, schrijft code, runt commando's, en past wijzigingen toe - allemaal vanuit je terminal.

Waarom Claude Code Gebruiken?

Traditionele AI coding tools zoals ChatGPT of GitHub Copilot werken stateless: je kopieert code, plakt het in een chat, krijgt een antwoord, en kopieert het terug. Dit is omslachtig en foutgevoelig.

Claude Code werkt anders:

Volledige codebase context: Claude leest automatisch je bestanden en begrijpt de hele projectstructuur
Multi-file editing: Wijzig meerdere bestanden tegelijk met een enkel commando
Agentic execution: Claude voert bash commando's uit, installeert packages, en runt tests
Git integration: Commit, branch, en push direct vanuit Claude Code
Persistent memory: Claude onthoudt context binnen je sessie

Kernmogelijkheden

Feature	Beschrijving
Codebase Understanding	Begrijpt je hele project door bestanden te lezen
Multi-file Editing	Wijzigt meerdere bestanden in een keer
Agentic Bash	Voert terminal commando's uit
Git Operations	Commit, branch, merge, push
Test Execution	Runt en analyseert tests
MCP Servers	Verbind met externe tools en API's
Custom Commands	Maak herbruikbare slash commands

Installatie

Claude Code werkt op Mac, Linux, en Windows (via WSL). Hier zijn de installatie-instructies per platform.

Vereisten

Node.js 18+ - Check met node --version
npm - Komt met Node.js
Terminal - Bash, Zsh, of PowerShell
Anthropic account - Claude Pro abonnement vereist

Mac Installatie

Open je terminal en voer uit:

# Installeer Claude Code globaal
npm install -g @anthropic-ai/claude-code

# Verifieer installatie
claude --version

# Login met je Anthropic account
claude login

Dit opent je browser voor OAuth authenticatie. Log in met je Anthropic account.

Linux Installatie

# Update npm indien nodig
sudo npm install -g npm@latest

# Installeer Claude Code
npm install -g @anthropic-ai/claude-code

# Login
claude login

Windows Installatie (via WSL)

Claude Code werkt niet native op Windows. Gebruik Windows Subsystem for Linux (WSL):

# Installeer WSL (in PowerShell als admin)
wsl --install

# Start Ubuntu
wsl

# Installeer Node.js in WSL
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

# Installeer Claude Code
npm install -g @anthropic-ai/claude-code

# Login
claude login

Verificatie

Na installatie, test of alles werkt:

# Toon versie
claude --version

# Toon hulp
claude --help

Eerste Gebruik en Authenticatie

Je Eerste Sessie

Navigeer naar je project en start Claude Code:

cd /pad/naar/je/project
claude

Je krijgt een interactieve shell:

Claude Code v1.x.x
Authenticated as: jouw-email@example.com
Current directory: /pad/naar/je/project

Type your request, or /help for commands.

>

Authenticatie Opties

Claude Code ondersteunt meerdere authenticatie methodes:

# Browser OAuth (aanbevolen)
claude login

# Met API key
export ANTHROPIC_API_KEY="sk-ant-..."
claude

# Logout
claude logout

Model Selectie

Claude Code gebruikt standaard Claude Sonnet. Je kunt dit wijzigen:

# Start met specifiek model
claude --model claude-3-5-sonnet-20241022

# Of set environment variable
export CLAUDE_MODEL="claude-3-5-sonnet-20241022"

Beschikbare modellen:

claude-3-5-sonnet - Beste balans (aanbevolen)
claude-3-opus - Meest capable, langzamer
claude-3-haiku - Snelst, minder capable

Belangrijkste Features

1. Agentic Mode

Het belangrijkste verschil met andere AI tools is de agentic mode. Claude Code denkt niet alleen mee - het handelt. Wanneer je een vraag stelt, kan Claude:

Je codebase analyseren
Bestanden lezen en schrijven
Terminal commando's uitvoeren
Packages installeren
Tests runnen
Git operaties uitvoeren

> "Maak een nieuwe API endpoint voor user registration met email validation, hash het wachtwoord met bcrypt, en schrijf tests."

Claude zal:

De bestaande codestructuur analyseren
Routes, controllers, en services aanmaken
bcrypt installeren indien nodig
Validatie toevoegen
Tests schrijven met Jest
De wijzigingen tonen ter goedkeuring

2. File Reading en Writing

Claude Code kan je hele codebase lezen en begrijpen:

> "Leg uit hoe de authenticatie in dit project werkt"

Claude leest automatisch relevante bestanden en geeft een uitleg.

Voor schrijven, vraag om wijzigingen:

> "Voeg TypeScript types toe aan src/services/UserService.js"

Claude toont diffs en vraagt bevestiging voordat wijzigingen worden toegepast.

3. Git Integration

Claude Code heeft native Git support:

# Status bekijken
> "Wat is de git status?"

# Commits maken
> "Commit deze wijzigingen met een goede message"

# Branches
> "Maak een nieuwe branch voor deze feature"

# Diff analyseren
> "Wat zijn de verschillen met main?"

# Pull request description
> "Schrijf een PR description voor deze branch"

4. MCP Servers (Model Context Protocol)

MCP is een protocol waarmee Claude Code externe tools en API's kan aanspreken. Dit breidt de mogelijkheden enorm uit:

# Voorbeeld: Supabase MCP
> "Toon alle tabellen in de database"

# Voorbeeld: Playwright MCP
> "Open de homepage en neem een screenshot"

Maak .claude/mcp.json in je project:

{
  "mcpServers": {
    "supabase": {
      "command": "npx",
      "args": ["supabase-mcp"]
    },
    "playwright": {
      "command": "npx",
      "args": ["@anthropic-ai/playwright-mcp"]
    }
  }
}

Populaire MCP servers:

Supabase - Database operaties
Playwright - Browser automation
GitHub - Repository management
Slack - Messaging
Filesystem - File operaties

5. Slash Commands

Claude Code ondersteunt ingebouwde en custom slash commands:

Command	Functie
`/help`	Toon beschikbare commando's
`/clear`	Wis de huidige context
`/exit` of `/quit`	Sluit Claude Code
`/cost`	Toon token usage en kosten
`/compact`	Comprimeer context
`/init`	Maak CLAUDE.md configuratie

Maak custom commands in .claude/commands/:

# .claude/commands/deploy.md

# Deploy Command

Deploy de applicatie naar production.

## Stappen

1. Run tests
2. Build de applicatie  
3. Deploy naar Vercel
4. Verifieer de deployment

Gebruik met:

> /deploy

6. Hooks

Hooks laten je automatisch acties uitvoeren bij bepaalde events:

# .claude/hooks/pre-commit.sh
npm run lint
npm run test

# .claude/hooks/post-edit.sh
npm run format

Praktische Voorbeelden en Workflows

Workflow 1: Nieuwe Feature Bouwen

cd /mijn-project
claude

> "Ik wil een password reset feature toevoegen.

Requirements:
- User vraagt reset aan met email
- Email met reset link (1 uur geldig)
- Reset pagina voor nieuw wachtwoord
- Wachtwoord gehashed met bcrypt

Dit project gebruikt Express, Prisma, en Nodemailer."

Claude maakt alle benodigde bestanden:

routes/auth/reset-password.js
services/PasswordResetService.js
templates/reset-email.html
Prisma migration
Jest tests

Workflow 2: Bug Fixing

> "Ik krijg deze error:
TypeError: Cannot read property 'id' of undefined
In: src/controllers/OrderController.js line 45

Analyseer en fix het probleem."

Claude:

Leest het bestand
Analyseert de context
Identificeert de root cause
Geeft een fix met uitleg

Workflow 3: Code Review

> "Review de code in /src/api voor:
- Security vulnerabilities
- Performance issues
- Best practice violations
- Code smells

Geef specifieke fixes."

Workflow 4: Refactoring

> "Refactor dit project:
- Van CommonJS naar ES Modules
- Update alle imports/exports
- Verifieer dat tests nog slagen"

Workflow 5: Documentatie

> "Genereer JSDoc comments voor alle exports in /src/lib"

Workflow 6: Test Generatie

> "Schrijf uitgebreide unit tests voor UserService.js met Jest.
Include:
- Happy path tests
- Error cases
- Edge cases
- Mocking van dependencies"

Claude Code vs Cursor Vergelijking

Beide tools zijn populair voor AI-assisted development. Hier is een eerlijke vergelijking:

Aspect	Claude Code	Cursor
Type	CLI tool	IDE (VS Code fork)
Interface	Terminal	Visueel
Model	Claude (Anthropic)	GPT-4, Claude
Agentic	Ja, volledig	Beperkt
Multi-file	Excellent	Goed
Git	Native	Via VS Code
MCP	Ja	Nee
Prijs	Claude Pro ($20/mo)	$20/mo
Learning curve	Medium	Laag
Best voor	Power users	Visual learners

Wanneer Claude Code Kiezen?

Je werkt veel in de terminal
Je wilt volledige agentic control
Je hebt MCP integraties nodig
Je werkt aan complexe multi-file operaties

Wanneer Cursor Kiezen?

Je prefereert visueel werken
Je wilt een complete IDE
Je bent nieuw met AI coding
Je wilt meerdere modellen gebruiken

Pricing en Claude Pro

Claude Code vereist een Claude Pro abonnement van $20 per maand. Dit geeft je:

Toegang tot Claude Code CLI
5x meer usage dan gratis tier
Priority access tijdens piekuren
Geen training op je code

Usage Limits

Claude Pro heeft generous limits:

Ongeveer 100+ lange gesprekken per dag
Onbeperkt korte queries
Rate limiting bij extreem gebruik

API Credits

Voor intensief gebruik kun je ook API credits kopen:

Pay-per-token model
Geen subscription nodig
Flexibel voor teams

Tips voor Power Users

1. CLAUDE.md Configuratie

Maak een CLAUDE.md in je project root met project-specifieke instructies:

# Project: My App

## Stack
- Frontend: React + TypeScript
- Backend: Node.js + Express
- Database: PostgreSQL via Prisma

## Conventions
- Use functional components
- Tailwind for styling
- Tests in __tests__ folders

## Important
- Never commit .env files
- Always use TypeScript strict mode

Claude leest dit automatisch voor context.

2. Context Management

Claude heeft een context window. Beheer het slim:

# Goed: Specifiek
> "Analyseer alleen /src/services/UserService.js"

# Te breed
> "Analyseer alles"

# Clear context wanneer nodig
/clear

3. Incrementeel Werken

Werk in kleine stappen:

# Stap 1
> "Maak eerst de interface definitie"

# Stap 2  
> "Nu de implementatie"

# Stap 3
> "Voeg error handling toe"

# Stap 4
> "Schrijf tests"

4. Templates Gebruiken

Maak herbruikbare prompt templates:

> "Maak een service class met:
- Naam: [X]Service
- Methods: create, read, update, delete
- Database: Prisma
- Error handling: Custom errors
- Logging: Winston
- Tests: Jest"

5. Git Workflow

Gebruik Claude Code voor je hele Git workflow:

> "Maak een feature branch genaamd feat/user-auth"
> "Stage alle wijzigingen"
> "Commit met een goede message"
> "Push naar origin"
> "Maak een PR description"

6. Keyboard Shortcuts

Ctrl+C - Cancel huidige actie
Ctrl+D - Exit Claude Code
Up/Down - Navigate history
Tab - Autocomplete

Troubleshooting

Rate Limiting

Error: Rate limit exceeded

Oplossing:

Wacht enkele minuten
Verminder prompt grootte
Gebruik /compact voor context

Authentication Failed

Error: Authentication failed

Oplossing:

claude logout
claude login

Context Too Large

Error: Context exceeds maximum

Oplossing:

Gebruik specifiekere prompts
Start nieuwe sessie met /clear
Maak een .claudeignore file

Slow Responses

Oorzaken:

Grote codebase
Complex prompt
Server load

Oplossing:

Wees specifieker
Exclude node_modules via .claudeignore
Probeer later opnieuw

Permission Denied

Error: Permission denied

Oplossing:

# Fix npm permissions
sudo chown -R $(whoami) ~/.npm
npm install -g @anthropic-ai/claude-code

Security Best Practices

1. Sensitive Data

Voeg nooit toe aan prompts:

API keys
Wachtwoorden
Personal data
Credentials

Gebruik environment variables:

> "Gebruik process.env.API_KEY voor authenticatie"

2. Code Review

Review altijd AI-gegenereerde code voor:

SQL injection
XSS vulnerabilities
Authentication bypasses
Data exposure

3. .claudeignore

Maak een .claudeignore file:

node_modules/
dist/
.env
.env.local
*.log
coverage/
.git/
credentials.json

Conclusie

Claude Code is een van de krachtigste tools voor moderne software development. Het combineert:

Agentic AI - Claude handelt, niet alleen adviseert
Codebase understanding - Volledige projectcontext
Multi-file editing - Wijzig alles tegelijk
Native Git - Volledige version control
MCP extensibility - Integreer met alle tools

De investering in Claude Pro ($20/maand) verdient zichzelf terug door verhoogde productiviteit. Of je nu bugs fixt, features bouwt, of code refactort - Claude Code maakt je significant sneller.

Aan de Slag

Installeer - npm install -g @anthropic-ai/claude-code
Login - claude login
Start - cd /je-project && claude
Experimenteer - Begin met simpele vragen
Schaal op - Tackle complexere taken

---

Meer leren over Claude Code? Check deze gerelateerde artikelen:

Claude Code Pricing - Alle kosten uitgelegd
Claude Code in VS Code - IDE integratie
Claude Code vs Cursor - Volledige vergelijking

Gestructureerd leren? Onze Claude AI Cursus behandelt Claude Code uitgebreid met hands-on oefeningen.