Guide d’installation de Claude Code — commandes macOS et Windows, puis connexion par abonnement ou clé API

L’installation de Claude Code ne nécessite qu’une seule ligne de commande : sur macOS, Linux et WSL, exécutez curl -fsSL https://claude.ai/install.sh | bash ; sur Windows, exécutez irm https://claude.ai/install.ps1 | iex dans PowerShell (dans l’invite de commandes CMD, utilisez la ligne install.cmd ci-dessous). Une fois l’installation terminée, ouvrez un nouveau terminal, vérifiez l’installation avec claude --version, puis exécutez claude pour commencer. Lors de la première connexion, deux options s’offrent à vous : vous connecter à un compte Pro, Max, Team, Enterprise ou Console (l’offre gratuite de Claude.ai n’inclut pas Claude Code), ou définir les deux variables d’environnement ANTHROPIC_BASE_URL et ANTHROPIC_AUTH_TOKEN pour utiliser une clé API avec une facturation à l’usage, sans aucun abonnement.

Commandes vérifiées le 11 septembre 2026, d’après la documentation officielle d’installation d’Anthropic. Cette page traite uniquement de l’installation et de la première connexion ; pour l’utilisation quotidienne après installation, consultez le guide Claude Code.

Vérifications avant l’installation

Installation sur macOS

Ouvrez le « Terminal » et collez cette ligne :

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

Il s’agit de la méthode d’installation native recommandée officiellement : elle installe un exécutable autonome qui se met automatiquement à jour en arrière-plan. Le point d’entrée de l’exécutable se trouve dans ~/.local/bin/claude ; un terminal déjà ouvert ne lira pas le nouveau PATH, alors ouvrez une nouvelle fenêtre après l’installation. Linux et WSL utilisent la même commande.

Installation sous Windows

Windows possède deux commandes différentes ; seule la nature du terminal ouvert change. Si l’invite est PS C:\Users\你的名字>, il s’agit de PowerShell ; si elle ne contient pas PS et contient uniquement C:\Users\你的名字>, il s’agit de l’invite de commandes (CMD). Les droits d’administrateur ne sont pas nécessaires.

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

:: Windows 命令提示字元（CMD）
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Coller la commande au mauvais endroit est l’échec le plus fréquent sous Windows. Si vous exécutez la ligne CMD dans PowerShell, vous verrez The token '&&' is not a valid statement separator ; si vous exécutez la ligne PowerShell dans CMD, vous verrez 'irm' is not recognized as an internal or external command. Si vous collez curl … | bash de macOS dans PowerShell, vous obtiendrez A parameter cannot be found that matches parameter name 'fsSL'. Dans les trois cas, revenez simplement à la ligne correspondante.

Il est recommandé d’installer également Git for Windows : Claude Code utilise le Git Bash fourni avec celui-ci pour exécuter les commandes ; à défaut, il utilise PowerShell. Si Git Bash est installé mais introuvable, ajoutez CLAUDE_CODE_GIT_BASH_PATH au bloc env du fichier de configuration, en le faisant pointer vers le chemin de bash.exe.

Si vous choisissez WSL, exécutez la ligne macOS/Linux ci-dessus dans le terminal WSL et démarrez également claude dans WSL, et non depuis PowerShell ou CMD.

Installation avec un gestionnaire de paquets

Vous pouvez aussi laisser votre gestionnaire de paquets existant gérer l’installation ; en contrepartie, les mises à jour automatiques sont désactivées par défaut et vous devrez effectuer vous-même les mises à niveau régulièrement (par exemple brew upgrade claude-code, winget upgrade Anthropic.ClaudeCode). Debian/Ubuntu, Fedora/RHEL et Alpine disposent également de dépôts officiels apt, dnf et apk signés.

# Homebrew（macOS、Linux）— stable 通道
brew install --cask claude-code

# WinGet（Windows）
winget install Anthropic.ClaudeCode

# npm — 需要 Node.js 22 以上；絕對不要加 sudo
npm install -g @anthropic-ai/claude-code

La méthode npm nécessite Node.js 22 ou une version ultérieure depuis v2.1.198 ; avec une version antérieure, npm affiche uniquement un avertissement EBADENGINE, mais l’installation se termine. Elle installe le même exécutable que l’installateur natif et n’utilise pas Node.js à l’exécution. N’utilisez surtout pas sudo npm install -g : cela crée des problèmes de permissions et présente aussi un risque de sécurité.

Vérifier la réussite de l’installation

claude --version   # 正常會印出版本號，例如 2.1.211 (Claude Code)
claude doctor      # 唯讀的安裝與設定診斷，不會開啟工作階段

claude doctor est la commande la plus utile à retenir : elle n’ouvre pas de session de travail ; elle liste uniquement l’état de l’installation, les erreurs du fichier de configuration et les corrections recommandées. C’est le moyen le plus rapide de distinguer une installation défectueuse d’une configuration défectueuse.

Si command not found: claude apparaît, ou 'claude' is not recognized sous Windows, le répertoire d’installation ne se trouve pas dans PATH. Sous macOS/Linux, ouvrez d’abord un nouveau terminal ; si cela ne suffit pas, ajoutez ~/.local/bin au PATH de ~/.zshrc ou ~/.bashrc. Sous Windows, l’emplacement d’installation est %USERPROFILE%\.local\bin ; vérifiez-le et ajoutez-le avec PowerShell :

# 1. 檢查安裝目錄是否已在 PATH 裡
$env:PATH -split ';' | Select-String '\.local\\bin'

# 2. 沒有任何輸出的話，把它加進「使用者」PATH，然後關掉終端機重開
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

# 3. 重開後再確認一次；若有兩份安裝，這行會列出兩個路徑
where.exe claude

Première connexion : connexion par abonnement ou clé facturée à l’usage

Option A : se connecter avec un compte d’abonnement

Exécutez claude dans le dossier du projet, puis suivez les instructions du navigateur pour vous connecter avec un compte Pro, Max, Team, Enterprise ou Console. Un détail important : si ANTHROPIC_API_KEY est déjà présent dans l’environnement, Claude Code vous demandera une fois si vous souhaitez utiliser cette clé ; si vous refusez, il l’ignorera ensuite silencieusement et ne vous le demandera plus, donnant l’impression que la variable n’a pas été lue. Pour la réactiver, allez dans /config puis sélectionnez Use custom API key.

Option B : sans abonnement, avec une clé facturée à l’usage

Claude Code prend nativement en charge ANTHROPIC_BASE_URL ; pointer vers n’importe quel endpoint fournissant l’API Anthropic Messages est donc une configuration officiellement prise en charge, sans extension, proxy ni exécutable modifié. Les étapes sont les suivantes : créer un compte, ajouter des fonds (minimum $10), créer dans la page de gestion des clés une clé commençant par sk-kn- (elle ne sera affichée qu’une seule fois), puis définir les variables ci-dessous. Sous macOS/Linux :

export ANTHROPIC_BASE_URL=https://api.kunavo.com   # 只寫到網域，不要加 /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 faire d’abord un essai dans une fenêtre PowerShell :

# 只對這個 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-5"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL = "claude-sonnet-5"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "claude-haiku-4-5"
claude

Pour une utilisation durable, il est recommandé d’écrire ces variables dans la section env du fichier de configuration utilisateur ~/.claude/settings.json (sous Windows, il s’agit de %USERPROFILE%\.claude\settings.json). Écrites ici, elles sont lues par chaque terminal, extension d’éditeur et processus en arrière-plan ; si le fichier contient déjà d’autres réglages, fusionnez simplement env avec ceux-ci :

{
  "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"
  }
}

Ces six lignes contiennent chacune un point mal configuré qui peut vous bloquer longtemps :

• ANTHROPIC_BASE_URL doit contenir uniquement le domaine.Claude Code ajoute lui-même /v1/messages ; si vous ajoutez /v1, cela devient /v1/v1/messages et renvoie 404.
• Utilisez ANTHROPIC_AUTH_TOKEN, et non ANTHROPIC_API_KEY.Les deux sont transmis dans des en-têtes HTTP différents : le premier envoie Authorization: Bearer et prend effet immédiatement ; le second envoie x-api-key et nécessite en outre la confirmation unique mentionnée ci-dessus.
• ANTHROPIC_MODEL doit contenir le nom complet et exact du modèle.Kunavo ne reconnaît que les noms correspondant exactement et ne fait pas automatiquement correspondre les anciens noms comportant un suffixe de date.
• ANTHROPIC_DEFAULT_OPUS_MODEL gère l’alias opus. Le modèle par défaut de Claude Code et l’alias opus pointent tous deux vers le dernier Opus ; si Kunavo ne le propose pas encore, ils renvoient 404. Cette ligne et ANTHROPIC_MODEL doivent donc être fixées. Ici, l’alias opus est fixé sur Opus 5.5 (claude-opus-5-5) ; Claude Code v2.1.280 ou une version ultérieure est requis, et les anciennes versions doivent d’abord exécuter claude update.
• ANTHROPIC_DEFAULT_SONNET_MODEL gère l’alias sonnet. Dans l’API Anthropic, l’alias sonnet pointe vers Sonnet 5.5, mais Kunavo ne propose pas ce modèle. Sans fixation, /model sonnet, la phase d’exécution de opusplan et les sous-agents définis avec model: sonnet renvoient 404 ; fixez donc également cet alias sur Claude Sonnet 5 (claude-sonnet-5).
• ANTHROPIC_DEFAULT_HAIKU_MODEL gère les appels en arrière-plan.Les résumés et titres générés par Claude Code utilisent ce modèle : Claude Haiku 4.5 à $0.70 / $3.50 par million de tokens ; le modèle principal Claude Sonnet 5 coûte $1.40 / $7.00 (au même tarif officiel qu’Anthropic).

Ne mettez .claude/settings.json dans le projet — ce fichier sera validé dans le dépôt et partagé avec chaque personne qui clone le projet. Avec l’extension VS Code, placez les variables dans claudeCode.environmentVariables des paramètres utilisateur de VS Code, car l’extension vérifie les identifiants avant le démarrage.

Vérifier quelle voie est utilisée

Après être entré dans Claude Code, exécutez /status. Si la ligne Auth token apparaît, la clé est active ; si Login method apparaît avec un compte claude.ai, les variables n’ont pas été lues. Les deux ne se cumulent pas : tant que les variables de clé sont présentes, l’abonnement connecté est mis en attente ; supprimez les variables pour revenir à l’abonnement, sans réinstaller.

Trois éléments diffèrent lors du passage par une passerelle : Remote Control et la saisie vocale nécessitent une identité claude.ai et sont indisponibles ; le contrôle de disponibilité de /fast interroge directement Anthropic et peut indiquer que la fonctionnalité est indisponible, sans affecter les requêtes ordinaires ; les chiffres de /context deviennent des estimations locales. L’écriture de code, les outils, les sous-agents, MCP, les hooks et la mise en cache des prompts continuent de fonctionner normalement. Les explications complètes se trouvent dans la documentation d’intégration de Claude Code et le guide des clés API Claude Code (tous deux en anglais).

Tableau des erreurs courantes

Après l’installation

Lors de la première entrée dans le projet, exécutez d’abord /init afin qu’il parcoure tout le projet et génère CLAUDE.md. Le guide Claude Code explique ensuite comment choisir entre Opus, Sonnet et Haiku selon la tâche, combien coûte réellement une session et comment réduire les dépenses avec /clear et /compact.

Il vaut également la peine de parler franchement du choix : pour les personnes qui interagissent longtemps chaque jour et utilisent beaucoup le service, le forfait mensuel fixe est généralement plus avantageux ; la facturation à l’usage convient aux volumes très variables ou à ceux qui ne veulent pas être bloqués par une fenêtre d’utilisation de 5 heures, et un mois sans activité coûte $0. Avec Kunavo, vous utilisez une capacité partagée, sans quota dédié ni SLA contractuel ; les équipes qui ont besoin de ces garanties devraient acheter directement auprès d’Anthropic. Les coûts mensuels et le seuil de rentabilité des deux options sont détaillés dans le coût de Claude Code.

Questions fréquentes