Claude Code installeren: kiezen, installeren en je eerste taak
Claude Code installeer je met één commando in je terminal: curl -fsSL https://claude.ai/install.sh | bash op Mac en Linux, irm https://claude.ai/install.ps1 | iex in PowerShell op Windows. Bij onze tests duurde dat 16 seconden op een Mac zonder eerdere installatie, 6 op Linux en 26 op een Windows 10-pc. Daarna werkte claude op alle drie nog niet, omdat de installer de programmamap niet aan je zoekpad toevoegt. Hieronder lees je eerst welke variant je nodig hebt, dan de installatie, de fouten die we tegenkwamen en een eerste taak die je meteen kunt proberen.
Zelf getest op 11 november 2026.
Eerst kiezen: terminal, app of editor
Claude Code bestaat in drie vormen: in de terminal, in de desktop-app en als extensie in je editor. Met deze drie vragen weet je welke je nodig hebt.
- Heb je nog nooit een terminal geopend? Neem dan de Claude desktop-app. Daarin werk je met Claude Code via vensters en knoppen, zonder terminal. Scripts en taken die vanzelf op een server draaien, kun je er niet mee maken; daarvoor heb je later de terminalversie nodig.
- Werk je de hele dag in VS Code of een editor die daarop lijkt? Installeer dan de extensie
anthropic.claude-code. Die werkt in VS Code 1.94 of nieuwer en volgens de documentatie ook in Cursor. Let op: de extensie zet het commandoclaudeniet in je terminal. - Wil je Claude Code in de terminal, of laten draaien in scripts en op een server? Installeer dan de terminalversie. Dat is de rest van deze pagina.
Alle drie gebruiken dezelfde instellingen en gespreksgeschiedenis, in de map .claude in je gebruikersmap. Wissel je later van vorm, dan neem je alles mee.
Wat je nodig hebt
- macOS 13 of nieuwer, Windows 10 (versie 1809) of nieuwer, of Linux: Ubuntu 20.04, Debian 10 of Alpine 3.19 en nieuwer.
- Minstens 4 GB werkgeheugen en een internetverbinding.
- Een betaald abonnement (Pro, Max, Ultra, Team of Enterprise) of een Console-account met API-tegoed. Met het gratis account van claude.ai werkt Claude Code niet.
- Geen beheerdersrechten en geen Node.js. Het programma komt in je eigen gebruikersmap terecht.
Het commando per systeem
| Systeem | Commando | Updates |
|---|---|---|
| Mac, Linux, WSL | curl -fsSL https://claude.ai/install.sh | bash | Vanzelf |
| Windows (PowerShell) | irm https://claude.ai/install.ps1 | iex | Vanzelf |
| Mac met Homebrew | brew install --cask claude-code | Zelf: brew upgrade claude-code |
| Windows met WinGet | winget install Anthropic.ClaudeCode | Zelf: winget upgrade Anthropic.ClaudeCode |
| Debian, Ubuntu (apt) | Pakketbron van Anthropic toevoegen, dan sudo apt install claude-code | Met je gewone systeemupdates |
| Via npm (Node.js 22+) | npm install -g @anthropic-ai/claude-code | Vanzelf, als npm zonder sudo kan schrijven |
Wij kiezen de bovenste twee regels. Die werken zichzelf bij zonder dat je eraan hoeft te denken. Op Windows moet je na de installatie de map .local\bin zelf aan het pad toevoegen, net als op Mac en Linux, maar met PowerShell-commando's. Die staan uitgewerkt in Claude Code installeren op Windows. De Homebrew-variant claude-code volgt het stabiele kanaal, dat volgens de handleiding meestal zo'n week achterloopt.
(opent op ware grootte)Installeren op Mac en Linux
Open de terminal
Op de Mac zoek je met Cmd+spatie naar Terminal. Op Linux open je je gewone terminal. Ga niet eerst naar een projectmap; de installatie komt toch in je gebruikersmap.
bashcurl -fsSL https://claude.ai/install.sh | bashLees de laatste regels van de uitvoer
Bij ons meldde de installer op beide machines dat versie 2.1.322 geïnstalleerd was, en daaronder een waarschuwing:
Native installation exists but ~/.local/bin is not in your PATH. PATH is de lijst met mappen waarin je computer naar programma's zoekt. De installer zet de map er niet zelf in en past je shellbestand ook niet aan: het bestand.zshrcop onze Mac was na de installatie onveranderd.Zet de map in je zoekpad
Op de Mac (shell zsh) voeg je de regel toe aan
.zshrc. Op Linux met bash vervang je.zshrcdoor.bashrc. Doe dit één keer, anders staat de regel er dubbel in.bashecho 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrcControleer de installatie
Typ
claude --version. Bij ons gaf dat2.1.322 (Claude Code). Metclaude doctorkrijg je een volledig overzicht zonder dat er een sessie start, met onder meer het platform, of updates aan staan en welke waarschuwingen er openstaan.bashclaude --version claude doctor
Inloggen en je eerste taak
Ga met cd naar de map van een project en typ claude. Je browser opent een inlogscherm; log in met het account waarmee je je abonnement betaalt. Start Claude Code altijd in een projectmap: het mag lezen in de map waarin je het start en alles daaronder.
Een goede eerste taak is klein, controleerbaar en raakt een echt bestand. Wij gebruiken deze: zet een exportbestand met facturen in een lege map en vraag om een script dat de totalen per klant uitrekent. Je ziet dan in één keer hoe Claude Code een bestand leest, code schrijft, die uitvoert en de uitkomst laat zien.
Schrijf een Python-script totaal.py dat facturen.csv inleest en het totaalbedrag
per klant print, gesorteerd van hoog naar laag. Draai het daarna één keer en laat
de uitkomst zien.De opdracht die wij gaven, in een map met alleen facturen.csv (kolommen datum, klant, bedrag).
Wij deden dit op Linux met een bestand van vier facturen. Na 9 seconden stond totaal.py in de map en kwam deze uitkomst terug: C: 300.00, A: 165.75, B: 80.00. Dat klopte met het bestand. Claude Code had uit zichzelf Decimal gebruikt voor de bedragen, zodat er geen afrondingsfouten in de centen sluipen. Wij telden de bedragen met de hand na: klant A had twee facturen, van 120,50 en 45,25, samen 165,75. Zo'n controle op een klein bestand laat je zien wat je van de uitkomst kunt verwachten, voordat je Claude Code op echte administratie loslaat.
Foutmeldingen en wat je eraan doet
De meldingen met ‘gezien’ in de laatste kolom kwamen we zelf tegen. De andere komen uit de officiële probleemgids.
| Melding | Oorzaak | Wat je doet | Bron |
|---|---|---|---|
command not found: claude | ~/.local/bin staat niet in je zoekpad. | Stap 3 hierboven, daarna een nieuw terminalvenster. | gezien |
Multiple installations found in claude doctor | Er staat nog een oude npm-installatie naast de nieuwe. | Verwijder de oude met npm uninstall -g @anthropic-ai/claude-code. Anders bepaalt de volgorde in je zoekpad welke versie start. | gezien |
Not logged in · Please run /login | Je startte Claude Code zonder in te loggen, bijvoorbeeld met claude -p. | Start eenmaal claude zonder opties en log in via de browser. | gezien |
syntax error near unexpected token '<' of een 403 | Je kreeg een webpagina terug in plaats van het script, vaak door een proxy of een land waar de dienst niet beschikbaar is. | Volg de probleemgids, of installeer via Homebrew, WinGet of npm. | probleemgids |
EBADENGINE bij npm | Je Node.js is ouder dan versie 22. | Een waarschuwing, geen fout: claude werkt toch. Liever: gebruik de installer. | probleemgids |
Rechtenfout bij npm install -g | De globale npm-map is niet van jou. | Nooit sudo npm install -g gebruiken; kies de installer. | probleemgids |
Verwijderen zonder restjes
De handleiding noemt twee regels om het programma te verwijderen. Na onze test op de Mac bleef er daarna nog een lege map ~/.local/state/claude achter, met daarin een map locks. Die haal je met de derde regel weg. Je instellingen en geschiedenis staan in ~/.claude en ~/.claude.json; verwijder die alleen als je helemaal opnieuw wilt beginnen.
rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude
rm -rf ~/.local/state/claudeVragen
Kun je Claude Code gratis installeren en gebruiken?
Installeren is gratis, gebruiken niet. Je hebt minstens een Pro-abonnement nodig of een Console-account met API-tegoed. Met het gratis account van claude.ai kun je niet inloggen in Claude Code.
Heb je adminrechten nodig om Claude Code te installeren?
Nee. De installer schrijft alleen in je eigen gebruikersmap, op Mac, Linux en Windows. Alleen de route via de apt-pakketbron op Linux vraagt sudo.
Kun je Claude Code in VS Code of Cursor gebruiken?
Ja. Installeer de extensie anthropic.claude-code uit de extensiewinkel; volgens de documentatie werkt die ook in Cursor. De extensie heeft een eigen kopie van Claude Code. Wil je ook claude in de terminal typen, installeer dan ook de terminalversie.
Wat is een goede eerste taak na installatie?
Iets kleins met een echt bestand waarvan je de uitkomst zelf kunt nakijken, zoals een script dat de totalen uit een export uitrekent. Na tien minuten weet je dan hoe Claude Code leest, schrijft en uitvoert.
Hoe weet ik welke versie ik heb en of updates aan staan?
claude --version geeft de versie. claude doctor laat zien of automatische updates aan staan en welk kanaal je volgt: latest of stable.
Bronnen
- Claude Code: Advanced setup (systeemeisen, alle installatieroutes, verwijderen) gecontroleerd op
- Claude Code: Quickstart gecontroleerd op
- Claude Code: Troubleshoot installation and login gecontroleerd op
- Claude Code: Use Claude Code in VS Code (extensie, Cursor) gecontroleerd op
Meer over claude in de praktijk
- Claude Code installeren op WindowsClaude Code op Windows installeren met één commando in PowerShell. Met de stap die de installer overslaat, de keuze voor WSL en de bekende foutmeldingen.
- Claude Desktop: downloaden, installeren en goed instellenDe Claude desktop-app voor Windows, Mac en Linux: waar je hem downloadt, wat hij kost, wat hij meer kan dan de browser en wat je na installatie instelt.
- Claude Code gebruiken: een handleiding met één echt projectjeHoe je Claude Code gebruikt, uitgelegd met één echt projectje: plannen, bouwen, nakijken en vastleggen. Met alle opdrachten woord voor woord en de uitkomst.
- MCP-servers in Claude Code: toevoegen, testen en weghalenEen MCP-server toevoegen aan Claude Code, testen en weer weghalen. Op een Windows-pc getest met drie servers, met de fouten die we tegenkwamen.
Ook handig
- AI-nieuws deze week: wat er van 2 tot 10 november 2026 veranderde in de tools die je gebruiktAI-nieuws van 2 tot 10 november 2026 voor ondernemers: nieuwe Claude-modellen, updates van Codex, Gemini CLI en n8n, en wat je ermee doet.
- Claude Code kosten: abonnement, limieten en wat een klus kostClaude Code zit in Pro ($20), Max en Ultra. Wij maten vijf klussen drie keer: gemiddeld $0,28 per klus met Opus en $0,09 met Sonnet. Met rekenvoorbeeld.
- Claude Code changelog in gewone taal: wat er van 2 tot 10 november 2026 veranderdeDe Claude Code-changelog van 2 tot 10 november 2026 in gewone taal: wat je gebruikt, wat breekt en onze eigen test. Laatste versie: 2.1.322.