Installer Claude Code : Windows, macOS et Linux, clé API sans abonnement et paiement par Bancontact

Pour installer Claude Code, une ligne suffit, mais ce n’est pas la même partout : curl -fsSL https://claude.ai/install.sh | bash dans le terminal de macOS, de Linux ou de WSL, irm https://claude.ai/install.ps1 | iex dans PowerShell, et une ligne install.cmd dans l’invite de commandes de Windows. La vraie question arrive au premier lancement : qui paie les requêtes ? Un compte Pro, Max, Team, Enterprise ou Console permet de se connecter (le plan gratuit de Claude.ai n’inclut pas Claude Code). Sans abonnement, une clé API suffit : cinq variables, dont ANTHROPIC_BASE_URL sans /v1 et ANTHROPIC_AUTH_TOKEN, puis un coup d’œil à /status. Le solde Kunavo se règle par carte, Apple Pay, Google Pay, Link ou, en Belgique, Bancontact, à partir de $10, sans abonnement.

D’où viennent les informations : les commandes et les variables sont reprises de la documentation officielle de Claude Code (installation, variables d’environnement, connexion à une passerelle), relue le 3 octobre 2026 ; les prix Kunavo et les moyens de paiement ont été contrôlés le 3 octobre 2026. D’après la liste des pays pris en charge par Anthropic (lue le 3 octobre 2026), Claude.ai et l’API sont ouverts en France, en Belgique, en Suisse, au Luxembourg et au Canada, comme au Maroc, en Tunisie, en Algérie, au Sénégal et en Côte d’Ivoire. Le même guide existe en anglais et, pour la Flandre, en néerlandais.

Quelle commande taper : tout dépend de la fenêtre

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

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

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

Les trois premières lignes posent la version native, celle que recommande Anthropic : un binaire autonome, rangé dans ~/.local/bin (%USERPROFILE%\.local\bin sous Windows), qui télécharge ses mises à jour en tâche de fond et les applique au démarrage suivant. Une fois l’installation terminée, fermez le terminal et rouvrez-en un : celui qui a servi à installer ne connaît pas encore le nouveau PATH.

Sous Windows, se tromper de fenêtre est la cause d’échec numéro un, et le message le dit sans ambiguïté. The token '&&' is not a valid statement separator : vous avez collé la ligne CMD dans PowerShell. 'irm' is not recognized as an internal or external command : c’est l’inverse. Sur un Windows en français, ce second message peut apparaître traduit ; la cause ne change pas. Les autres messages sont dans le tableau des erreurs, en fin de guide.

Configuration requise

Windows : ce que disent les vieux tutoriels, et ce qui est vrai

Une bonne partie des tutoriels en français datent des premières versions de Claude Code. Voici leurs consignes les plus répandues, confrontées à la documentation d’installation actuelle et à la page de dépannage (lues le 3 octobre 2026) :

Si vous installez Git for Windows, Claude Code passe par Git Bash et garde l’outil PowerShell à côté. Il arrive qu’il ne trouve pas bash.exe : indiquez alors son chemin dans la variable CLAUDE_CODE_GIT_BASH_PATH, au sein du bloc env de ~/.claude/settings.json (la documentation donne C:\Program Files\Git\bin\bash.exe en exemple). Dernier piège : le raccourci « Windows PowerShell (x86) » lance une version 32 bits, que Claude Code refuse.

Natif ou WSL, le choix se fait selon l’endroit où vivent vos projets :

Côté WSL, tout se passe à l’intérieur de la distribution Linux : c’est là qu’on colle la ligne curl … | bash, et c’est là qu’on tape claude ensuite. Lancé depuis PowerShell ou CMD, il ne verrait pas cette installation.

Homebrew, WinGet, apt ou npm

Les gestionnaires de paquets fonctionnent, avec une contrepartie : Claude Code n’y est pas mis à jour automatiquement. Pour Homebrew et WinGet, la variable CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1 charge Claude Code de lancer la mise à jour lui-même ; sans elle, c’est à vous de le faire :

# Homebrew (macOS)
brew install --cask claude-code
brew upgrade claude-code              # pas de mise à jour automatique

# WinGet (Windows)
winget install Anthropic.ClaudeCode
winget upgrade Anthropic.ClaudeCode   # pas de mise à jour automatique

Sur Debian, Ubuntu, Fedora, RHEL et Alpine, Anthropic publie aussi des dépôts apt, dnf et apk signés, mis à jour avec le reste du système ; la procédure figure sur la page d’installation.

Reste npm, pratique si Node.js fait déjà partie de votre outillage. Le paquet réclame Node.js 22 au minimum. Sur une version plus ancienne, npm se contente d’un avertissement EBADENGINE et va au bout, parce que le paquet installe le même binaire natif, qui n’a pas besoin de Node.js pour tourner. Deux règles : pas de sudo npm install -g, et la mise à jour avec @latest, car npm update -g reste dans la plage de versions d’origine et peut vous laisser en arrière.

node -v                                       # v22 ou plus récent
npm install -g @anthropic-ai/claude-code      # jamais avec sudo

# mise à jour : avec @latest, pas avec npm update -g
npm install -g @anthropic-ai/claude-code@latest

Vérifier l’installation et réparer le PATH

claude --version   # affiche le numéro de version, suivi de (Claude Code)
claude doctor      # diagnostic de l’installation et des réglages, sans ouvrir de session

Un numéro de version en retour, et c’est installé. claude doctor va plus loin sans démarrer de session : état de l’installation, erreurs dans les fichiers de réglages, résultat de la dernière mise à jour. Quand quelque chose cloche, c’est la première commande à lancer.

command not found: claude sur macOS ou Linux, claude « non reconnu » sous Windows : le programme est bien installé, mais le shell ne sait pas où le chercher. Une nouvelle fenêtre suffit le plus souvent. Sinon, ajoutez ~/.local/bin au PATH dans ~/.zshrc ou ~/.bashrc. Sous Windows, la page de dépannage officielle donne ces trois étapes PowerShell :

# 1. Le dossier d'installation est-il déjà dans le PATH ?
$env:PATH -split ';' | Select-String '\.local\\bin'

# 2. Aucun résultat ? Ajoutez-le au PATH de l'utilisateur, puis ouvrez une nouvelle fenêtre
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

# 3. Dans la nouvelle fenêtre : deux chemins = deux installations concurrentes
where.exe claude

Installé par npm, et PowerShell répond npm.ps1 cannot be loaded ? Sa stratégie d’exécution bloque les scripts de npm. Passez à l’installateur natif, ou autorisez les scripts locaux pour votre seul compte :

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Qui paie les requêtes : abonnement Claude ou clé API

Le choix ne se fait pas à l’installation, mais au premier lancement, et il reste réversible. Une clé définie dans l’environnement prend le pas sur une connexion claude.ai enregistrée, qui reste en sommeil ; supprimez la variable, et la connexion reprend la main au lancement suivant.

Avec un abonnement Claude

Rien à configurer : claude dans le dossier du projet, puis connexion dans le navigateur. Une seule exception, une ANTHROPIC_API_KEY qui traînerait dans votre environnement. Claude Code demande alors, une fois, s’il doit l’utiliser ; un refus est mémorisé, et la clé est ensuite ignorée sans message, ce qui laisse croire que la variable n’est pas lue. Pour revenir sur ce choix : /config → Use custom API key.

Sans abonnement : la clé API Kunavo

Faire pointer Claude Code ailleurs que chez Anthropic n’a rien d’un bricolage. La liste officielle des variables d’environnement présente ANTHROPIC_BASE_URL comme le moyen d’envoyer les requêtes vers un proxy ou une passerelle. Kunavo répond au format de l’API Messages d’Anthropic : vous gardez le Claude Code officiel, sans extension ni version modifiée.

1. Ouvrez un compte : inscription Kunavo.
2. Alimentez le solde dans Billing, $10 au minimum (moyens de paiement plus bas).
3. Générez une clé dans /app/keys. Elle commence par sk-kn- et n’est montrée qu’à sa création : copiez-la aussitôt.
4. Renseignez les cinq variables ci-dessous.

Pourquoi épingler trois modèles ? Les alias de Claude Code suivent les sorties d’Anthropic. D’après la documentation sur la configuration des modèles (lue le 3 octobre 2026), pour un compte API, le réglage par défaut et opus visent aujourd’hui Opus 5.5, et sonnet vise Sonnet 5.5, que Kunavo ne sert pas. Un modèle tout juste sorti n’est pas non plus toujours disponible chez Kunavo le jour même. Avec des noms complets, chaque requête part vers un modèle servi, au prix que vous connaissez. La documentation sur le protocole des passerelles (lue le 3 octobre 2026) confirme le point sur les tâches de fond : avec Claude Haiku 4.5, elles coûtent peu. Si vous tapez souvent /model sonnet, ajoutez ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5.

Où écrire les variables

La version recommandée, à fusionner avec le contenu existant du fichier s’il y en a déjà un (ajoutez seulement 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",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5"
  }
}

Les mêmes valeurs dans le shell, sur macOS et Linux :

export ANTHROPIC_BASE_URL=https://api.kunavo.com   # le domaine seul, sans /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

Pour un test rapide dans une fenêtre PowerShell :

# Valable uniquement dans cette fenêtre PowerShell
$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

Et pour l’extension VS Code, dans les réglages utilisateur de l’éditeur (commande Preferences: Open User 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" },
    { "name": "ANTHROPIC_DEFAULT_HAIKU_MODEL", "value": "claude-haiku-4-5" }
  ]
}

L’app de bureau Claude fait exception : elle ne lit ni ANTHROPIC_BASE_URL ni settings.json. Une variable modifiée dans le shell qui reste sans effet ? Cherchez d’abord la même variable dans un settings.json, prioritaire.

Tarifs par million de tokens tirés du catalogue Kunavo, à côté du prix public d’Anthropic relevé sur claude.com/pricing (lu le 3 octobre 2026) :

Pour passer à Opus le temps d’une tâche : /model claude-opus-5 en cours de session, ou claude --model claude-opus-5 au démarrage. Le budget mensuel selon votre usage, et le seuil à partir duquel l’abonnement devient plus avantageux, sont chiffrés dans le prix de Claude Code. Le calculateur de coût en tokens Claude fait le calcul pour vos propres volumes, et la page des tarifs liste tous les modèles.

Vérifier avec /status

Premier signe, avant même /status : avec ANTHROPIC_AUTH_TOKEN en place, Claude Code démarre sans écran de connexion. Si cet écran apparaît, aucune clé n’a été lue, souvent parce qu’elle ne se trouve que dans les réglages du projet (.claude/settings.json ou .claude/settings.local.json). En session interactive, ce bloc env n’est appliqué qu’après l’assistant de premier lancement et la question de confiance sur le dossier. Déplacez la clé dans votre shell ou dans ~/.claude/settings.json.

Une fois dans la session, /status s’ouvre sur l’onglet Status. Voici comment le lire, d’après la documentation sur les passerelles (lue le 3 octobre 2026) :

Vous étiez déjà connecté avec un abonnement ? Claude Code peut alors signaler au démarrage deux sources d’identification actives, dans un avertissement qui se termine par auth may not work as expected. C’est la clé qui sert pour les requêtes ; /logout supprime l’ancienne connexion et fait disparaître l’avertissement.

Pour savoir si un problème vient de Kunavo ou de votre configuration, testez sans Claude Code. La documentation propose une requête limitée à un seul token de sortie, qui coûte une fraction de centime. Les deux commandes ci-dessous prennent l’adresse et la clé dans le shell : définies uniquement dans settings.json, elles ne seraient pas vues ici.

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

Un JSON qui commence par {"id":"msg_, ou dans PowerShell un objet dont l’id commence par msg_ : l’adresse et la clé fonctionnent. Un 401 : la clé est refusée.

Ce qui change avec une clé API

• Remote Control et dictée vocale disparaissent. Tous deux reposent sur un compte claude.ai et restent indisponibles tant que ANTHROPIC_AUTH_TOKEN est définie. Remote Control se coupe aussi dès que ANTHROPIC_BASE_URL désigne un autre hôte qu’Anthropic.
• Le mode rapide (/fast) apparaît désactivé, car sa vérification exige une connexion claude.ai ou une clé Anthropic, pas un simple jeton bearer.
• La recherche d’outils MCP est coupée par défaut lorsque ANTHROPIC_BASE_URL pointe hors d’Anthropic.
• /context affiche des estimations. Kunavo ne propose pas /v1/messages/count_tokens, et dans ce cas Claude Code compte à partir du nombre de caractères (documentation sur le protocole des passerelles).

Pour le reste (lecture et écriture de code, outils, sous-agents, serveurs MCP, hooks, cache de prompt), rien ne change. Les détails techniques, en anglais, sont dans la documentation d’intégration Claude Code.

Payer depuis la France ou la Belgique

Deux circuits à ne pas confondre. L’abonnement Claude acheté sur le web se règle uniquement par carte de crédit ou de débit (FAQ facturation d’Anthropic, lue le 3 octobre 2026) ; souscrit dans l’app mobile, il passe par l’App Store ou Google Play. Les montants de claude.com/pricing sont hors taxes.

Le solde Kunavo, lui, se recharge sur une page de paiement Stripe. Le tarif est fixé en dollars américains, mais depuis la France ou la Belgique Stripe vous montre le montant en euros, à un taux garanti 24 heures qui intègre 2 à 4 % de frais de conversion à votre charge (documentation Stripe sur l’Adaptive Pricing, lue le 3 octobre 2026). Vous pouvez payer en dollars pour éviter ces frais, mais votre banque applique alors son propre change, et Bancontact n’est proposé qu’en euros. Les moyens de paiement disponibles :

• Carte CB française ? Selon la documentation Stripe sur Cartes Bancaires (lue le 3 octobre 2026), plus de 95 % des cartes CB sont co-badgées Visa ou Mastercard. Elles passent donc au checkout en tant que Visa ou Mastercard, et une simple carte de débit fait l’affaire.
• Bancontact est proposé aux acheteurs situés en Belgique. Stripe vous envoie sur le site ou l’app Bancontact pour valider, et le résultat est connu immédiatement (documentation Stripe sur Bancontact, lue le 3 octobre 2026).
• Pay by Bank, le paiement depuis votre banque en ligne, peut apparaître dans un checkout en euros si votre banque le permet. Mieux vaut ne pas compter dessus : la documentation Stripe sur Pay by Bank (lue le 3 octobre 2026) le classe en préversion privée pour la France et ne mentionne pas la Belgique.
• Depuis la Suisse ou le Canada, le montant s’affiche en francs suisses ou en dollars canadiens, avec la carte et Link, plus Apple Pay et Google Pay, qui reposent sur une carte.

Non proposé : PayPal, prélèvement SEPA, Klarna dans un checkout en euros.

1. Inscrivez-vous sur Kunavo ; aucune carte n’est demandée à ce stade.
2. Dans Billing, choisissez le montant : $10 au minimum. Les montants plus élevés donnent droit à un bonus ($100 payés, $110 crédités ; $1 000 payés, $1 200 crédités ; $5 000 payés, $6 250 crédités).
3. Sur la page Stripe, sélectionnez le moyen de paiement ; le montant en euros est affiché avant validation. Avec Bancontact, confirmez dans l’app ou avec la carte.
4. Créez la clé dans /app/keys et placez-la dans ANTHROPIC_AUTH_TOKEN.

Le solde est prépayé : aucun frais mensuel, aucune date d’expiration, et une requête qui échoue n’est pas facturée. La recharge automatique demande une carte enregistrée ou Link. Bancontact ne gère pas les paiements récurrents chez Stripe, donc chaque recharge Bancontact se lance à la main. Kunavo ne délivre pas de facture avec TVA, ni française, ni belge, ni d’un autre pays ; l’historique des recharges se consulte dans Billing. Enfin, ces moyens de paiement servent uniquement au solde API Kunavo et ne règlent pas un abonnement Claude Pro ou Max. Toutes les autres pistes, App Store et Google Play compris, sont passées en revue dans payer Claude sans carte bancaire.

Erreurs courantes

Premiers pas dans un projet

Dans un dépôt que Claude Code découvre, commencez par /init : il explore le code et rédige un CLAUDE.md qui consigne les commandes de test et les conventions repérées. Relisez ce fichier et élaguez-le, puisqu’il est rechargé à chaque session. Pour changer de sujet, /clear repart d’une conversation vierge ; pour poursuivre une longue tâche, /compact en résume l’historique.

Les limites de la clé API

• Vous payez à la consommation, pas un forfait Claude Pro ou Max. Pour plusieurs heures de Claude Code par jour, tous les jours, l’abonnement l’emporte souvent ; pour un usage irrégulier, le paiement au token est plus souple, et les mois creux ne coûtent rien. Chiffres dans le prix de Claude Code.
• Pas de Remote Control ni de dictée vocale tant que la clé est active.
• La capacité de Kunavo est partagée, sans quota réservé ni engagement contractuel ; si vous en avez besoin, contractez directement avec Anthropic.
• Bancontact ne permet que des recharges manuelles ; l’automatique passe par une carte enregistrée ou Link.
• Les montants en euros incluent les frais de conversion de Stripe, et Kunavo n’émet pas de facture avec TVA.

Questions fréquentes