Terug naar handleidingen
Installatie·3 oktober 2026·Bijgewerkt op 13 november 2026·12 min. leestijd

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

Claude Code installeer je met één commando. Vastlopen doe je meestal daarna: in het verkeerde Windows-venster, op het PATH of op de Node.js-versie bij npm. En dan moet je nog een API-sleutel instellen zonder abonnement.

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 vier modelvariabelen, en controleert met /status of de sleutel actief is. Het Kunavo-tegoed waardeer je op 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 13 november 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

OnderdeelVereiste (officiële installatiedocumentatie, gecontroleerd op 3 oktober 2026)
BesturingssysteemmacOS 13.0 of nieuwer; Windows 10 1809 of nieuwer, of Windows Server 2019 of nieuwer; Ubuntu 20.04+; Debian 10+; Alpine Linux 3.19+
HardwareMinstens 4 GB RAM, x64- of ARM64-processor (geen 32-bits Windows)
ShellBash, Zsh, PowerShell of CMD
Netwerk en locatieInternetverbinding, in een land dat Anthropic ondersteunt (Nederland en België staan erop)
AccountOm in te loggen heb je Pro, Max, Team, Enterprise of Console nodig; het gratis Claude.ai-abonnement bevat geen Claude Code. Met een API-sleutel heb je geen abonnement nodig en log je niet in.
Node.jsAlleen voor de npm-route, en dan versie 22 of nieuwer; de native installer heeft het niet nodig

Claude Code installeren op macOS en Linux

Open Terminal en plak deze regel:

Terminal
# 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.

PowerShell
# Windows PowerShell
irm https://claude.ai/install.ps1 | iex
cmd.exe
:: 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.

OptieWat je nodig hebtSandboxingWanneer kiezen
Native WindowsNiets; Git for Windows optioneelNiet ondersteundProjecten en tools die op Windows zelf draaien
WSL 2WSL 2 ingeschakeldOndersteundLinux-gereedschap nodig, of commando’s in een sandbox
WSL 1WSL 1 ingeschakeldNiet ondersteundAls WSL 2 niet beschikbaar is

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.

Terminal
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:

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:

PowerShell
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 een abonnementRoute B: API-sleutel, zonder abonnement
Wat je nodig hebtPro-, Max-, Team-, Enterprise- of Console-accountEen Kunavo-sleutel die met sk-kn- begint
Hoe je betaaltPro en Max: vast bedrag per maand; Console: per token bij AnthropicPer token, van vooruitbetaald tegoed; geen maandbedrag
BetaalmethodeVia de website alleen credit- of debitcardUSDT of USDC, of een lokale methode in 7 markten; kaarten worden ingeschakeld
Remote Control en spraakdicterenBeschikbaar: beide werken alleen met een claude.ai-loginNiet beschikbaar
InstellenInloggen in de browserZes omgevingsvariabelen

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. Maak op /app/keys een sleutel aan die met sk-kn- begint. Hij wordt maar één keer getoond, dus bewaar hem meteen.
  3. Zet de variabelen. Op macOS en Linux in ~/.zshrc of ~/.bashrc:
~/.zshrc
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-5
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5

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

PowerShell
# 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-5"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL = "claude-sonnet-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:

~/.claude/settings.json
{
  "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-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-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 en ANTHROPIC_DEFAULT_SONNET_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. Zonder ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5 mislukken daardoor /model sonnet, de uitvoerfase van opusplan en subagents die op model: sonnet staan. De alias opus zet je vast op Opus 5.5 (claude-opus-5-5); daarvoor heb je Claude Code v2.1.280 of nieuwer nodig; een oudere versie werk je bij met claude update.
  • Zet ook ANTHROPIC_DEFAULT_HAIKU_MODEL vast. De alias haiku vraagt een ID op dat Kunavo niet aanbiedt: vanaf v2.1.293 Haiku 5.5, daarvoor een Haiku 4.5-ID met datum. Zonder deze regel geven /model haiku en subagents op model: haiku een 404.
  • 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.

VS Code settings.json
{
  "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-5" },
    { "name": "ANTHROPIC_DEFAULT_SONNET_MODEL", "value": "claude-sonnet-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):

ModelKunavo (input / output)Lijstprijs Anthropic (input / output)VerschilWaarvoor
claude-haiku-4-5$0,70 / $3,50$1,00 / $5,00~30% lagerAchtergrondtaken van Claude Code zelf en eenvoudig werk
claude-sonnet-5$1,40 / $7,00$2,00 / $10,00~30% lagerHet standaardmodel voor dagelijks werk
claude-opus-5-5$2,80 / $14,00$4,00 / $20,00~30% lagerGrote refactors en planning

Binnen een sessie wissel je met /model claude-opus-5-5, of je start meteen met claude --model claude-opus-5-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.

Terminal
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": "."}]}'
PowerShell
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).

Zo waardeer je je Kunavo-saldo op

Kunavo is prepaid: elke methode hieronder waardeert hetzelfde API-saldo op.

  • Vanaf elke plek: USDT op TRON (TRC-20) of USDC op Base, verstuurd naar het adres en voor het exacte bedrag dat de opwaardeerpagina geeft.
  • In lokale valuta: Alipay (vasteland van China), AlipayHK (Hongkong), Pix (Brazilië), GCash (Filipijnen), Touch 'n Go eWallet / Boost (Maleisië), PayNow (Singapore) en K PLUS / LINE Pay (Thailand); de opwaardeerpagina toont het bedrag in die valuta voordat je betaalt.
  • Betalen met een kaart wordt nu ingeschakeld en is nog niet mogelijk.

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.

  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 en bij $5.000 krijg je $6.250.
  3. Maak op /app/keys een sleutel aan en vul die in bij ANTHROPIC_AUTH_TOKEN.

Veelvoorkomende fouten

Wat je zietOorzaak en oplossing
The token '&&' is not a valid statement separatorDe CMD-regel in PowerShell geplakt. Gebruik irm … | iex.
'irm' is not recognized as an internal or external command (of de Nederlandse versie van die melding)De PowerShell-regel in CMD geplakt. Gebruik de install.cmd-regel.
'bash' is not recognized as the name of a cmdletDe macOS/Linux-regel op Windows geplakt. Gebruik de PowerShell-regel.
Het commando toont de tekst van het script, maar installeert nietsDe tweede helft ontbreekt. In PowerShell is het de hele regel irm … | iex, in CMD het volledige commando met -o install.cmd.
syntax error near unexpected token '<' of een 403De download leverde een webpagina of foutcode op in plaats van het script. Volgens de officiële probleemoplossing kan dat komen door netwerkproblemen, regionale routering, een tijdelijke storing of (bij een kale 403) een bedrijfsproxy of firewall. Probeer het na een paar minuten opnieuw, of installeer op macOS via Homebrew en op Windows via WinGet.
Claude Code does not support 32-bit WindowsJe opende Windows PowerShell (x86). Open de gewone Windows PowerShell.
npm.ps1 cannot be loadedHet uitvoeringsbeleid van PowerShell blokkeert npm. Voer de Set-ExecutionPolicy-regel uit of gebruik de native installer.
command not found: claude, of claude wordt niet herkendDe installatiemap staat niet in je PATH. Open een nieuw venster; op Windows het PATH-fragment hierboven.
Inlogscherm terwijl de sleutel is ingesteldClaude Code heeft geen sleutel gelezen. Zet de variabelen in je shell of in ~/.claude/settings.json, niet alleen in projectinstellingen, en open een nieuw venster.
Waarschuwing die eindigt op auth may not work as expectedSleutel en oude login zijn allebei actief. Gebruik /logout om alleen de sleutel over te houden, of haal de variabele weg om de login te gebruiken.
401De sleutel wordt niet herkend: controleer dat je de volledige sk-kn--sleutel hebt gekopieerd, zonder spaties, dat hij niet is verwijderd op /app/keys en dat hij in ANTHROPIC_AUTH_TOKEN staat.
404ANTHROPIC_BASE_URL eindigt op /v1, of het gevraagde model staat niet bij Kunavo (bijvoorbeeld omdat de vier modelvariabelen ontbreken).

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.

Veelgestelde vragen

Hoe installeer ik Claude Code?

Met één officieel commando. Op macOS, Linux en WSL: curl -fsSL https://claude.ai/install.sh | bash. Op Windows in PowerShell: irm https://claude.ai/install.ps1 | iex. In de Windows-Opdrachtprompt (CMD): curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd. Dit is de native installatie die Anthropic aanbeveelt; ze werkt zichzelf op de achtergrond bij. Open daarna een nieuw terminalvenster, controleer met claude --version en start met claude.

Heb ik WSL of administratorrechten nodig om Claude Code op Windows te installeren?

Nee. Volgens de officiële installatiedocumentatie voer je het installatiecommando uit in PowerShell of CMD, zonder het venster als administrator te openen. Git for Windows is optioneel: is het geïnstalleerd, dan voert Claude Code commando’s uit via Git Bash, anders via PowerShell. WSL 2 is alleen een keuze als je Linux-gereedschap of sandboxing nodig hebt; installeer en start Claude Code dan binnen de WSL-terminal. Open niet Windows PowerShell (x86): Claude Code ondersteunt geen 32-bits Windows.

Heb ik Node.js nodig voor Claude Code?

Alleen als je via npm installeert, en dan Node.js 22 of nieuwer. De native installer, Homebrew en WinGet hebben geen Node.js nodig. Met een oudere Node.js toont npm alleen een EBADENGINE-waarschuwing en gaat de installatie gewoon door. Gebruik nooit sudo npm install -g, en werk bij met npm install -g @anthropic-ai/claude-code@latest in plaats van npm update -g.

Kan ik Claude Code gebruiken zonder abonnement?

Ja. Om in te loggen heb je een Pro-, Max-, Team-, Enterprise- of Console-account nodig, en het gratis Claude.ai-abonnement bevat geen Claude Code. Zonder abonnement zet je ANTHROPIC_BASE_URL=https://api.kunavo.com en ANTHROPIC_AUTH_TOKEN met een Kunavo-sleutel; Claude Code slaat het inlogscherm dan over en je betaalt per gebruikte token uit een vooruitbetaald Kunavo-tegoed, vanaf $10, zonder maandbedrag. Remote Control en spraakdicteren zijn op die manier niet beschikbaar, omdat ze een claude.ai-account nodig hebben.

Hoe stel ik een API-sleutel in voor Claude Code?

Zet de variabelen in het env-blok van ~/.claude/settings.json (op Windows %USERPROFILE%\.claude\settings.json) of als export-regels in ~/.zshrc, ~/.bashrc of je PowerShell-$PROFILE. Gebruik ANTHROPIC_AUTH_TOKEN, niet ANTHROPIC_API_KEY: de eerste gaat mee als Authorization: Bearer en geldt meteen, de tweede gaat in de x-api-key-header en moet eerst één keer worden goedgekeurd. ANTHROPIC_BASE_URL is alleen het domein, https://api.kunavo.com, zonder /v1: Claude Code zet er zelf /v1/messages achter, dus met /v1 krijg je /v1/v1/messages en een 404. Zet de sleutel nooit in de .claude/settings.json van een project, want dat bestand wordt gecommit. Zetten shell en instellingenbestand dezelfde variabele, dan wint het instellingenbestand.

Waarom vier modelvariabelen bij Claude Code via een API-sleutel?

Zonder vaste modellen gebruikt Claude Code aliassen die met nieuwe versies van Anthropic meeschuiven. Volgens de officiële 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. Kunavo biedt Sonnet 5.5 nu niet aan, en een model dat er niet is geeft een 404: zonder vaste sonnet-variabele mislukken /model sonnet, de uitvoerfase van opusplan en subagents met model: sonnet. Met ANTHROPIC_MODEL=claude-sonnet-5, ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5, ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5 en ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5 vraagt elk verzoek een model dat Kunavo aanbiedt en weet je wat je betaalt. Opus 5.5 vereist Claude Code v2.1.280 of nieuwer; een oudere versie werk je bij met claude update. De haiku-variabele bepaalt ook het model voor de achtergrondtaken van Claude Code.

Hoe controleer ik of Claude Code mijn API-sleutel gebruikt?

Typ /status in Claude Code. Op het tabblad Status moet de regel Anthropic base URL https://api.kunavo.com tonen, en de regel 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. Krijg je bij het starten een inlogscherm, dan heeft Claude Code helemaal geen sleutel gelezen.