Claude Code op Windows: installatie & setup

Claude Code op Windows: Installatie & Setup

Wil je aan de slag met Claude Code op Windows, maar weet je niet waar te beginnen? Je bent niet alleen. Veel Nederlandse developers en vibe coders vinden de installatie van command-line tools op Windows uitdagender dan op Mac of Linux. Maar geen zorgen - in deze complete gids neem ik je stap-voor-stap mee door het hele proces.

Of je nu een doorgewinterde developer bent of net begint met vibe coding, na het lezen van deze handleiding heb je Claude Code draaiend op je Windows machine en kun je direct apps bouwen met AI.

Wat is Claude Code en waarom Windows?

Claude Code is de officiële CLI (Command Line Interface) van Anthropic die je directe toegang geeft tot Claude AI vanuit je terminal. In tegenstelling tot de browser versie op claude.ai, biedt Claude Code:

Directe integratie met je development workflow - Werk in je favoriete terminal en IDE zonder context te hoeven wisselen.

Snellere workflows - Genereer code, bestanden en hele projectstructuren met simpele commando's.

Scriptable AI - Bouw automatisering en CI/CD pipelines met Claude AI.

Lokale file access - Claude kan direct je lokale bestanden lezen en bewerken (met jouw toestemming).

Maar waarom specifiek een Windows gids? Simpel: Windows heeft een andere terminal omgeving dan Mac en Linux. PowerShell, Command Prompt en Windows Subsystem for Linux (WSL) hebben elk hun eigen quirks. Deze gids behandelt ze allemaal, zodat jij de setup kiest die bij jou past.

Systeemvereisten voor Claude Code

Voordat we beginnen, check even of je systeem aan deze minimale eisen voldoet:

Operating System:

Windows 10 (versie 1903 of hoger) of Windows 11
Voor WSL: Windows 10 versie 2004 of hoger (Build 19041+)

Hardware:

Minimaal 4GB RAM (8GB aanbevolen)
500MB vrije schijfruimte voor Node.js en Claude Code
Stabiele internetverbinding

Software:

Windows Terminal (sterk aanbevolen, gratis in Microsoft Store)
Een moderne code editor (VS Code aanbevolen)

Toegang:

Claude AI account (maak gratis aan op claude.ai)
Administrator rechten op je Windows machine (voor installatie)

Check je Windows versie via Windows + R → winver.

Stap 1: Node.js Installeren op Windows

Claude Code draait op Node.js, dus dit is de eerste en belangrijkste stap.

Download Node.js

Ga naar nodejs.org
Download de LTS versie (Long Term Support) - op het moment van schrijven is dat versie 20.x
Kies de Windows Installer (.msi) voor jouw systeem:

64-bit voor de meeste moderne Windows systemen
32-bit alleen als je een oudere machine hebt

Installatie uitvoeren

Open de gedownloade .msi file
Klik door de setup wizard:

Accept the license agreement
Belangrijk: Vink "Automatically install necessary tools" aan
Kies de standaard installatie locatie (meestal C:\Program Files\nodejs\)

Klik "Install" en wacht tot de installatie compleet is

Verificatie

Open een nieuwe PowerShell of Command Prompt (belangrijk: moet na installatie geopend worden) en check:

node --version

Je zou iets moeten zien als: v20.11.0

Check ook npm (Node Package Manager):

npm --version

Output: 10.2.4 of vergelijkbaar.

Troubleshooting:

Zie je 'node' is not recognized? Herstart je computer. Windows moet de PATH variabele updaten.
Nog steeds niet? Check of C:\Program Files\nodejs\ in je PATH staat (Systeeminstellingen → Geavanceerd → Omgevingsvariabelen).

Stap 2: Claude Code Installeren via npm

Nu Node.js draait, is het tijd voor het hoofdgerecht: Claude Code zelf.

Installatie commando

Open PowerShell of Windows Terminal en voer uit:

npm install -g @anthropic-ai/claude-code

De -g flag installeert Claude Code "global", wat betekent dat je het overal kunt gebruiken.

Wat gebeurt er?

Tijdens de installatie download npm:

De Claude Code CLI tool
Alle dependencies (ondersteunende packages)
Command executables

Dit duurt ongeveer 30-60 seconden afhankelijk van je internet snelheid.

Verificatie

Check of Claude Code correct is geïnstalleerd:

claude --version

Je zou de versie moeten zien: claude-code version 1.x.x

Troubleshooting: "claude is not recognized"

Dit gebeurt soms op Windows. Probeer:

Herstart je terminal - PowerShell moet de nieuwe PATH laden
Check npm prefix:

   npm config get prefix

Dit zou C:\Users\JouwNaam\AppData\Roaming\npm moeten zijn.

Voeg npm folder toe aan PATH:

Open "Environment Variables" (zoek in Start menu)
Onder "User variables", selecteer "Path"
Klik "Edit" → "New"
Voeg toe: C:\Users\JouwNaam\AppData\Roaming\npm
Klik OK en herstart je terminal

Stap 3: Claude Code Configureren

Nu Claude Code geïnstalleerd is, moeten we het koppelen aan je Claude AI account.

API Key verkrijgen

Ga naar console.anthropic.com
Log in met je Claude account
Navigeer naar "API Keys" in het menu
Klik "Create Key"
Geef je key een naam (bijv. "Windows Development")
Kopieer de key direct - je kunt hem maar één keer zien!

API Key opslaan in Windows

Je hebt twee opties: environment variable (aanbevolen) of config file.

Voor permanente setup:

Zoek "Environment Variables" in het Start menu
Klik "Environment Variables..." onderaan
Onder "User variables" klik "New"
Variable name: ANTHROPIC_API_KEY
Variable value: plak je API key
Klik OK en herstart je terminal

Test in een nieuwe PowerShell:

$env:ANTHROPIC_API_KEY

Je API key zou moeten verschijnen.

Alternatief kun je een .env file aanmaken in je project folder:

# Navigeer naar je project
cd C:\Users\JouwNaam\MijnProject

# Maak .env file aan
echo ANTHROPIC_API_KEY=jouw-api-key-hier > .env

Security tip: Voeg .env toe aan je .gitignore om je API key niet per ongeluk te committen!

Eerste test

Probeer je eerste Claude Code commando:

claude "Hallo, wat kun je voor me betekenen?"

Als alles goed gaat, krijg je een antwoord van Claude in je terminal. Gefeliciteerd - je hebt Claude Code draaien op Windows!

Terminal Tips voor Windows Gebruikers

Windows heeft meerdere terminal opties. Hier zijn de belangrijkste met hun voor- en nadelen:

Windows Terminal (Aanbevolen)

Modern, snel en ondersteunt tabs en splits.

Voordelen:

Mooie UI met customization opties
Meerdere tabs en panes
Unicode en emoji support (handig voor AI output)
Integratie met PowerShell, CMD én WSL

Installeren:

Gratis in Microsoft Store: zoek "Windows Terminal"
Of via commando: winget install Microsoft.WindowsTerminal

Tips:

Gebruik Ctrl+Shift+P voor command palette
Ctrl+Shift+T opent een nieuwe tab
Split screen met Alt+Shift++ (horizontaal) of Alt+Shift+- (verticaal)

PowerShell

Windows' standaard moderne shell.

Voordelen:

Pre-installed op Windows 10/11
Goede scripting mogelijkheden
Volledige .NET integratie

Claude Code tips:

Gebruik backticks (`) voor multi-line commando's
Aliassen werken: Set-Alias cl claude
Tab completion werkt voor commando's

Command Prompt (CMD)

De klassieke Windows terminal.

Voordelen:

Simpel en snel
Werkt altijd

Nadelen:

Beperkte scripting
Geen mooie Unicode rendering
Minder modern

Gebruik alleen als: PowerShell problemen geeft.

Windows Subsystem for Linux (WSL)

Een echte Linux environment binnen Windows - ideaal voor developers.

Zie volgende sectie voor volledige WSL setup!

WSL als Alternatief: De Linux Ervaring op Windows

Voor wie gewend is aan Mac/Linux workflows, of veel met vibe coding tools werkt die Linux prefereren, is WSL een game-changer.

Waarom WSL voor Claude Code?

Native Linux ervaring - Alle tutorials en documentatie werken 1-op-1.

Betere package management - apt, nvm en andere Linux tools werken perfect.

Compatibiliteit - Sommige dev tools werken beter op Linux/WSL dan native Windows.

Geen dual-boot nodig - Linux én Windows naast elkaar.

WSL Installeren

Op Windows 10 (versie 2004+) of Windows 11:

# In PowerShell als Administrator
wsl --install

Dit installeert WSL 2 en Ubuntu standaard. Herstart je computer na afloop.

Ubuntu Setup

Na reboot opent Ubuntu automatisch:

Kies een username (lowercase, zonder spaties)
Kies een wachtwoord
Wacht tot de setup compleet is

Node.js in WSL Installeren

Gebruik nvm (Node Version Manager) voor betere versie controle:

# Install nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

# Reload shell
source ~/.bashrc

# Install Node.js LTS
nvm install --lts

# Verify
node --version
npm --version

Claude Code in WSL

npm install -g @anthropic-ai/claude-code

Setup API key in WSL:

# Voeg toe aan .bashrc
echo 'export ANTHROPIC_API_KEY=jouw-api-key' >> ~/.bashrc
source ~/.bashrc

Test:

claude "Test vanuit WSL"

WSL + VS Code Integratie

De krachtigste combo:

Installeer "Remote - WSL" extension in VS Code
Open WSL terminal: Ctrl+Shift+P → "WSL: New Window"
VS Code draait nu in WSL context
Claude Code commando's werken direct in de integrated terminal

Pro tip: Gebruik code . in een WSL folder om die folder in VS Code te openen.

Veelvoorkomende Problemen en Oplossingen

Zelfs met een goede gids loop je soms tegen issues aan. Hier zijn de meest voorkomende en hun fixes:

Probleem: "npm is not recognized"

Oorzaak: Node.js PATH niet correct ingesteld.

Oplossing:

Herstart computer volledig (niet alleen terminal)
Check of Node.js installed is via Programs & Features
Herinstalleer Node.js indien nodig, zorg dat "Add to PATH" aangevinkt is

Probleem: "Permission denied" bij npm install

Oorzaak: npm probeert naar een protected folder te schrijven.

Oplossing:

# Run PowerShell als Administrator (rechtsklik → Run as Administrator)
npm install -g @anthropic-ai/claude-code

Of configure npm naar je user directory:

npm config set prefix "$env:USERPROFILE\npm"

Dan $env:USERPROFILE\npm toevoegen aan je PATH.

Probleem: Claude Code trager dan verwacht

Oorzaak: Netwerk latency of API rate limiting.

Oplossing:

Check je internet verbinding
Voor Claude Pro gebruikers: hogere rate limits
Gebruik --timeout flag: claude --timeout 30 "prompt"

Probleem: Unicode/Emoji renderen niet goed

Oorzaak: Oude terminal of font zonder Unicode support.

Oplossing:

Upgrade naar Windows Terminal
Installeer een Nerd Font (bijv. FiraCode Nerd Font)
In Windows Terminal settings: kies het nieuwe font

Probleem: "Failed to authenticate"

Oorzaak: API key niet correct ingesteld of verlopen.

Oplossing:

Verify je API key:

   $env:ANTHROPIC_API_KEY

Moet een string zijn die begint met sk-ant-
Genereer een nieuwe key op console.anthropic.com indien nodig
Update je environment variable en herstart terminal

Probleem: WSL commando's werken niet in Windows

Oorzaak: Je draait Linux commando's in PowerShell of omgekeerd.

Oplossing:

Voor Linux commando's: open Ubuntu/WSL terminal
Voor Windows commando's: gebruik PowerShell
In Windows Terminal: gebruik de dropdown om te wisselen tussen shells

VS Code Integratie: De Ultieme Setup

Claude Code wordt nóg krachtiger als je het integreert met je editor. VS Code is dé populairste keuze.

Claude Code Extension

Installeer de officiële extension:

Open VS Code
Ga naar Extensions (Ctrl+Shift+X)
Zoek "Claude Code"
Klik "Install"

Terminal Integratie

Gebruik de integrated terminal in VS Code:

Openen: Ctrl+ ` (backtick)

Default shell instellen:

Ctrl+Shift+P → "Terminal: Select Default Profile"
Kies PowerShell, CMD, of WSL (Ubuntu)

Split terminal:

Klik het split icon rechtsboven in terminal
Of Ctrl+Shift+5

Workflows voor vibe coding

Workflow 1: Claude genereert bestanden

# Claude maakt een nieuwe component
claude "Maak een React component Button.tsx met TypeScript, styled-components en hover states"

# Output wordt automatisch opgeslagen

Workflow 2: Code review

# Review een specifiek bestand
claude "Review dit bestand voor bugs en verbeteringen" < src/components/Header.tsx

Workflow 3: Debugging

# Analyseer error logs
claude "Leg deze error uit en geef een fix" < error.log

Keyboard Shortcuts Customizen

Voeg toe aan keybindings.json (File → Preferences → Keyboard Shortcuts → Open Keyboard Shortcuts JSON):

[
  {
    "key": "ctrl+alt+c",
    "command": "workbench.action.terminal.sendSequence",
    "args": { "text": "claude " }
  }
]

Nu opent Ctrl+Alt+C een terminal met claude vooraf ingevuld.

Tips voor Snellere Development

Aliassen in PowerShell:

Voeg toe aan je PowerShell profile ($PROFILE):

# Open profile
code $PROFILE

# Voeg aliassen toe:
Set-Alias cl claude
function cg { claude "Genereer $args" }
function cr { claude "Review code" < $args }

Nu kun je typen:

cl "prompt" in plaats van claude "prompt"
cg "een login form" om snel code te genereren
cr App.tsx voor quick reviews

Best Practices voor Claude Code op Windows

Nu je setup compleet is, hier zijn tips om het maximale eruit te halen:

Organiseer je Projecten

Maak een dedicated folder voor AI-gegenereerde projecten:

mkdir C:\Dev\ClaudeProjects
cd C:\Dev\ClaudeProjects

Gebruik Git voor version control:

git init
git add .
git commit -m "Claude generated initial code"

Gebruik Scripts voor Repetitieve Taken

Maak een claude-prompts.ps1:

function New-Component {
    param($Name)
    claude "Maak een React component $Name.tsx met TypeScript, props interface en styled-components"
}

function Generate-API {
    param($Endpoint)
    claude "Maak een Express.js API endpoint voor $Endpoint met TypeScript, error handling en validatie"
}

Gebruik: New-Component "Dashboard" of Generate-API "users"

Security & Privacy

Nooit API keys in code committen:

# Voeg toe aan .gitignore
echo ".env" >> .gitignore
echo "*.key" >> .gitignore

Sensitive data beschermen:

Claude Code heeft toegang tot bestanden die je deelt. Wees bewust:

Deel geen bestanden met passwords of secrets
Review generated code op security issues
Gebruik environment variables voor credentials

Performance Optimalisatie

Cache prompts voor snellere responses:

Claude onthoud context binnen een sessie. Start een interactive sessie voor gerelateerde vragen:

claude --interactive

Limiteer output voor lange responses:

claude --max-tokens 500 "Leg uit..."

Integratie met andere Tools

GitHub Integration:

# Generate commit messages
git diff | claude "Schrijf een goede commit message voor deze changes"

Docker:

claude "Maak een Dockerfile voor een Node.js app met multi-stage builds"

CI/CD:

Gebruik Claude Code in GitHub Actions voor automated code reviews.

Wil je meer leren over het effectief inzetten van AI in je development workflow? Check onze cursussen voor hands-on vibe coding training.

Conclusie: Klaar om te Bouwen met Claude Code

Je hebt nu een volledig werkende Claude Code setup op Windows. Of je kiest voor de native PowerShell ervaring, de Linux-achtige WSL workflow, of een mix van beiden - je hebt de tools om apps te bouwen met AI als je co-pilot.

Wat je hebt geleerd:

✅ Node.js en npm installeren op Windows ✅ Claude Code opzetten via npm ✅ API authentication configureren ✅ Terminal opties vergelijken (PowerShell, CMD, WSL) ✅ WSL installeren voor een Linux-like ervaring ✅ Problemen oplossen en troubleshooten ✅ VS Code integratie voor maximale productiviteit ✅ Best practices voor veilig en efficiënt gebruik

Volgende Stappen

Nu de technische setup compleet is, is het tijd om écht te gaan bouwen:

Stap 1: Experimenteer Probeer simpele commando's, vraag Claude code te schrijven, laat het bestanden genereren. Leer hoe Claude 'denkt' en reageert op verschillende prompts.

Stap 2: Bouw je eerste project Start klein: een todo app, een dashboard, een API. Gebruik Claude Code om de code te genereren en te verfijnen.

Stap 3: Leer advanced technieken Verdiep je in prompt engineering, chain-of-thought prompting en complexere architectuur met Claude. Bekijk onze Claude AI Cursus voor een gestructureerd leerpad.

Stap 4: Join de community Vibe coding groeit explosief. Verbind met andere Nederlandse developers die apps bouwen met AI. Deel je learnings, stel vragen, bouw samen.

Hulp Nodig?

Loop je vast of heb je vragen over je Windows setup? Hier zijn resources:

📖 Officiële documentatie: docs.anthropic.com 🎓 Gestructureerde training: Vibe Coding Academy cursussen 💬 Community: Join onze Discord voor directe hulp 📧 Contact: Mail ons voor specifieke vragen

Pro Tip: Bookmark deze gids. Je zult hem vaker nodig hebben dan je denkt - bijvoorbeeld als je Claude Code op een nieuwe machine moet installeren, of als je een collega wilt helpen met de setup.

De toekomst van software development is hier, en het spreekt Nederlands (en Engels, en Python, en TypeScript...). Met Claude Code op je Windows machine heb je een krachtige AI-partner in je terminal, klaar om samen te bouwen.

Ready to vibe code? Open je terminal en laat Claude je eerste app bouwen. De enige limiet is je eigen creativiteit.

Veel succes met Claude Code op Windows - en laat zien wat je bouwt! 🚀