Naar de inhoud
Mia Automation
NLEN Inloggen Zet Mia aan het werkBeginnen

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.

Claude in de praktijkBijgewerkt op 8 min lezen

Zelf getest op 11 november 2026.

Bewegend schema met vijf stappen die om de beurt oplichten: kiezen, installeren, pad aanvullen, controleren met claude --version en een eerste taak

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.

  1. 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.
  2. 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 commando claude niet in je terminal.
  3. 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

Uit de officiële installatiehandleiding, gecontroleerd op 11 november 2026. Alle routes installeren hetzelfde programma; ze verschillen in hoe updates binnenkomen.
SysteemCommandoUpdates
Mac, Linux, WSLcurl -fsSL https://claude.ai/install.sh | bashVanzelf
Windows (PowerShell)irm https://claude.ai/install.ps1 | iexVanzelf
Mac met Homebrewbrew install --cask claude-codeZelf: brew upgrade claude-code
Windows met WinGetwinget install Anthropic.ClaudeCodeZelf: winget upgrade Anthropic.ClaudeCode
Debian, Ubuntu (apt)Pakketbron van Anthropic toevoegen, dan sudo apt install claude-codeMet je gewone systeemupdates
Via npm (Node.js 22+)npm install -g @anthropic-ai/claude-codeVanzelf, 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.

PowerShell-venster op Windows 10: de installer meldt versie 2.1.322 en dat .local\bin niet in het pad staat, claude wordt eerst niet herkend en werkt na het aanvullen van het pad (opent op ware grootte)
Zo zag het eruit op onze Windows-pc. In deze test vulden we het pad alleen voor dat ene venster aan; blijvend doe je het met de commando's uit de Windows-handleiding.

Installeren op Mac en Linux

  1. 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.

    bash
    curl -fsSL https://claude.ai/install.sh | bash
  2. Lees 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 .zshrc op onze Mac was na de installatie onveranderd.

  3. Zet de map in je zoekpad

    Op de Mac (shell zsh) voeg je de regel toe aan .zshrc. Op Linux met bash vervang je .zshrc door .bashrc. Doe dit één keer, anders staat de regel er dubbel in.

    bash
    echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc
  4. Controleer de installatie

    Typ claude --version. Bij ons gaf dat 2.1.322 (Claude Code). Met claude doctor krijg je een volledig overzicht zonder dat er een sessie start, met onder meer het platform, of updates aan staan en welke waarschuwingen er openstaan.

    bash
    claude --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.

text
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.

MeldingOorzaakWat je doetBron
command not found: claude~/.local/bin staat niet in je zoekpad.Stap 3 hierboven, daarna een nieuw terminalvenster.gezien
Multiple installations found in claude doctorEr 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 /loginJe 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 403Je 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 npmJe Node.js is ouder dan versie 22.Een waarschuwing, geen fout: claude werkt toch. Liever: gebruik de installer.probleemgids
Rechtenfout bij npm install -gDe 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.

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

Vragen

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