Claude Code installeren Mac: officiële installer en Homebrew

Wat is Claude Code en waarom werkt het in de terminal?#

De terminal schrikt bijna iedereen af die zonder achtergrond in softwareontwikkeling met vibe coding begint. Hij ziet eruit als een zwart venster uit hackersfilms, maar in werkelijkheid is het gewoon een regel waarin je opdrachten typt. Claude Code heeft die terminal nodig om je bestanden te openen, ze te wijzigen en zelf controles uit te voeren terwijl jij de taak in woorden beschrijft.

Anthropic beschrijft het product als volgt.

Het verschil met een gewone chat is eenvoudig. In een browser kopieer je code met de hand heen en weer tussen het venster en je editor. Claude Code gaat zelf naar de projectmap, leest de benodigde bestanden, brengt de wijziging aan en laat zien wat hij heeft aangepast. Jij blijft degene die beslist en goedkeuring geeft; de tool doet het mechanische werk voor je.

Als je echt geen terminal wilt gebruiken, heeft Anthropic een desktopapp met een gewoon venster en een webversie op claude.ai/code die rechtstreeks in de browser werkt. De krachtigste en flexibelste optie is echter de terminalversie. Dit artikel gaat helemaal over die versie.

Waar staat de officiële Claude Code-website en wat moet je downloaden?#

Voor beginners is de eerste verwarring vaak waar de officiële Claude Code-website staat en waarop ze moeten klikken om het programma te downloaden. Hier vind je een tabel met alle officiële adressen van Anthropic, zodat je niet hoeft te gissen.

Je downloadt geen installatiebestand van de website zoals je bij een gewoon programma zou doen. Dat gaat tegen de verwachtingen in. Je installeert het met een terminalopdracht, die vervolgens de juiste versie voor je systeem downloadt. In dit artikel staan de precieze opdrachten voor Mac, Windows en Linux.

Een veelvoorkomende valkuil is de naam: mensen schrijven die vaak verkeerd als clode code, clade code, слод код of clode design. Het product heet Claude Code, met au. Houd dat in gedachten wanneer je de officiële website zoekt: domeinen met vergelijkbare spelling zijn van iemand anders.

Het is ook handig om de exacte naam van het npm-pakket te kennen. Het canonieke pakket is @anthropic-ai/claude-code, met het voorvoegsel @anthropic-ai/. Anthropic zelf beheert de korte naam claude-code zonder voorvoegsel; dat is hun officiële verwijzing naar hetzelfde pakket. De eenvoudige regel: Anthropic moet de uitgever zijn en voor de installatie gebruik je de naam met het voorvoegsel.

Wat heb je nodig om het te installeren: computervereisten#

De vereisten van Claude Code zijn bescheiden: de servers van Anthropic doen het zware werk; je computer verstuurt alleen verzoeken en ontvangt antwoorden.

Een aparte opmerking over Node.js, omdat daar de meeste misverstanden over bestaan. Het native installatieprogramma — dat Anthropic zelf aanbeveelt — heeft Node.js helemaal niet nodig: het installeert als één zelfstandig bestand. Node.js is alleen vereist als je Claude Code via npm installeert; dan heb je versie 22 of hoger nodig. In oudere artikelen staat “Node 18 en hoger”, maar dat is verouderd; ga uit van 22+.

Voor de hoofdversie heb je een terminal nodig. Wil je die niet gebruiken, installeer dan de desktopapp met het gewone venster of gebruik de webversie op claude.ai/code. De terminalversie heeft nog steeds meer mogelijkheden, dus de rest van dit artikel legt uit hoe je die installeert.

Claude Code installeren is alsof je een gereedschap in handen krijgt. Maar op zichzelf hallucineert het vaak: het vergeet je project, verzint dingen en raakt halverwege een taak de draad kwijt. Een combinatie van drie dingen maakt het betrouwbaar: een AI-kloon, een Second Brain en context engineering. Dat zijn de drie pijlers die AI ervan weerhouden te hallucineren.

Hoe Claude Code installeren op een Mac werkt#

Open Terminal (dat staat op elke Mac: druk op Cmd+Space in Spotlight en typ “Terminal”) en plak deze ene regel:

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

De opdracht downloadt het installatieprogramma vanaf het officiële adres van Anthropic en installeert Claude Code. Node.js is niet nodig. De native methode is ook handig vanwege de updates.

Als je Homebrew al gebruikt, is er een tweede optie:

brew install --cask claude-code

Het verschil zit in de manier waarop updates werken: het native installatieprogramma werkt zichzelf bij, Homebrew niet — je moet het handmatig bijwerken met de opdracht brew upgrade claude-code. Het programma zelf is hetzelfde, dus kies de methode die je gewend bent. Weet je het niet zeker, gebruik dan de eerste.

Hoe installeer je Claude Code op Windows?#

Bepaal eerst in welke omgeving je werkt. Windows heeft twee shells, elk met een eigen opdracht. Open een venster en kijk naar het begin van de prompt: PS C:\> betekent PowerShell, terwijl alleen C:\> zonder PS Opdrachtprompt (CMD) betekent.

Voor PowerShell (je opent dit het eenvoudigst door met de rechtermuisknop op de Startknop te klikken en “Terminal” te kiezen):

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

Voor Opdrachtprompt (CMD):

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Er is een derde optie: de ingebouwde pakketbeheerder WinGet gebruiken.

winget install Anthropic.ClaudeCode

Heb je al een werkende omgeving in WSL (Linux binnen Windows), installeer Claude Code dan rechtstreeks in WSL met dezelfde opdracht als op Linux. Er is een afzonderlijk aandachtspunt rond WSL en Node; dat bespreek ik hieronder in het gedeelte over veelvoorkomende fouten.

Hoe installeer je Claude Code op Linux?#

De basismethode is voor elke populaire distributie hetzelfde zelfstandige installatieprogramma:

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

Node.js is niet nodig; het programma bestaat uit één bestand en werkt zichzelf daarna bij.

Als je gewend bent programma’s alleen via de systeempakketbeheerder te installeren, kun je de officiële repositories van Anthropic toevoegen: apt voor Debian en Ubuntu, dnf voor Fedora en RHEL, en apk voor Alpine. Ze zijn ondertekend met een sleutel en hebben stabiele en nieuwste kanalen. Voor beginners is dat te veel gedoe, dus laat ik de details over aan de documentatie in het gedeelte Bronnen en raad ik standaard de bovenstaande opdracht aan.

Op goedkope servers kan één probleem optreden. Als de machine weinig vrij geheugen heeft, kan de installatie stoppen met het woord Killed (code 137) — het systeem heeft het proces beëindigd omdat het geheugen op was. De oplossing is een swapbestand toevoegen: Claude Code heeft ongeveer 512 MB vrij geheugen nodig voor de installatie.

Hoe start je Claude Code voor het eerst?#

De eerste keer starten duurt een paar minuten. Zo gaat het in zijn werk.

1. Ga naar de projectmap

   Gebruik in de terminal de opdracht cd path-to-project om naar de map te gaan waarin je wilt werken en typ vervolgens claude.

2. Meld je aan bij je account

   Er wordt een browservenster geopend om je aan te melden. Als het niet automatisch opent, druk dan op c om de link te kopiëren en plak die handmatig in een browser. Als de browser een code toont (dit kan gebeuren in WSL en op externe servers), plak die code dan terug in de terminal.

3. Wacht op bevestiging

   Nadat je bent aangemeld, verschijnt in de terminal Login successful en wordt gevraagd om op Enter te drukken.

4. Stel je eerste vraag

   Stel een eenvoudige vraag over het project, zoals “Wat doet dit project?” Claude leest de bestanden en geeft antwoord.

5. Keur de eerste wijziging goed

   Als je vraagt om iets te wijzigen, toont Claude de voorgestelde wijzigingen en vraagt het om bevestiging. Met Shift+Tab kun je tussen toegangsmodi wisselen.

Het is handig om meteen een paar basisopdrachten voor de sessie te leren: /help geeft een lijst met opdrachten, /clear wist de gespreksgeschiedenis en /exit sluit af (twee keer Ctrl+D doet hetzelfde). Als je /help typt, laat Claude dit allemaal zelf zien.

Aanmelden met een abonnement of API-sleutel: wat kies je?#

Dit is de eerste vraag die opkomt wanneer je je aanmeldt.

Je kunt je op twee manieren aanmelden; het verschil zit in hoe je betaalt.

Gebruik je Claude.ai-account om je met een abonnement aan te melden. Voor aanmelden met een API-sleutel haal je een sleutel op bij Claude Console (platform.claude.com); terwijl je werkt, worden de kosten van je vooraf opgeladen saldo afgetrokken. Stel de sleutel in via de omgevingsvariabele ANTHROPIC_API_KEY, zodat Claude Code niet telkens de browser opent.

Je kunt tijdens een sessie van account wisselen met /login en je afmelden met /logout.

Maar zonder betaalde toegang start Claude Code niet. Heb je nog geen account, bepaal dan eerst welk e-mailadres je wilt gebruiken om je te registreren: je kunt het later niet meer wijzigen.

Hoe controleer je of alles goed is geïnstalleerd?#

Er zijn drie opdrachten die handig zijn om meteen te kennen.

De eerste controleert de versie:

claude --version

Een werkende installatie antwoordt met een getal in de vorm X.Y.Z (Claude Code). De precieze cijfers verschillen per versie; het belangrijkste is dat de opdracht überhaupt een versienummer teruggeeft. De melding “command not found” betekent iets anders — dat bespreek ik in het volgende gedeelte.

De tweede opdracht is voor diagnose als er iets misgaat.

De derde opdracht is /status binnen een sessie: die laat zien hoe je bent aangemeld, welk e-mailadres of welke organisatie is gekoppeld en of je toegang is verlopen. Met claude update installeer je de nieuwste update meteen, zonder op de update op de achtergrond te wachten.

Waarom wordt de opdracht claude na de installatie niet gevonden?#

Dit is de meest voorkomende klacht van beginners en het klinkt enger dan het is. De terminal zoekt niet op de hele computer naar opdrachten; hij controleert alleen de mappen in PATH. Claude Code plaatst zichzelf in ~/.local/bin/claude (op Mac en Linux) of %USERPROFILE%\\.local\\bin\\claude.exe (op Windows). Staat die map niet in PATH, dan kan de terminal het programma niet vinden.

Voeg de map op Mac en Linux toe aan de lijst. Open het instellingenbestand van je shell (~/.zshrc voor Zsh, ~/.bashrc voor Bash) en voeg deze regel onderaan toe:

export PATH="$HOME/.local/bin:$PATH"

Sluit de terminal en open hem opnieuw (of voer source ~/.zshrc uit). Daarna wordt claude gevonden.

Veelvoorkomende fouten bij installatie en de eerste keer starten#

We lopen ze op volgorde door; ze komen allemaal uit de officiële probleemoplossingsgids van Anthropic.

1. Oude Node-versie bij installatie via npm. Het pakket @anthropic-ai/claude-code vereist Node.js 22 of hoger. Op Windows kan npm mislukken met een melding dat scripts zijn uitgeschakeld — het beleid van PowerShell houdt ze tegen. In WSL is een veelvoorkomende fout exec: node: not found: WSL gebruikt de Windows-versie van Node in plaats van de Linux-versie. Krijg je problemen met npm, stap dan over op het native installatieprogramma; daarvoor is Node niet nodig.
2. Verkeerd installatieprogramma voor de shell. 'irm' is not recognized betekent dat je een PowerShell-opdracht in Opdrachtprompt hebt geplakt. The token '&&' is not a valid statement separator betekent het omgekeerde: je hebt een CMD-opdracht in PowerShell uitgevoerd. A parameter cannot be found that matches parameter name 'fsSL' betekent dat je de opdracht voor Mac/Linux in PowerShell hebt uitgevoerd. Controleer het begin van de prompt: PS C:\ is PowerShell en C:\ is CMD.
3. Een oude API-sleutel krijgt voorrang op het abonnement. Als je abonnement actief is maar er nog een oude sleutel in je omgeving is ingesteld, zie je API Error: 400 ... This organization has been disabled. De sleutel krijgt voorrang op aanmelden met een abonnement. Verwijder hem met unset ANTHROPIC_API_KEY (gebruik in PowerShell Remove-Item Env:ANTHROPIC_API_KEY), controleer ~/.zshrc en ~/.bashrc en typ daarna /status.
4. Te weinig geheugen op een zwakke server. De installatie stopt met het woord Killed en code 137 — dat betekent dat er niet genoeg RAM is. Je hebt ongeveer 512 MB vrij nodig; extra swap verhelpt dit.
5. Het installatieprogramma gaf iets anders terug. De fout syntax error near unexpected token '<' of een verwijzing naar <!DOCTYPE html> betekent dat de installatie-URL een webpagina heeft teruggegeven in plaats van het installatiescript — meestal door je regio, een bedrijfsfirewall of een tijdelijke storing. Probeer een andere methode (Homebrew, WinGet) of probeer het over een paar minuten opnieuw.

Bij elk van deze fouten is de eerste stap hetzelfde: voer claude doctor uit. Het laat zien wat er stuk is en waar je moet zoeken.

Er is hierbij een diagnostische complicatie: een losse 403 tijdens de installatie kan ook afkomstig zijn van een bedrijfsfirewall of proxy. Zit je op een kantoornetwerk, controleer dan eerst of die de toegang blokkeert.

Wat doe je na de installatie: eerste stappen#

Installeren is pas het begin. Het echte werk begint daarna en het eerste waar mensen tegenaan lopen, is geheugen. Een taalmodel onthoudt je niet tussen gesprekken: in een nieuwe chat weet het alleen wat je in de context hebt gezet.

De eerste echte stap na de installatie is daarom een bestand CLAUDE.md aanmaken in de hoofdmap van je project. Het is een tekstbestand met projectregels en context dat Claude Code bij elke start leest. Beschrijf één keer wat je doet, hoe het project is georganiseerd en wat belangrijk is — dan hoef je dat niet in elk gesprek te herhalen.

In een aparte gids leg ik uit hoe je dat bestand samenstelt en Claude aanpast: Claude aanpassen. Ik heb ook een algemeen overzicht gemaakt van vibe-codingtools voor 2026.

Wat vragen mensen nog meer?#

Het complete vibe-codingframework: AI-kloon + Second Brain + Context engineering.