Claude Code-serie Tutorial 5: Hoe installeer ik Claude Code?

Hoe installeer ik Claude Code

De installatie van Claude Code heeft geen grafische interface met "Volgende"; het gebeurt volledig via de commandoregel. Als je gewend bent aan npm, duurt het hele proces niet langer dan twee minuten.

Vereisten

Voordat je begint, zorg dat je het volgende bij de hand hebt:

Node.js 18 of hoger
Controleer met: node -v in de terminal. Als de versie lager is dan 18, upgrade dan met nvm, fnm of ga naar nodejs.org.
Een Anthropic-account
Registreer op https://console.anthropic.com. Het account levert een API-sleutel, die je na installatie nodig hebt. Registratie is gratis; de kosten worden berekend op basis van gebruik.
Netwerktoegang tot het API-eindpunt van Anthropic
Het standaarddomein is api.anthropic.com. Als je omgeving een proxy nodig heeft, stel dan HTTP_PROXY of HTTPS_PROXY in de terminal in.

Installatiemethode 1: Globale npm-installatie

Dit is de meest gebruikte manier; eenmaal geïnstalleerd, overal te gebruiken.

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

Voer daarna claude --version uit. Als er een versienummer verschijnt, is de installatie gelukt. Na globale installatie kan het commando claude in elke map worden aangeroepen.

Als je een foutmelding krijgt over rechten (vaak in /usr/local/lib op macOS), zijn er twee oplossingen:

Gebruik sudo om te installeren (makkelijk, maar veiligheidsrisico).
Configureer npm om een gebruikersmap te gebruiken, zodat sudo niet nodig is:
bash mkdir -p ~/.npm-global npm config set prefix '~/.npm-global'
Voeg daarna ~/.npm-global/bin toe aan je PATH en open de terminal opnieuw.

Installatiemethode 2: npx – gebruik het meteen

Als je niets globaal wilt installeren of het alleen tijdelijk wilt uitproberen, gebruik dan npx.

npx @anthropic-ai/claude-code

npx downloadt tijdelijk de nieuwste versie en laat geen globaal commando achter. Elke keer wordt gecontroleerd op updates, dus je hebt altijd de nieuwste versie. Nadeel: het is iets trager (elke keer downloaden) en niet geschikt voor frequente aanroepen in scripts.

Geschikt voor: eerste kennismaking, tijdelijk gebruik op andermans computer, of incidenteel gebruik.

Controleer of het correct start

Na installatie kun je eerst eenvoudig testen of het programma start:

claude --help

Als er hulpinfo verschijnt, werkt het binaire bestand. De volgende stap is verbinding maken met je account, wat later wordt uitgelegd.

De twee methoden leveren hetzelfde programma op; de authenticatie en het gebruik zijn identiek. Kies de methode die het prettigst voor je is.

Veelgestelde problemen

Node-versie te laag
Versies onder 18 geven direct een foutmelding, geen waarschuwing. Upgrade Node is de eenvoudigste oplossing.
Netwerktime-out
Zowel npm-pakketten als API-verbindingen kunnen worden geblokkeerd door een proxy of firewall. Controleer eerst of curl https://api.anthropic.com werkt voordat je verder gaat.
Windows: gebruik van de originele cmd
Hoewel het theoretisch mogelijk is, wordt aanbevolen om Git Bash, WSL2 of Windows Terminal te gebruiken om rare padproblemen te voorkomen.