Hoe installeer je Claude Code? Stap voor stap voor beginners

Je opent een zwart venster op je computer, typt in gewoon Nederlands of Engels wat je wilt, en een paar seconden later staan er bestanden op je schijf die er nog niet waren. Geen menu’s, geen knoppen, alleen tekst. Dat is Claude Code.

Het klinkt intimiderend als je nog nooit een terminal hebt opengehad. Dat is het niet. De installatie bestaat uit één commando kopiëren, één keer inloggen en dan beginnen. In deze handleiding lopen we het samen door, inclusief de foutmeldingen die je onderweg tegen kunt komen.

Wat is Claude Code eigenlijk?

Claude Code is een versie van Claude die in je terminal draait en daadwerkelijk toegang heeft tot je bestanden. Waar je in de browser tekst kopieert en plakt, kan Claude Code zelf lezen, schrijven, commando’s uitvoeren en fouten opsporen in een map op je computer.

Dat maakt het geschikt voor programmeren, maar zeker niet alleen daarvoor. Mensen gebruiken het om documenten te verwerken, data op te schonen, websites te bouwen en repetitief werk te automatiseren.

Wat je nodig hebt voordat je begint

Twee dingen, en het eerste is belangrijker dan mensen denken.

Een betaald Claude-account. Claude Code werkt met een Pro-, Max-, Team-, Enterprise- of Console-account. Het gratis plan geeft geen toegang. Als je nog geen abonnement hebt, is dit het moment om er een te nemen, want de installatie loopt anders vast bij het inloggen.

Een computer die aan de eisen voldoet. Claude Code draait op macOS 13.0 of nieuwer, Windows 10 (versie 1809) of nieuwer, en op Linux vanaf Ubuntu 20.04, Debian 10 of Alpine 3.19. Verder heb je minimaal 4 GB RAM nodig, een x64- of ARM64-processor en een internetverbinding.

Je hebt géén Node.js, Docker of andere software nodig. Dat was in het verleden anders, en je komt online nog oude handleidingen tegen die wel om Node vragen. Negeer die.

Liever geen terminal? Dan hoeft het niet

Voordat we de terminal induiken: er is een grafische variant. De Claude Desktop-app geeft je Claude Code met knoppen en vensters in plaats van commando’s. Voor wie de terminal echt niets vindt is dat een volwaardig alternatief, en je kunt later altijd nog overstappen.

Blijf je lezen? Dan gaan we het gewoon doen.

Stap 1: open de terminal

De terminal is een programma dat al op je computer staat. Je hoeft niets te downloaden.

Op macOS open je Spotlight met Cmd + spatiebalk, typ je “Terminal” en druk je op Enter.

Op Windows zoek je in het startmenu naar “Terminal” of “PowerShell” en open je dat. Je hoeft het niet als administrator te starten.

Op Linux gebruik je meestal Ctrl + Alt + T, of je zoekt naar “Terminal” in je applicatiemenu.

Wat je nu ziet is een venster met een tekstregel die eindigt op een knipperende cursor. Dat is het. Hier ga je typen.

Stap 2: voer het installatiecommando uit

Kopieer de regel die bij jouw systeem hoort, plak hem in de terminal en druk op Enter.

Voor macOS, Linux en WSL:

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

Voor Windows PowerShell:

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

Voor Windows CMD:

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Weet je niet of je in PowerShell of CMD zit? Kijk naar het begin van de regel. Staat er PS C:\, dan zit je in PowerShell. Staat er alleen C:\ zonder die PS, dan is het CMD. Gebruik je het verkeerde commando, dan krijg je een foutmelding over een ongeldige scheidingsoperator of over irm die niet herkend wordt. Geen paniek, pak dan simpelweg het andere commando.

De installatie duurt een halve minuut tot een minuut. Je ziet wat tekst voorbij scrollen. Dat is normaal.

Stap 3: controleer of het gelukt is

Typ dit en druk op Enter:

claude --version

Als alles goed is gegaan, krijg je een versienummer te zien, bijvoorbeeld 2.1.211 (Claude Code).

Krijg je in plaats daarvan de melding dat het commando niet gevonden is? Sluit dan je terminal helemaal af en open een nieuw venster. Vaak is dat genoeg, omdat de terminal het nieuwe programma pas na een herstart oppikt.

Wil je een uitgebreidere controle, dan is er een ingebouwd diagnoseprogramma:

claude doctor

Dat laat zien welk installatietype actief is, of je instellingen kloppen en of er waarschuwingen zijn. Handig commando om te onthouden voor als er later iets misgaat.

Stap 4: log in

Ga eerst naar de map waarin je wilt werken. Heb je nog geen project, maak dan iets aan om mee te experimenteren:

mkdir mijn-eerste-project
cd mijn-eerste-project

Start dan Claude Code:

claude

Je browser opent en vraagt je in te loggen op je Claude-account. Na goedkeuring keer je terug naar de terminal en zit je in een gesprek.

Opent je browser niet? Dan print Claude Code een webadres in de terminal. Kopieer dat naar een browser, rond het inloggen af en plak de code die je terugkrijgt in de terminal.

Stap 5: de eerste stap die echt verschil maakt

Je zit nu in een sessie. Typ het volgende en druk op Enter:

/init

Claude bekijkt je map, zoekt uit wat voor project het is en maakt een bestand aan met de belangrijkste afspraken. Dat bestand heet CLAUDE.md en wordt bij elke volgende sessie automatisch meegelezen, zodat je niet elke keer opnieuw hoeft uit te leggen hoe je project in elkaar zit.

Bij een lege map heeft dit weinig zin, maar zodra je een echt project opent is dit het eerste wat je doet.

Andere manieren om te installeren

Het commando hierboven is de aanbevolen route, en voor de meeste mensen de enige die ze nodig hebben. Er zijn alternatieven, vooral interessant als je al met een pakketbeheerder werkt.

Via Homebrew op macOS:

brew install --cask claude-code

Via WinGet op Windows:

winget install Anthropic.ClaudeCode

Via npm, als je dat toch al gebruikt:

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

Voor de npm-route heb je Node.js 22 of nieuwer nodig. Werk je met een oudere versie, dan krijg je een waarschuwing maar loopt de installatie meestal alsnog door, omdat het pakket een los programma downloadt dat Node niet gebruikt.

Eén ding is belangrijk: gebruik nooit sudo bij de npm-installatie. Dat lijkt de oplossing als je een foutmelding over rechten krijgt, maar het maakt bestanden aan die je gebruiker niet meer kan bewerken. Daar heb je bij elke volgende installatie last van.

Let er ook op dat Homebrew, WinGet en de Linux-pakketbeheerders zichzelf niet automatisch bijwerken. De standaardinstallatie doet dat wel, op de achtergrond.

Een aanrader op Windows

Installeer op Windows ook Git for Windows. Dat is niet verplicht, maar het geeft Claude Code toegang tot Git Bash, waardoor het shell-commando’s op dezelfde manier kan uitvoeren als op macOS en Linux. Zonder Git for Windows valt Claude Code terug op PowerShell, wat werkt maar op sommige punten anders reageert.

Werk je in WSL, dan heb je dit niet nodig. Daar installeer en start je Claude Code binnen de WSL-terminal, niet in PowerShell.

Bijwerken

De standaardinstallatie werkt zichzelf op de achtergrond bij. Het downloaden gebeurt terwijl je werkt, de nieuwe versie wordt actief bij je volgende start. Wil je niet wachten:

claude update

Waar je nu bent

Claude Code staat op je computer, je bent ingelogd en je hebt een eerste sessie gehad. De installatie is het makkelijke deel. Het echte leerwerk zit in leren formuleren wat je wilt, en in het opbouwen van een setup die je project kent.

Twee dingen zijn daarbij het meest waard om als volgende uit te zoeken: het bestand CLAUDE.md, waarmee je vastlegt wat Claude in elke sessie moet weten, en skills, waarmee je terugkerende opdrachten in één commando vastlegt. Daarover schreven we aparte handleidingen.