Claude Code Installatiehandleiding: irm Script, npm Setup en https://claude.ai/install.ps1 Script Gebruiken

Introductie

Claude Code is mijn favoriete command-line tool voor AI-geassisteerd coderen. Of je nu op Windows, macOS of Linux werkt, installatie is eenvoudig met meerdere opties:

• Native Binary (Aanbevolen): curl -fsSL https://claude.ai/install.sh | bash voor Linux/macOS
• Windows PowerShell: irm https://claude.ai/install.ps1 | iex voor Windows-gebruikers
• npm Global Install: npm install -g @anthropic-ai/claude-code voor Node.js omgevingen

Deze handleiding behandelt elke installatiemethode in detail, plus probleemoplossing met het claude doctor commando om veelvoorkomende problemen te diagnosticeren en op te lossen.

Aanbevolen: Native Binary

Vanaf 2025 is Claude beschikbaar in verschillende runtimes, waaronder node.js en bun.js. Anthropic raadt aan om de native binary-installatie te gebruiken. Deze methode vermijdt conflicten met package managers en is het meest stabiel.

De Native Binary Installeren

1. Voer het installatiescript uit:

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

2. Herlaad je shell-configuratie:

   source ~/.bashrc
   # of voor zsh-gebruikers:
   source ~/.zshrc

3. Verifieer de installatie:

   claude --version
   claude doctor

Dat is het! Claude Code zou nu geïnstalleerd moeten zijn op ~/.claude/bin/claude of ~/.local/bin/claude.

Probleemoplossing: Kapotte Installaties Repareren

Als je problemen ondervindt met Claude Code zoals segmentation fault errors, heb je waarschijnlijk een gemixte of verouderde installatie. Als je Claude al vanaf het begin gebruikt zoals ik, heb je misschien ook node.js of bun.js versies geïnstalleerd. Hier is hoe je dat repareert:

Diagnose van Je Huidige Installatie met claude doctor

Het claude doctor commando is je eerste stop voor probleemoplossing. Het analyseert je installatie en rapporteert potentiële problemen.

claude doctor

Wat claude doctor Controleert

Het claude doctor commando inspecteert:

• Installatiemethode: Native binary, npm, Bun of Homebrew
• Versie-informatie: Huidige versie en updatestatus
• Auto-update mogelijkheid: Of updates kunnen worden toegepast
• Zoekfunctionaliteit: Of ripgrep correct gebundeld/geïnstalleerd is
• Padconfiguratie: Of Claude correct in je PATH staat
• Uitvoeringspad: De daadwerkelijke binary die wordt uitgevoerd

Veelvoorkomende Problematische Outputs

Let op deze waarschuwingstekens in claude doctor output:

• unknown (2.0.0) - Versiedetectie mislukt, waarschijnlijk gemixte installatie
• Gemixte paden tussen Bun, npm en Node.js
• Aanroeppad verschilt van uitvoeringspad
• Auto-updates uitgeschakeld of falend
• Zoekstatus toont fouten

Controleer ook op meerdere installaties die kunnen conflicteren:

which -a claude

Verwijder ALLE Bestaande Installaties

# Verwijder Bun-installatie
bun uninstall -g @anthropic-ai/claude-code
rm -f ~/.bun/bin/claude

# Verwijder npm/Node.js-installatie
npm uninstall -g @anthropic-ai/claude-code

# Verwijder eventuele nvm-specifieke installaties
# Controleer elke nvm Node-versie die je hebt
nvm list
# Voor elke versie, schakel ernaar en de-installeer
nvm use <version>
npm uninstall -g @anthropic-ai/claude-code

Brew Uninstall Claude Code

Als je Claude Code via Homebrew hebt geïnstalleerd:

# De-installeer Claude Code van Homebrew
brew uninstall claude-code

# Ruim gecachte bestanden op
brew cleanup claude-code

Na de-installatie via brew kun je overschakelen naar de native binary-installatie voor betere auto-update ondersteuning.

Stap 3: Configuratie en Cache Opruimen

Verwijder eventuele achtergebleven configuratiebestanden:

# Verwijder Claude Code config directories
rm -rf ~/.claude-code
rm -rf ~/.config/claude-code
rm -rf ~/.cache/claude-code

Stap 4: Verse Native Binary Installatie

Installeer nu de native binary:

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

Stap 5: De Reparatie Verifiëren

Na installatie, verifieer of alles werkt:

# Controleer versie
claude --version

# Voer diagnostiek uit
claude doctor

Een gezonde installatie zou moeten tonen:

• Version: native (2.0.x of hoger)
• Config install method: native
• Auto-updates: enabled
• Search: OK (bundled)

Alternatieve Installatiemethoden

Hoewel de native binary wordt aanbevolen, hier zijn andere opties:

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

Als je liever npm (Node Package Manager) gebruikt, kun je Claude Code globaal installeren. Deze methode vereist Node.js 18 of hoger.

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

Wat npm install -g Doet

De -g flag installeert het pakket globaal, waardoor claude beschikbaar wordt als commando overal in je terminal. Het pakket @anthropic-ai/claude-code is het officiële npm-pakket onderhouden door Anthropic.

Voordelen van npm-installatie:

• Vertrouwde workflow voor Node.js-ontwikkelaars
• Eenvoudig te beheren naast andere globale pakketten
• Werkt goed in gecontaineriseerde/CI-omgevingen

Nadelen:

• Vereist Node.js runtime
• Kan conflicteren met andere package managers (Bun, pnpm)
• Updates vereisen handmatig npm update -g @anthropic-ai/claude-code

Belangrijk: Gebruik nooit sudo npm install -g want dit veroorzaakt permissieproblemen. Als je EACCES-fouten krijgt, repareer dan je npm-permissies.

Specifieke Versie Installatie

Om een specifieke versie van de native binary te installeren:

# Installeer nieuwste versie
curl -fsSL https://claude.ai/install.sh | bash -s latest

# Installeer specifieke versie
curl -fsSL https://claude.ai/install.sh | bash -s 2.0.22

Platform-Specifieke Instructies

macOS met Homebrew

brew install claude-code

Opmerking: Homebrew-installaties updaten automatisch onafhankelijk van de brew-directory.

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

Voor Windows-gebruikers heb je drie opties:

1. WSL (Aanbevolen): Installeer WSL en volg de Linux-instructies
2. Git Bash: Gebruik de native installer met Git Bash
3. PowerShell (Native Windows):

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

Het irm Commando Begrijpen

Het irm commando is PowerShell's Invoke-RestMethod, dat content downloadt van een URL. Dit is wat het commando doet:

• irm https://claude.ai/install.ps1 - Downloadt het installatiescript van Anthropic's servers
• | iex - Stuurt het script naar Invoke-Expression, dat het uitvoert

Het https://claude.ai/install.ps1 script handelt af:

• Detectie van je Windows-architectuur (x64, ARM64)
• Downloaden van de juiste Claude Code binary
• Installeren naar je gebruikersdirectory
• Toevoegen van Claude aan je PATH-omgevingsvariabele

Beveiligingsopmerking: Verifieer altijd dat je downloadt van het officiële claude.ai-domein voordat je installatiescripts uitvoert.

Alpine Linux

Alpine en andere musl-gebaseerde distributies hebben extra dependencies nodig:

apk add libgcc libstdc++ ripgrep
export USE_BUILTIN_RIPGREP=0
curl -fsSL https://claude.ai/install.sh | bash

Post-Installatie Setup

Authenticatie

Na installatie, authenticeer Claude Code:

claude

Je wordt gevraagd om je authenticatiemethode te kiezen:

• Claude Console (standaard): Voor API-toegang met facturering op console.anthropic.com
• Claude Pro/Max: Als je een Claude-abonnement hebt
• Enterprise: Voor AWS Bedrock of Google Vertex AI deployments

Basisgebruik

Begin Claude Code te gebruiken:

# Navigeer naar je project
cd /path/to/your/project

# Start Claude Code
claude

# Krijg hulp
claude help

# Binnen een sessie, gebruik slash-commando's
/help    # Toon beschikbare commando's
/clear   # Wis conversatie
/exit    # Sluit Claude Code af

Updates Beheren

Auto-Updates

Claude Code werkt standaard automatisch bij. Updates worden bij opstarten gecontroleerd en op de achtergrond toegepast.

Hoe Claude Code te Updaten

claude update

Voeg dit toe aan je .bashrc of .zshrc om het permanent te maken.

Veelvoorkomende Problemen en Oplossingen

Probleem: "Insufficient permissions to install update"

Dit gebeurt meestal bij npm/Bun-installaties. Oplossing: Schakel over naar native binary-installatie.

Probleem: "command not found: claude"

Het PATH is niet bijgewerkt. Voeg toe aan je shell-configuratie:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

Probleem: Zoekfunctionaliteit werkt niet

Meestal opgelost door de native installatie, maar als het aanhoudt:

# Installeer ripgrep handmatig
sudo apt-get install ripgrep  # Ubuntu/Debian
brew install ripgrep          # macOS

Best Practices

1. Gebruik altijd de native binary tenzij je specifieke vereisten hebt
2. Vermijd sudo bij elke installatiemethode
3. Houd auto-updates ingeschakeld voor beveiliging en features
4. Voer claude doctor uit na elke installatie of update
5. Ruim oude installaties op voordat je nieuwe versies installeert

Conclusie

Onthoud: bij twijfel, verwijder alles en begin opnieuw met de native binary. Het is de eenvoudigste, snelste en meest betrouwbare manier om Claude Code te draaien.

Gerelateerde Lectuur

Nu je Claude Code hebt geïnstalleerd, zet het aan het werk:

• Bouw een Winkelwagen met Flask - Een hands-on tutorial waar je Claude Code kunt gebruiken om een complete e-commerce backend te bouwen met Python en Flask

Snelle Referentie

• Installeren: curl -fsSL https://claude.ai/install.sh | bash
• Versie controleren: claude --version
• Diagnosticeren: claude doctor
• Updaten: claude update
• Starten: claude
• Hulp: claude help