Hoe installeer ik Claude Code?

Voer 'npm install -g @anthropic-ai/claude-code' uit in je terminal. Je moet Node.js 18+ geïnstalleerd hebben. Voer na de installatie 'claude' uit in een willekeurige projectmap en verifieer jezelf met je Anthropic-account.

Is Claude Code gratis te installeren?

De CLI tool zelf is gratis te installeren. Om het te gebruiken heb je ofwel een Claude Pro-abonnement ($20/maand) of Claude Max ($100-200/maand) nodig voor zwaarder gebruik. API-gebruik wordt apart gefactureerd tegen de token-tarieven van Anthropic.

Wat zijn de systeemvereisten voor Claude Code?

Node.js 18 of hoger, macOS, Linux, of Windows met WSL. Ten minste 4GB RAM aanbevolen. Geen GPU vereist — Claude Code maakt verbinding met de cloud-API van Anthropic voor AI-verwerking.

Kan ik Claude Code installeren op Windows?

Ja, maar je hebt Windows Subsystem for Linux (WSL) nodig. Installeer eerst WSL ('wsl --install' in PowerShell), installeer daarna Node.js binnen WSL, en voer het npm install-commando uit vanuit de WSL-terminal.

Waarom mislukt de installatie van Claude Code?

Veelvoorkomende problemen: Node.js-versie te oud (18+ nodig), npm-rechtenfouten (herstel met 'sudo' of nvm), netwerk/firewall blokkeert de npm registry, of een poging tot installatie op Windows zonder WSL. Controleer eerst 'node --version' om je Node.js-versie te verifiëren.

Belangrijkste inzichten

Twee installatiemethoden: Gebruik de native installer (curl -fsSL https://claude.ai/install.sh | bash) voor een setup zonder afhankelijkheden, of npm (npm install -g @anthropic-ai/claude-code) als je version pinning nodig hebt.
Systeemvereisten zijn minimaal: macOS 13+, Linux (Ubuntu 20.04+/Debian 10+), of Windows 10+ met WSL. Minimaal 4GB RAM. Geen GPU nodig.
Account vereist: Je hebt een Claude Pro, Max, Teams, Enterprise of Console (API) account nodig. Het gratis Claude.ai plan bevat geen toegang tot Claude Code.
Setup duurt minder dan vijf minuten: Installeer, authenticeer in je browser en begin direct met het gebruiken van Claude Code in elke project directory.

Hoe Claude Code te installeren: Volledige Setup Gids (2026)

Claude Code is de AI-codeerassistent van Anthropic die direct in je terminal draait. Het leest je codebase, schrijft code, voert commando's uit en handelt complexe bewerkingen in meerdere bestanden af -- allemaal vanuit een enkele CLI.

In tegenstelling tot browser-gebaseerde AI-chattools, werkt Claude Code binnen je eigen ontwikkelomgeving. Het ziet je bestandsstructuur, begrijpt de context van je project en brengt wijzigingen aan in echte bestanden op je machine.

Deze gids leidt je door elke stap van het installeren van Claude Code in 2026, van het controleren van de vereisten tot het draaien van je eerste door AI ondersteunde codeersessie. Of je nu op macOS, Linux of Windows werkt, je hebt Claude Code binnen vijf minuten draaiend.

Wat je nodig hebt (Checklist vereisten)

Bevestig voordat je Claude Code installeert of je het volgende hebt:

Besturingssysteem: macOS 13.0 (Ventura) of later, Ubuntu 20.04+ of Debian 10+, of Windows 10 (versie 1809+) met WSL
RAM: Ten minste 4GB (8GB aanbevolen voor grotere codebases)
Internetverbinding: Claude Code maakt verbinding met de cloud API van Anthropic, dus een actieve verbinding is vereist
Anthropic account: Een Claude Pro ($20/maand), Claude Max ($100-200/maand), Teams, Enterprise of Console (API) account
Terminal: Bash, Zsh of PowerShell
Node.js 18+ (alleen vereist voor de npm installatiemethode)

Je hebt geen GPU nodig. Alle AI-verwerking vindt plaats op de servers van Anthropic. Je machine hoeft alleen de CLI client te draaien en verzoeken over het netwerk te sturen.

Stap 1: Installeer Node.js (als je dit nog niet hebt)

Als je van plan bent de npm installatiemethode te gebruiken, heb je Node.js 18 of hoger nodig. Als je Node.js al hebt geïnstalleerd, controleer dan je versie:

node --version

Als de uitvoer v18.0.0 of hoger aangeeft, ga dan door naar Stap 2. Zo niet, installeer of update Node.js dan met nvm (Node Version Manager). Dit is de aanbevolen aanpak omdat het permissieproblemen voorkomt en je eenvoudig tussen Node versies kunt schakelen.

Installeer nvm op macOS of Linux:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash

Sluit en heropen je terminal en installeer vervolgens Node.js:

nvm install 22
nvm use 22
node --version

Je zou een versienummer moeten zien dat begint met v22. Node.js 22 is de huidige LTS release en werkt perfect met Claude Code.

Installeer Node.js op Windows (binnen WSL):

Zorg er eerst voor dat WSL is geïnstalleerd (zie de Windows-sectie hieronder). Open daarna je WSL terminal en voer dezelfde nvm commando's als hierboven uit.

Stap 2: Installeer Claude Code

Je hebt twee opties voor het installeren van Claude Code. De native installer is nu de aanbevolen methode, maar npm blijft volledig ondersteund.

Optie A: Native Installer (Aanbevolen)

De native installer vereist geen afhankelijkheden -- geen Node.js, geen npm. Het wordt automatisch bijgewerkt op de achtergrond en is de primaire methode die Anthropic test en ondersteunt.

macOS en Linux:

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

Windows (PowerShell, als Administrator):

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

De installer downloadt de Claude Code binary, plaatst deze in je PATH en configureert automatische updates. Het hele proces duurt minder dan een minuut.

Optie B: npm installatie

Als je de voorkeur geeft aan npm -- bijvoorbeeld om een specifieke versie te pinnen of omdat npm standaard is in je workflow -- voer dan uit:

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

Belangrijk: Gebruik geen sudo bij npm install. Als je permissiefouten krijgt, is de juiste oplossing het gebruik van nvm (dat Node.js in je home directory installeert) in plaats van npm als root uit te voeren.

Verifieer de installatie

Ongeacht de gekozen methode, verifieer of Claude Code is geïnstalleerd:

claude --version

Je zou een versienummer moeten zien. Je kunt ook de ingebouwde diagnostiek uitvoeren:

claude doctor

Dit commando controleert je omgeving en rapporteert eventuele configuratieproblemen.

Stap 3: Authenticeren

Claude Code vereist authenticatie voordat je het kunt gebruiken. Voer uit:

claude

De eerste keer dat je dit commando uitvoert, opent Claude Code je standaard webbrowser en vraagt je om in te loggen op je Anthropic account. Volg de aanwijzingen om de CLI te autoriseren.

Authenticatie-opties

Browser-gebaseerde login (standaard): Beste voor persoonlijke machines. Claude Code opent een browservenster, je logt in en de CLI ontvangt automatisch een authenticatie token. Dit werkt met Claude Pro, Max, Teams en Enterprise accounts.

API-sleutel (voor CI/CD en automatisering): Als je Claude Code draait in een headless omgeving of CI/CD pipeline, stel dan je API-sleutel in als een omgevingsvariabele:

export ANTHROPIC_API_KEY=sk-ant-your-key-here

Je kunt een API-sleutel genereren via de Anthropic Console. API-gebruik wordt gefactureerd per token tegen de gepubliceerde tarieven van Anthropic.

Abonnement vs. API-facturering: Met een Pro of Max abonnement is je Claude Code gebruik inbegrepen in je maandelijkse plan (onderworpen aan gebruikslimieten). Met een API-sleutel van de Console betaal je per token. Kies op basis van je gebruiksvolume -- abonnementen zijn eenvoudiger voor regelmatig gebruik, terwijl API-facturering je meer controle geeft voor variabele of geautomatiseerde workloads.

Stap 4: Je eerste project

Nu Claude Code is geïnstalleerd en geauthenticeerd, kun je het proberen op een echt project.

Navigeer naar een willekeurige project directory:

cd ~/my-project

Start Claude Code:

claude

Je bevindt je nu in een interactieve sessie. Claude Code heeft je projectstructuur gelezen en is klaar om te helpen. Probeer het een taak te geven:

> Leg de architectuur van dit project uit

Claude Code scant je bestanden, identificeert de tech stack en geeft je een samenvatting van hoe het project is georganiseerd.

Probeer iets meer hands-on:

> Voeg invoervalidatie toe aan het gebruikersregistratieformulier

Claude Code identificeert de relevante bestanden, stelt wijzigingen voor en vraagt om je bevestiging voordat er iets wordt gewijzigd. Je bekijkt elke wijziging in een diff-weergave en accepteert of weigert deze.

Voor een eenmalige taak zonder de interactieve modus te openen, gebruik je de -p flag:

claude -p "Schrijf unit tests voor de auth module"

Dit voert de taak uit, geeft het resultaat weer en sluit af -- handig voor scripting en snelle vragen.

Stap 5: Essentiële configuratie

Claude Code werkt direct uit de doos met verstandige standaardinstellingen, maar je kunt het gedrag aanpassen aan je workflow.

Modelselectie

Claude Code gebruikt standaard het nieuwste Claude model. Om een ander model te specificeren:

claude config set model claude-opus-4-6

Of voor een enkele sessie:

claude --model claude-sonnet-4-20250514

Machtigingen

Claude Code vraagt om bevestiging voordat het potentieel destructieve acties uitvoert, zoals het schrijven van bestanden of het uitvoeren van shell-commando's. Je kunt dit gedrag configureren:

claude config set permissions.auto-accept-edits true

Instellingen op projectniveau

Maak een .claude/settings.json bestand aan in de root van je project om team-gedeelde configuratie te definiëren:

{
  "permissions": {
    "allow": ["read", "write", "shell"],
    "deny": ["shell:rm -rf *"]
  },
  "model": "claude-sonnet-4-20250514",
  "environment": {
    "NODE_ENV": "development"
  }
}

Dit bestand moet worden toegevoegd aan versiebeheer, zodat je hele team hetzelfde Claude Code gedrag deelt.

Gebruik voor persoonlijke overrides die niet moeten worden gecommit .claude/settings.local.json.

MCP Server configuratie

Claude Code ondersteunt Model Context Protocol (MCP) servers voor het uitbreiden van de mogelijkheden. Configureer ze in .mcp.json in de root van je project:

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"]
    }
  }
}

Installeren in verschillende omgevingen

macOS

De native installer is de eenvoudigste weg op macOS. Zowel Apple Silicon (M1/M2/M3/M4) als Intel machines worden ondersteund:

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

Als alternatief is Claude Code beschikbaar via Homebrew:

brew install --cask claude-code

Linux

Werkt op Ubuntu 20.04+, Debian 10+ en de meeste moderne distributies:

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

Als je een oudere distributie gebruikt, gebruik dan de npm methode met nvm om systeem-afhankelijke problemen te voorkomen.

Windows (WSL)

Claude Code op Windows vereist ofwel WSL of Git for Windows. WSL is de aanbevolen aanpak:

Open PowerShell als Administrator en installeer WSL:

wsl --install

Start je computer opnieuw op wanneer daarom wordt gevraagd.
Open de WSL terminal (standaard Ubuntu) en installeer Claude Code:

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

Als alternatief kun je de native Windows installer direct in PowerShell gebruiken:

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

Docker

Voeg voor gecontaineriseerde omgevingen Claude Code toe aan je Dockerfile:

FROM node:22-alpine
RUN npm install -g @anthropic-ai/claude-code
ENV ANTHROPIC_API_KEY=your-key-here

Geef voor CI/CD pipelines de API-sleutel door tijdens runtime in plaats van deze in de image te bakken:

docker run -e ANTHROPIC_API_KEY=$ANTHROPIC_API_KEY my-claude-image claude -p "Voer de test suite uit en herstel eventuele fouten"

CI/CD Pipelines

De headless modus van Claude Code (-p flag) is ontworpen voor automatisering. Hier is een GitHub Actions voorbeeld:

- name: AI Code Review
  run: |
    npx @anthropic-ai/claude-code -p "Beoordeel de wijzigingen in deze PR en stel verbeteringen voor" --output-format json
  env:
    ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}

De --output-format json flag retourneert gestructureerde uitvoer die door vervolgstappen kan worden verwerkt.

Claude Code bijwerken

Native Installer

Als je Claude Code hebt geïnstalleerd met de native installer, vinden updates automatisch plaats op de achtergrond. Geen actie vereist. Je kunt het updatekanaal configureren:

claude config set update-channel stable

Om je huidige versie te controleren:

claude --version

npm

Als je via npm hebt geïnstalleerd, update dan handmatig:

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

Of installeer een specifieke versie:

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

IDE-integratie

Hoewel Claude Code primair een terminal-tool is, integreert het direct met populaire IDEs voor een meer visuele ervaring.

VS Code extensie

De VS Code extensie biedt een native grafische interface voor Claude Code binnen je editor. Het bevat een chatpaneel, ongedaan maken op basis van checkpoints, bestandsreferenties met @-vermeldingen en de mogelijkheid om meerdere gesprekken in parallelle tabbladen te voeren.

Om te installeren, open VS Code en zoek naar "Claude Code" in het Extensions paneel, of voer uit:

code --install-extension anthropic.claude-code

Eenmaal geïnstalleerd, kun je het Claude Code paneel openen vanuit de zijbalk en ermee communiceren net als met de terminalversie, maar met het extra voordeel dat bestandsdiffs worden weergegeven in de native diff-viewer van VS Code.

JetBrains plugin

Voor IntelliJ IDEA, PyCharm, WebStorm, GoLand en andere JetBrains IDEs, installeer je de Claude Code plugin vanuit de JetBrains Marketplace:

Open je JetBrains IDE
Ga naar Settings, dan Plugins, dan Marketplace
Zoek naar "Claude Code"
Klik op Install en herstart de IDE

De JetBrains plugin draait de Claude Code CLI binnen de geïntegreerde terminal van je IDE en opent voorgestelde wijzigingen in de diff-viewer van de IDE. Het is momenteel in bèta maar volledig functioneel voor dagelijks gebruik.

Problemen oplossen

"commando niet gevonden: claude"

De Claude Code binary bevindt zich niet in je PATH. Als je de native installer hebt gebruikt, probeer dan een nieuw terminalvenster te openen. Als dat niet werkt, voer het installatiescript dan opnieuw uit. Zorg er bij npm installaties voor dat je globale npm bin directory in je PATH staat:

npm config get prefix

Voeg de bin subdirectory van dat pad toe aan de PATH-variabele van je shell.

"Node.js versie te oud"

Claude Code vereist Node.js 18+. Controleer je versie met node --version. Als deze lager is dan 18, installeer dan een nieuwere versie met nvm:

nvm install 22
nvm use 22

npm permissiefouten (EACCES)

Gebruik nooit sudo npm install -g. Herstel in plaats daarvan de standaarddirectory van npm of gebruik nvm, dat alles in je home directory installeert en permissieconflicten volledig vermijdt:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
nvm install 22
npm install -g @anthropic-ai/claude-code

Authenticatie mislukt of browser opent niet

Als de browser-gebaseerde login niet werkt (vaak op remote servers of WSL), kun je in plaats daarvan authenticeren met een API-sleutel:

export ANTHROPIC_API_KEY=sk-ant-your-key-here
claude

Genereer je API-sleutel op console.anthropic.com.

"Netwerkfout" of timeout tijdens installatie

Je netwerk of firewall blokkeert mogelijk npm of de native installer. Probeer:

npm config set registry https://registry.npmjs.org/

Als je achter een zakelijke proxy zit, configureer npm dan om deze te gebruiken:

npm config set proxy http://jouw-proxy:8080
npm config set https-proxy http://jouw-proxy:8080

Claude Code draait traag

Claude Code zelf is lichtgewicht -- traagheid duidt meestal op netwerklatentie naar de API van Anthropic. Controleer je internetverbinding. Als je een VPN gebruikt, probeer deze dan uit te schakelen. Je kunt ook de API-status controleren op status.anthropic.com.

Volgende stappen

Je hebt Claude Code geïnstalleerd, geauthenticeerd en draaiend. Dit is wat je nu kunt doen:

Leer de workflow: Lees onze Claude Code-tutorial voor een diepe duik in prompting-strategieën, bewerkingen in meerdere bestanden en het optimaal benutten van door AI ondersteunde ontwikkeling.
Vergelijk je opties: Bekijk hoe Claude Code presteert in onze Claude Code vs Cursor vergelijking als je twijfelt tussen AI-codeertools.
Verken geavanceerde functies: Claude Code ondersteunt MCP servers, custom hooks, headless automatisering en multi-model configuraties. De officiële documentatie behandelt deze in detail.

Claude Code is de snelste manier om AI in je bestaande ontwikkelworkflow te brengen zonder je tools te veranderen of je terminal te verlaten. Nu het is geïnstalleerd, begin met een kleine taak in een echt project -- je zult het verschil onmiddellijk merken.

Hoe installeer je Claude Code: Complete installatiegids (2026)