Passer au contenu principal

Configuration requise

  • Systèmes d’exploitation : macOS 10.15+, Ubuntu 20.04+/Debian 10+, ou Windows 10+ (avec WSL 1, WSL 2, ou Git pour Windows)
  • Matériel : 4 Go+ de RAM
  • Logiciel : Node.js 18+ (requis uniquement pour l’installation NPM)
  • Réseau : Connexion Internet requise pour l’authentification et le traitement de l’IA
  • Shell : Fonctionne mieux dans Bash, Zsh ou Fish
  • Localisation : Pays supportés par Anthropic

Dépendances supplémentaires

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

Installation standard

To install Claude Code, use one of the following methods:
Certains utilisateurs peuvent être automatiquement migrés vers une méthode d’installation améliorée.
Une fois le processus d’installation terminé, accédez à votre projet et démarrez Claude Code :
cd your-awesome-project
claude
Claude Code propose les options d’authentification suivantes :
  1. Claude Console : L’option par défaut. Connectez-vous via Claude Console et complétez le processus OAuth. Nécessite une facturation active sur console.anthropic.com. Un espace de travail « Claude Code » sera automatiquement créé pour le suivi de l’utilisation et la gestion des coûts. Notez que vous ne pouvez pas créer de clés API pour l’espace de travail Claude Code - il est dédié exclusivement à l’utilisation de Claude Code.
  2. Application Claude (avec plan Pro ou Max) : Abonnez-vous au plan Pro ou Max de Claude pour un abonnement unifié qui inclut à la fois Claude Code et l’interface web. Obtenez plus de valeur au même prix tout en gérant votre compte en un seul endroit. Connectez-vous avec votre compte Claude.ai. Au lancement, choisissez l’option qui correspond à votre type d’abonnement.
  3. Plateformes d’entreprise : Configurez Claude Code pour utiliser Amazon Bedrock ou Google Vertex AI pour les déploiements d’entreprise avec votre infrastructure cloud existante.
Claude Code stocke vos identifiants de manière sécurisée. Consultez Gestion des identifiants pour plus de détails.

Configuration Windows

Option 1 : Claude Code dans WSL
  • WSL 1 et WSL 2 sont tous deux supportés
Option 2 : Claude Code sur Windows natif avec Git Bash
  • Nécessite Git pour Windows
  • Pour les installations Git portables, spécifiez le chemin vers votre bash.exe :
    $env:CLAUDE_CODE_GIT_BASH_PATH="C:\Program Files\Git\bin\bash.exe"
    

Méthodes d’installation alternatives

Claude Code propose plusieurs méthodes d’installation adaptées à différents environnements. Si vous rencontrez des problèmes lors de l’installation, consultez le guide de dépannage.
Exécutez claude doctor après l’installation pour vérifier votre type d’installation et votre version.

Options d’installation native

L’installation native est la méthode recommandée et offre plusieurs avantages :
  • Un exécutable autonome
  • Aucune dépendance Node.js
  • Stabilité améliorée du mise à jour automatique
Si vous avez une installation existante de Claude Code, utilisez claude install pour migrer vers l’installation du binaire natif. Pour les options d’installation avancées avec le programme d’installation natif : macOS, Linux, WSL :
# Installer la version stable (par défaut)
curl -fsSL https://claude.ai/install.sh | bash

# Installer la dernière version
curl -fsSL https://claude.ai/install.sh | bash -s latest

# Installer un numéro de version spécifique
curl -fsSL https://claude.ai/install.sh | bash -s 1.0.58
Alpine Linux et autres distributions basées sur musl/uClibc : La compilation native vous oblige à installer libgcc, libstdc++ et ripgrep. Installez (Alpine : apk add libgcc libstdc++ ripgrep) et définissez USE_BUILTIN_RIPGREP=0.
Claude Code installé via Homebrew se mettra à jour automatiquement en dehors du répertoire brew sauf s’il est explicitement désactivé avec la variable d’environnement DISABLE_AUTOUPDATER (voir la section Mises à jour automatiques).
Windows PowerShell :
# Installer la version stable (par défaut)
irm https://claude.ai/install.ps1 | iex

# Installer la dernière version
& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) latest

# Installer un numéro de version spécifique
& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 1.0.58
Windows CMD :
REM Installer la version stable (par défaut)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

REM Installer la dernière version
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd latest && del install.cmd

REM Installer un numéro de version spécifique
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd 1.0.58 && del install.cmd
Assurez-vous de supprimer tous les anciens alias ou liens symboliques avant d’installer.

Installation NPM

Pour les environnements où NPM est préféré ou requis :
npm install -g @anthropic-ai/claude-code
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 permission, consultez configurer Claude Code pour les solutions recommandées.

Exécution sur AWS ou GCP

Par défaut, Claude Code utilise l’API Claude. Pour plus de détails sur l’exécution de Claude Code sur AWS ou GCP, consultez intégrations tierces.

Mettre à jour Claude Code

Mises à jour automatiques

Claude Code se met à jour automatiquement pour vous assurer que vous disposez des dernières fonctionnalités et correctifs de sécurité.
  • Vérifications de mise à jour : Effectuées au démarrage et périodiquement pendant l’exécution
  • Processus de mise à jour : Télécharge et installe automatiquement en arrière-plan
  • Notifications : Vous verrez une notification lorsque les mises à jour sont installées
  • Application des mises à jour : Les mises à jour prennent effet la prochaine fois que vous démarrez Claude Code
Désactiver les mises à jour automatiques : Définissez la variable d’environnement DISABLE_AUTOUPDATER dans votre shell ou fichier settings.json :
export DISABLE_AUTOUPDATER=1

Mettre à jour manuellement

claude update