Résumé rapide : Claude Code CLI s'installe via une seule commande qui télécharge et configure automatiquement l'outil. Sur macOS et Linux, utilisez le script shell officiel de la documentation d'Anthropic, tandis que les utilisateurs Windows exécutent des commandes PowerShell ou WSL. Après l'installation, authentifiez-vous avec votre clé API pour commencer à utiliser l'assistant de codage IA de Claude dans votre terminal.
Claude Code est un outil de codage agentique qui réside dans votre terminal et comprend l'intégralité de votre base de code. Selon la documentation officielle de Claude Code, il peut lire des fichiers, exécuter des commandes, modifier du code et s'intégrer aux outils de développement par le biais de conversations en langage naturel.
Mais pour commencer, il faut une installation correcte. Voici tout ce dont vous avez besoin pour installer Claude Code CLI et le configurer correctement.
Exigences système avant l'installation
Avant d'installer Claude Code, vérifiez que le système répond aux exigences de base. Selon la documentation officielle de configuration avancée, supprimez cette phrase entièrement.
Vérifiez l'installation de Node.js en ouvrant un terminal et en exécutant :
| node –version |
Si Node.js n'est pas installé ou si la version est inférieure à 18, téléchargez-le depuis le site officiel de Node.js. La version de Support à Long Terme (LTS) fonctionne parfaitement pour Claude Code.
Au-delà de Node.js, le système nécessite des exigences de base : macOS 13.0 ou supérieur pour les utilisateurs Mac, Windows 10 ou supérieur pour les systèmes Windows, et la plupart des distributions Linux modernes fonctionnent sans problème. Un compte Claude d'Anthropic est également requis pour l'authentification après l'installation.
Installation de Claude Code sur macOS et Linux
Le processus d'installation pour macOS et Linux utilise une seule commande shell qui gère tout automatiquement. Cette méthode est documentée dans le guide de démarrage rapide officiel de Claude Code.
Ouvrez Terminal et exécutez le script d'installation :
| curl -fsSL claude.ai/install.sh | bash |
Le script télécharge le binaire Claude Code, le place dans le bon répertoire et configure le PATH automatiquement. L'ensemble du processus se termine généralement en moins d'une minute.
Pour les utilisateurs macOS qui préfèrent Homebrew, une méthode d'installation alternative existe bien qu'elle ne soit pas officiellement documentée dans les sources principales. La méthode curl reste l'approche recommandée selon la documentation officielle.
Vérification de l'installation
Une fois l'installation terminée, vérifiez que Claude Code est accessible :
| claude –version |
Cette commande doit afficher le numéro de version installé. Si une erreur apparaît indiquant "command not found", la configuration du PATH nécessite un ajustement.
Selon la documentation officielle de dépannage, les problèmes de PATH sont le problème d'installation le plus courant. La solution consiste à ajouter le répertoire d'installation de Claude au fichier de configuration du shell.
Installation de Claude Code sur macOS et Linux
Le processus d'installation pour macOS et Linux repose sur npm (Node Package Manager). Selon la documentation officielle, vous devez avoir installé Node.js 18+ sur votre système avant de continuer. Contrairement aux outils CLI traditionnels qui utilisent des scripts shell, Claude Code est installé globalement via votre terminal pour garantir que toutes les dépendances sont correctement gérées.
Ouvrez votre Terminal et exécutez la commande suivante pour installer le package :
| export CLAUDE_CODE_RELEASE_ALPHA=1 && npm install -g @anthropic-ai/claude-code |
Remarque : La variable d'environnement CLAUDE_CODE_RELEASE_ALPHA=1 est actuellement requise pendant la phase bêta/alpha publique pour reconnaître le statut d'aperçu de l'outil.
Cette commande télécharge le package depuis le registre npm officiel et lie l'exécutable claude au répertoire bin global de votre système. Bien que certains utilisateurs puissent tenter de trouver des formules Homebrew, la méthode npm est le seul chemin d'installation officiellement pris en charge et documenté.
Vérification de l'installation
Une fois l'installation terminée, vérifiez que la CLI est correctement mappée à votre environnement en exécutant :
| claude –version |
Cette commande doit afficher le numéro de version actuel (par exemple, 0.2.9). Si vous rencontrez une erreur "command not found", cela signifie généralement que votre répertoire npm global ne se trouve pas dans le PATH de votre système.
Selon la documentation officielle de dépannage, vous pouvez résoudre ce problème en identifiant votre préfixe npm avec npm config get prefix et en vous assurant que le dossier /bin résultant est ajouté à votre fichier .zshrc ou .bashrc.
Installation de Claude Code sous Windows
L'installation sous Windows offre deux approches principales : installation native PowerShell ou utilisation de Windows Subsystem for Linux (WSL). La documentation officielle recommande PowerShell pour la plupart des utilisateurs.
Méthode d'installation PowerShell
Ouvrez PowerShell en tant qu'administrateur (clic droit sur le menu Démarrer et sélectionnez "Windows PowerShell (Admin)"). Exécutez cette commande :
| irm claude.ai/install.ps1 | iex |
Le script PowerShell gère automatiquement le téléchargement, l'installation et la configuration du PATH. Après l'achèvement, fermez et rouvrez PowerShell pour vous assurer que les mises à jour du PATH prennent effet.
Méthode d'installation WSL
Les développeurs utilisant déjà WSL peuvent installer Claude Code en utilisant la méthode Linux. Ouvrez le terminal WSL et exécutez la même commande curl que celle utilisée pour Linux :
| curl -fsSL claude.ai/install.sh | bash |
L'approche WSL fonctionne de manière identique aux installations Linux natives. Un avantage : WSL fournit un environnement plus semblable à Unix qui correspond aux configurations de serveurs de production.
Selon la documentation officielle de dépannage, les utilisateurs WSL rencontrent parfois des problèmes de connectivité réseau. Si l'installation échoue, vérifiez que WSL peut accéder aux réseaux externes et que les règles de pare-feu ne bloquent pas le trafic.
Trouver les crédits Claude et les outils IA au même endroit
Installer Claude Code CLI est une étape. Payer les outils IA à long terme en est une autre. Get AI Perks collecte les crédits de démarrage et les réductions logicielles pour les outils IA et cloud en un seul endroit. Il offre aux fondateurs l'accès à plus de 200 avantages, y compris des offres d'Anthropic, Claude, OpenAI, Gemini, ElevenLabs, Intercom, et d'autres. La plateforme affiche également les conditions des avantages et des guides pour réclamer chaque offre.
Vous cherchez des crédits Claude ou Anthropic ?
Consultez Get AI Perks pour :
- trouver les crédits et réductions d'outils IA en un seul endroit
- examiner les conditions des avantages avant de postuler
- accéder aux guides pour réclamer les offres de démarrage
👉 Visitez Get AI Perks pour découvrir les avantages disponibles pour Claude, Anthropic et d'autres logiciels IA.
Authentification et configuration initiale
Après l'installation, Claude Code nécessite une authentification avant de pouvoir fonctionner. L'outil utilise les clés API d'Anthropic pour vérifier l'accès.
Lancez le processus d'authentification en exécutant :
| claude |
La première fois que cette commande s'exécute, Claude Code demande l'authentification. Selon le guide de démarrage rapide officiel, cela ouvre une fenêtre de navigateur pour se connecter au compte Anthropic.
Après vous être connecté via le navigateur, la CLI reçoit automatiquement un jeton d'authentification. Ce jeton est stocké localement et persiste entre les sessions, donc une authentification répétée n'est pas nécessaire.
Configuration des paramètres au niveau du projet
Claude Code prend en charge la configuration à plusieurs niveaux selon la documentation officielle des paramètres. Les niveaux de configuration les plus courants sont :
| Portée | Emplacement | Cas d'utilisation |
|---|---|---|
| Utilisateur | Répertoire ~/.claude/ | Préférences personnelles pour tous les projets |
| Projet | .claude/ dans le dépôt | Configuration d'équipe partagée |
| Local | .claude/settings.local.json | Remises spécifiques à la machine |
Pour la configuration initiale, la configuration au niveau de l'utilisateur est suffisante. Les paramètres au niveau du projet deviennent importants lorsque l'on travaille avec des équipes qui partagent des normes de codage.
Lancer votre première session Claude Code
Une fois l'installation et l'authentification terminées, lancez Claude Code en exécutant la commande sans arguments :
| claude |
Cela démarre le mode interactif où Claude répond aux requêtes en langage naturel. La documentation officielle décrit le mode interactif comme le moyen principal d'utiliser Claude Code pour les tâches de développement.
Essayez une commande de test simple :
| Montrez-moi la structure de ce projet |
Claude Code analyse le répertoire actuel et fournit un aperçu de la structure de la base de code. Cela démontre que l'installation fonctionne correctement et que Claude a accès pour lire les fichiers.
Commandes essentielles pour une utilisation quotidienne
Au-delà du mode interactif, Claude Code prend en charge plusieurs modèles de commandes documentés dans la référence CLI :
| Modèle de commande | Objectif | Exemple |
|---|---|---|
| claude | Démarrer une session interactive | claude |
| claude “tâche” | Exécuter une tâche unique | claude “corrige les erreurs de linting” |
| claude -p “requête” | Requête rapide sans session | claude -p “que fait cette fonction” |
Le modèle de tâche unique est particulièrement utile pour les pipelines CI/CD et les scripts d'automatisation où une session interactive n'est pas appropriée.
Dépannage d'installation courant
Même avec des scripts d'installation automatisés, des problèmes surviennent occasionnellement. La documentation officielle de dépannage couvre les problèmes les plus fréquents.
Erreurs "Command not found"
Si le terminal affiche "command not found: claude" après l'installation, la configuration du PATH n'a pas été correctement effectuée. Pour macOS et Linux, ajoutez manuellement l'emplacement du binaire de Claude au fichier de configuration du shell.
Pour les utilisateurs bash, modifiez ~/.bashrc ou ~/.bash_profile et ajoutez :
| export PATH=”$HOME/.local/bin:$PATH” |
Pour les utilisateurs zsh (par défaut sur les macOS modernes), modifiez ~/.zshrc avec la même ligne. Après avoir enregistré, rechargez la configuration avec source ~/.zshrc ou ouvrez une nouvelle fenêtre de terminal.
Problèmes réseau et de pare-feu
Les réseaux d'entreprise et les pare-feux restrictifs bloquent parfois le script d'installation. Selon la documentation de dépannage, si l'installation échoue ou renvoie du HTML au lieu de s'exécuter, l'accès réseau aux serveurs d'Anthropic peut être bloqué.
La solution de contournement consiste à télécharger le script d'installation séparément :
| curl -fsSL code.anthropic.com/install.sh -o install.sh chmod +x install.sh ./install.sh |
Cette approche offre plus de visibilité sur ce qui échoue si des erreurs se produisent pendant le téléchargement ou l'exécution.
Problèmes spécifiques à WSL
Les utilisateurs Windows exécutant WSL rencontrent parfois des problèmes de connectivité entre le sous-système Linux et Windows. La documentation officielle mentionne que les règles de pare-feu peuvent devoir être ajustées pour autoriser le trafic WSL.
Si Claude Code s'installe correctement mais ne peut pas atteindre les serveurs d'Anthropic pour l'authentification, vérifiez que le pare-feu Windows autorise l'accès réseau WSL. Le guide de dépannage fournit des commandes PowerShell spécifiques pour configurer les règles de pare-feu.
Mise à jour de Claude Code
Claude Code reçoit des mises à jour régulières avec de nouvelles fonctionnalités et améliorations. Selon la documentation officielle, les mises à jour s'installent en utilisant la même commande que l'installation initiale.
Exécutez à nouveau le script d'installation :
| curl -fsSL code.anthropic.com/install.sh | sh |
Le script détecte l'installation existante et la met à jour vers la dernière version. Aucune configuration ni authentification n'est perdue pendant le processus de mise à jour.
Vérifiez la version actuelle avant et après la mise à jour :
| claude –version |
Le journal des modifications dans la documentation officielle de Claude Code liste toutes les modifications entre les versions, ce qui aide à déterminer si une mise à jour introduit des fonctionnalités pertinentes pour des flux de travail spécifiques.
Prochaines étapes après l'installation
Avec Claude Code installé et fonctionnel, l'exploration de fonctionnalités avancées devient possible. La documentation officielle décrit plusieurs domaines qui méritent d'être étudiés :
- Compétences et personnalisation : Selon la documentation officielle sur les compétences, Claude Code prend en charge les compétences personnalisées définies dans des fichiers Markdown dans le répertoire .claude/skills/. Ces compétences étendent les capacités de Claude avec des commandes et des flux de travail spécifiques au projet.
- Protocole de contexte du modèle (MCP) : L'intégration MCP permet à Claude Code de se connecter à des outils et services externes. Cela transforme Claude en un hub qui peut accéder aux bases de données, aux API et à d'autres ressources de développement.
- Collaboration d'équipe : Les fichiers de configuration au niveau du projet dans le répertoire .claude/ peuvent être ajoutés au contrôle de version, partageant les paramètres de Claude Code entre les équipes de développement entières.
- La documentation officielle fournit des guides détaillés pour chacun de ces domaines, s'appuyant sur l'installation de base couverte ici.
Questions fréquemment posées
Ai-je besoin d'un abonnement Claude payant pour utiliser Claude Code CLI ?
Claude Code nécessite un compte Claude d'Anthropic, mais le niveau d'abonnement spécifique requis dépend de l'utilisation. Selon la documentation officielle, l'authentification est nécessaire, mais les détails de tarification doivent être vérifiés sur le site officiel d'Anthropic car les plans évoluent avec le temps.
Puis-je installer Claude Code sans privilèges d'administrateur ?
Sur macOS et Linux, Claude Code s'installe par défaut dans le répertoire personnel de l'utilisateur et ne nécessite pas de droits d'administrateur. Les utilisateurs Windows peuvent avoir besoin de privilèges d'administrateur pour la méthode d'installation PowerShell, bien que les installations WSL ne nécessitent pas de droits d'administrateur.
Claude Code fonctionne-t-il hors ligne ?
Non. Claude Code est un outil alimenté par l'IA qui communique avec les serveurs d'Anthropic pour traiter les requêtes. Selon la documentation officielle, une connexion Internet active est nécessaire pour que Claude analyse le code et génère des réponses.
Comment désinstaller Claude Code ?
La documentation officielle de configuration avancée explique que la désinstallation implique de supprimer le binaire et les fichiers de configuration. Sur macOS et Linux, supprimez le répertoire ~/.claude et retirez la modification du PATH des fichiers de configuration du shell. Les utilisateurs Windows doivent supprimer le répertoire d'installation et effacer la variable d'environnement PATH.
Claude Code peut-il accéder à l'intégralité de mon système de fichiers ?
Par défaut, Claude Code fonctionne dans le répertoire de travail actuel et ses sous-répertoires. Selon la documentation officielle sur les autorisations, l'accès peut être restreint davantage en utilisant les paramètres sandbox dans les fichiers de configuration. Claude demande toujours une confirmation avant d'exécuter des opérations potentiellement destructrices.
Quelle est la différence entre Claude Code CLI et Claude Desktop ?
Claude Code CLI s'exécute dans le terminal et se concentre sur les flux de travail de développement avec un accès direct au système de fichiers et à l'exécution de commandes. Claude Desktop est une application autonome avec une interface graphique. Les deux outils servent des cas d'utilisation différents, le CLI étant optimisé pour les développeurs qui préfèrent les flux de travail basés sur le terminal.
À quelle fréquence dois-je mettre à jour Claude Code ?
Les mises à jour peuvent être installées quand vous le souhaitez. Le journal des modifications officiel documente les nouvelles fonctionnalités et les corrections de bugs. Pour les équipes, la coordination des mises à jour garantit que tout le monde utilise des versions compatibles, bien que Claude Code maintienne la rétrocompatibilité avec les fichiers de configuration entre les versions.
Conclusion
L'installation de Claude Code CLI ne prend que quelques minutes, quel que soit le système d'exploitation. Les scripts d'installation automatisés gèrent la configuration, la configuration du PATH et le placement du binaire sans intervention manuelle.
Après l'installation et l'authentification, Claude Code devient un puissant assistant de codage IA accessible depuis n'importe quel terminal. Les commandes en langage naturel permettent aux développeurs d'écrire du code, de corriger des bugs et d'automatiser des tâches sans quitter la ligne de commande.
Prêt à découvrir le développement assisté par l'IA ? Exécutez la commande d'installation pour votre plateforme et lancez votre première session Claude Code dès aujourd'hui. La documentation officielle sur code.claude.com fournit des guides complets pour les fonctionnalités avancées une fois la configuration de base terminée.
