Installer Claude Code : commandes pour Windows, macOS et Linux, clé API sans abonnement et paiement avec iDEAL

Installez Claude Code avec une seule commande officielle : sur macOS, Linux et WSL avec curl -fsSL https://claude.ai/install.sh | bash, sous Windows dans PowerShell avec irm https://claude.ai/install.ps1 | iex (dans l’invite de commandes, CMD, avec la ligne install.cmd ci-dessous). Choisissez ensuite votre mode de paiement. Connectez-vous avec un compte Pro, Max, Team, Enterprise ou Console (l’abonnement gratuit Claude.ai ne comprend pas Claude Code), ou utilisez une clé API sans abonnement : définissez ANTHROPIC_BASE_URL (le domaine seul, sans /v1), ANTHROPIC_AUTH_TOKEN et quatre variables de modèle, puis vérifiez avec /status que la clé est active. Rechargez le crédit Kunavo avec iDEAL (Pays-Bas) ou Bancontact (Belgique), à partir de $10, sans frais mensuels.

Commando’s en variabelen gecontroleerd op 3 octobre 2026 in de la documentation officielle d’installation de Claude Code en de documentation sur les variables d’environnement; prijzen en betaalmethoden gecontroleerd op 3 octobre 2026. Nederland en België staan allebei op de la liste des pays pris en charge par Anthropic (gecontroleerd op 3 octobre 2026), zowel voor Claude.ai als voor de API. Deze handleiding bestaat ook in het Engels: Installer Claude Code.

Avant l’installation

Installer Claude Code sur macOS et Linux

Ouvrez Terminal et collez cette ligne :

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

C’est l’installation native recommandée : un seul programme autonome qui se met à jour en arrière-plan. La commande claude est placée dans ~/.local/bin. Un terminal déjà ouvert ne connaît pas encore le nouveau PATH ; ouvrez donc d’abord une nouvelle fenêtre avant de tester. Dans WSL, utilisez exactement la même ligne, dans le terminal WSL.

Installer Claude Code sur Windows

Sous Windows, il existe deux lignes, et celle dont vous avez besoin dépend uniquement de la fenêtre ouverte. Si l’invite commence par PS C:\Users\Naam>, vous êtes dans PowerShell ; si elle affiche uniquement C:\Users\Naam> sans PS, il s’agit de l’invite de commandes (CMD). Vous n’avez pas besoin d’ouvrir la fenêtre en tant qu’administrateur : selon la documentation officielle, ce n’est pas nécessaire.

# 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

L’erreur la plus fréquente consiste à coller la ligne dans la mauvaise fenêtre. La ligne CMD dans PowerShell affiche The token '&&' is not a valid statement separator ; la ligne PowerShell dans CMD affiche 'irm' is not recognized as an internal or external command. Sur une version néerlandaise de Windows, ce second message peut apparaître en néerlandais, pour la même raison. De même, la ligne macOS avec | bash dans PowerShell affiche une erreur indiquant que bash n’est pas reconnu. Dans les trois cas, utilisez la ligne correspondant à votre fenêtre.

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 n’est donc pas une obligation, contrairement à ce qu’affirment certains anciens guides, mais un choix. Si vous choisissez WSL, exécutez la ligne macOS/Linux dans le terminal WSL et lancez également claude depuis celui-ci, et non depuis PowerShell ou CMD.

Via Homebrew, WinGet ou npm

C’est également possible, avec une différence importante : selon la documentation officielle, les installations Homebrew et WinGet ne se mettent pas automatiquement à jour. Vous devez alors effectuer vous-même les mises à jour :

# 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

Le paquet npm requiert Node.js 22 ou une version ultérieure, et non Node.js 18 comme l’indiquent encore certains anciens guides. Avec une version antérieure de Node.js, npm affiche simplement un avertissement EBADENGINE et poursuit normalement l’installation : le paquet installe le même programme natif, qui n’a pas besoin de Node.js pour fonctionner. N’utilisez jamais sudo npm install -g : cela entraîne des problèmes de droits et constitue un risque de sécurité. Effectuez les mises à jour avec @latest, et non avec 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

Vérifier l’installation

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

claude doctor ne démarre pas de session ; la commande affiche l’état de l’installation et de vos fichiers de configuration. Vous pouvez ainsi déterminer rapidement si le problème vient de l’installation ou de la configuration.

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 résolution officielle des problèmes 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

Si vous installez via npm et que PowerShell affiche npm.ps1 cannot be loaded because running scripts is disabled on this system, la stratégie d’exécution de PowerShell bloque les scripts de démarrage de npm. Utilisez l’installateur natif, lancez npm.cmd et claude.cmd, ou autorisez les scripts locaux pour votre propre utilisateur :

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Premier démarrage : abonnement ou clé API

Lors du premier démarrage, choisissez le mode de paiement de Claude Code. Les deux routes s’excluent mutuellement : si une clé API est configurée, une connexion enregistrée reste inutilisée ; si vous supprimez la variable, Claude Code revient à la connexion, sans qu’il soit nécessaire de réinstaller.

Route A : se connecter avec votre abonnement

Lancez claude dans le dossier de votre projet et connectez-vous via le navigateur. Un piège : si ANTHROPIC_API_KEY est déjà configurée, Claude Code vous demande une fois s’il doit utiliser cette clé. Si vous refusez, il ignore ensuite la clé sans vous le demander à nouveau, ce qui peut donner l’impression que la variable n’est pas lue. Réactivez-la via /config → Use custom API key.

Route B : sans abonnement, avec une clé API

ANTHROPIC_BASE_URL est une variable intégrée de Claude Code. Selon la documentation officielle, elle remplace le point de terminaison de l’API afin d’acheminer les requêtes via un proxy ou une passerelle. Configurer Claude Code pour pointer vers un point de terminaison utilisant l’API Anthropic Messages est donc une configuration prise en charge, sans plug-in ni version personnalisée. Procédez comme suit :

1. Créez un compte Kunavo.
2. Ajoutez du crédit via Billing, à partir de $10 (iDEAL et Bancontact sont présentés plus loin).
3. Créez une clé sur /app/keys qui commence par sk-kn-. Elle ne s’affiche qu’une seule fois ; enregistrez-la immédiatement.
4. Définissez les variables. Sur macOS et Linux, dans ~/.zshrc ou ~/.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-5
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5

Sous Windows, pour commencer par tester dans une seule fenêtre 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

Pour une utilisation permanente, le bloc env de vos paramètres utilisateur est le meilleur emplacement : ~/.claude/settings.json (sous Windows, %USERPROFILE%\.claude\settings.json). Les valeurs s’appliquent partout où Claude Code s’exécute, y compris aux agents en arrière-plan. Les variables de votre shell ne s’appliquent qu’à cette fenêtre de terminal : un éditeur ouvert depuis le Dock ou le menu Démarrer ne les voit pas. Si le fichier contient déjà d’autres paramètres, ajoutez uniquement le bloc env :

{
  "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 jamais in de .claude/settings.json van een project: volgens de documentation officielle des passerelles (gecontroleerd op 3 octobre 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.

Chaque ligne comporte son propre piège :

• ANTHROPIC_BASE_URL est uniquement le domaine. Claude Code ajoute lui-même /v1/messages ; avec /v1 à la fin, la requête est envoyée vers /v1/v1/messages et vous obtenez une erreur 404.
• Utilisez ANTHROPIC_AUTH_TOKEN, et non ANTHROPIC_API_KEY. Selon la documentation, ANTHROPIC_AUTH_TOKEN est transmis dans l’en-tête Authorization, précédé de Bearer, et s’applique immédiatement. ANTHROPIC_API_KEY est placé dans l’en-tête x-api-key et doit d’abord être approuvé une fois en mode interactif (voir la route A).
• Écrivez exactement le nom du modèle dans ANTHROPIC_MODEL. Kunavo ne reconnaît que le nom exact et ne convertit pas les anciens noms suivis d’une date.
• Définissez également ANTHROPIC_DEFAULT_OPUS_MODEL et ANTHROPIC_DEFAULT_SONNET_MODEL de manière fixe. Volgens de documentation sur la configuration des modèles (gecontroleerd op 3 octobre 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.
• ANTHROPIC_DEFAULT_HAIKU_MODEL s’applique également aux tâches en arrière-plan. Selon la documentation, cette variable détermine l’alias haiku et le modèle utilisé pour les fonctions en arrière-plan, comme les titres de session. Avec Claude Haiku 4.5, ces tâches restent peu coûteuses.

Si vous utilisez l’extension VS Code, définissez les variables dans claudeCode.environmentVariables, dans les paramètres utilisateur de VS Code lui-même (commande Preferences: Open User Settings (JSON)). L’extension vérifie déjà les identifiants de connexion à cet emplacement avant de démarrer ; les valeurs de ~/.claude/settings.json atteignent bien le processus lancé, mais pas cette vérification.

{
  "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 octobre 2026):

Au cours d’une session, changez de modèle avec /model claude-opus-5-5, ou démarrez directement avec claude --model claude-opus-5-5. Le coût mensuel approximatif de Claude Code et les cas où un abonnement est plus avantageux sont présentés dans Claude Code pricing (en anglais) ; calculez votre propre consommation avec la Claude-tokencalculator. Tous les modèles et leurs prix sont indiqués sur la page des tarifs.

Vérifier avec /status

Lancez claude. Lorsque ANTHROPIC_AUTH_TOKEN est configurée, vous n’obtenez aucun écran de connexion : la variable s’applique immédiatement. Si l’écran de connexion s’affiche malgré tout, Claude Code n’a pas lu la clé. Placez-la alors à un emplacement que Claude Code lit avant l’assistant du premier démarrage : un export dans votre shell ou le bloc env de ~/.claude/settings.json. Un bloc env dans .claude/settings.json ou .claude/settings.local.json d’un projet ne s’applique à une session interactive qu’après l’assistant du premier démarrage et la question de confiance envers le dossier.

Typ in de sessie /status en kijk op het tabblad Status naar twee regels (bron: de documentation officielle des passerelles, gecontroleerd op 3 octobre 2026):

• Anthropic base URL doit afficher https://api.kunavo.com. Cette ligne apparaît uniquement lorsqu’une adresse de passerelle est configurée ; si elle est absente, ANTHROPIC_BASE_URL n’a pas atteint la session.
• Auth token doit mentionner ANTHROPIC_AUTH_TOKEN. Si vous voyez à la place Login method avec un compte claude.ai, la variable n’a pas été lue et la session utilise votre abonnement.

Si vous étiez auparavant connecté avec un abonnement, Claude Code peut vous avertir au démarrage que deux sources de connexion sont actives (le message se termine par auth may not work as expected). Les requêtes passent alors par la clé ; utilisez /logout pour supprimer l’ancienne connexion.

Vous souhaitez tester l’adresse et la clé avant d’ouvrir Claude Code ? Envoyez alors, comme le recommande la documentation, une requête d’un seul token de sortie ; cela consomme une très petite quantité de crédit. Les commandes lisent les variables depuis votre shell ; définissez-les donc également à cet endroit si elles figurent déjà dans settings.json.

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

Une réponse JSON commençant par {"id":"msg_ signifie que l’adresse et la clé fonctionnent ; dans PowerShell, vous voyez un id commençant par msg_. Un 401 signifie que la clé a été refusée.

Ce qui fonctionne autrement avec une clé API

• Aucun Remote Control ni dictée vocale. Les deux nécessitent un compte claude.ai et ne sont pas disponibles tant que ANTHROPIC_AUTH_TOKEN est active ; Remote Control est en outre désactivé tant que ANTHROPIC_BASE_URL pointe vers une adresse extérieure à Anthropic.
• /fast indique que le mode rapide est désactivé. Avec uniquement un jeton bearer, Claude Code considère le mode rapide comme désactivé, sans envoyer la vérification.
• La recherche d’outils MCP est désactivée par défaut dès que ANTHROPIC_BASE_URL pointe vers une adresse extérieure à Anthropic.
• Les nombres affichés dans /context sont une approximation : Kunavo biedt /v1/messages/count_tokens nu niet aan. Volgens de documentation officielle de compatibilité des passerelles (gecontroleerd op 3 octobre 2026) valt Claude Code zonder dat endpoint terug op een schatting op basis van tekens, dus /context toont benaderde aantallen.

Le code, les outils, les sous-agents, les serveurs MCP, les hooks et la mise en cache des prompts fonctionnent comme d’habitude. Pour plus de détails, consultez la documentation d’intégration de Claude Code (en anglais) et Claude Code without a subscription (en anglais).

Payer avec iDEAL ou Bancontact

Een Claude-abonnement betaal je via de website alleen met een creditcard of debitcard (Article d’aide de Claude sur les abonnements payants, gecontroleerd op 3 octobre 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 Documentation Stripe sur Adaptive Pricing (gecontroleerd op 3 octobre 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 concernant iDEAL, gecontroleerd op 3 octobre 2026).
• Bancontact, voor België, met je Bancontact-kaart of de app (Stripe concernant Bancontact, gecontroleerd op 3 octobre 2026).
• Cartes (Visa, Mastercard), Apple Pay, Google Pay et Link.

Non proposés : PayPal, prélèvement SEPA, Klarna (uniquement disponible pour les acheteurs aux États-Unis), Tikkie, Riverty (anciennement AfterPay) et virement bancaire ordinaire.

1. Créez un compte Kunavo.
2. Dans Billing, choisissez un montant d’au moins $10. Une recharge plus importante en une seule fois donne droit à un crédit supplémentaire : bij $100 krijg je $110, bij $1.000 krijg je $1.200, bij $5.000 krijg je $6.250.
3. Sur la page de paiement Stripe, choisissez iDEAL ou Bancontact et finalisez le paiement dans l’environnement de votre banque (iDEAL), ou avec l’application ou la carte Bancontact. Le montant en euros s’affiche sur la page de paiement avant la confirmation.
4. Créez une clé sur /app/keys et renseignez-la dans ANTHROPIC_AUTH_TOKEN.

Le crédit est prépayé : aucun montant mensuel, le crédit n’expire pas et les requêtes échouées ne sont pas facturées. La recharge automatique est possible uniquement avec une carte enregistrée ou Link ; avec iDEAL et Bancontact, vous devez donc recharger manuellement à chaque fois. Kunavo n’émet pas de factures de TVA ; votre historique de recharges figure dans Billing. Ces moyens de paiement servent uniquement à recharger votre crédit API Kunavo : ils ne permettent pas de payer un abonnement Claude Pro ou Max. Pour en savoir plus sur le paiement en euros : Payer Claude avec iDEAL.

Erreurs fréquentes

Après l’installation

Lors de votre première utilisation dans un projet, saisissez /init : Claude Code lit le dépôt et crée un fichier CLAUDE.md contenant les commandes de test et les conventions qu’il trouve. Vérifiez ce fichier et gardez-le court, car il est chargé à chaque session. Entre deux tâches distinctes, /clear démarre une nouvelle conversation ; si une tâche devient longue, /compact résume l’historique et vous permet de poursuivre.

Ce qu’il faut savoir

• Il s’agit d’une API facturée au token, et non d’un abonnement Claude Pro ou Max. Si vous utilisez Claude Code plusieurs heures chaque jour, un abonnement est souvent plus économique ; le paiement par token convient à une utilisation variable, et un mois sans utilisation ne coûte rien. La comparaison figure dans Claude Code pricing (en anglais).
• Avec une clé API, Remote Control et la dictée vocale ne sont pas disponibles.
• Avec Kunavo, vous utilisez une capacité partagée, sans quota réservé ni garanties contractuelles ; si vous en avez besoin, concluez directement un contrat avec Anthropic.
• iDEAL et Bancontact servent uniquement aux recharges manuelles ; la recharge automatique est possible uniquement avec une carte ou Link.
• Les montants en euros incluent la marge de conversion de Stripe. Kunavo n’émet pas de factures de TVA.

Foire aux questions