Claude Code installeren en inloggen, op je laptop en je server

Claude Code installeer je met één commando van Anthropic zelf, en daarna log je één keer in met je Claude-account. Op een Mac en onder Linux, dus ook op een server, is dat commando hetzelfde. Op Windows gebruik je een eigen variant in PowerShell. Je start Claude Code met claude, en bijwerken gaat vanzelf. Hieronder loop ik de stappen langs, met de plekken waar het bij beginners vaak hapert. Wat Claude Code eigenlijk is, lees je in Wat is Claude Code?

Wat je nodig hebt

Je hebt een betaald Claude-account nodig. Dat kan Pro of Max zijn, of een account via je werk (Team of Enterprise). Wie liever per gebruik betaalt, kan ook een account in de Console van Anthropic gebruiken. Het gratis abonnement geeft geen toegang tot Claude Code. Welke keuze bij je past, staat in Wat Claude Code kost; voor de prijzen kijk je op claude.com/pricing.

Verder heb je een computer nodig met minstens vier gigabyte werkgeheugen en een recent besturingssysteem: macOS 13 of nieuwer, Windows 10 (versie 1809) of nieuwer, of een gangbare Linux zoals Ubuntu 20.04 of nieuwer. Dat staat in de installatiehandleiding van Anthropic. En je hebt een terminal nodig, het venster waarin je commando’s typt. Heb je dat nog nooit geopend, lees dan eerst De terminal voor beginners.

Installeren op een Mac of onder Linux

Open de terminal en plak dit commando:

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

Het eerste deel, curl, haalt het installatiescript op bij claude.ai. Het rechte streepje met bash erachter geeft dat script door aan de terminal, die het uitvoert. Het script zet Claude Code in je eigen thuismap. Je hebt er dus geen sudo voor nodig, het commando waarmee je iets als beheerder uitvoert. Gebruik je dat toch, dan komt Claude Code bij de beheerder terecht in plaats van bij jou.

Open daarna een nieuw terminalvenster en typ claude --version. Werkt de installatie, dan verschijnt er een versienummer, gevolgd door (Claude Code). Meldt de terminal dat claude niet bestaat, dan kent het venster waarin je installeerde het nieuwe programma nog niet. Een vers venster lost dat meestal op.

Wie op een Mac Homebrew gebruikt, kan ook installeren met brew install --cask claude-code. Die versie werkt zichzelf alleen niet bij, dus dan moet je af en toe zelf brew upgrade claude-code typen.

Plak een installatiecommando alleen als je het zelf van de officiële pagina hebt overgenomen. Een commando uit een onbekende bron kan alles op je computer installeren wat de afzender maar wil.

Installeren op Windows

Op Windows open je PowerShell. Je herkent het aan PS aan het begin van de regel waarop je typt. Plak dan dit commando:

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

Krijg je een melding dat irm niet herkend wordt, dan zit je in de gewone opdrachtprompt (CMD) in plaats van in PowerShell. Voor CMD staat een eigen commando op de installatiepagina. Je hoeft PowerShell niet als beheerder te openen.

Anthropic raadt aan om op Windows ook Git for Windows te installeren. Claude Code kan dan dezelfde soort commando’s gebruiken als op een Mac of een server. Zonder Git for Windows werkt het ook, maar dan voert Claude Code zijn commando’s uit in PowerShell.

Op je eigen server

Op een server gaat het installeren precies zoals onder Linux: log in met SSH en plak hetzelfde curl-commando. Doe dat als je eigen gebruiker en niet als root, de beheerder van de server. Claude Code komt dan in jouw thuismap terecht, en daar hoort hij. Richt je je server in tijdens de retraitedag of met het online programma, dan staat Claude Code er al op en hoef je alleen nog in te loggen.

Op een heel kleine server kan het werkgeheugen krap zijn. Volgens Anthropic heeft het installeren ongeveer 512 MB vrij geheugen nodig. Krijg je tijdens het installeren de melding Killed, dan was het geheugen op. Wisselgeheugen op de schijf (swap) lost dat meestal op. De stappen daarvoor, en de oplossing voor andere foutmeldingen, staan op de pagina met oplossingen voor installatieproblemen.

Inloggen

Ga in de terminal naar de map waarin je wilt werken en typ claude. Bij de eerste start loop je een korte instelronde door, met onder meer de keuze voor een kleurenschema. Daarna volgt het inloggen.

Een voorbeeld. Lotte is fotograaf. Op haar laptop gebruikt ze Claude Code om mappen met foto’s te ordenen, en op haar server bouwt Claude aan haar website. Op de laptop opent het inloggen vanzelf haar browser. Op de server kan dat niet, want daar draait geen browser. Daar gaat het zo:

1. Kies voor inloggen met je Claude-abonnement. Kies niet voor de Console, want die rekent per gebruik af.
2. Claude Code toont een inloglink. Kopieer die met c of met de muis, en plak hem in de browser van je laptop.
3. Meld je in de browser aan met het account dat bij je abonnement hoort, en sta de koppeling toe.
4. De browser toont een code. Plak die in de terminal, achter Paste code here if prompted, en druk op Enter.
5. Na de melding Login successful ga je met Enter verder.

Weigert het invoerveld je code, gebruik dan claude auth login. Daarmee plak je de code op een gewone regel van de terminal, en dat lukt vaak wel. Controleer daarna in Claude Code met /status met welk account je bent ingelogd.

Je login blijft bewaard, ook na een herstart. Op Linux staat hij in het bestand ~/.claude/.credentials.json, dat alleen jouw gebruiker kan lezen. Iemand die onder jouw naam op de server komt, kan dus ook je Claude-account gebruiken. Ga daarom zorgvuldig om met je SSH-sleutel; hoe dat werkt, staat in Inloggen met een sleutel in plaats van een wachtwoord. Uitloggen doe je met /logout, opnieuw of met een ander account inloggen met /login. Alle varianten staan in de uitleg over inloggen.

Eén valkuil wil ik apart noemen. Staat er op je computer een instelling ANTHROPIC_API_KEY, bijvoorbeeld van een eerder experiment, dan gebruikt Claude Code die sleutel in plaats van je abonnement. Je betaalt dan per gebruik via de API. Met /status zie je welke manier actief is.

Bijwerken

Claude Code krijgt vaak nieuwe versies. Een installatie met het officiële commando werkt zichzelf op de achtergrond bij. Bij het starten en af en toe tijdens het werk kijkt Claude Code of er een nieuwe versie is. Die haalt hij binnen, en de volgende keer dat je claude start, werk je ermee. Wie niet wil wachten, haalt de nieuwste versie direct op met claude update.

Doet Claude Code vreemd, typ dan claude doctor. Dat controleert je installatie en je instellingen en laat zien hoe de laatste update verliep, zonder iets te veranderen. Vaak staat er meteen bij wat je kunt doen.

Staat claude --version er en zie je bij /status het goede account, dan ben je klaar om te beginnen. Begin in een lege map met een kleine opdracht, bijvoorbeeld een eenvoudige pagina over jezelf, en lees mee wat er gebeurt. Na de eerste sessie weet je meteen of alles werkt, en anders heb je met claude doctor en de hulppagina een goed begin om het uit te zoeken.