Claude Code: installeren en instellen
Claude Code: ReviewInstalleren & instellenNieuwsTechnische tutorial
Stand september 2026, samengesteld uit onze eigen notities en nieuwsarchief; tekst machinaal opgesteld en redactioneel gecontroleerd. Controleer versies en commando's in de officiële documentatie.
In deze handleiding installeer je Claude Code op macOS, Linux of Windows, log je in, kies je een updatekanaal en controleer je of alles werkt. Alle commando's komen uit de officiële documentatie van Anthropic (stand september 2026).
Wat je nodig hebt
- Besturingssysteem: macOS 13 of nieuwer, Windows 10 (versie 1809) of nieuwer, Ubuntu 20.04+, Debian 10+ of Alpine 3.19+.
- Hardware: minimaal 4 GB RAM, een x64- of ARM64-processor.
- Account: een betaald Claude-abonnement (Pro, Max, Team of Enterprise) of een Console-account met API-tegoed. Het gratis claude.ai-plan geeft geen toegang tot Claude Code.
- Internet: Claude Code werkt niet offline.
Node.js is niet meer nodig: de aanbevolen installatie is een zelfstandig programma.
Installeren op macOS, Linux of WSL
Open een terminal en voer uit:
curl -fsSL https://claude.ai/install.sh | bash
Open daarna een nieuw terminalvenster en controleer:
claude --version
Zie je een versienummer, dan werkt het. Meldt je shell dat claude niet gevonden wordt, dan staat de installatiemap (~/.local/bin) nog niet in je PATH.
Liever Homebrew? Dat kan ook:
brew install --cask claude-code # stabiel kanaal
brew install --cask claude-code@latest # nieuwste versies direct
Let op: Homebrew-installaties werken niet vanzelf bij. Je draait dan zelf brew upgrade claude-code.
Installeren op Windows
In PowerShell:
irm https://claude.ai/install.ps1 | iex
In de klassieke opdrachtprompt (CMD):
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
Via WinGet kan het ook: winget install Anthropic.ClaudeCode.
Je hebt geen beheerdersrechten nodig. Installeer bij voorkeur ook Git for Windows: dan kan Claude Code Bash-commando's draaien. Zonder Git for Windows gebruikt het PowerShell.
Werk je met Linux-tools of wil je de sandbox gebruiken (zie de tutorial)? Kies dan WSL 2: open je WSL-distributie en gebruik daar het Linux-commando van hierboven. De sandbox werkt niet in native Windows.
Inloggen
Ga naar je projectmap en start:
cd ~/mijn-project
claude
Bij de eerste start opent er een browservenster om in te loggen met je Claude-account. Werk je met een API-sleutel uit de Console, zet die dan vóór het starten in de omgevingsvariabele ANTHROPIC_API_KEY; Claude Code vraagt je dan één keer of je die sleutel wilt gebruiken. Zet een sleutel nooit in een bestand dat in git terechtkomt.
De eerste instellingen die ertoe doen
1. Laat Claude Code je project leren kennen. Typ in de sessie:
/init
Claude Code bekijkt je code en maakt een CLAUDE.md met buildcommando's, testinstructies en conventies. Dat bestand leest het bij elke sessie. Houd het kort (onder de 200 regels) en concreet, bijvoorbeeld: "Run npm test voor elke commit" in plaats van "test je wijzigingen".
Heeft je project al een AGENTS.md voor andere coding agents? Vanaf versie 2.1.277 leest Claude Code die automatisch als er geen CLAUDE.md is.
2. Kies je updatekanaal. De standaardinstallatie werkt zichzelf op de achtergrond bij via het kanaal latest: nieuwe functies meteen. Wil je minder verrassingen, kies dan stable. Dat kanaal loopt ongeveer een week achter en slaat versies met grote fouten over. Instellen kan via /config → Auto-update channel, of in ~/.claude/settings.json:
{
"autoUpdatesChannel": "stable"
}
3. Bekijk je instellingen. Met /config open je het instellingenpaneel; met /status zie je welke instellingenbestanden geladen zijn.
Controleren of het werkt
Voer buiten een sessie de diagnose uit:
claude doctor
Dit toont de staat van je installatie, fouten in instellingenbestanden en het resultaat van de laatste update. Geef daarna een onschuldige opdracht:
claude -p "Leg in drie zinnen uit wat dit project doet."
Met -p draait Claude Code één keer zonder interactieve sessie en print het antwoord.
Bijwerken
- Standaardinstallatie: werkt vanzelf bij. Meteen bijwerken:
claude update. - Homebrew:
brew upgrade claude-code(ofclaude-code@latest). - WinGet:
winget upgrade Anthropic.ClaudeCode. - npm (alleen als je het zo installeerde, vereist Node.js 22+):
npm install -g @anthropic-ai/claude-code@latest. Gebruik geennpm update -gen nooitsudo npm install -g.
Na een update geeft claude doctor aan of alles nog klopt.