Configuration avancée

Configuration requise, installation spécifique à la plateforme, gestion des versions et désinstallation pour Claude Code.

Cette page couvre la configuration requise, les détails d'installation spécifiques à la plateforme, les mises à jour et la désinstallation. Pour une présentation guidée de votre première session, consultez le démarrage rapide. Si vous n'avez jamais utilisé un terminal auparavant, consultez le guide du terminal.

Configuration requise

Claude Code s'exécute sur les plateformes et configurations suivantes :

• Système d'exploitation :
  • macOS 13.0+
  • Windows 10 1809+ ou Windows Server 2019+
  • Ubuntu 20.04+
  • Debian 10+
  • Alpine Linux 3.19+
• Matériel : 4 Go+ de RAM, processeur x64 ou ARM64
• Réseau : connexion Internet requise. Consultez la configuration réseau.
• Shell : Bash, Zsh, PowerShell ou CMD.
• Localisation : pays supportés par Anthropic

Dépendances supplémentaires

• ripgrep : généralement inclus avec Claude Code. Si la recherche échoue, consultez le dépannage de la recherche.

Installer Claude Code

Pour installer Claude Code, utilisez l'une des méthodes suivantes :

curl -fsSL https://claude.ai/install.sh | bash

irm https://claude.ai/install.ps1 | iex

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

brew install --cask claude-code

winget install Anthropic.ClaudeCode

Vous pouvez également installer avec apt, dnf, ou apk sur Debian, Fedora, RHEL et Alpine.

Une fois l'installation terminée, ouvrez un terminal dans le projet sur lequel vous souhaitez travailler et démarrez Claude Code :

claude

Claude Code ouvre une session interactive dans votre terminal.

Si vous rencontrez des problèmes lors de l'installation, consultez Dépannage de l'installation et de la connexion.

Configuration sur Windows

Vous pouvez exécuter Claude Code nativement sur Windows ou à l'intérieur de WSL. Choisissez en fonction de l'endroit où vos projets sont situés et des fonctionnalités dont vous avez besoin :

Option 1 : Windows natif

Exécutez la commande d'installation à partir de PowerShell ou CMD. Vous n'avez pas besoin d'exécuter en tant qu'administrateur. L'installation de Git for Windows est optionnelle. Elle active l'outil Bash en fournissant Git Bash.

Que vous installiez à partir de PowerShell ou CMD affecte uniquement la commande d'installation que vous exécutez. Votre invite affiche PS C:\Users\VotreNom> dans PowerShell et C:\Users\VotreNom> sans le PS dans CMD. Si vous êtes nouveau sur le terminal, le guide du terminal vous guide à travers chaque étape.

Après l'installation, lancez claude à partir de n'importe quel terminal.

• Sans Git for Windows, Claude Code exécute les commandes shell via l'outil PowerShell.

• Avec Git for Windows, Claude Code utilise Git Bash pour l'outil Bash. Si Claude Code ne trouve pas Git Bash, définissez le chemin dans votre fichier settings.json :

  {
    "env": {
      "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
    }
  }
  

Lorsque Git for Windows est installé, l'outil PowerShell est disponible aux côtés de Bash : activé par défaut pour les comptes claude.ai et Console, et activé avec CLAUDE_CODE_USE_POWERSHELL_TOOL=1 dans les sessions Amazon Bedrock, Google Cloud's Agent Platform et Microsoft Foundry. Définissez-le à 0 pour désactiver l'outil. Consultez outil PowerShell pour la configuration et les limitations.

Option 2 : WSL

Ouvrez votre distribution WSL et exécutez le programme d'installation Linux à partir des instructions d'installation ci-dessus. Vous installez et lancez claude à l'intérieur du terminal WSL, pas à partir de PowerShell ou CMD.

Alpine Linux et distributions basées sur musl

L'installation de Claude Code sur Alpine et autres distributions basées sur musl/uClibc nécessite bash et curl pour la commande d'installation, et libgcc, libstdc++ et ripgrep à l'exécution. Alpine n'inclut pas bash ou curl par défaut, donc la commande d'installation documentée échoue avec une erreur not found jusqu'à ce que vous les installiez. Installez ces paquets à l'aide du gestionnaire de paquets de votre distribution, puis définissez USE_BUILTIN_RIPGREP=0.

Cet exemple installe les paquets requis sur Alpine :

apk add bash curl libgcc libstdc++ ripgrep

Sur Alpine, ripgrep se trouve dans le dépôt community. Si apk signale que le paquet est manquant, ajoutez le dépôt community à /etc/apk/repositories, en utilisant votre version d'Alpine :

echo "https://dl-cdn.alpinelinux.org/alpine/v3.22/community" >> /etc/apk/repositories

Exécutez apk update pour actualiser l'index des paquets, et réessayez la commande apk add.

Ensuite, définissez USE_BUILTIN_RIPGREP à 0 dans votre fichier settings.json :

{
  "env": {
    "USE_BUILTIN_RIPGREP": "0"
  }
}

Vérifier votre installation

Après l'installation, confirmez que Claude Code fonctionne :

claude --version

Une installation fonctionnelle affiche un numéro de version tel que 2.1.211 (Claude Code).

Si cela échoue avec command not found ou une autre erreur, consultez Dépannage de l'installation et de la connexion.

Pour une vérification plus détaillée de votre installation et configuration, exécutez claude doctor :

claude doctor

claude doctor affiche les diagnostics d'installation et de paramètres en lecture seule sans démarrer une session, y compris l'état de santé de l'installation, les erreurs de validation du fichier de paramètres et tous les avertissements avec les corrections suggérées.

S'authentifier

Claude Code nécessite un compte Pro, Max, Team, Enterprise ou Console. Le plan gratuit Claude.ai n'inclut pas l'accès à Claude Code. Vous pouvez également utiliser Claude Code avec un fournisseur d'API tiers comme Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry.

Après l'installation, connectez-vous en exécutant claude et en suivant les invites du navigateur. Si la variable d'environnement ANTHROPIC_API_KEY est définie, Claude Code vous demande une fois d'approuver la clé au lieu d'ouvrir un navigateur. Consultez Authentification pour tous les types de comptes et les options de configuration d'équipe.

Mettre à jour Claude Code

Les installations natives se mettent à jour automatiquement en arrière-plan. Vous pouvez configurer le canal de version pour contrôler si vous recevez les mises à jour immédiatement ou selon un calendrier stable retardé, ou désactiver les mises à jour automatiques entièrement. Les installations Homebrew, WinGet et gestionnaire de paquets Linux nécessitent des mises à jour manuelles par défaut.

Mises à jour automatiques

Claude Code vérifie les mises à jour au démarrage et périodiquement pendant l'exécution. Les mises à jour se téléchargent et s'installent en arrière-plan, puis prennent effet la prochaine fois que vous démarrez Claude Code.

Exécutez claude doctor pour voir le résultat de la tentative de mise à jour la plus récente.

Sur macOS et Linux, le programme d'installation natif gère le lanceur à ~/.local/bin/claude en tant que lien symbolique vers ~/.local/share/claude/versions/. Si vous remplacez ce lanceur par votre propre script ou lien symbolique, la mise à jour automatique et claude update le laissent en place : les nouvelles versions s'installent toujours sous le répertoire versions/, et votre lanceur décide quelle version s'exécute. Avant la v2.1.207, le programme de mise à jour automatique remplaçait un lanceur personnalisé à ce chemin par son propre lien symbolique à chaque mise à jour.

Avec un lanceur personnalisé, Claude Code conserve également chaque version installée sur le disque car il ne peut pas déterminer quelle version le lanceur nécessite. claude doctor signale un lanceur que le programme d'installation natif n'a pas créé.

Pour laisser Claude Code gérer à nouveau le lanceur, supprimez ~/.local/bin/claude et exécutez claude update.

Si une installation npm globale ne peut pas se mettre à jour automatiquement car le répertoire npm global n'est pas accessible en écriture, Claude Code affiche un avis unique au démarrage, et claude doctor répertorie les correctifs disponibles. Consultez erreurs de permission lors de l'installation pour plus de détails.

Configurer le canal de version

Contrôlez le canal de version que Claude Code suit pour les mises à jour automatiques et claude update avec le paramètre autoUpdatesChannel :

• "latest", la valeur par défaut : recevez les nouvelles fonctionnalités dès qu'elles sont publiées
• "stable" : utilisez une version qui a généralement environ une semaine, en ignorant les versions avec des régressions majeures

Configurez ceci via /config → Canal de mise à jour automatique, ou ajoutez-le à votre fichier settings.json :

{
  "autoUpdatesChannel": "stable"
}

Pour les déploiements d'entreprise, vous pouvez appliquer un canal de version cohérent dans votre organisation à l'aide des paramètres gérés.

Les installations Homebrew choisissent un canal par nom de cask au lieu de ce paramètre : claude-code suit stable et claude-code@latest suit latest.

Épingler une version minimale

Le paramètre minimumVersion établit un plancher. Les mises à jour automatiques en arrière-plan et claude update refusent d'installer toute version inférieure à cette valeur, donc passer au canal "stable" ne vous rétrograde pas si vous êtes déjà sur une version "latest" plus récente.

Passer de "latest" à "stable" via /config vous invite à rester sur la version actuelle ou à autoriser la rétrogradation. Choisir de rester définit minimumVersion à cette version. Revenir à "latest" l'efface.

Ajoutez-le à votre fichier settings.json pour épingler un plancher explicitement :

{
  "autoUpdatesChannel": "stable",
  "minimumVersion": "2.1.100"
}

Dans les paramètres gérés, cela applique un minimum à l'échelle de l'organisation que les paramètres utilisateur et projet ne peuvent pas remplacer.

Le pin minimumVersion ne contraint que les mises à jour. Pour faire refuser à Claude Code de démarrer en dehors d'une plage de versions, utilisez plutôt les paramètres gérés requiredMinimumVersion et requiredMaximumVersion. Les mises à jour respectent également le plafond requiredMaximumVersion. Consultez requiredMinimumVersion et requiredMaximumVersion.

Désactiver les mises à jour automatiques

Définissez DISABLE_AUTOUPDATER à "1" dans la clé env de votre fichier settings.json :

{
  "env": {
    "DISABLE_AUTOUPDATER": "1"
  }
}

Sur une installation native ou npm, confirmez que la modification a pris effet en exécutant claude doctor et en vérifiant que la ligne Auto-updates affiche disabled (set by env: DISABLE_AUTOUPDATER) au lieu de enabled.

DISABLE_AUTOUPDATER arrête uniquement la vérification en arrière-plan ; claude update et claude install fonctionnent toujours. Pour bloquer tous les chemins de mise à jour, y compris les mises à jour manuelles, définissez DISABLE_UPDATES à la place. Utilisez ceci lorsque vous distribuez Claude Code via vos propres canaux et que vous avez besoin que les utilisateurs restent sur la version que vous fournissez.

Mettre à jour manuellement

Pour appliquer une mise à jour immédiatement sans attendre la prochaine vérification en arrière-plan, exécutez :

claude update

Lorsqu'une mise à jour s'installe, la commande signale Successfully updated from <old version> to version <new version>. Si vous êtes déjà sur la version la plus récente, elle signale Claude Code is up to date (<version>). Les installations gérées par Homebrew, WinGet ou apk signalent Claude is up to date! à la place.

Options d'installation avancées

Ces options sont destinées à l'épinglage de version, aux gestionnaires de paquets Linux, à npm et à la vérification de l'intégrité des binaires.

Installer une version spécifique

L'installateur natif accepte soit un numéro de version spécifique, soit un canal de version (latest ou stable). Le canal que vous choisissez au moment de l'installation devient votre valeur par défaut pour les mises à jour automatiques. Consultez configurer le canal de version pour plus d'informations.

Pour installer la dernière version (par défaut) :

curl -fsSL https://claude.ai/install.sh | bash

irm https://claude.ai/install.ps1 | iex

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Pour installer la version stable :

curl -fsSL https://claude.ai/install.sh | bash -s stable

& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) stable

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd stable && del install.cmd

Pour installer un numéro de version spécifique :

curl -fsSL https://claude.ai/install.sh | bash -s 2.1.89

& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 2.1.89

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd 2.1.89 && del install.cmd

Pour confirmer quelle version a été installée, exécutez claude --version : la commande affiche la version exacte que vous avez transmise, par exemple 2.1.89 (Claude Code).

Installer avec les gestionnaires de paquets Linux

Claude Code publie des dépôts apt, dnf et apk signés. Chaque dépôt offre deux canaux : stable fournit une version généralement une semaine ancienne, en ignorant les versions avec des régressions majeures, et latest fournit chaque version dès qu'elle est publiée. Les commandes ci-dessous configurent le canal stable, qui convient à la plupart des utilisateurs ; chaque onglet affiche également l'URL du dépôt latest. Les installations du gestionnaire de paquets ne se mettent pas à jour automatiquement via Claude Code ; les mises à jour arrivent via votre flux de mise à niveau système normal.

Tous les dépôts sont signés avec la clé de signature de version Claude Code. Avant de faire confiance à la clé, vérifiez-la comme décrit dans chaque onglet.

sudo apt install curl gnupg

sudo install -d -m 0755 /etc/apt/keyrings
sudo curl -fsSL https://downloads.claude.ai/keys/claude-code.asc \
-o /etc/apt/keyrings/claude-code.asc

gpg --show-keys /etc/apt/keyrings/claude-code.asc

echo "deb [signed-by=/etc/apt/keyrings/claude-code.asc] https://downloads.claude.ai/claude-code/apt/stable stable main" \
| sudo tee /etc/apt/sources.list.d/claude-code.list
sudo apt update
sudo apt install claude-code

echo "deb [signed-by=/etc/apt/keyrings/claude-code.asc] https://downloads.claude.ai/claude-code/apt/latest latest main" \
| sudo tee /etc/apt/sources.list.d/claude-code.list

sudo tee /etc/yum.repos.d/claude-code.repo <<'EOF'
[claude-code]
name=Claude Code
baseurl=https://downloads.claude.ai/claude-code/rpm/stable
enabled=1
gpgcheck=1
gpgkey=https://downloads.claude.ai/keys/claude-code.asc
EOF
sudo dnf install claude-code

baseurl=https://downloads.claude.ai/claude-code/rpm/latest

wget -O /etc/apk/keys/claude-code.rsa.pub \
https://downloads.claude.ai/keys/claude-code.rsa.pub
echo "https://downloads.claude.ai/claude-code/apk/stable" >> /etc/apk/repositories
apk add claude-code

sed -i '\|downloads.claude.ai/claude-code/apk/stable|d' /etc/apk/repositories
echo "https://downloads.claude.ai/claude-code/apk/latest" >> /etc/apk/repositories

Installer avec npm

Vous pouvez également installer Claude Code en tant que paquet npm global. À partir de la v2.1.198, le paquet npm nécessite Node.js 22 ou ultérieur. Sur une version antérieure de Node.js, npm affiche un avertissement EBADENGINE lors de l'installation plutôt que d'échouer ; l'installation se termine et claude s'exécute toujours, car le paquet télécharge un binaire natif qui n'utilise pas votre Node.js à l'exécution.

npm install -g @anthropic-ai/claude-code

Le paquet npm installe le même binaire natif que l'installateur autonome. npm récupère le binaire via une dépendance optionnelle par plateforme telle que @anthropic-ai/claude-code-darwin-arm64, et une étape postinstallation le lie en place. Le binaire claude installé n'invoque pas lui-même Node.

Les plateformes d'installation npm supportées sont darwin-arm64, darwin-x64, linux-x64, linux-arm64, linux-x64-musl, linux-arm64-musl, win32-x64 et win32-arm64. Votre gestionnaire de paquets doit autoriser les dépendances optionnelles. Consultez le dépannage si le binaire est manquant après l'installation.

Pour mettre à niveau une installation npm, exécutez npm install -g @anthropic-ai/claude-code@latest. Évitez npm update -g, qui respecte la plage semver de l'installation d'origine et peut ne pas vous amener à la version la plus récente.

Intégrité des binaires et signature du code

Chaque version publie un manifest.json contenant les sommes de contrôle SHA256 pour chaque binaire de plateforme. Le manifeste est signé avec une clé GPG Anthropic, donc vérifier la signature sur le manifeste vérifie transitivement chaque binaire qu'il répertorie.

Vérifier la signature du manifeste

Les étapes 1 à 3 nécessitent un shell POSIX avec gpg et curl. Sur Windows, exécutez-les dans Git Bash ou WSL. L'étape 4 inclut une option PowerShell.

curl -fsSL https://downloads.claude.ai/keys/claude-code.asc | gpg --import

gpg --fingerprint security@anthropic.com

31DD DE24 DDFA B679 F42D  7BD2 BAA9 29FF 1A7E CACE

REPO=https://downloads.claude.ai/claude-code-releases
VERSION=2.1.89
curl -fsSLO "$REPO/$VERSION/manifest.json"
curl -fsSLO "$REPO/$VERSION/manifest.json.sig"

gpg --verify manifest.json.sig manifest.json

sha256sum claude

shasum -a 256 claude

(Get-FileHash claude.exe -Algorithm SHA256).Hash.ToLower()

Signatures de code de plateforme

En plus du manifeste signé, les binaires individuels portent des signatures de code natives de plateforme où supportées.

• macOS : signé par « Anthropic PBC » et notarié par Apple. Vérifiez avec codesign --verify --verbose ./claude.
• Windows : signé par « Anthropic, PBC ». Vérifiez avec Get-AuthenticodeSignature .\claude.exe.
• Linux : les binaires ne sont pas individuellement signés en code. Si vous téléchargez directement depuis le bucket claude-code-releases ou utilisez l'installateur natif, vérifiez l'intégrité avec la signature de manifeste ci-dessus. Si vous installez avec apt, dnf ou apk, votre gestionnaire de paquets vérifie automatiquement les signatures en utilisant la clé de signature du dépôt.

Désinstaller Claude Code

Pour supprimer Claude Code, suivez les instructions correspondant à votre méthode d'installation. Si claude s'exécute toujours après cela, vous avez probablement une deuxième installation ou un alias shell résiduel d'un ancien installateur. Consultez Vérifier les installations en conflit pour le trouver et le supprimer.

Installation native

Supprimez le binaire Claude Code et les fichiers de version :

rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude

Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force
Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force

Installation Homebrew

Supprimez le cask Homebrew que vous avez installé. Si vous avez installé le cask stable :

brew uninstall --cask claude-code

Si vous avez installé le cask latest :

brew uninstall --cask claude-code@latest

Installation WinGet

Supprimez le paquet WinGet :

winget uninstall Anthropic.ClaudeCode

apt / dnf / apk

Supprimez le paquet et la configuration du référentiel :

sudo apt remove claude-code
sudo rm /etc/apt/sources.list.d/claude-code.list /etc/apt/keyrings/claude-code.asc

sudo dnf remove claude-code
sudo rm /etc/yum.repos.d/claude-code.repo

apk del claude-code
sed -i '\|downloads.claude.ai/claude-code/apk|d' /etc/apk/repositories
rm /etc/apk/keys/claude-code.rsa.pub

npm

Supprimez le paquet npm global :

npm uninstall -g @anthropic-ai/claude-code

Supprimer les fichiers de configuration

L'extension VS Code, le plugin JetBrains et l'application de bureau écrivent également dans ~/.claude/. Si l'un d'eux est toujours installé, le répertoire est recréé la prochaine fois qu'il s'exécute. Pour supprimer Claude Code complètement, désinstallez l'extension VS Code, le plugin JetBrains et l'application de bureau avant de supprimer ces fichiers.

Pour supprimer les paramètres et données en cache de Claude Code :

# Supprimer les paramètres utilisateur et l'état
rm -rf ~/.claude
rm ~/.claude.json

# Supprimer les paramètres spécifiques au projet (exécutez depuis votre répertoire de projet)
rm -rf .claude
rm -f .mcp.json

# Supprimer les paramètres utilisateur et l'état
Remove-Item -Path "$env:USERPROFILE\.claude" -Recurse -Force
Remove-Item -Path "$env:USERPROFILE\.claude.json" -Force

# Supprimer les paramètres spécifiques au projet (exécutez depuis votre répertoire de projet)
Remove-Item -Path ".claude" -Recurse -Force
Remove-Item -Path ".mcp.json" -Force