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
To install Claude Code, use one of the following methods:
macOS, Linux, WSL:
curl -fsSL https://claude.ai/install.sh | bash
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
If you see The token '&&' is not a valid statement separator, you're in PowerShell, not CMD. If you see 'irm' is not recognized as an internal or external command, you're in CMD, not PowerShell. Your prompt shows PS C:\ when you're in PowerShell and C:\ without the PS when you're in CMD.
Git for Windows is recommended on native Windows so Claude Code can use the Bash tool. If Git for Windows is not installed, Claude Code uses PowerShell as the shell tool instead. WSL setups do not need Git for Windows.
brew install --cask claude-code
Homebrew offers two casks. claude-code tracks the stable release channel, which is typically about a week behind and skips releases with major regressions. claude-code@latest tracks the latest channel and receives new versions as soon as they ship.
winget install Anthropic.ClaudeCode
You can also install with apt, dnf, or apk on Debian, Fedora, RHEL, and Alpine.
Une fois l'installation terminée, ouvrez un terminal dans le projet sur lequel vous souhaitez travailler et démarrez Claude Code :
claude
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 | Nécessite | Sandboxing | Quand l'utiliser |
|---|---|---|---|
| Windows natif | Aucun ; Git for Windows est optionnel | Non supporté | Projets et outils Windows natifs |
| WSL 2 | WSL 2 activé | Supporté | Chaînes d'outils Linux ou exécution de commandes en sandbox |
| WSL 1 | WSL 1 activé | Non supporté | Si WSL 2 n'est pas disponible |
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 déployé progressivement en tant qu'option supplémentaire aux côtés de Bash. Définissez CLAUDE_CODE_USE_POWERSHELL_TOOL=1 pour l'activer ou 0 pour le désactiver. 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'installateur natif sur Alpine et autres distributions basées sur musl/uClibc nécessite libgcc, libstdc++ et ripgrep. Installez-les à 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 libgcc libstdc++ ripgrep
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
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
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 Vertex AI ou Microsoft Foundry.
Après l'installation, connectez-vous en exécutant claude et en suivant les invites du 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.
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 paramètres disponibles.
Désactiver les mises à jour automatiques
Définissez DISABLE_AUTOUPDATER à "1" dans la clé env de votre fichier settings.json :
{
"env": {
"DISABLE_AUTOUPDATER": "1"
}
}
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
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
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.
Pour Debian et Ubuntu. Les commandes suivantes configurent le canal stable :
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
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
Pour utiliser le canal latest à la place, le chemin d'URL et le nom de la suite changent tous les deux. Utilisez cette ligne deb :
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
Vérifiez l'empreinte digitale de la clé GPG avant de lui faire confiance : gpg --show-keys /etc/apt/keyrings/claude-code.asc devrait signaler 31DD DE24 DDFA B679 F42D 7BD2 BAA9 29FF 1A7E CACE.
Pour mettre à jour ultérieurement, exécutez sudo apt update && sudo apt upgrade claude-code.
Pour Fedora et RHEL. Les commandes suivantes configurent le canal stable :
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
Pour utiliser le canal latest à la place, définissez baseurl sur le dépôt latest :
baseurl=https://downloads.claude.ai/claude-code/rpm/latest
dnf télécharge la clé lors de la première installation et vous demande de confirmer l'empreinte digitale. Vérifiez qu'elle correspond à 31DD DE24 DDFA B679 F42D 7BD2 BAA9 29FF 1A7E CACE avant d'accepter.
Pour mettre à jour ultérieurement, exécutez sudo dnf upgrade claude-code.
Pour Alpine Linux. Les commandes suivantes configurent le canal stable :
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
Pour basculer vers le canal latest, supprimez la ligne du dépôt stable et ajoutez le dépôt latest :
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
Vérifiez la clé téléchargée avec sha256sum /etc/apk/keys/claude-code.rsa.pub, qui devrait signaler 395759c1f7449ef4cdef305a42e820f3c766d6090d142634ebdb049f113168b6.
Pour mettre à jour ultérieurement, exécutez apk update && apk upgrade claude-code.
Installer avec npm
Vous pouvez également installer Claude Code en tant que paquet npm global. Le paquet nécessite Node.js 18 ou ultérieur.
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.
Télécharger et importer la clé publique
La clé de signature de version est publiée à une URL fixe.
curl -fsSL https://downloads.claude.ai/keys/claude-code.asc | gpg --import
Afficher l'empreinte digitale de la clé importée.
gpg --fingerprint security@anthropic.com
Confirmez que la sortie inclut cette empreinte digitale :
31DD DE24 DDFA B679 F42D 7BD2 BAA9 29FF 1A7E CACE
Télécharger le manifeste et la signature
Définissez VERSION sur la version que vous souhaitez vérifier.
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"
Vérifier la signature
Vérifiez la signature détachée par rapport au manifeste.
gpg --verify manifest.json.sig manifest.json
Un résultat valide signale Good signature from "Anthropic Claude Code Release Signing <security@anthropic.com>".
gpg imprime également WARNING: This key is not certified with a trusted signature! pour toute clé nouvellement importée. C'est attendu. La ligne Good signature confirme que la vérification cryptographique a réussi. La comparaison d'empreinte digitale à l'étape 1 confirme que la clé elle-même est authentique.
Vérifier le binaire par rapport au manifeste
Comparez la somme de contrôle SHA256 de votre binaire téléchargé avec la valeur répertoriée sous platforms.<platform>.checksum dans 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-releasesou 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