Snelle samenvatting: Claude Code kan worden geïnstalleerd via native installatieprogramma's op macOS, Windows en Linux van de officiële Claude Code website. Windows-gebruikers moeten eerst WSL2 installeren voordat ze Claude Code uitvoeren. Na installatie, authenticatie met uw Claude-account wanneer Claude Code een browsertabblad opent om u in te laten loggen bij de eerste lancering om te beginnen met coderen met AI-hulp rechtstreeks vanuit uw terminal of desktop-app.
Claude Code vertegenwoordigt de vooruitgang van Anthropic op het gebied van agent-AI-ontwikkelingstools. Deze command-line assistent leest codebases, bewerkt bestanden, voert commando's uit en integreert met ontwikkelworkflows.
Maar het installeren is niet altijd eenvoudig. Verschillende platforms vereisen verschillende benaderingen. Windows heeft extra setup nodig. En de documentatie, hoewel uitgebreid, kan nieuwkomers overweldigen.
Deze gids snijdt door de complexiteit. Het behandelt systeemeisen, platformspecifieke installatiestappen, authenticatie en verificatie—alles wat nodig is om Claude Code correct te laten werken.
Systeemeisen voor installatie
Volgens de officiële Claude Code documentatie ondersteunt de tool macOS, Windows en Linux. Elk platform heeft echter specifieke vereisten.
Voor macOS zijn de vereisten minimaal. Het systeem heeft macOS 13.0 of hoger nodig. Zowel Intel als Apple Silicon chips werken prima.
Windows brengt meer complexiteit met zich mee. Het besturingssysteem moet Windows 10 Build 19041 of hoger zijn, of Windows 11. Maar hier is de kneep—Claude Code draait niet native op Windows.
Windows Subsystem for Linux 2 (WSL2) is verplicht. Dit creëert een Linux-omgeving waar Claude Code daadwerkelijk draait. Zonder WSL2 mislukt de installatie.
Linux-gebruikers hebben een 64-bits distributie nodig. De officiële documentatie bevestigt ondersteuning voor Ubuntu, Debian, Fedora en andere belangrijke distributies. Alpine Linux en musl-gebaseerde systemen vereisen aanvullende configuratie.
Alle platforms hebben een stabiele internetverbinding nodig tijdens de installatie. De downloadgroottes variëren, maar liggen typisch tussen 50MB en 500MB, afhankelijk van wat er al is geïnstalleerd.
| Platform | Minimale versie | Speciale vereisten |
|---|---|---|
| macOS | 13.0 | Geen |
| Windows | 10 Build 19041 of 11 | WSL2 vereist |
| Linux | 64-bits distributie | glibc-gebaseerd heeft de voorkeur |
Claude Code installeren op macOS
Het macOS-installatieproces maakt gebruik van een native installatieprogramma. Dit is het eenvoudigste pad onder alle platforms.
Download eerst het installatieprogramma van de officiële Claude Code website. De downloadpagina detecteert automatisch macOS en biedt het juiste pakket aan.
Open het gedownloade .dmg-bestand. Sleep de Claude Code-applicatie naar de map Programma's. Standaard macOS-installatie—niets ongebruikelijks hier.
Sommige gebruikers ondervinden een beveiligingsprompt bij de eerste lancering. macOS blokkeert standaard apps van niet-geïdentificeerde ontwikkelaars. Klik met de rechtermuisknop op de Claude Code-applicatie en selecteer "Openen" om deze eenmalige waarschuwing te omzeilen.
De command-line tool wordt automatisch geïnstalleerd met de desktop-applicatie. Open Terminal en typ claude --version om te verifiëren. Als het versienummer verschijnt, is de installatie geslaagd.
macOS-installatie verifiëren
Voer deze commando's uit om te bevestigen dat alles werkt:
| claude --version claude --help |
Beide commando's zouden uitvoer moeten retourneren zonder fouten. Het versiecommando toont de geïnstalleerde Claude Code-versie. Het helpcommando toont beschikbare opties en commando's.
Het aanmaken van een testmap helpt bij het verifiëren van de volledige functionaliteit. Navigeer naar een projectmap en voer claude uit om een interactieve sessie te starten. De tool zou moeten initialiseren en om authenticatie vragen als u nog niet bent ingelogd.
Windows installatie met WSL2
Windows-installatie vereist meerdere stappen. Het proces duurt langer dan macOS, maar blijft beheersbaar.
WSL2 moet eerst worden geïnstalleerd. Open PowerShell als Administrator en voer uit:
| wsl --install |
Dit commando installeert WSL2 en standaard Ubuntu. Het systeem vereist een herstart. Na het opnieuw opstarten wordt Ubuntu automatisch gestart om de initiële setup te voltooien.
Maak een Unix-gebruikersnaam en wachtwoord aan wanneer daarom wordt gevraagd. Deze inloggegevens zijn gescheiden van de Windows-inloggegevens.
Zodra WSL2 actief is, is het Linux-installatieproces van toepassing. Open de Ubuntu-terminal (geïnstalleerd met WSL2) en download het Claude Code-installatieprogramma voor Linux.
Claude Code installeren in WSL2
Volgens de officiële documentatie downloadt en voert het installatiecommando het native installatieprogramma uit:
| curl -o- raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash |
Dit script beheert afhankelijkheden automatisch. Het installeert Node.js indien nodig, stelt de Claude Code-binaries in en configureert PATH-variabelen.
De installatie duurt enkele minuten. Voortgangsbalken en statusberichten geven aan wat er gebeurt. Wanneer voltooid, sluit en heropen de terminal om omgevingsvariabelen te vernieuwen.
Het testen van de installatie volgt hetzelfde proces als macOS. Voer claude --version uit om te verifiëren.
Installatieproces voor Linux
Linux-gebruikers hebben het meest eenvoudige installatiepad. Het native installatieprogramma werkt direct zonder extra lagen zoals WSL2.
Download en voer het installatiescript uit:
| curl -fsSL claude.ai/install.sh | bash |
Dit downloadt de Claude Code-binaries, installeert afhankelijkheden en configureert de shell-omgeving. Het script detecteert de distributie en past zich dienovereenkomstig aan.
Voor Ubuntu en Debian-gebaseerde systemen configureert het script de installatie. De officiële documentatie bevestigt ondersteuning voor Ubuntu 20.04+, Debian 10+ en andere distributies.
Overwegingen voor Alpine Linux
Alpine Linux en musl-gebaseerde distributies hebben extra stappen nodig. De officiële documentatie vermeldt dat deze systemen handmatige configuratie vereisen.
Het standaard installatieprogramma kan mislukken op Alpine. Download in plaats daarvan de musl-compatibele binaries rechtstreeks van de releasespagina. Pak ze uit naar een map in de systeempad, meestal /usr/local/bin.
Stel uitvoerbare rechten in:
| chmod +x /usr/local/bin/claude |
Alpine-gebruikers moeten compatibiliteit controleren voordat ze verder gaan. Sommige functies werken mogelijk niet identiek aan glibc-gebaseerde distributies.
Authenticatie en accountinstelling
Nadat Claude Code is geïnstalleerd, voert u claude uit in uw terminal. Bij de eerste lancering opent Claude Code een browsertabblad waar u kunt inloggen.
Dit opent de Claude authenticatiepagina. Log in met een bestaand Claude-account of maak een nieuw account aan.
De browser toont een autorisatiecode. Kopieer deze code en ga terug naar de terminal. Plak de code wanneer daarom wordt gevraagd.
Succesvolle authenticatie slaat inloggegevens lokaal op. Toekomstige sessies vereisen geen login, tenzij de inloggegevens verlopen of handmatig worden gewist.
Team- en zakelijke authenticatie
Volgens de officiële authenticatie documentatie hebben teams die Claude voor Teams of Enterprise gebruiken aanvullende opties. Organisaties kunnen single sign-on (SSO) of cloudproviderauthenticatie configureren.
SSO-configuratie vereist configuratie door de beheerder. Individuele ontwikkelaars authenticeren vervolgens via de identity provider van hun organisatie in plaats van persoonlijke Claude-accounts.
Cloudproviderauthenticatie werkt voor AWS-, Google Cloud- en Azure-implementaties. Deze methode gebruikt bestaande cloudinloggegevens in plaats van aparte Claude-accounts.
| Authenticatiemethode | Gebruiksscenario | Installatiecomplexiteit |
|---|---|---|
| Persoonlijk account | Individuele ontwikkelaars | Eenvoudig |
| Teams/Enterprise SSO | Organisaties | Vereist admin |
| Cloudprovider | AWS/GCP/Azure-gebruikers | Gemiddeld |
Desktop-app installatie
Claude Code biedt zowel command-line als desktopapplicaties. De desktop-app biedt een grafische interface met behoud van volledige terminalfunctionaliteit.
Download het desktop-installatieprogramma van de officiële Claude website. De pagina biedt versies voor macOS, Windows en Windows ARM64. Selecteer de juiste versie voor het systeem.
macOS-installatie volgt hetzelfde .dmg-proces als eerder beschreven. Windows-gebruikers kunnen de desktop-app downloaden voor een grafische interface zonder dat een WSL2-setup vereist is.
De desktop-app bevat geïntegreerde terminaltoegang. Het kan Claude Code-sessies starten zonder te schakelen naar externe terminalapplicaties.
Een voordeel van de desktop-app is beschikbaarheid op de achtergrond. Volgens de officiële downloadpagina blijft de app "klaar op de achtergrond" en kan deze vanuit elke app worden geopend zonder van venster te wisselen of de focus te verliezen.
Gebruik Get AI Perks om Kredieten te Vinden voor uw Claude Code Stack
Installatie is het gemakkelijke deel. De werkelijke kosten komen meestal van alles eromheen: infrastructuur, ondersteunende tools en betaalde services die tijdens de setup en het testen worden gebruikt. Get AI Perks kan helpen door startup-kredieten en kortingen op één plek te vermelden, samen met advies over hoe deze toe te passen.
Met Get AI Perks kunt u:
- Kredieten vinden voor cloud- en AI-gerelateerde tools
- Perk-voorwaarden controleren voordat u zich aanmeldt
- Verspilde tijd aan aanbiedingen waarvoor u mogelijk niet in aanmerking komt, voorkomen
- De kosten verlagen voor het opzetten van uw systeem
Bezoek Get AI Perks om te zien of de beschikbare aanbiedingen overeenkomen met de tools die u van plan bent te gebruiken met Claude Code.
IDE Extensies en Integraties
Naast standalone installatie integreert Claude Code met populaire ontwikkelomgevingen. Er zijn extensies voor Visual Studio Code en JetBrains IDEs.
De VS Code-extensie wordt geïnstalleerd via de marketplace. Zoek naar "Claude Code" in het paneel Extensies en klik op Installeren. De extensie vereist dat de command-line tool eerst is geïnstalleerd.
Sommige gebruikers melden problemen met het gebundelde VS Code-extensiebestand. Als de automatische installatie mislukt met een foutmelding "End of central directory record signature not found", kan het gebundelde .vsix-bestand beschadigd zijn.
De oplossing omvat het handmatig installeren van de extensie vanuit de VS Code marketplace in plaats van te vertrouwen op de gebundelde versie van de CLI. Dit scheidt de twee componenten en voorkomt installatieconflicten.
JetBrains-integratie werkt op vergelijkbare wijze. Installeer de plugin vanuit de JetBrains marketplace binnen IntelliJ IDEA, PyCharm, WebStorm of andere JetBrains-producten.
Installatie Succes Verifiëren
Correcte verificatie zorgt ervoor dat Claude Code correct werkt voordat de daadwerkelijke ontwikkelingstaken worden gestart.
Basale verificatie controleert de beschikbaarheid van commando's:
| claude --help claude --version |
Deze commando's zouden zonder fouten moeten worden uitgevoerd. Het helpcommando somt beschikbare opties op. Het versiecommando toont de geïnstalleerde release.
Functionele tests vereisen het starten van een sessie. Maak een testmap aan:
| mkdir test-project cd test-project claude |
Dit initialiseert een interactieve Claude Code-sessie. De tool zou de map (in dit geval leeg) moeten analyseren en een prompt moeten weergeven.
Probeer eenvoudige commando's binnen de sessie. Typ help om beschikbare acties te zien. Vraag eenvoudige taken zoals "maak een README-bestand" of "leg uit wat je kunt doen".
Succesvolle antwoorden geven aan dat de installatie correct is. Als er fouten optreden, hebben deze meestal betrekking op authenticatie, netwerkconnectiviteit of ontbrekende afhankelijkheden.
Update en versiebeheer
Claude Code wordt standaard automatisch bijgewerkt. De officiële documentatie legt uit dat de tool controleert op nieuwe versies en deze installeert zonder gebruikersinterventie.
Het updategedrag kan worden geconfigureerd via de instellingen van Claude Code. De officiële documentatie behandelt de configuratie van releasekanalen en handmatige update-opties.
Handmatige updates vereisen dat u het installatiescript opnieuw uitvoert. Hetzelfde commando als voor de initiële installatie haalt de nieuwste versie op:
| curl -fsSL claude.ai/install.sh | bash |
Het installeren van specifieke versies is mogelijk voor test- of compatibiliteitsredenen. De documentatie voor geavanceerde setup behandelt versie-vastlegging en configuratie van releasekanalen.
Releasekanalen omvatten stabiel, bèta en nightly. Stabiel wordt aanbevolen voor productiewerk. Bèta- en nightly-kanalen bieden vroege toegang tot nieuwe functies, maar kunnen bugs bevatten.
Veelvoorkomende installatieproblemen
Verschillende problemen komen vaak voor in communitydiscussies over de installatie van Claude Code.
PATH-configuratie veroorzaakt veel problemen. Als het claude-commando niet wordt gevonden na installatie, bevindt de binaries directory zich niet in het systeempad.
Op macOS en Linux omvat het toevoegen van de map aan PATH doorgaans het bewerken van ~/.bashrc, ~/.zshrc of vergelijkbare shell-configuratiebestanden. Het installatiescript regelt dit meestal automatisch, maar handmatige verificatie helpt bij het oplossen van problemen.
Windows-gebruikers in WSL2 moeten mogelijk de terminal sluiten en opnieuw openen na de installatie. De omgevingsvariabelen worden niet vernieuwd in bestaande sessies.
Netwerkbeperkingen blokkeren sommige installaties. Bedrijfsfirewalls of proxyservers kunnen voorkomen dat het installatieprogramma wordt gedownload of dat er verbinding wordt gemaakt met authenticatieservers.
Proxyconfiguratie vereist omgevingsvariabelen:
| export HTTP_PROXY= proxy.example.com:8080 export HTTPS_PROXY= proxy.example.com:8080 |
Rechtenfouten treden op bij installatie in beschermde mappen. Het installatieprogramma heeft schrijftoegang nodig tot /usr/local/bin of vergelijkbare locaties. Uitvoeren met sudo lost dit op, maar moet worden vermeden tenzij noodzakelijk.
Veelgestelde Vragen
Kan Claude Code draaien zonder internetverbinding?
Nee. Claude Code vereist internetconnectiviteit om te functioneren. De tool stuurt code en queries naar de servers van Anthropic voor verwerking. Lokale caching kan ervoor zorgen dat sommige bewerkingen tijdelijk offline werken, maar volledige functionaliteit vereist een actieve verbinding.
Werkt Claude Code met bestaande AI-codeertools?
Ja. Claude Code kan naast GitHub Copilot, Cursor of andere AI-ontwikkeltools draaien. Ze werken onafhankelijk en conflicteren niet. Het gelijktijdig gebruiken van meerdere AI-assistenten kan echter leiden tot verwarring over welke tool welke taak uitvoert.
Is WSL2 vereist voor alle Windows-functies?
De command-line tool vereist WSL2 op Windows. De desktopapplicatie draait echter native op Windows zonder WSL2. De desktop-app biedt vergelijkbare functionaliteit via een grafische interface in plaats van pure command-line interactie.
Hoeveel kost het gebruik van Claude Code?
De prijzen variëren op basis van gebruik en abonnementstype. Raadpleeg de officiële Claude-website voor de actuele prijzen, aangezien kosten en abonnementsstructuren in de loop van de tijd veranderen. Sommige functies vereisen Claude Pro- of Enterprise-abonnementen.
Kan Claude Code bestanden buiten de projectmap bewerken?
Standaard beperkt Claude Code de toegang tot bestanden tot de huidige projectmap om veiligheidsredenen. Configuratie-instellingen kunnen permissies uitbreiden, maar dit vereist expliciete autorisatie. De sandbox-documentatie behandelt permissiebeheer in detail.
Wat is het verschil tussen Claude Code en de Claude API?
Claude Code is een ontwikkelingstool voor interactieve code-assistentie. De Claude API biedt programmatische toegang voor het bouwen van applicaties die de AI-mogelijkheden van Claude gebruiken. Ze dienen verschillende doelen—één voor ontwikkelaars die code schrijven, de andere voor applicaties die AI-functies integreren.
Verwijdert de-installatie alle Claude Code-gegevens?
De-installatie verwijdert de applicatiebinaries, maar kan configuratiebestanden en gecachte gegevens achterlaten. Volledige verwijdering vereist het handmatig verwijderen van de map ~/.claude op macOS en Linux, of de equivalente AppData-locatie op Windows.
Aan de slag na installatie
Met Claude Code geïnstalleerd en geverifieerd, is de volgende stap het begrijpen hoe u het effectief kunt gebruiken.
De quickstart-documentatie raadt aan te beginnen met eenvoudige taken. Navigeer naar een bestaand project en voer claude uit om een interactieve sessie te starten.
Vraag Claude om de projectstructuur uit te leggen. Vraag om een samenvatting van wat de codebase doet. Deze verkennende vragen helpen begrijpen hoe de tool code interpreteert.
Probeer kleine wijzigingen aan te brengen. Vraag Claude om commentaar toe te voegen aan functies, eenvoudige testbestanden te maken of basale codeblokken te refactoren. Deze taken demonstreren bewerkingsmogelijkheden zonder risico.
Git-integratie werkt automatisch als het project versiebeheer gebruikt. Claude Code kan commits maken, diffs uitleggen en suggesties doen op basis van wijzigingen.
De officiële documentatie bevat workflowvoorbeelden voor veelvoorkomende ontwikkeltaken. Deze omvatten het oplossen van fouten, het implementeren van functies, codebeoordeling en geautomatiseerde tests.
Claude Code is een evoluerende tool. Installatie is slechts de basis. Het begrijpen van de mogelijkheden, beperkingen en best practices vereist experimenteren en oefenen.
Klaar om Claude Code te installeren? Download het juiste installatieprogramma voor uw platform van de officiële website en volg de stappen in deze gids. Authenticatie met uw Claude-account, verifieer dat de installatie correct werkt en begin met het verkennen van AI-ondersteunde ontwikkeling.
