Claude Code installeren: stap voor stap (Mac en Windows)

Claude Code installeren doe je met één commando in de terminal: op Mac en Linux plak je een regel van Anthropic, op Windows werkt dat via PowerShell of CMD. Daarna log je in met een betaald Claude-account en start je met claude. Wil je helemaal geen terminal gebruiken, dan is de desktop-app de makkelijkere route. Beide staan hieronder, met de commando's zoals ze nu in de documentatie van Anthropic staan.

Ben je nog niet zeker wat het programma doet? Lees dan eerst wat Claude Code is. Hier gaat het alleen om het installeren.

Wat heb je nodig?

Volgens de documentatie draait Claude Code op:

• Mac: macOS 13.0 of nieuwer.
• Windows: Windows 10 versie 1809 of nieuwer, of Windows Server 2019 of nieuwer.
• Linux: Ubuntu 20.04+, Debian 10+ of Alpine Linux 3.19+.
• Hardware: minstens 4 GB werkgeheugen en een x64- of ARM64-processor.
• Internet: verplicht. Claude Code werkt niet offline.
• Account: Claude Pro, Max, Team, Enterprise of een Claude Console-account. Het gratis Claude-abonnement geeft geen toegang.

Nederland staat op de lijst van landen waar Anthropic zijn diensten aanbiedt, dus je hoeft niets om te leiden. Wat het kost lees je bij wat Claude Code kost, en de abonnementen zelf staan bij Claude Pro en Max.

Welke manier past bij jou?

Weet je het niet, kies dan het installatiescript. Het is de route die Anthropic zelf het eerst noemt, en het houdt zichzelf up-to-date.

Claude Code installeren op een Mac

1. Open Terminal (zoek met Spotlight op "Terminal").
2. Plak dit commando en druk op Enter:

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

3. Wacht tot het klaar is. Het commando laat tijdens het downloaden geen voortgang zien, dus een stil scherm is normaal.
4. Open een nieuw terminalvenster en controleer de installatie:

claude --version

Je krijgt een versienummer te zien, gevolgd door "(Claude Code)".

Gebruik je liever Homebrew, dan kan dat ook:

brew install --cask claude-code

Homebrew kent twee varianten. claude-code volgt het stabiele kanaal, dat ongeveer een week achterloopt en versies met grote problemen overslaat. claude-code@latest krijgt nieuwe versies meteen. Bij Homebrew moet je zelf updaten.

Claude Code installeren op Windows

Op Windows kun je Claude Code rechtstreeks installeren (native) of binnen WSL, de Linux-omgeving van Windows. Voor de meeste mensen is native de simpelste keuze. Je hebt geen beheerdersrechten nodig.

Kijk eerst welk venster je open hebt. Staat er PS C:\ voor de cursor, dan zit je in PowerShell. Staat er C:\ zonder PS, dan is het CMD. Het commando verschilt per venster, en het verkeerde commando geeft een foutmelding.

In PowerShell:

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

In CMD:

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

Open daarna een nieuw venster en voer claude --version uit. Een versienummer betekent dat het gelukt is.

Gebruik je liever WinGet, dan werkt dit in PowerShell:

winget install Anthropic.ClaudeCode

Ook hier moet je zelf updaten.

Heb je Git for Windows nodig?

Anthropic raadt Git for Windows aan, maar het is optioneel. Met Git gebruikt Claude Code de Bash-shell, zonder Git valt het terug op PowerShell. Voor een eerste kennismaking kun je Git dus overslaan.

Native of WSL?

Kies je WSL, open dan je WSL-distributie en voer daar het Linux-commando uit (curl -fsSL https://claude.ai/install.sh | bash). Je installeert en start claude dan binnen de WSL-terminal, niet vanuit PowerShell of CMD. Staan je projecten op de Windows-schijf (/mnt/c/), dan kan zoeken in WSL minder resultaten geven. Anthropic adviseert dan de projecten in het Linux-bestandssysteem te zetten of native Windows te gebruiken.

Claude Code installeren op Linux

Open een terminal en gebruik hetzelfde commando als op de Mac:

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

Controleer daarna met claude --version. Er zijn ook apt-, dnf- en apk-opslagplaatsen voor Debian, Fedora/RHEL en Alpine. Die vragen meer stappen (een ondertekeningssleutel toevoegen en controleren), dus volg daarvoor de officiële instructies. Op Alpine heb je eerst bash, curl, libgcc, libstdc++ en ripgrep nodig.

Installeren met npm

Ook dat kan nog:

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

Het pakket vereist Node.js 22 of nieuwer. Draai je een oudere versie, dan geeft npm een waarschuwing (EBADENGINE), maar de installatie loopt gewoon door, omdat het pakket een kant-en-klaar programma binnenhaalt dat Node.js zelf niet gebruikt. Gebruik nooit sudo npm install -g: dat geeft rechtenproblemen. Krijg je toch permissiefouten, dan raadt Anthropic aan over te stappen op het installatiescript. Veel oudere gidsen noemen npm en Node.js 18 als hoofdroute. Dat klopt niet meer: het script is nu de aanbevolen weg en heeft geen Node.js nodig.

Zonder terminal: de desktop-app

Wil je geen commando's typen, download dan de Claude-app voor Mac of Windows. Installeer hem, start Claude, log in en klik bovenin de zijbalk op het tabblad Code. De app bevat Claude Code, je hoeft de CLI of Node.js niet apart te installeren. Je hebt wel een betaald abonnement nodig. Voor Linux is de app in beta, via apt. Hoe de installatie van de app zelf gaat staat in onze gids over Claude Desktop installeren.

Als extensie in je editor

Voor VS Code zoek je in het extensiescherm (Cmd+Shift+X op de Mac, Ctrl+Shift+X op Windows en Linux) naar "Claude Code". Daarna open je met Cmd+Shift+P of Ctrl+Shift+P het opdrachtenpalet, typ je "Claude Code" en kies je Open in New Tab. Dezelfde extensie is er voor Cursor. Voor JetBrains-editors installeer je de Claude Code-plug-in uit de JetBrains Marketplace en start je de editor opnieuw op. Die plug-in heeft de CLI nodig, die je apart installeert zoals hierboven.

Inloggen en de eerste keer starten

Open een terminal in de map waar je mee wilt werken en typ:

cd /pad/naar/jouw/project
claude

Vervang het pad door je eigen map. Bij de eerste keer vraagt Claude Code je in te loggen. Een browservenster opent, daar volg je de aanwijzingen. Je kunt inloggen met:

• een Claude Pro-, Max-, Team- of Enterprise-account (de aanbevolen route);
• een Claude Console-account, waarbij je met vooruitbetaalde tegoeden per verbruik betaalt;
• een cloudaanbieder: Amazon Bedrock, Google Cloud's Agent Platform of Microsoft Foundry;
• een intern Claude apps gateway, als je organisatie dat heeft.

Staat de omgevingsvariabele ANTHROPIC_API_KEY ingesteld en keur je het gebruik van die sleutel goed, dan slaat Claude Code het inlogscherm over. Je inloggegevens worden bewaard, dus je hoeft niet elke keer opnieuw in te loggen. Wissel je later van account, typ dan /login in een lopende sessie.

Probeer daarna een veilige eerste vraag, zoals "what does this project do?". Claude Code leest de bestanden zelf, je hoeft niets handmatig toe te voegen. Met /help zie je alle commando's. Begin liefst in een map waarvan je een kopie hebt. Op Pro, Max en Team draaien nieuwe sessies standaard in de automatische modus, waarin een classifier riskante acties tegenhoudt. Wil je elke wijziging zelf goedkeuren, wissel dan met Shift+Tab van modus.

Updaten

Bij het installatiescript gaat dat vanzelf: Claude Code controleert bij het opstarten en regelmatig tijdens het draaien op updates, installeert ze op de achtergrond en gebruikt ze de volgende keer dat je start. Wil je meteen bijwerken:

claude update

Bij een installatie met Homebrew, WinGet, apt, dnf of apk gebeurt er niets automatisch. Gebruik dan:

• Homebrew: brew upgrade claude-code (of brew upgrade claude-code@latest)
• WinGet: winget upgrade Anthropic.ClaudeCode
• npm: npm install -g @anthropic-ai/claude-code@latest

Voor npm waarschuwt Anthropic voor npm update -g: dat brengt je niet altijd naar de nieuwste versie.

Verwijderen

Wat je moet doen hangt af van hoe je installeerde.

Installatiescript op Mac, Linux of WSL:

rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude

Installatiescript op Windows (PowerShell):

Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force
Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force

Andere methoden: brew uninstall --cask claude-code, winget uninstall Anthropic.ClaudeCode of npm uninstall -g @anthropic-ai/claude-code.

Je instellingen en gespreksgeschiedenis staan in de map ~/.claude en het bestand ~/.claude.json. Die blijven staan na het verwijderen. Verwijder je ze ook, dan raak je al je instellingen, toegestane tools, MCP-koppelingen en sessiegeschiedenis kwijt. De desktop-app en de editor-extensies schrijven ook naar die map, dus verwijder die eerst als je alles wilt opruimen.

Veelvoorkomende fouten

Op de pagina Troubleshoot installation and login legt Anthropic de meeste fouten uit. Een voor een de vaakste.

"command not found: claude" of "claude is not recognized"

De installatie is gelukt, maar de map waar claude staat zit nog niet in je PATH (de lijst mappen waarin je terminal naar programma's zoekt). Het programma staat in ~/.local/bin/claude op Mac en Linux en in %USERPROFILE%\.local\bin\claude.exe op Windows.

Probeer eerst het simpelste: sluit je terminal en open een nieuwe. Een venster dat al openstond houdt zijn oude PATH. Helpt dat niet:

Mac met zsh (de standaard):

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Linux met bash:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

Windows PowerShell:

$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

Start daarna je terminal opnieuw en controleer met claude --version. Gebruik je een terminal binnen een editor, sluit dan de hele editor en open hem opnieuw. Heb je alleen de VS Code-extensie geïnstalleerd, dan bestaat claude in de terminal niet: de extensie bevat een eigen kopie. Voer dan ook het installatiescript uit.

"permission denied" bij het aanpassen van .zshrc of .bashrc

Je gebruiker mag dat bestand niet wijzigen. Bekijk met ls -l ~/.zshrc wie de eigenaar is. Is dat een andere gebruiker zoals root, gebruik dan sudo chown $(whoami) ~/.zshrc. Ben jij de eigenaar, dan helpt chmod u+w ~/.zshrc. Voer daarna de PATH-commando's opnieuw uit.

Foutmeldingen op Windows over het verkeerde commando

• 'irm' is not recognized: je zit in CMD. Open PowerShell via het Startmenu, of gebruik het CMD-commando.
• The token '&&' is not a valid statement separator: je zit in PowerShell maar plakte het CMD-commando. Gebruik het PowerShell-commando.
• A parameter cannot be found that matches parameter name 'fsSL': je plakte het Mac/Linux-commando in PowerShell. Gebruik irm https://claude.ai/install.ps1 | iex.

"syntax error near unexpected token '<'" of een 403

Het script kwam als webpagina binnen in plaats van als script, bijvoorbeeld door een netwerkfilter. Anthropic beschrijft hiervoor verschillende oplossingen en alternatieve installatiemethoden in de installatiehulp.

Node.js-versie

Bij het installatiescript speelt Node.js geen rol. Alleen bij npm heb je Node.js 22 of nieuwer nodig, en ook dan blokkeert een oudere versie de installatie niet maar geeft alleen een waarschuwing. Staat npm op een Windows-pc in de weg met de melding running scripts is disabled on this system, dan kun je Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser uitvoeren, of beter: het PowerShell-installatiescript gebruiken.

Controleren wat er mis is

Draai in de terminal:

claude doctor

Dat toont zonder een sessie te starten de gezondheid van je installatie en instellingen, met waarschuwingen en suggesties. Kom je er niet uit, dan verwijst Anthropic naar de GitHub-pagina van Claude Code en naar het commando /feedback binnen Claude Code.

Veelgestelde vragen

Hoe installeer ik Claude Code op Windows?

Open PowerShell en voer irm https://claude.ai/install.ps1 | iex uit. In CMD gebruik je curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd. Open daarna een nieuw venster en typ claude --version. Git for Windows is aanbevolen, maar niet verplicht.

Is Claude Code gratis te installeren?

Het programma installeren kost niets, maar gebruiken kan alleen met een betaald Claude-abonnement (Pro, Max, Team of Enterprise), een Console-account met tegoed of een cloudaanbieder. Het gratis Claude-abonnement geeft geen toegang.

Heb ik Node.js nodig voor Claude Code?

Niet met het installatiescript, Homebrew, WinGet of de desktop-app. Alleen de npm-methode vraagt Node.js 22 of nieuwer.

Kan ik Claude Code gebruiken zonder terminal?

Ja, via de desktop-app voor Mac en Windows (tabblad Code) of in de browser op claude.ai/code. Daarvoor installeer je niets, maar je hebt wel een betaald abonnement nodig.

Moet ik Claude Code zelf updaten?

Bij het installatiescript niet, dat gaat automatisch. Bij Homebrew, WinGet en de Linux-pakketbeheerders wel. Met claude update forceer je een update.

Bronnen

• Claude Code docs: Advanced setup
• Claude Code docs: Quickstart
• Claude Code docs: Troubleshoot installation and login
• Claude Code docs: Overview
• Claude Code docs: Get started with the desktop app
• Claude Code docs: Troubleshooting
• Auto mode is now the default in Claude Code (Anthropic)
• Claude Code: productpagina
• Anthropic: ondersteunde landen