Installer Claude Code : guide de démarrage pas à pas

Pour installer Claude Code, partez de la méthode officielle correspondant à votre système, vérifiez les prérequis puis testez le lancement dans un petit dépôt sans données sensibles. La documentation consultée indique notamment macOS 10.15 ou plus récent, Ubuntu 20.04/Debian 10 ou plus récent, ou Windows avec WSL ou Git for Windows, au moins 4 Go de mémoire et Node.js 18 ou ultérieur pour la méthode npm documentée. Les offres et options d’authentification peuvent évoluer : confirmez-les dans le guide officiel avant de commencer.

Ce tutoriel suit la méthode npm standard affichée par Anthropic à la date de rédaction. L’éditeur propose également d’autres méthodes; elles ne sont pas mélangées ici afin de garder les étapes reproductibles.

Objectif et périmètre

À la fin, vous devriez pouvoir vérifier que la commande claude est disponible, ouvrir une session dans un dépôt d’essai et comprendre où trouver les informations de diagnostic. Vous aurez également vérifié le système, l’authentification et le répertoire de travail.

Les étapes sont décrites à partir de la documentation officielle actuelle; elles n’ont pas été exécutées sur une machine de lecteur. Si votre environnement diffère, suivez les instructions de la version officielle plutôt que de forcer une commande issue d’un ancien tutoriel.

Prérequis avant l’installation

Vérifier le système

La page officielle « Set up Claude Code » liste macOS 10.15+, Ubuntu 20.04+/Debian 10+ et Windows 10+ avec WSL 1, WSL 2 ou Git for Windows. Elle mentionne 4 Go de mémoire, une connexion Internet pour l’authentification et le traitement, ainsi qu’un shell Bash, Zsh ou Fish recommandé.

Sur Windows natif, la documentation indique d’utiliser Git Bash, fourni par Git for Windows. Avec une installation Git portable, un chemin vers bash.exe peut être nécessaire. WSL est aussi pris en charge. Choisissez un seul environnement pour commencer et conservez-le pendant le dépannage.

Vérifier Node.js si vous utilisez npm

La procédure standard npm documentée requiert Node.js 18 ou ultérieur. Ouvrez un terminal et vérifiez les versions :

node --version
npm --version

Si node ou npm n’est pas reconnu, installez Node.js depuis une source officielle adaptée à votre système puis ouvrez une nouvelle session de terminal. Ne lancez pas une installation globale avec sudo npm install -g : Anthropic le déconseille, notamment à cause des problèmes de permissions et de sécurité.

Installer Claude Code avec la méthode npm officielle

Ouvrez un terminal adapté. Sur macOS ou Linux, utilisez votre shell habituel. Sur Windows, choisissez WSL ou Git Bash conformément à la documentation.
Vérifiez Node.js. Confirmez que la version retournée par node --version satisfait le prérequis officiel.

Lancez la commande documentée :

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

Laissez npm terminer. Si vous obtenez une erreur de permissions, ne la contournez pas avec sudo; utilisez les conseils officiels de configuration pour les installations npm globales.
Contrôlez l’installation :
```
claude doctor
```
Anthropic recommande cette commande de diagnostic. Elle peut notamment aider à vérifier le type d’installation et la version.
Créez ou choisissez un dépôt de test. N’utilisez pas directement un dépôt de production pour votre première session. Vérifiez que Git fonctionne et que votre arbre de travail est propre.
Entrez dans le projet et lancez Claude Code :
```
cd chemin/vers/votre-projet-test
claude
```
Remplacez le chemin d’exemple par le chemin réel de votre projet. La documentation officielle montre le démarrage depuis le répertoire du projet.
Choisissez la bonne méthode d’authentification. La documentation décrit l’Anthropic Console, un compte Claude avec une formule Pro ou Max admissible, et des plateformes d’entreprise telles qu’Amazon Bedrock ou Google Vertex AI. Les exigences de facturation et de disponibilité dépendent de la méthode; consultez la page avant de poursuivre.

Première session : vérifier avant de demander une modification

Commencez par une demande en lecture seule, par exemple : « Décris brièvement la structure de ce dépôt et indique les fichiers qui semblent contenir les tests. Ne modifie aucun fichier. » Vérifiez que la réponse correspond aux fichiers réellement présents.

Ensuite, demandez une modification minuscule sur le dépôt d’essai, telle qu’une correction de texte dans un fichier fictif. Avant d’accepter, inspectez le diff avec Git :

git status --short
git diff

Si la modification est inattendue, interrompez la tâche et restaurez vous-même l’état connu selon votre workflow habituel. Évitez les commandes de nettoyage automatiques dont vous ne connaissez pas l’effet. Une session réussie ne prouve pas encore que l’outil respecte toutes les conventions de votre projet.

Incidents fréquents et solutions

`claude` n’est pas reconnu

Le répertoire des exécutables npm globaux peut ne pas figurer dans votre PATH, ou le terminal peut être resté ouvert depuis l’installation. Ouvrez une nouvelle fenêtre de terminal et relancez claude doctor. Consultez ensuite la documentation officielle de dépannage pour votre système et votre gestionnaire npm; n’ajoutez pas au hasard un chemin trouvé dans un forum.

npm signale une erreur de permissions

N’utilisez pas sudo pour forcer l’installation. Anthropic documente des méthodes de configuration de l’environnement npm ou de migration vers un installateur local. Identifiez d’abord votre système et suivez la méthode officielle correspondant à votre installation actuelle.

Sous Windows, le shell ou Git Bash ne démarre pas

Confirmez que Git for Windows est installé, ou utilisez WSL conformément au guide. Pour une installation portable de Git, la documentation permet de définir CLAUDE_CODE_GIT_BASH_PATH vers bash.exe. Contrôlez le chemin exact avant de le définir; un chemin d’exemple n’est pas nécessairement celui de votre machine.

L’authentification ou la connexion échoue

Vérifiez l’accès Internet, la disponibilité de la méthode d’authentification dans votre région et l’état de votre compte. Si vous passez par une plateforme d’entreprise, adressez-vous à l’administrateur pour les paramètres requis. Ne copiez pas de clé ou de jeton dans un dépôt, un ticket public ou une capture d’écran.

Une ancienne version semble toujours active

Exécutez claude doctor, vérifiez le chemin de la commande résolue par votre shell et suivez les notes de mise à jour officielles. Des méthodes d’installation différentes peuvent coexister; ne supprimez pas de fichiers à l’aveugle.

Permissions et premières précautions

Claude Code peut interagir avec le projet. Commencez avec une copie de travail et une tâche limitée, examinez les demandes d’autorisation et refusez celles qui dépassent l’objectif. La référence CLI documente des options de permissions et des outils autorisés ou interdits. N’utilisez pas les options qui ignorent les confirmations pour un premier essai.

Évitez de placer des secrets dans les consignes, dans le dépôt de test ou dans une demande envoyée au modèle. Vérifiez la politique de votre organisation avant de transmettre du code propriétaire. L’authentification stockée localement doit rester dans l’environnement prévu par le fournisseur.

FAQ

Claude Code est-il disponible sur Windows ?

La documentation actuelle décrit une prise en charge via WSL 1 ou 2, ainsi qu’une option Windows native avec Git Bash. Vérifiez la page officielle pour les exigences exactes et les éventuelles évolutions.

Quels prérequis faut-il avant l’installation ?

Ils dépendent de la méthode retenue. Pour la procédure npm décrite ici, Anthropic indique notamment Node.js 18 ou plus récent, au moins 4 Go de mémoire et une connexion Internet. Vérifiez aussi la compatibilité de votre système.

Faut-il installer Node.js ?

La méthode npm standard le requiert. D’autres méthodes officielles peuvent avoir des prérequis différents. Ce guide suit volontairement la voie npm afin que les commandes restent cohérentes.

Comment vérifier que Claude Code est installé ?

Lancez claude doctor, commande de diagnostic recommandée par Anthropic. Si le shell ne trouve pas la commande, vérifiez l’installation et le PATH selon la documentation de votre système.

Comment se connecter à son compte ?

Au premier lancement, suivez le parcours d’authentification correspondant à votre compte ou à votre infrastructure d’entreprise. Les options listées par Anthropic comprennent Console, certaines formules Claude et des plateformes cloud prises en charge.

Comment lancer Claude Code dans un dépôt ?

Ouvrez un terminal, placez-vous dans le répertoire du dépôt, puis exécutez claude. Commencez par une demande sans modification et vérifiez le contexte détecté.

Peut-on limiter les permissions ?

La CLI fournit des options et modes de permission décrits dans la référence officielle. Consultez ces paramètres pour votre version, commencez avec les confirmations activées et accordez uniquement les accès nécessaires.

Que faire si la commande n’est pas trouvée ?

Rouvrez le terminal, lancez le diagnostic si possible et vérifiez le répertoire des exécutables npm globaux dans votre PATH. Utilisez le guide de dépannage officiel avant de modifier la configuration de shell.

Comment mettre à jour ou désinstaller Claude Code ?

Les méthodes de mise à jour varient selon l’installation. La documentation décrit la mise à jour automatique et des commandes manuelles. Pour la désinstallation, suivez les instructions correspondant à la méthode installée; ne supprimez pas des dossiers supposés.

Peut-on commencer dans un dépôt de test ?

Oui, c’est recommandé. Un petit dépôt sans secret permet de comprendre les réponses, les autorisations et la revue des changements sans exposer un environnement de production.

Conclusion

Une installation réussie ne se limite pas à voir la commande claude démarrer. Vérifiez le diagnostic, l’authentification, le répertoire courant et les permissions dans un dépôt d’essai, puis contrôlez chaque modification avec Git et les tests du projet. Si un prérequis ou une commande diffère de ce guide, suivez la documentation officielle à jour avant d’intervenir sur un dépôt réel.

Sources et limites

Documentation officielle Anthropic consultée le 24 septembre 2026 : installation et prise en main de Claude Code, référence CLI et vue d’ensemble. Les systèmes pris en charge, prérequis, méthodes d’installation et offres peuvent changer; revérifiez ces pages avant publication. Les étapes n’ont pas été exécutées dans cet environnement.