Passer au contenu principal

Documentation Index

Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

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. Sur Windows natif, Git for Windows est recommandé ; Claude Code bascule vers PowerShell en l’absence de Git Bash. Les configurations WSL ne nécessitent pas Git for Windows.
  • Localisation : pays supportés par Anthropic

​
Dépendances supplémentaires

​
Installer Claude Code

Préférez une interface graphique ? L’application de bureau vous permet d’utiliser Claude Code sans le terminal. Téléchargez-la pour macOS ou Windows.Nouveau sur le terminal ? Consultez le guide du terminal pour des instructions étape par étape.
To install Claude Code, use one of the following methods: 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 :
OptionNécessiteSandboxingQuand l’utiliser
Windows natifGit for Windows recommandé ; PowerShell utilisé en l’absence de celui-ciNon supportéProjets et outils Windows natifs
WSL 2WSL 2 activéSupportéChaînes d’outils Linux ou exécution de commandes en sandbox
WSL 1WSL 1 activéNon supportéSi WSL 2 n’est pas disponible
Option 1 : Windows natif avec Git Bash Installez Git for Windows, puis exécutez la commande d’installation à partir de PowerShell ou CMD. Vous n’avez pas besoin d’exécuter en tant qu’administrateur. 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 PowerShell, CMD ou Git Bash. Lorsque Git Bash est installé, Claude Code l’utilise en interne pour exécuter les commandes quel que soit l’endroit d’où vous l’avez lancé. Si Claude Code ne trouve pas votre installation de Git Bash, définissez le chemin dans votre fichier settings.json : 
{
  "env": {
    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
  }
}
Claude Code peut également exécuter PowerShell nativement sur Windows. Lorsque Git Bash est installé, l’outil PowerShell est déployé progressivement en tant qu’option supplémentaire : 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.
Les installations Homebrew, WinGet, apt, dnf et apk ne se mettent pas à jour automatiquement par défaut ; consultez ci-dessous pour opter pour Homebrew et WinGet. Pour mettre à niveau Homebrew manuellement, exécutez brew upgrade claude-code ou brew upgrade claude-code@latest, selon le cask que vous avez installé. Pour WinGet, exécutez winget upgrade Anthropic.ClaudeCode. Pour les gestionnaires de paquets Linux, consultez les commandes de mise à niveau dans Installer avec les gestionnaires de paquets Linux.Pour que Claude Code exécute la commande de mise à niveau pour vous sur Homebrew ou WinGet, définissez CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE à 1. Claude Code exécute ensuite la mise à niveau en arrière-plan lorsqu’une nouvelle version est disponible et affiche une invite de redémarrage en cas de succès. La mise à niveau cible uniquement le paquet Claude Code et n’affecte pas les autres logiciels que vous avez installés.Sur WinGet, la mise à niveau peut échouer pendant que Claude Code s’exécute car Windows verrouille l’exécutable. Dans ce cas, Claude Code affiche la commande manuelle à la place. apt, dnf et apk continuent à nécessiter une mise à niveau manuelle car ces commandes ont besoin de privilèges élevés.Problème connu : Claude Code peut vous notifier des mises à jour avant que la nouvelle version soit disponible dans ces gestionnaires de paquets. Si une mise à niveau échoue, attendez et réessayez plus tard.Homebrew conserve les anciennes versions sur le disque après les mises à niveau. Exécutez brew cleanup périodiquement pour récupérer de l’espace disque.

​
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.

​
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
Pour installer la version stable : 
curl -fsSL https://claude.ai/install.sh | bash -s stable
Pour installer un numéro de version spécifique : 
curl -fsSL https://claude.ai/install.sh | bash -s 2.1.89

​
Installer avec les gestionnaires de paquets Linux

Claude Code publie des dépôts apt, dnf et apk signés. Remplacez stable par latest pour le canal de roulement. 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. Pour utiliser le canal de roulement, modifiez les deux occurrences de stable dans la ligne deb : le chemin d’URL et le nom de la suite.
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
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.

​
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.
N’utilisez PAS sudo npm install -g car cela peut entraîner des problèmes de permissions et des risques de sécurité. Si vous rencontrez des erreurs de permissions, consultez le dépannage des erreurs de permissions.

​
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.
1

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
2

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"
3

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.
4

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
Les signatures de manifeste sont disponibles pour les versions à partir de 2.1.89. Les versions antérieures publient les sommes de contrôle dans manifest.json sans signature détachée.

​
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

​
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

​
npm

Supprimez le paquet npm global : 
npm uninstall -g @anthropic-ai/claude-code

​
Supprimer les fichiers de configuration

La suppression des fichiers de configuration supprimera tous vos paramètres, outils autorisés, configurations de serveur MCP et historique de session.
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