Claude Code installeren: commando’s voor Windows, macOS en Linux, API-sleutel zonder abonnement en betalen met iDEAL

Claude Code installeer je met één officieel commando: op macOS, Linux en WSL met curl -fsSL https://claude.ai/install.sh | bash, op Windows in PowerShell met irm https://claude.ai/install.ps1 | iex (in de Opdrachtprompt, CMD, met de install.cmd-regel hieronder). Daarna kies je hoe je betaalt. Je logt in met een Pro-, Max-, Team-, Enterprise- of Console-account (het gratis Claude.ai-abonnement bevat geen Claude Code), of je gebruikt zonder abonnement een API-sleutel: je zet ANTHROPIC_BASE_URL (alleen het domein, zonder /v1), ANTHROPIC_AUTH_TOKEN en drie modelvariabelen, en controleert met /status of de sleutel actief is. Het Kunavo-tegoed waardeer je op met iDEAL (Nederland) of Bancontact (België), vanaf $10, zonder maandbedrag.

Commando’s en variabelen gecontroleerd op 3 oktober 2026 in de officiële installatiedocumentatie van Claude Code en de documentatie over omgevingsvariabelen; prijzen en betaalmethoden gecontroleerd op 3 oktober 2026. Nederland en België staan allebei op de lijst van landen die Anthropic ondersteunt (gecontroleerd op 3 oktober 2026), zowel voor Claude.ai als voor de API. Deze handleiding bestaat ook in het Engels: Install Claude Code.

Voor je installeert

Claude Code installeren op macOS en Linux

Open Terminal en plak deze regel:

# macOS, Linux, WSL
curl -fsSL https://claude.ai/install.sh | bash

Dit is de aanbevolen, native installatie: één zelfstandig programma dat zichzelf op de achtergrond bijwerkt. Het commando claude komt in ~/.local/bin terecht. Een terminal die al openstond kent het nieuwe PATH nog niet, dus open eerst een nieuw venster voordat je test. In WSL gebruik je precies dezelfde regel, in de WSL-terminal.

Claude Code installeren op Windows

Op Windows zijn er twee regels, en welke je nodig hebt hangt alleen af van het venster dat je open hebt. Begint de prompt met PS C:\Users\Naam>, dan zit je in PowerShell; staat er alleen C:\Users\Naam> zonder PS, dan is het de Opdrachtprompt (CMD). Je hoeft het venster niet als administrator te openen: volgens de officiële documentatie is dat niet nodig.

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

:: Windows Opdrachtprompt (CMD)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

De meest gemaakte fout is de regel in het verkeerde venster plakken. De CMD-regel in PowerShell geeft The token '&&' is not a valid statement separator; de PowerShell-regel in CMD geeft 'irm' is not recognized as an internal or external command. Op een Nederlandstalige Windows kan die tweede melding in het Nederlands verschijnen, met dezelfde oorzaak. En de macOS-regel met | bash in PowerShell geeft een foutmelding dat bash niet wordt herkend. In alle drie de gevallen: gebruik de regel die bij je venster hoort.

Git for Windows is optioneel. Staat het erop, dan voert Claude Code commando’s uit via de meegeleverde Git Bash; zonder Git gebruikt het PowerShell. Is Git wel geïnstalleerd maar wordt Git Bash niet gevonden, zet dan CLAUDE_CODE_GIT_BASH_PATH in het env-blok van ~/.claude/settings.json op het pad naar bash.exe; het voorbeeldpad in de documentatie is C:\Program Files\Git\bin\bash.exe.

WSL is dus geen vereiste, zoals sommige oudere handleidingen beweren, maar een keuze. Kies je WSL, voer dan de macOS/Linux-regel uit in de WSL-terminal en start claude ook daar, niet vanuit PowerShell of CMD.

Via Homebrew, WinGet of npm

Dat kan ook, met één belangrijk verschil: volgens de officiële documentatie werken Homebrew- en WinGet-installaties niet vanzelf bij. Bijwerken doe je dan zelf:

# Homebrew (macOS)
brew install --cask claude-code
brew upgrade claude-code              # bijwerken gebeurt niet vanzelf

# WinGet (Windows)
winget install Anthropic.ClaudeCode
winget upgrade Anthropic.ClaudeCode   # bijwerken gebeurt niet vanzelf

Het npm-pakket vraagt Node.js 22 of nieuwer, niet Node.js 18 zoals oudere handleidingen nog schrijven. Met een oudere Node.js toont npm alleen een EBADENGINE-waarschuwing en gaat de installatie gewoon door: het pakket installeert hetzelfde native programma, dat Node.js niet nodig heeft om te draaien. Gebruik nooit sudo npm install -g: dat geeft rechtenproblemen en is een veiligheidsrisico. Bijwerken doe je met @latest, niet met npm update -g.

node -v                                           # moet v22 of hoger zijn
npm install -g @anthropic-ai/claude-code          # nooit met sudo

# later bijwerken: met @latest, niet met npm update -g
npm install -g @anthropic-ai/claude-code@latest

Installatie controleren

claude --version   # toont het versienummer, gevolgd door (Claude Code)
claude doctor      # alleen-lezen diagnose van installatie en instellingen, start geen sessie

claude doctor start geen sessie, maar toont de staat van de installatie en van je instellingenbestanden. Zo zie je snel of een probleem in de installatie of in de configuratie zit.

Krijg je command not found: claude, of meldt Windows dat claude niet wordt herkend, dan staat de installatiemap niet in je PATH. Open eerst een nieuw terminalvenster. Helpt dat niet, zet dan op macOS en Linux ~/.local/bin in je PATH via ~/.zshrc of ~/.bashrc. Op Windows is de map %USERPROFILE%\.local\bin; volgens de officiële probleemoplossing controleer en voeg je die zo toe in PowerShell:

# 1. Staat de installatiemap al in je PATH?
$env:PATH -split ';' | Select-String '\.local\\bin'

# 2. Geen uitvoer? Voeg de map toe aan je gebruikers-PATH en open een nieuw venster
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

# 3. In het nieuwe venster: twee paden betekent twee installaties naast elkaar
where.exe claude

Installeer je via npm en meldt PowerShell npm.ps1 cannot be loaded because running scripts is disabled on this system, dan blokkeert het uitvoeringsbeleid van PowerShell de startscripts van npm. Gebruik de native installer, start npm.cmd en claude.cmd, of sta lokale scripts toe voor je eigen gebruiker:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Eerste start: abonnement of API-sleutel

Bij de eerste start kies je hoe Claude Code wordt betaald. De twee routes sluiten elkaar uit: is een API-sleutel ingesteld, dan blijft een opgeslagen login ongebruikt; haal je de variabele weg, dan valt Claude Code terug op de login, zonder opnieuw te installeren.

Route A: inloggen met je abonnement

Start claude in je projectmap en log in via de browser. Eén valkuil: staat ANTHROPIC_API_KEY al ingesteld, dan vraagt Claude Code één keer of het die sleutel moet gebruiken. Weiger je, dan negeert het de sleutel daarna zonder het nog eens te vragen, en lijkt het alsof de variabele niet wordt gelezen. Zet hem weer aan via /config → Use custom API key.

Route B: zonder abonnement, met een API-sleutel

ANTHROPIC_BASE_URL is een ingebouwde variabele van Claude Code. Volgens de officiële documentatie overschrijft hij het API-endpoint, om verzoeken via een proxy of gateway te sturen. Claude Code naar een endpoint met de Anthropic Messages API laten wijzen is dus een ondersteunde configuratie, zonder plug-in en zonder aangepaste versie. De stappen:

1. Maak een Kunavo-account aan.
2. Waardeer je tegoed op via Billing, vanaf $10 (iDEAL en Bancontact staan verderop).
3. Maak op /app/keys een sleutel aan die met sk-kn- begint. Hij wordt maar één keer getoond, dus bewaar hem meteen.
4. Zet de variabelen. Op macOS en Linux in ~/.zshrc of ~/.bashrc:

export ANTHROPIC_BASE_URL=https://api.kunavo.com   # alleen het domein, zonder /v1
export ANTHROPIC_AUTH_TOKEN=sk-kn-...
export ANTHROPIC_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5

Op Windows, om eerst in één PowerShell-venster te testen:

# Geldt alleen voor dit PowerShell-venster
$env:ANTHROPIC_BASE_URL = "https://api.kunavo.com"
$env:ANTHROPIC_AUTH_TOKEN = "sk-kn-..."
$env:ANTHROPIC_MODEL = "claude-sonnet-5"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL = "claude-opus-5"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "claude-haiku-4-5"
claude

Voor vast gebruik is het env-blok van je gebruikersinstellingen de beste plek: ~/.claude/settings.json (op Windows %USERPROFILE%\.claude\settings.json). Daar gelden de waarden overal waar Claude Code draait, ook voor achtergrondagents. Variabelen uit je shell gelden alleen voor dat terminalvenster: een editor die je vanuit het Dock of het Startmenu opent, ziet ze niet. Staan er al andere instellingen in het bestand, voeg dan alleen het env-blok toe:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.kunavo.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-kn-...",
    "ANTHROPIC_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5"
  }
}

Zet de sleutel nooit in de .claude/settings.json van een project: volgens de officiële gatewaydocumentatie (gecontroleerd op 3 oktober 2026) wordt dat bestand gecommit en gedeeld met iedereen die de repository kloont. Let ook op de volgorde: zetten zowel je shell als een instellingenbestand dezelfde variabele, dan wint het instellingenbestand. Heeft een gewijzigde shellvariabele geen effect, kijk dan eerst in settings.json.

Elke regel heeft zijn eigen valkuil:

• ANTHROPIC_BASE_URL is alleen het domein. Claude Code zet er zelf /v1/messages achter; met /v1 aan het eind gaat het verzoek naar /v1/v1/messages en krijg je een 404.
• Gebruik ANTHROPIC_AUTH_TOKEN, niet ANTHROPIC_API_KEY. Volgens de documentatie gaat ANTHROPIC_AUTH_TOKEN mee als Authorization-header met Bearer ervoor en geldt hij meteen. ANTHROPIC_API_KEY gaat in de x-api-key-header en moet in de interactieve modus eerst één keer worden goedgekeurd (zie route A).
• Schrijf de modelnaam in ANTHROPIC_MODEL exact. Kunavo herkent alleen de exacte naam en vertaalt geen oude namen met een datum erachter.
• Zet ook ANTHROPIC_DEFAULT_OPUS_MODEL vast. Volgens de documentatie over modelconfiguratie (gecontroleerd op 3 oktober 2026) wijzen de standaardinstelling en de alias opus voor API-gebruikers naar Opus 5.5 en de alias sonnet naar Sonnet 5.5, en schuiven die aliassen mee met nieuwe versies. Vastzetten doe je met de volledige modelnaam of met variabelen als ANTHROPIC_DEFAULT_OPUS_MODEL. Kunavo biedt Sonnet 5.5 nu niet aan, en een nieuw Opus-model staat er niet altijd meteen; een model dat er niet is, geeft een 404. Wissel je graag met /model sonnet, voeg dan ook ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5 toe.
• ANTHROPIC_DEFAULT_HAIKU_MODEL geldt ook voor achtergrondtaken. Volgens de documentatie bepaalt deze variabele de alias haiku en het model voor achtergrondfuncties, zoals sessietitels. Met Claude Haiku 4.5 blijven die goedkoop.

Gebruik je de VS Code-extensie, zet de variabelen dan in claudeCode.environmentVariables, in de gebruikersinstellingen van VS Code zelf (opdracht Preferences: Open User Settings (JSON)). De extensie controleert de inloggegevens daar al voordat ze start; waarden uit ~/.claude/settings.json bereiken wel het gestarte proces, maar niet die controle.

{
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://api.kunavo.com" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-kn-..." },
    { "name": "ANTHROPIC_MODEL", "value": "claude-sonnet-5" },
    { "name": "ANTHROPIC_DEFAULT_OPUS_MODEL", "value": "claude-opus-5" },
    { "name": "ANTHROPIC_DEFAULT_HAIKU_MODEL", "value": "claude-haiku-4-5" }
  ]
}

Prijzen per miljoen tokens, uit de Kunavo-catalogus; de lijstprijs van Anthropic komt van claude.com/pricing (gecontroleerd op 3 oktober 2026):

Binnen een sessie wissel je met /model claude-opus-5, of je start meteen met claude --model claude-opus-5. Wat een maand Claude Code ongeveer kost en wanneer een abonnement voordeliger is, staat in Claude Code pricing (Engelstalig); je eigen verbruik reken je uit met de Claude-tokencalculator. Alle modellen en prijzen staan op de prijspagina.

Controleren met /status

Start claude. Met ANTHROPIC_AUTH_TOKEN ingesteld krijg je geen inlogscherm: de variabele geldt meteen. Zie je toch het inlogscherm, dan heeft Claude Code geen sleutel gelezen. Zet hem dan op een plek die Claude Code vóór de eerste-startwizard leest: een export in je shell of het env-blok van ~/.claude/settings.json. Een env-blok in de .claude/settings.json of .claude/settings.local.json van een project geldt in een interactieve sessie pas na de eerste-startwizard en de vraag of je de map vertrouwt.

Typ in de sessie /status en kijk op het tabblad Status naar twee regels (bron: de officiële gatewaydocumentatie, gecontroleerd op 3 oktober 2026):

• Anthropic base URL moet https://api.kunavo.com tonen. Deze regel verschijnt alleen als er een gateway-adres is ingesteld; ontbreekt hij, dan heeft ANTHROPIC_BASE_URL de sessie niet bereikt.
• Auth token moet ANTHROPIC_AUTH_TOKEN noemen. Zie je in plaats daarvan Login method met een claude.ai-account, dan is de variabele niet gelezen en draait de sessie op je abonnement.

Was je eerder ingelogd met een abonnement, dan kan Claude Code bij het starten waarschuwen dat er twee inlogbronnen actief zijn (de melding eindigt op auth may not work as expected). De verzoeken gaan dan via de sleutel; met /logout ruim je de oude login op.

Wil je adres en sleutel testen voordat je Claude Code opent? Stuur dan, zoals de documentatie voorstelt, een verzoek van één outputtoken; dat kost een heel klein beetje tegoed. De commando’s lezen de variabelen uit je shell, dus zet ze daar ook als ze al in settings.json staan.

curl -sS -w '\n%{http_code}\n' -X POST "$ANTHROPIC_BASE_URL/v1/messages" \
  -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model": "claude-sonnet-5", "max_tokens": 1, "messages": [{"role": "user", "content": "."}]}'

Invoke-RestMethod -Method Post -Uri "$env:ANTHROPIC_BASE_URL/v1/messages" `
  -Headers @{ "Authorization" = "Bearer $env:ANTHROPIC_AUTH_TOKEN"; "anthropic-version" = "2023-06-01" } `
  -ContentType "application/json" `
  -Body '{"model": "claude-sonnet-5", "max_tokens": 1, "messages": [{"role": "user", "content": "."}]}'

Een JSON-antwoord dat begint met {"id":"msg_ betekent dat adres en sleutel werken; in PowerShell zie je een id die met msg_ begint. Een 401 betekent dat de sleutel is geweigerd.

Wat anders werkt met een API-sleutel

• Geen Remote Control en geen spraakdicteren. Beide hebben een claude.ai-account nodig en zijn niet beschikbaar zolang ANTHROPIC_AUTH_TOKEN actief is; Remote Control staat bovendien uit zolang ANTHROPIC_BASE_URL naar een adres buiten Anthropic wijst.
• /fast meldt dat fast mode uit staat. Met alleen een bearer-token behandelt Claude Code fast mode als uitgeschakeld, zonder de controle te versturen.
• MCP tool search staat standaard uit zodra ANTHROPIC_BASE_URL naar een adres buiten Anthropic wijst.
• De getallen in /context zijn een benadering: Kunavo biedt /v1/messages/count_tokens nu niet aan. Volgens de officiële compatibiliteitsdocumentatie voor gateways (gecontroleerd op 3 oktober 2026) valt Claude Code zonder dat endpoint terug op een schatting op basis van tekens, dus /context toont benaderde aantallen.

Code, tools, subagents, MCP-servers, hooks en prompt caching werken zoals altijd. Meer details staan in de Claude Code-integratiedocumentatie (Engelstalig) en in Claude Code without a subscription (Engelstalig).

Betalen met iDEAL of Bancontact

Een Claude-abonnement betaal je via de website alleen met een creditcard of debitcard (Claude-helpartikel over betaalde abonnementen, gecontroleerd op 3 oktober 2026); de prijzen op claude.com/pricing zijn exclusief belasting.

Het Kunavo-tegoed waardeer je op via Stripe Checkout. De prijzen staan in Amerikaanse dollars; voor kopers in Nederland en België toont Stripe het bedrag in euro’s. Volgens de Stripe-documentatie over Adaptive Pricing (gecontroleerd op 3 oktober 2026) zit in die wisselkoers een omrekenopslag van 2–4% die de koper betaalt; wie in dollars betaalt (met een kaart, Apple Pay, Google Pay of Link), betaalt die opslag niet. iDEAL en Bancontact werken alleen in euro’s. Op de betaalpagina worden aangeboden:

• iDEAL, voor Nederland. De methode heet inmiddels iDEAL | Wero (Stripe vroeg om die naam in het eerste kwartaal van 2026 over te nemen), dus ook die naam kun je op de betaalpagina zien. Je wordt doorgestuurd naar de omgeving van je eigen bank en bevestigt daar (Stripe over iDEAL, gecontroleerd op 3 oktober 2026).
• Bancontact, voor België, met je Bancontact-kaart of de app (Stripe over Bancontact, gecontroleerd op 3 oktober 2026).
• Kaarten (Visa, Mastercard), Apple Pay, Google Pay en Link.

Niet aangeboden: PayPal, SEPA-incasso, Klarna in een euro-checkout, Tikkie, Riverty (het vroegere AfterPay) en een gewone bankoverschrijving.

1. Maak een Kunavo-account aan.
2. Kies op Billing een bedrag, minimaal $10. Wie meer in één keer opwaardeert, krijgt extra tegoed: bij $100 krijg je $110, bij $1.000 krijg je $1.200, bij $5.000 krijg je $6.250.
3. Kies op de Stripe-betaalpagina iDEAL of Bancontact en rond de betaling af in de omgeving van je bank (iDEAL) of met de Bancontact-app of -kaart. Het bedrag in euro’s zie je op de betaalpagina voordat je bevestigt.
4. Maak op /app/keys een sleutel aan en vul die in bij ANTHROPIC_AUTH_TOKEN.

Het tegoed is vooruitbetaald: geen maandbedrag, het tegoed vervalt niet en mislukte verzoeken worden niet in rekening gebracht. Automatisch opwaarderen kan alleen met een opgeslagen kaart of Link; met iDEAL en Bancontact waardeer je dus steeds handmatig op. Kunavo geeft geen btw-facturen uit; je opwaardeergeschiedenis staat op Billing. Deze betaalmethoden waarderen alleen je Kunavo API-tegoed op: een Claude Pro- of Max-abonnement betaal je er niet mee. Meer over betalen in euro’s: Claude betalen met iDEAL.

Veelvoorkomende fouten

Na de installatie

Start je voor het eerst in een project, typ dan /init: Claude Code leest de repository en maakt een CLAUDE.md met de testcommando’s en conventies die het vindt. Controleer dat bestand en houd het kort, want het wordt in elke sessie geladen. Tussen losse taken begint /clear een nieuw gesprek; wordt een taak lang, dan vat /compact de geschiedenis samen en werk je verder.

Wat je moet weten

• Dit is een API met betaling per token, geen Claude Pro- of Max-abonnement. Wie Claude Code elke dag urenlang gebruikt, is met een abonnement vaak goedkoper uit; per token betalen past bij wisselend gebruik, en een maand niets doen kost niets. De vergelijking staat in Claude Code pricing (Engelstalig).
• Met een API-sleutel zijn Remote Control en spraakdicteren niet beschikbaar.
• Via Kunavo gebruik je gedeelde capaciteit, zonder gereserveerd quotum en zonder contractuele garanties; heb je die nodig, sluit dan rechtstreeks een contract met Anthropic.
• iDEAL en Bancontact zijn alleen voor handmatig opwaarderen; automatisch opwaarderen kan alleen met een kaart of Link.
• Bedragen in euro’s bevatten de omrekenopslag van Stripe. Kunavo geeft geen btw-facturen uit.

Veelgestelde vragen