Claude Code op Windows: installeren in PowerShell of WSL, en wat te doen als het misgaat

De keuze

Claude Code op Windows: native, WSL 2 of de desktop-app?

Veel handleidingen zeggen nog dat Claude Code op Windows WSL nodig heeft. Dat klopt al lang niet meer: Anthropic ondersteunt native Windows 10 vanaf versie 1809, Windows 11 en Windows Server 2019 of nieuwer, op x64 en ARM64. Je kiest dus zelf. De vraag is waar je projecten staan, welk gereedschap Claude moet gebruiken en of je commando's afgeschermd wilt laten draaien.

De beslisregel in vier vragen

1. Staan je projecten op je C:-schijf en gebruik je Windows-gereedschap? Kies native. Dat is de kortste route en Claude werkt met dezelfde bestanden als jij.
2. Draait je code later op een Linux-server of in Docker? Kies WSL 2. Claude test dan in dezelfde omgeving als waar de code landt.
3. Moet Claude commando's afgeschermd uitvoeren, bijvoorbeeld omdat je hem meer zelfstandigheid wilt geven? Kies WSL 2, want de sandbox draait op Windows alleen daar.
4. Heb je nog nooit een terminal gebruikt? Begin met de desktop-app en installeer de terminalversie pas als je iets mist.

WSL 1 alleen als het niet anders kan

WSL 1 wordt ondersteund, maar zonder sandboxing en met een bekende fout bij het starten van het programma (zie foutmeldingen). Een nieuwe installatie met wsl --install krijgt volgens Microsoft standaard WSL 2. Met wsl -l -v in PowerShell zie je welke versie je distributie gebruikt.

Welk abonnement heb je nodig?

Op elke route hetzelfde: Pro, Max, Team, Enterprise of een Claude Console-account. Het gratis plan geeft geen toegang. Vanuit Nederland kost Pro €15 per maand bij jaarbetaling of €18 per maand, en een Team standard seat €18 per gebruiker per maand bij jaarbetaling (€21,04 maandelijks), alles exclusief btw. Welk plan past, lees je op Claude-abonnementen; wat je verbruik doet, op wat Claude Code kost.

PowerShell en CMD

Claude Code installeren op Windows in PowerShell of CMD

De native installer is de route die Anthropic aanraadt. Hij zet één programma neer, claude.exe, dat zichzelf op de achtergrond bijwerkt. Je hebt er geen Node.js voor nodig en geen beheerdersrechten. Of je PowerShell of CMD gebruikt, maakt alleen uit voor het commando dat je plakt.

Het PowerShell-commando om te kopiëren

Plak dit in PowerShell en controleer daarna in een nieuw venster of het gelukt is:

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

claude --version

Waarom dit de beste keuze is: de PowerShell-installer downloadt via .NET en gebruikt het certificatenarchief van Windows. Achter een bedrijfsfirewall loopt hij daardoor minder vaak vast dan het CMD-commando, dat curl gebruikt.

Waar het programma terechtkomt

De installer zet claude.exe in %USERPROFILE%\.local\bin, dus in de map .local\bin in je gebruikersmap. De versies staan in %USERPROFILE%\.local\share\claude. Je instellingen en sessies staan apart, in %USERPROFILE%\.claude en het bestand .claude.json in je gebruikersmap. Herinstalleren raakt je instellingen dus niet.

Latest of stable?

Standaard volg je latest: nieuwe functies zodra ze uitkomen. Stable loopt doorgaans ongeveer een week achter en slaat releases met grote regressies over. Werk je in een team waarin iedereen hetzelfde moet zien, dan is stable de rustigere keuze. De afweging en hoe je later wisselt, staan op Claude Code updaten.

Scoop, Chocolatey of een "Windows-installer" van GitHub?

Anthropic documenteert voor Windows drie routes: de native installer, WinGet en npm. Scoop en Chocolatey staan niet in de officiële documentatie. Kom je op GitHub een "Windows-port" of een los .exe-installatieprogramma tegen, installeer dat dan niet: zo'n project is niet van Anthropic, en je geeft een programma van een onbekende toegang tot je bestanden en je terminal. De officiële claude.exe is ondertekend door "Anthropic, PBC"; controleren kan met Get-AuthenticodeSignature gevolgd door het pad naar claude.exe.

Git for Windows

Claude Code en Git for Windows: wanneer heb je Git Bash nodig?

Oudere handleidingen noemen Git for Windows verplicht. Dat is het niet meer. Claude Code heeft een shell nodig om commando's uit te voeren, en op Windows is dat PowerShell, Git Bash of allebei. Wat je installeert, bepaalt welk gereedschap Claude krijgt.

Ons advies: installeer Git for Windows er wel bij

Download het van git-scm.com/downloads/win en kies tijdens de installatie "Add to PATH". De reden: veel scripts, README's en voorbeelden gaan uit van Bash. Met Git Bash erbij hoeft Claude die niet eerst naar PowerShell te vertalen, en de Monitor-tool (die een langlopend proces in de gaten houdt) werkt alleen met Git Bash. Werk je uitsluitend met PowerShell-scripts en Windows-beheer, dan kun je het overslaan.

Claude Code vindt Git Bash niet

Claude Code zoekt bash.exe eerst in C:\Program Files\Git en C:\Program Files (x86)\Git, daarna via de git in je PATH. Staat Git ergens anders, zoek het pad dan op met where.exe git en zet het in je settings.json (in %USERPROFILE%\.claude):

{
  "env": {
    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
  }
}

Laat het pad naar bash.exe wijzen, niet naar git-bash.exe. Sinds versie 2.1.219 negeert Claude Code een bestand met een andere naam en zoekt hij zelf verder, met een waarschuwing die je ziet met --debug.

Execution policy: waarom scripts toch draaien

Claude Code start PowerShell met -ExecutionPolicy Bypass, maar alleen voor dat ene proces. Je .ps1-scripts en modules werken daardoor ook op een standaard Windows-installatie, zonder dat de instelling van je machine verandert. Een execution policy die je IT-afdeling via Group Policy oplegt, blijft wel gelden. Wil je dat Claude zich aan de gewone policy van de machine houdt, zet dan CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY op 1.

Let op met een deny-regel voor Bash

Verbied je in je permissies Bash, ook een smalle regel als Bash(git push *), dan zet Claude Code de PowerShell-tool voor die sessie uit. Zonder melding. Dat doet hij omdat een Bash-regel PowerShell niet afschermt. Wil je PowerShell houden, voeg dan een eigen PowerShell-regel toe, bijvoorbeeld een deny op PowerShell(git push *), of zet CLAUDE_CODE_USE_POWERSHELL_TOOL op 1. Meer over permissies en hooks staat in de tutorial hooks.

WSL

Claude Code in WSL 2: installeren, inloggen en de sandbox aanzetten

In WSL draait Claude Code als gewoon Linux-programma. Je installeert en start het binnen je Linux-distributie, niet vanuit PowerShell. Heb je WSL nog niet, dan staat het er met één commando op.

Waarom je project in Linux moet staan, niet op /mnt/c

Vanuit WSL kun je je C:-schijf bereiken via /mnt/c. Dat lijkt handig, maar elke bestandsbewerking gaat dan over een netwerkbestandssysteem tussen Linux en Windows. Anthropic schrijft dat dit traag is en dat het bestandsbewaking breekt, waardoor bijvoorbeeld een dev-server wijzigingen niet oppikt. Kopieer of clone je project daarom naar ~/projecten in je distributie. In de Windows Verkenner vind je die map terug onder \\wsl.localhost\Ubuntu\home\jouwnaam.

Inloggen als de browser niet opent

In WSL opent Claude Code soms geen browser, of de browser meldt een verbindingsfout op een localhost-adres. Druk dan bij de inlogprompt op c om de inlog-URL te kopiëren, open die in je Windows-browser, log in en plak de code die je krijgt bij "Paste code here". Werkt plakken niet, probeer dan rechtsklikken of Shift+Insert in Windows Terminal, of gebruik claude auth login. Wil je dat Claude voortaan je Windows-browser opent, zet dan de variabele BROWSER:

export BROWSER="/mnt/c/Program Files/Google/Chrome/Application/chrome.exe"

Pas het pad aan voor Edge of een andere browser. Meer over accounts en inloggen staat in account en inloggen.

De sandbox aanzetten in WSL 2

De sandbox schermt de commando's van Claude af van de rest van je systeem en van het netwerk. In WSL 2 gebruikt hij dezelfde onderdelen als op Linux. Installeer ze in Ubuntu en open daarna in Claude Code het commando /sandbox:

sudo apt-get install bubblewrap socat

Op Ubuntu 24.04 en nieuwer kan AppArmor bubblewrap tegenhouden. Controleer dat met sysctl kernel.apparmor_restrict_unprivileged_userns: krijg je 1 terug, volg dan de AppArmor-stap uit de officiële sandboxdocumentatie. Zie je de melding "Sandboxing requires WSL2", dan draait je distributie nog op WSL 1.

Gebruik geen Node.js van Windows binnen WSL

Dit speelt alleen als je via npm installeert. WSL neemt standaard je Windows-PATH over, en dan pakt npm in WSL soms de Windows-versie. Je ziet dan "exec: node: not found" of een melding over het verkeerde platform. Controleer met which npm en which node: een pad dat met /mnt/c/ begint, is van Windows. Installeer Node in Linux zelf, of gebruik gewoon de native installer, die geen Node nodig heeft.

Desktop en VS Code

Claude Code in de desktop-app en VS Code op Windows

Wil je geen terminal openen, dan zit Claude Code in de Claude Desktop-app als het tabblad Code. In VS Code gebruik je de extensie. Beide werken op Windows, maar elk met een paar Windows-eigenaardigheden die je beter vooraf kent.

De desktop-app installeren

Download de app via claude.com/download. Kies x64 voor een laptop met Intel of AMD en ARM64 voor een laptop met een Snapdragon-processor. Start Claude via het Startmenu, log in en open het tabblad Code. Kies daarna een map op je computer. Systeemeisen, de Microsoft Store-versie en uitrol via MSIX staan op Claude Desktop downloaden.

Een WSL-sessie in de desktop-app

In het tabblad Code kies je onder het invoerveld een omgeving. Onder WSL staan je WSL 2-distributies. Claude Code, de tools en git draaien dan in Linux, met Linux-paden. Je hebt daarvoor Windows 10 of 11 met WSL 2 nodig, minstens één distributie en git in die distributie. WSL 1 werkt hier niet. Plugins zijn in een WSL-sessie niet beschikbaar, en bestanden kun je in het bestandspaneel bekijken maar niet bewerken. Op een beheerd apparaat kan je organisatie WSL-sessies uitzetten.

PATH in de desktop-app

De desktop-app leest je PowerShell-profiel niet. Vindt een sessie npm, python of een ander programma niet, zet de map dan in je Windows-omgevingsvariabelen (zoek in Windows op "omgevingsvariabelen"). Sluit daarna de app helemaal af en open hem opnieuw. Een terminalsessie zet je over naar de app met /desktop; dat werkt op Windows x64 met een Claude-abonnement, niet op ARM64 en niet met een API-key.

VS Code op Windows

Open de extensies met Ctrl+Shift+X, zoek op "Claude Code" en klik op Install. Je hebt VS Code 1.94.0 of nieuwer nodig. Met Ctrl+Esc wissel je tussen editor en Claude, met Alt+K voeg je een verwijzing naar je selectie toe. Belangrijk: de extensie zet claude niet in je PATH. Wil je claude ook in de terminal van VS Code typen, installeer dan de terminalversie er apart bij. Werk je in WSL, open je project dan vanuit Ubuntu met code ., zodat VS Code via Remote - WSL in Linux werkt. De volledige uitleg staat in Claude Code in VS Code.

Windows Terminal, Shift+Enter en Backspace

In Windows Terminal werkt Shift+Enter voor een nieuwe regel zonder instellen. In de terminal van VS Code of Cursor draai je één keer /terminal-setup. Wist elke Backspace een heel woord? Dan stuurt je terminal ^H voor een gewone Backspace. Zet de omgevingsvariabele CLAUDE_CODE_BS_AS_CTRL_BACKSPACE op 0 en het is opgelost.

Foutmeldingen

Claude Code werkt niet op Windows: elke foutmelding met de oplossing

Bijna alle problemen op Windows vallen in vier groepen: het commando van de verkeerde shell, een PATH die de nieuwe map niet kent, een bedrijfsnetwerk dat downloads tegenhoudt, en beveiligingssoftware die bestanden vasthoudt. Zoek je melding op in de tabel. Draai bij twijfel eerst claude doctor: dat controleert je installatie en instellingen zonder een sessie te starten.

Zo zet je de map in je PATH

Controleer in PowerShell eerst of het programma er staat. Geeft dit True, dan is de installatie gelukt en mist alleen je PATH:

Test-Path "$env:USERPROFILE\.local\bin\claude.exe"

Voeg de map dan toe aan je gebruikers-PATH:

$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

Sluit alle terminals en open een nieuwe. Draai je Claude in de terminal van VS Code, sluit dan heel VS Code af: die terminal erft het PATH van de editor. Liever via het menu: zoek in Windows op "omgevingsvariabelen", kies Path bij je gebruikersvariabelen en voeg %USERPROFILE%\.local\bin toe.

Claude.exe herstellen na een mislukte update

Bij een update zet Claude Code de oude claude.exe opzij als back-up en zet hij de nieuwe op zijn plek. Mislukt dat halverwege, dan staat er alleen een bestand dat begint met claude.exe.old. Dit commando hernoemt de nieuwste back-up terug:

Get-ChildItem "$env:USERPROFILE\.local\bin\claude.exe.old.*" | Sort-Object Name | Select-Object -Last 1 | Rename-Item -NewName claude.exe

Werkt claude --version daarna nog niet, installeer dan opnieuw met het PowerShell-commando.

TLS-fout in Windows PowerShell 5.1

Krijg je deze fout in Windows PowerShell 5.1, de PowerShell die standaard in Windows zit, zet dan TLS 1.2 aan en draai de installer in hetzelfde venster:

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
irm https://claude.ai/install.ps1 | iex

Onderschept je bedrijfsproxy het verkeer met een eigen certificaat, dan moet IT dat certificaat in het Windows-certificatenarchief zetten. Voor Claude Code zelf zet je daarna NODE_EXTRA_CA_CERTS op het pad naar dat certificaatbestand.

Virusscanner, AppLocker of EDR

Beveiligingssoftware kan twee dingen doen: het downloadbestand vasthouden tijdens de installatie (dan zie je "being used by another process"), of claude.exe en de processen die het start blokkeren. Anthropic noemt AppLocker, software restriction policies via Group Policy en EDR-agents. De oplossing ligt bij IT: zet claude.exe en de processen die het start, zoals cmd.exe en bash.exe, op de toegestane lijst. Zet je virusscanner niet zelf uit.

Team en beheer

Claude Code uitrollen op Windows-laptops: WinGet, Intune en Group Policy

Voor één persoon is de native installer genoeg. Voor een team wil je twee dingen regelen: dat iedereen op een werkende versie zit, en dat niemand met klantcode op een privéaccount werkt. Op Windows doe je dat met de tooling die je IT-partner al gebruikt.

De desktop-app heeft een eigen beleid

Claude Desktop leest zijn instellingen uit een andere registersleutel en wordt op Windows uitgerold als MSIX-pakket. Machinebreed installeren gaat met Add-AppxProvisionedPackage; een Intune line-of-business-app installeert per gebruiker en faalt voor gebruikers zonder beheerdersrechten. De stappen en de belangrijkste beleidssleutels staan op Claude Desktop uitrollen.

Werkt je organisatie al met Azure?

Claude Code kan ook via Microsoft Foundry werken in plaats van via een claude.ai-account. Dan loopt het verbruik via je Azure-afspraken. Weet dat functies die een claude.ai-login nodig hebben, zoals cloudsessies en geplande routines, op die route niet werken, en dat je de PowerShell-tool daar zelf aanzet met CLAUDE_CODE_USE_POWERSHELL_TOOL=1. Wat Claude in Foundry betekent voor een Nederlands bedrijf, lees je in Claude in Microsoft Azure Foundry.

Gebruikers met lokale beheerdersrechten

Is een medewerker lokaal beheerder, dan kan hij het bestand of de registerwaarde zelf aanpassen. Daarom raadt Anthropic aan dat je MDM-tooling het beleid periodiek opnieuw uitrolt. Een gewone gebruiker kan wel de HKCU-sleutel schrijven, maar die negeert Claude Code zodra er een beleid op machineniveau staat.

Valkuil

De grootste valkuil met Claude Code op Windows: Windows en WSL door elkaar gebruiken

De fout die we in trainingen het vaakst zien, is geen kapotte installatie. Iemand installeert Claude Code in PowerShell, volgt daarna een handleiding voor WSL, en werkt vervolgens half in de ene en half in de andere wereld. Alles lijkt te werken, tot het niet meer werkt en niemand weet welke claude er draait.

Hoe het eruitziet

Je hebt claude.exe in Windows en een tweede claude in Ubuntu. Je project staat op C:, maar je opent het in WSL via /mnt/c. Claude reageert traag, de dev-server pikt wijzigingen niet op, en een update in Windows verandert niets aan de versie in WSL. Elke omgeving heeft ook een eigen login, eigen instellingen en een eigen CLAUDE.md in de gebruikersmap. Instructies die je in de ene wereld toevoegt, ziet Claude in de andere niet.

Waarom het misgaat

Windows en WSL zijn twee besturingssystemen met elk hun eigen gebruikersmap, PATH en programma's. Claude Code in Windows bewaart zijn instellingen in %USERPROFILE%\.claude, Claude Code in WSL in ~/.claude binnen Linux. Bestanden op /mnt/c benaderen vanuit Linux gaat via een netwerkbestandssysteem, en Anthropic noemt dat traag en slecht voor bestandsbewaking.

Zo voorkom je het

Kies per project één wereld en blijf daar. Windows-project op C:: native Claude Code in PowerShell. Linux-project: clone het in ~/projecten in WSL en start Claude daar. Twijfel je wat er staat, controleer het dan in PowerShell met where.exe claude en in WSL met which -a claude. Staan er meerdere installaties in dezelfde wereld, verwijder er dan één; de commando's staan bij bijwerken en verwijderen.

En gebruik geen oude handleidingen

Veel video's, Reddit-draadjes en blogs die bovenaan in Google staan, zijn ouder dan de huidige installer. Ze zeggen dat WSL verplicht is, dat je PowerShell als administrator moet openen, of dat Git for Windows verplicht is. Geen van drieën klopt nog. Een installatie als administrator is niet nodig. Volg de officiële commando's van deze pagina, of controleer ze op code.claude.com/docs/en/setup.

Ons oordeel

Ons oordeel: welke Windows-route past bij een Nederlands MKB-team?

De meeste MKB-teams werken op Windows-laptops met Microsoft 365, en een deel van die laptops wordt beheerd door een IT-partner. Dat bepaalt meer dan de techniek. Dit is het advies dat we in trainingen geven, met per keuze de reden.

Ons verdict

Begin native in PowerShell, met Git for Windows erbij. Dat werkt voor de meeste mensen in tien minuten en Claude ziet je bestanden zoals jij ze ziet. Kies WSL 2 pas als je code op Linux draait of als je Claude meer zelfstandigheid wilt geven binnen een sandbox. Schrijf je zelf geen code maar wil je met scripts, exports of een website aan de slag, begin dan in de desktop-app. Laat Claude Code helemaal weg als je werk vooral in Excel, Word of Outlook zit: daar zijn de gewone Claude-app en de add-ins de betere ingang, zie de tutorials voor Excel en Outlook.

Een voorbeeld: een installatiebedrijf met een kantoor van acht mensen

Stel: acht medewerkers op Windows-laptops met Microsoft 365, de boekhouding in Exact Online, en één collega die de website en een paar PowerShell-scripts voor rapportages onderhoudt. Ons advies voor zo'n team: één Team-account, en alleen die ene collega installeert Claude Code, native met Git for Windows. De IT-partner zet via Intune een managed-settings.json met forceLoginOrgUUID op de laptops, zodat niemand met een privéaccount inlogt. De rest werkt in de gewone Claude-app. Wil je Claude laten werken met gegevens uit Exact, lees dan eerst de tutorial Exact Online. Acht standard seats kosten bij jaarbetaling €144 per maand exclusief btw; geef die ene collega een premium seat (€90 in plaats van €18 per maand) als hij dagelijks uren in Claude Code werkt.

AVG: het account telt, niet het besturingssysteem

Windows of WSL maakt voor de AVG geen verschil. Het account waarmee je inlogt wel. Pro en Max vallen onder de consumentenvoorwaarden, Team, Enterprise en de API onder de commerciële voorwaarden, waar Anthropic standaard niet op je code of prompts traint. Leest Claude bestanden met persoonsgegevens, zoals een klantexport uit AFAS of een logbestand, dan wil je dat op een zakelijk account doen. De details staan op Claude Code en privacy en privacy en zakelijk gebruik.

Wanneer je het samen wilt opzetten

Lukt het installeren wel, maar weet je team daarna niet goed wat ze Claude kunnen laten doen, dan zit de winst in de afspraken: welke permissiemodus, welke CLAUDE.md, wie wat mag. Dat zetten we in de Claude Code Masterclass in één middag op jullie eigen laptops neer, Windows of Mac.

Bijwerken en verwijderen

Claude Code bijwerken en verwijderen op Windows

De native installatie werkt zichzelf op de achtergrond bij. Bij WinGet doe je het zelf. Verwijderen gaat met twee regels in PowerShell, en je instellingen blijven staan tot je ze zelf weghaalt.

Een native installatie verwijderen

Draai dit in PowerShell:

Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force
Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force

Wil je ook je instellingen, toegestane tools, MCP-servers en sessiegeschiedenis kwijt, verwijder dan daarna %USERPROFILE%\.claude en %USERPROFILE%\.claude.json. Doe dat pas nadat je ook de VS Code-extensie en de desktop-app hebt verwijderd, want die schrijven ook naar die map en maken hem anders opnieuw aan.

WinGet en een draaiende Claude

Windows vergrendelt een programma dat draait. Een WinGet-upgrade kan daardoor mislukken terwijl Claude Code open staat. Sluit alle sessies en draai de upgrade opnieuw. Meldt Claude Code een nieuwe versie die WinGet nog niet kent, wacht dan een paar uur: de pakketbeheerder loopt soms achter. Alles over versies, kanalen en de changelog staat op Claude Code updaten.