Comment installer Claude Code : guide Mac, Windows & Linux

En bref : Claude Code s'installe comme un package npm en moins de 5 minutes sur Mac, Windows ou Linux. Vous avez besoin de Node.js 18+ et d'un accès FreeClaude actif. Ce guide couvre l'installation sur chaque plateforme, la configuration post-installation, votre première session, les commandes essentielles et la résolution des problèmes courants.

Qu'est-ce que Claude Code ?

Claude Code est l'assistant de codage IA basé sur le terminal d'Anthropic — et il est fondamentalement différent des outils IA basés sur navigateur ou des plugins IDE. Au lieu de coller des extraits de code dans une fenêtre de chat et d'appliquer manuellement les modifications, Claude Code opère directement dans votre terminal avec un accès complet à votre système de fichiers, aux commandes shell et aux outils de développement.

Cela signifie que Claude Code peut :

• Lire l'intégralité de la structure de votre projet et la comprendre avant toute modification
• Créer, modifier et supprimer des fichiers directement sur votre machine
• Lancer votre suite de tests, voir les échecs et les corriger automatiquement
• Exécuter des commandes git, des outils de build et toute commande shell
• Effectuer des modifications coordonnées sur des dizaines de fichiers en une seule session
• Créer des commits avec des messages explicites qui expliquent le raisonnement derrière les modifications

Pour les développeurs professionnels, cela transforme l'IA d'un assistant copier-coller en un véritable partenaire de développement autonome. Des fonctionnalités qui prenaient auparavant une après-midi peuvent être implémentées en 20 minutes lors de sessions agentiques Claude Code.

Prérequis

Avant d'installer Claude Code, assurez-vous de disposer des éléments suivants :

Si vous n'avez pas encore d'accès FreeClaude actif, visitez freeclaude.io et complétez votre premier parrainage pour débloquer les téléchargements. Le système de parrainage est le seul moyen d'accéder à Claude Code via FreeClaude.

Installation macOS

Étape 1 : Installer Node.js (si nécessaire)

Ouvrez Terminal (appuyez sur Cmd + Espace, tapez « Terminal », appuyez sur Entrée). Vérifiez si Node.js est déjà installé :

node --version

Si vous voyez un numéro de version inférieur à 18.x ou « command not found », installez Node.js en utilisant fnm (Fast Node Manager) — l'approche recommandée :

curl -fsSL https://fnm.vercel.app/install | bash

Fermez et rouvrez Terminal, puis exécutez :

fnm install --lts

Vérification : node --version doit maintenant afficher 20.x ou supérieur.

Étape 2 : Installer Claude Code

Avec Node.js prêt, installez Claude Code globalement via npm :

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

Alternativement, vous pouvez télécharger le binaire précompilé directement depuis l'onglet Téléchargements de votre tableau de bord FreeClaude. L'approche binaire ne nécessite pas Node.js mais offre moins de flexibilité pour les mises à jour.

Étape 3 : Authentification

Exécutez claude dans votre terminal. Au premier lancement, il vous demandera de vous authentifier avec vos identifiants FreeClaude. Suivez les instructions à l'écran — généralement une fenêtre de navigateur s'ouvre pour l'authentification OAuth, ou vous collez un token depuis votre tableau de bord.

Apple Silicon (M1/M2/M3/M4) vs Intel

La méthode d'installation via npm fonctionne de manière identique sur les deux architectures — npm détecte votre puce et installe automatiquement le bon binaire. L'approche par binaire précompilé fournit des téléchargements séparés pour Apple Silicon et Intel ; votre tableau de bord sert automatiquement la bonne version en fonction de la détection de votre appareil.

Installation Windows

Étape 1 : Installer Node.js

Ouvrez PowerShell en tant qu'Administrateur (clic droit sur le bouton Démarrer, sélectionnez « Windows PowerShell (Admin) »).

Vérifiez si Node.js est installé : node --version

S'il n'est pas installé, utilisez winget (intégré à Windows 10/11) :

winget install -e --id OpenJS.NodeJS.LTS --accept-source-agreements --accept-package-agreements

Fermez complètement PowerShell et rouvrez-le en tant qu'Administrateur. Vérification : node --version

Étape 2 : Installer Claude Code

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

Si vous rencontrez une erreur de politique d'exécution PowerShell, exécutez d'abord :

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Étape 3 : Recommandation Windows Terminal

Pour la meilleure expérience Claude Code sur Windows, utilisez Windows Terminal (disponible gratuitement sur le Microsoft Store) avec PowerShell 7. L'Invite de commandes classique fonctionne mais présente des limitations d'affichage pour le formatage de sortie riche de Claude Code.

WSL (Sous-système Windows pour Linux) fonctionne également bien si vous préférez un environnement de développement Linux sur Windows.

Installation Linux

L'installation Linux est généralement la plus simple, car la plupart des machines de développement ont déjà Node.js et un terminal capable.

Ubuntu/Debian

Vérifiez la version de Node.js : node --version

Si inférieure à 18 ou manquante, installez via NodeSource :

curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

Puis installez Claude Code : sudo npm install -g @anthropic-ai/claude-code

Fedora/RHEL/CentOS

curl -fsSL https://rpm.nodesource.com/setup_lts.x | sudo bash -
sudo dnf install -y nodejs
sudo npm install -g @anthropic-ai/claude-code

Arch Linux

sudo pacman -S nodejs npm
sudo npm install -g @anthropic-ai/claude-code

N'importe quel Linux (via fnm)

curl -fsSL https://fnm.vercel.app/install | bash
Redémarrez votre shell, puis :
fnm install --lts
npm install -g @anthropic-ai/claude-code

Configuration post-installation

Après l'installation, effectuez ces étapes avant votre première session de développement :

1. Ouvrez une nouvelle fenêtre de terminal — C'est important. Les nouvelles entrées PATH ajoutées par l'installation npm ne prennent effet que dans les nouvelles sessions de terminal.
2. Vérifiez l'installation — Tapez claude --version et confirmez qu'un numéro de version s'affiche.
3. Lancez l'authentification initiale — Tapez claude et suivez les invites d'authentification. Cela connecte Claude Code à votre compte FreeClaude.
4. Configurez git (si ce n'est pas déjà fait) — Claude Code crée des commits en votre nom. Assurez-vous que git connaît votre identité : git config --global user.name "Votre Nom" et git config --global user.email "vous@exemple.com"

Votre première session Claude Code

Naviguez vers un projet sur lequel vous travaillez et démarrez Claude Code :

cd ~/mon-projet
claude

Claude Code se lance et affiche les détails de votre compte et le statut d'accès. Pour votre première session, essayez ces prompts d'introduction :

• « Lis ce projet et donne-moi un résumé de l'architecture, des principaux composants et des problèmes immédiats que tu remarques »
• « Montre-moi la couverture de tests et identifie les zones sans tests »
• « Trouve les commentaires TODO ou les instructions console.log laissés dans le code »
• « Quelles dépendances sont obsolètes et quelles mises à jour seraient sûres à appliquer ? »

Ces prompts donnent à Claude Code l'occasion de se familiariser avec votre projet avant que vous ne lui demandiez de faire des modifications — ce qui produit généralement de meilleurs résultats que de passer directement aux modifications de code.

Référence des commandes essentielles

Configuration et personnalisation

Claude Code lit un fichier CLAUDE.md depuis la racine de votre projet s'il existe. Ce fichier agit comme un ensemble d'instructions persistantes que Claude Code charge au début de chaque session dans ce projet. Vous pouvez l'utiliser pour spécifier :

• Les conventions du projet, les patterns de nommage et les préférences de style de code
• Les exigences de tests et les attentes en matière de couverture
• Les procédures de déploiement et les notes d'infrastructure
• Le contexte spécifique à l'équipe que Claude doit toujours connaître
• Les chemins de fichiers ne devant pas être modifiés

Exécutez /init dans n'importe quel projet pour que Claude Code génère automatiquement un CLAUDE.md initial basé sur son analyse de votre base de code. Revoyez-le et affinez-le avant de le commiter.

Dépannage

« command not found: claude »

Fermez et rouvrez votre terminal. Si le problème persiste, vérifiez que le répertoire bin global npm est dans votre PATH :

npm config get prefix

Ajoutez le chemin de sortie avec /bin en annexe à votre profil shell (~/.zshrc, ~/.bashrc ou équivalent).

« Authentication failed » ou « Unauthorized »

Vérifiez votre tableau de bord FreeClaude pour confirmer que votre minuteur d'accès est actif. Si votre minuteur a expiré, invitez un autre ami pour le prolonger. Si le minuteur est actif mais que l'authentification échoue toujours, essayez d'exécuter claude logout suivi de claude login pour vous ré-authentifier.

Réponses lentes ou délais d'attente

Claude Code nécessite une connexion Internet stable pour communiquer avec les serveurs Anthropic. Vérifiez la qualité de votre connexion. En Wi-Fi, essayez une connexion filaire pour les sessions Claude Code prolongées afin d'éviter les connexions interrompues en cours d'opération.

Erreurs de permission lors de l'installation sur Mac/Linux

Évitez d'utiliser sudo npm install -g car cela peut causer des problèmes de permission. Configurez plutôt npm pour utiliser un répertoire accessible en écriture par l'utilisateur :

mkdir ~/.npm-global
npm config set prefix ~/.npm-global
Puis ajoutez export PATH=~/.npm-global/bin:$PATH à votre profil shell.

Claude Code effectue une modification que je ne souhaitais pas

Claude Code crée des commits git de manière incrémentale. Exécutez git log pour voir les commits récents et git revert HEAD pour annuler le dernier commit. Pour les sessions plus longues, Claude Code crée des commits à des points de contrôle logiques, facilitant le retour à n'importe quel état antérieur.

Questions fréquentes

Claude Code fonctionne-t-il hors ligne ?

Non. Claude Code envoie le contexte de votre code aux serveurs Anthropic pour le traitement IA. Une connexion Internet stable est requise pendant toutes les sessions.

Mon code est-il envoyé à Anthropic quand j'utilise Claude Code ?

Oui. Le contenu des fichiers que Claude Code lit est envoyé à l'API Anthropic pour traitement. La politique de confidentialité d'Anthropic s'applique. N'utilisez pas Claude Code sur des fichiers contenant des secrets, des identifiants ou des informations propriétaires hautement sensibles sans avoir examiné les politiques de gestion des données d'Anthropic pour votre cas d'usage.

Puis-je utiliser Claude Code dans un conteneur Docker ?

Oui, avec les images Docker Node.js standard. Installez claude-code via npm dans le conteneur et montez le répertoire de votre projet comme volume.

Quelle version de Node.js Claude Code nécessite-t-il ?

Node.js 18.0 ou supérieur est requis. Node.js 20 LTS ou Node.js 22 LTS sont recommandés pour la meilleure expérience.

Comment mettre à jour Claude Code ?

Exécutez npm update -g @anthropic-ai/claude-code pour mettre à jour vers la dernière version. Vous pouvez également exécuter npm install -g @anthropic-ai/claude-code@latest pour forcer l'installation d'une version spécifique.

Puis-je utiliser Claude Code dans des pipelines CI/CD ?

Claude Code est conçu pour une utilisation interactive par les développeurs. Pour les cas d'usage CI/CD automatisés, l'API Anthropic est plus appropriée. Cependant, certaines équipes scriptent des sessions Claude Code non interactives pour des tâches de revue spécifiques dans les pipelines CI.

Besoin d'aide ?

Si vous rencontrez des problèmes d'installation ou d'utilisation non couverts ici, contactez notre équipe de support via le bot Telegram FreeClaude. Vous pouvez également consulter notre comparaison des assistants IA pour le code pour comprendre pourquoi Claude Code est leader du domaine, ou notre guide de démarrage si vous avez besoin d'aide pour activer votre compte FreeClaude.

Configuration avancée pour les workflows professionnels

Une fois Claude Code installé et fonctionnel, ces options de configuration améliorent considérablement l'expérience pour les workflows de développement professionnel :

Créer un CLAUDE.md global

En plus des fichiers CLAUDE.md au niveau du projet, vous pouvez créer une configuration Claude Code globale dans ~/.claude/CLAUDE.md. Ce fichier est chargé pour chaque session Claude Code quel que soit le projet et est idéal pour les préférences personnelles qui s'appliquent universellement :

• Votre style préféré de commentaires de code
• Préférences par défaut de langage de programmation
• Conventions personnelles pour le format des messages de commit
• Rappel sur les outils que vous souhaitez toujours que Claude utilise (comme lancer les tests avant de commiter)
• Tout contexte personnel sur la configuration de votre environnement de développement

Configuration de la sélection du modèle

Claude Code peut être configuré pour utiliser par défaut un modèle spécifique avec le flag --model ou en le définissant dans la configuration :

• claude --model claude-opus-4-7 — Utiliser Opus pour la capacité maximale
• claude --model claude-sonnet-4-6 — Utiliser Sonnet pour des réponses plus rapides (recommandé pour la plupart des sessions)
• claude --model claude-haiku-4-5 — Utiliser Haiku pour les tâches légères et rapides

Vous pouvez également changer de modèle en cours de session avec la commande /model sans perdre le contexte de la conversation.

Alias shell pour un démarrage plus rapide

Ajoutez ces alias à votre profil shell (~/.zshrc ou ~/.bashrc) pour un lancement plus rapide de Claude Code :

• alias cc="claude" — Lancement rapide
• alias cc-fast="claude --model claude-sonnet-4-6" — Mode rapide avec Sonnet
• alias cc-deep="claude --model claude-opus-4-7" — Analyse approfondie avec Opus
• alias cc-review="claude --print /review" — Revue de code non interactive

Intégration au workflow Git

Claude Code s'intègre profondément aux workflows git. Voici les patterns sur lesquels s'appuient les utilisateurs expérimentés :

Workflow de branche de fonctionnalité

Commencez toujours une session Claude Code pour un travail significatif en créant une nouvelle branche :

1. Créer la branche : git checkout -b feature/ma-fonctionnalite
2. Démarrer Claude Code : claude
3. Décrire la fonctionnalité et laisser Claude Code l'implémenter
4. Examiner le diff : git diff main
5. Fusionner quand satisfait : git checkout main && git merge feature/ma-fonctionnalite

Ce workflow vous donne un contrôle total sur ce qui fusionne dans votre branche principale tout en permettant à Claude Code de travailler librement dans l'environnement de la branche de fonctionnalité.

Utiliser Claude Code pour la revue de code

Exécutez claude sur n'importe quelle branche et utilisez la commande /review pour obtenir une revue complète de toutes les modifications non commitées. C'est particulièrement précieux comme vérification pré-commit pour détecter les problèmes avant qu'ils ne soient poussés vers votre dépôt.

Assistance au rebase interactif

Demandez à Claude Code d'aider à nettoyer des historiques de commits confus : « J'ai 12 commits sur cette branche issus d'exploration et de faux départs. Veuillez les fusionner en 3 commits logiques avec des messages clairs décrivant ce que chaque groupe de modifications accomplit. » Claude Code analyse les commits et fournit les commandes git rebase nécessaires pour les restructurer proprement.

Utiliser Claude Code aux côtés de votre IDE

Claude Code et votre IDE ne sont pas mutuellement exclusifs — ce sont des outils complémentaires qui fonctionnent mieux en combinaison :

• IDE pour : Développement actif, coloration syntaxique, autocomplétion, débogage avec points d'arrêt, exploration visuelle des fichiers et opérations git basées sur l'interface
• Claude Code pour : Refactorisation multi-fichiers, implémentation de fonctionnalités à partir de descriptions en langage naturel, correction autonome de bugs, génération de tests, documentation et compréhension de parties inconnues de grandes bases de code

Un workflow courant : utilisez votre IDE pour le développement actif de fonctionnalités, passez à Claude Code quand vous rencontrez un problème complexe ou devez faire des modifications coordonnées sur plusieurs fichiers, puis revenez à votre IDE pour examiner et continuer à développer sur l'implémentation de Claude. Les deux outils n'entrent jamais en conflit car Claude Code opère sur votre système de fichiers réel — les modifications effectuées dans Claude Code apparaissent immédiatement dans votre éditeur IDE.

Configuration optimale de l'espace de travail pour les sessions Claude Code

Les développeurs professionnels qui utilisent Claude Code intensivement ont convergé vers des configurations d'espace de travail qui maximisent la productivité :

• Disposition de terminal en écran partagé — Exécutez Claude Code dans un volet de terminal, gardez un second volet pour lancer votre application, tests ou surveiller les logs. Regardez les résultats de tests apparaître en temps réel pendant que Claude Code corrige des bugs.
• Git diff dans l'IDE à côté du terminal — Gardez votre IDE ouvert sur la vue du diff de contrôle de source. Pendant que Claude Code modifie des fichiers, vous voyez les modifications surlignées en temps réel dans votre IDE sans interrompre la session Claude Code.
• Persistance de session Tmux ou iTerm2 — Utilisez un multiplexeur de terminal pour maintenir les sessions Claude Code actives pendant les interruptions de réseau et la fermeture du couvercle de l'ordinateur portable. C'est particulièrement important pour les longues sessions autonomes (30+ minutes) où les coupures de connexion feraient sinon perdre la progression.
• Répertoires de projet bien organisés — Gardez vos projets bien organisés avec des noms de répertoires clairs. Claude Code lit votre structure de répertoires dans le cadre de sa compréhension du projet, et une organisation propre l'aide à comprendre immédiatement les limites du projet.