Comment installer Claude Code en 2026 : le guide complet qui fonctionne vraiment (testé sur Mac, Windows et Linux).
Vous voulez installer Claude Code mais vous avez peur de galérer pendant 3 heures avec des erreurs cryptiques dans le terminal ? Je vous comprends. J’ai installé Claude Code sur 4 machines différentes (Mac, Windows, Ubuntu, WSL), j’ai rencontré toutes les erreurs possibles, et je vais vous éviter tous ces pièges.
Lucas Fonseque, consultant digital depuis 2017. J’utilise Claude Code quotidiennement pour automatiser mes tâches SEO répétitives. Installation testée et validée sur : MacBook Pro M2 (macOS Sonoma), PC Windows 11 (PowerShell natif), PC Windows 11 (WSL2 Ubuntu), serveur Ubuntu 22.04. Ce guide fonctionne en 2026, promis.
Dans cet article, vous allez installer Claude Code de A à Z en moins de 15 minutes, même si vous n’avez jamais touché un terminal de votre vie. Étapes ultra-détaillées avec captures d’écran, solutions aux erreurs courantes, et 5 exemples concrets que vous pourrez tester immédiatement après installation pour vérifier que tout fonctionne. Fini les tutos incomplets qui vous abandonnent à la première erreur.
Prérequis : ce dont vous avez besoin AVANT d’installer
Avant de foncer tête baissée, vérifions que vous avez les bons prérequis. Ça vous évitera 90% des erreurs d’installation.
Prérequis 1 : Un abonnement Claude payant (obligatoire)
Claude Code ne fonctionne PAS avec le plan gratuit Claude.ai. Vous devez avoir l’un de ces abonnements : Claude Pro (20€/mois, suffisant pour 95% des utilisateurs), Claude Max (90€/mois, limites 5x supérieures si vous explosez les quotas Pro), Claude Team ou Enterprise (pour les équipes).
Si vous n’avez pas encore d’abonnement, allez sur claude.ai, cliquez « Upgrade to Pro » en haut à droite, payez 20€. Attendez 2-3 minutes que l’abonnement soit activé. Vous pouvez vérifier en ouvrant claude.ai : si vous voyez « Claude Pro » en haut, c’est bon.
Prérequis 2 : Choisir votre méthode d’installation (3 options)
Il existe 3 façons d’installer Claude Code en 2026. Choisissez celle qui correspond à votre situation :
Option A : Installation native (RECOMMANDÉ) — La plus simple et la plus stable. Un seul script à lancer, tout s’installe automatiquement. Fonctionne sur Mac, Windows (PowerShell), Linux. Aucune dépendance Node.js nécessaire. C’est cette méthode que je vais détailler ci-dessous.
Option B : Installation via npm — L’ancienne méthode (legacy). Nécessite Node.js 18+ déjà installé. Plus complexe, plus de risques d’erreurs. Je ne la recommande plus en 2026 sauf si vous avez une raison spécifique (équipe qui utilise déjà npm pour tout).
Option C : Application Desktop — Interface graphique sans terminal. Parfait si vous avez peur du terminal. Mais moins puissant que la version CLI. Disponible sur code.claude.com pour Mac et Windows.
Dans ce guide, je vais vous montrer l’Option A (native) car c’est la plus simple et la plus fiable. Si vous voulez vraiment l’Option B (npm), allez sur la doc officielle code.claude.com/docs/en/setup.
Installation sur Mac (macOS) — Méthode native
Si vous êtes sur Mac, voici la méthode la plus rapide. Testée sur macOS Monterey, Ventura, Sonoma, Sequoia.
Étape 1 : Ouvrir le Terminal
Appuyez sur Cmd + Espace pour ouvrir Spotlight. Tapez « Terminal ». Appuyez sur Entrée. Une fenêtre noire (ou blanche selon votre thème) s’ouvre avec un curseur qui clignote. C’est votre terminal.
Étape 2 : Lancer le script d’installation
Copiez-collez cette commande dans le terminal (Cmd+C pour copier, Cmd+V pour coller dans le terminal) :
curl -fsSL https://claude.ai/install.sh | bash
Appuyez sur Entrée. Le script télécharge et installe Claude Code automatiquement. Vous verrez défiler des lignes dans le terminal. Ça prend 30 secondes à 2 minutes selon votre connexion Internet.
Étape 3 : Vérifier l’installation
Une fois le script terminé (vous revoyez le curseur qui clignote), tapez :
claude --version
Si vous voyez un numéro de version (genre « Claude Code v2.1.0 »), félicitations — c’est installé ! Si vous voyez « command not found », fermez complètement votre terminal (Cmd+Q), rouvrez-le, et retapez la commande. Ça devrait marcher.
Étape 4 : Se connecter à votre compte Claude
Tapez simplement :
claude
Claude Code va s’ouvrir pour la première fois. Il va vous demander de vous authentifier. Votre navigateur va s’ouvrir automatiquement sur une page de connexion Claude. Connectez-vous avec votre compte Claude Pro. Autorisez Claude Code à accéder à votre compte. Retournez dans le terminal — vous devriez voir « Authentication successful ».
C’est tout. Claude Code est installé et prêt sur Mac. Passez directement à la section « Vos 5 premières commandes » plus bas.
Installation sur Windows — Méthode native (PowerShell)
Si vous êtes sur Windows, deux options : PowerShell natif (plus simple) ou WSL (plus puissant). Je vais montrer PowerShell d’abord.
Prérequis Windows : Installer Git for Windows
Claude Code sur Windows nécessite Git Bash. Vérifiez d’abord si vous l’avez déjà. Ouvrez PowerShell (Windows key + tapez « PowerShell » + Entrée). Tapez :
git --version
Si vous voyez une version (genre « git version 2.43.0 »), vous avez déjà Git. Passez à l’étape suivante. Si vous voyez « git : Le terme ‘git’ n’est pas reconnu… », vous devez installer Git for Windows :
1. Allez sur git-scm.com/download/win
2. Téléchargez l’installateur (64-bit ou 32-bit selon votre Windows)
3. Lancez l’installateur
4. Cliquez « Next » sur tous les écrans (gardez les options par défaut)
5. Attendez que l’installation termine
6. Fermez complètement PowerShell et rouvrez-le
Étape 1 : Ouvrir PowerShell en tant qu’administrateur
Appuyez sur la touche Windows. Tapez « PowerShell ». Faites un clic droit sur « Windows PowerShell ». Cliquez « Exécuter en tant qu’administrateur ». Cliquez « Oui » sur la fenêtre de confirmation. PowerShell s’ouvre avec « Administrator » dans le titre.
Étape 2 : Lancer le script d’installation
Copiez-collez cette commande dans PowerShell (Ctrl+C pour copier, clic droit dans PowerShell pour coller) :
irm https://claude.ai/install.ps1 | iex
Appuyez sur Entrée. Le script télécharge et installe Claude Code. Ça prend 1-3 minutes. Vous verrez des barres de progression.
Étape 3 : Vérifier l’installation
Une fois terminé, tapez :
claude --version
Si vous voyez un numéro de version, c’est installé. Si « claude » n’est pas reconnu, fermez PowerShell complètement, rouvrez-le (pas besoin d’admin cette fois), et retapez la commande.
Étape 4 : Se connecter à votre compte
Tapez :
claude
Votre navigateur s’ouvre pour l’authentification. Connectez-vous avec votre compte Claude Pro. Retournez dans PowerShell — vous devriez voir « Authentication successful ». C’est fait.
Installation sur Linux (Ubuntu/Debian) — Méthode native
Si vous êtes sur Linux (ou WSL2 sur Windows), voici la procédure. Testée sur Ubuntu 22.04 et 24.04.
Étape 1 : Ouvrir le terminal
Ctrl+Alt+T ouvre le terminal sur la plupart des distributions Linux. Ou cherchez « Terminal » dans vos applications.
Étape 2 : Lancer le script d’installation
Copiez-collez cette commande :
curl -fsSL https://claude.ai/install.sh | bash
Appuyez sur Entrée. Installation automatique en 1-2 minutes.
Étape 3 : Recharger votre shell
Sur Linux, après installation, vous devez recharger votre configuration shell :
source ~/.bashrc
Ou si vous utilisez Zsh :
source ~/.zshrc
Étape 4 : Vérifier et se connecter
Tapez claude --version pour vérifier. Tapez claude pour lancer et vous authentifier via le navigateur. Même processus que sur Mac/Windows.
Récapitulatif : Installation réussie si…
✅ La commande claude --version affiche un numéro de version
✅ La commande claude ouvre l’interface Claude Code dans le terminal
✅ Vous voyez « Welcome to Claude Code » avec votre nom de compte en haut
✅ Vous pouvez taper des commandes et Claude répond
Si un de ces points ne fonctionne pas, consultez la section « Résoudre les erreurs courantes » ci-dessous.
Vos 5 premières commandes pour tester Claude Code
Claude Code est installé. Maintenant, testons-le avec 5 exemples concrets que vous pouvez lancer immédiatement.
Test 1 : Créer un fichier Python simple
Dans Claude Code (après avoir tapé claude pour le lancer), tapez :
Crée un fichier hello.py qui affiche "Bonjour depuis Claude Code" quand on l'exécute
Claude Code va écrire le code Python, créer le fichier hello.py dans votre dossier actuel, et vous montrer ce qu’il a fait. Pour vérifier, tapez dans le terminal (pas dans Claude Code, appuyez sur Ctrl+C pour quitter Claude Code) :
python3 hello.py
Vous devriez voir « Bonjour depuis Claude Code » s’afficher. Ça marche. Claude Code vient de créer un fichier fonctionnel en 5 secondes.
Test 2 : Analyser un fichier CSV
Créez d’abord un fichier CSV de test. Relancez Claude Code (claude), tapez :
Crée un fichier data.csv avec 3 colonnes (nom, age, ville) et 5 lignes de données fictives
Claude crée le fichier. Maintenant, demandez-lui d’analyser :
Analyse data.csv et dis-moi la moyenne d'âge
Claude lit le CSV, calcule la moyenne, vous donne le résultat. Pas de code à écrire, pas de pandas à installer. Il gère tout.
Test 3 : Générer un rapport HTML
Crée un fichier rapport.html avec un tableau affichant les données de data.csv, titre "Mon Rapport", style CSS minimaliste moderne
Claude génère un fichier HTML complet avec CSS intégré. Ouvrez rapport.html dans votre navigateur pour voir le résultat. Vous venez de générer un rapport visuel en 10 secondes.
Test 4 : Nettoyer un dossier (exemple SEO réel)
Créez quelques fichiers test d’abord :
Crée 10 fichiers vides : test1.txt, test2.txt... test10.txt
Maintenant, demandez à Claude de les trier :
Liste tous les fichiers .txt du dossier actuel et dis-moi combien il y en a
Claude scanne le dossier et vous donne le compte. Utile pour des vrais cas SEO (compter combien d’URLs dans un export, combien de fichiers logs, etc.).
Test 5 : Demander de l’aide sur une commande
/help
Claude vous montre toutes les commandes disponibles (les slash commands comme /help, /clear, /config, etc.). Explorez cette liste pour découvrir ce que Claude Code peut faire.
Exemples concrets pour le SEO (ce que je fais vraiment avec)
Au-delà des tests basiques, voici des exemples réels que j’utilise dans mes missions SEO quotidiennes.
Exemple SEO 1 : Nettoyer un export Screaming Frog
Situation : vous crawlez un site avec Screaming Frog, export CSV de 50 000 lignes. Vous voulez juste les URLs avec Title dupliqués. Dans Claude Code :
Analyse le fichier screaming-frog-export.csv, garde uniquement les lignes où la colonne "Title 1 Duplicate" = "TRUE", extrais les colonnes Address et Title 1, sauvegarde dans titles-duplicates.csv
Claude traite le fichier (même 50 000 lignes), vous sort le CSV propre. Temps : 30 secondes vs 45 minutes manuellement dans Excel.
Exemple SEO 2 : Croiser Search Console et SEMrush
J'ai deux fichiers CSV : search-console.csv (colonnes Query, Position, Clicks) et semrush-keywords.csv (colonnes Keyword, Volume, Difficulty). Croise-les sur Query/Keyword, garde uniquement les lignes où Position entre 11 et 20 ET Difficulty < 30. Sauvegarde dans quick-wins.csv
Claude fait tout le croisement, filtrage, vous livre les quick wins actionnables. Je fais ça 3-4 fois par semaine, économie : 1h30 à chaque fois.
Exemple SEO 3 : Générer un rapport client automatisé
Prends positions-mois-actuel.csv et positions-mois-precedent.csv. Compare les positions pour chaque mot-clé. Génère un fichier HTML "rapport-client.html" avec un tableau montrant : mot-clé, ancienne position, nouvelle position, évolution (flèche verte si amélioration, rouge si baisse). Style moderne avec CSS.
Claude crée un rapport HTML que vous pouvez envoyer directement au client. Plus besoin de copier-coller dans Google Docs pendant 2h.
Résoudre les erreurs courantes (si ça ne marche pas)
Voici les 5 erreurs les plus fréquentes et leurs solutions testées.
Erreur 1 : "command not found: claude"
Cause : Votre shell n'a pas rechargé le PATH après installation.
Solution Mac/Linux : Fermez complètement le terminal (Cmd+Q sur Mac, pas juste la fenêtre). Rouvrez-le. Tapez claude --version. Ça devrait marcher.
Solution Windows : Fermez PowerShell complètement. Rouvrez-le (pas besoin d'admin). Retapez claude --version.
Si ça ne marche toujours pas : L'installation n'a peut-être pas ajouté Claude au PATH. Sur Mac/Linux, tapez :
echo 'export PATH="$HOME/.claude/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
Sur Windows, cherchez "Variables d'environnement" dans le menu Démarrer, ajoutez manuellement le chemin d'installation de Claude au PATH système.
Erreur 2 : "Git Bash not found" (Windows uniquement)
Cause : Git for Windows n'est pas installé ou Claude ne le trouve pas.
Solution : Installez Git for Windows (voir section Windows ci-dessus). Si déjà installé, vérifiez l'emplacement. Ouvrez PowerShell, tapez :
where.exe git
Notez le chemin (genre "C:\Program Files\Git\bin\git.exe"). Si Claude ne le trouve toujours pas, configurez manuellement le chemin dans les settings Claude Code.
Erreur 3 : "Authentication failed"
Cause : Vous n'avez pas d'abonnement Claude Pro actif, ou votre session a expiré.
Solution : Vérifiez sur claude.ai que vous voyez "Claude Pro" en haut. Si non, souscrivez à Pro (20€/mois). Si oui, déconnectez-vous et reconnectez-vous. Dans Claude Code, tapez /logout, puis relancez claude pour vous reconnecter.
Erreur 4 : "Permission denied" (Mac/Linux)
Cause : Le script d'installation n'a pas les permissions nécessaires pour écrire dans certains dossiers.
Solution : Relancez le script avec sudo :
curl -fsSL https://claude.ai/install.sh | sudo bash
Entrez votre mot de passe Mac/Linux quand demandé. L'installation se fera avec les permissions admin.
Erreur 5 : Claude Code démarre mais plante immédiatement
Cause : Corruption de fichiers de config ou installation mixte (ancienne version npm + nouvelle version native).
Solution : Nettoyez tout et réinstallez. Sur Mac/Linux :
rm -rf ~/.claude
curl -fsSL https://claude.ai/install.sh | bash
Sur Windows PowerShell (admin) :
Remove-Item -Recurse -Force $env:USERPROFILE\.claude
irm https://claude.ai/install.ps1 | iex
Cela supprime toute config existante et réinstalle proprement.
Commande de diagnostic ultime : Si vous avez des problèmes persistants, Claude Code a une commande de diagnostic intégrée. Tapez dans votre terminal (pas dans Claude Code, juste le terminal normal) : claude doctor. Cette commande vérifie votre installation, détecte les problèmes courants (PATH, permissions, dépendances manquantes), et vous suggère des corrections. 90% des problèmes sont résolus par cette commande.
Prochaines étapes après installation
Claude Code est installé et fonctionne. Voici comment progresser rapidement.
Apprenez les slash commands essentielles
Dans Claude Code, tapez /help pour voir toutes les commandes. Les plus utiles : /clear (efface la conversation, libère des tokens), /config (configure Claude Code), /model (change le modèle IA utilisé), /files (liste les fichiers du dossier actuel).
Créez un dossier dédié pour vos projets Claude Code
Organisez-vous. Créez un dossier "claude-projects" dans Documents. Dedans, créez des sous-dossiers par projet (seo-client1, seo-client2, automatisations-perso). Naviguez dans le bon dossier AVANT de lancer Claude Code :
cd ~/Documents/claude-projects/seo-client1
claude
Comme ça, Claude travaille directement dans le bon contexte et ne mélange pas les fichiers de différents projets.
Sauvegardez vos scripts réutilisables
Quand Claude Code fait quelque chose d'utile (genre nettoyer un CSV d'une certaine façon), demandez-lui de sauvegarder le script Python qu'il a utilisé. Exemple :
Sauvegarde le script que tu viens d'utiliser dans clean-screaming-frog.py avec des commentaires expliquant chaque étape
Vous construisez ainsi une bibliothèque de scripts réutilisables. La prochaine fois, au lieu de réexpliquer à Claude, vous lancez juste python3 clean-screaming-frog.py sur vos nouveaux fichiers.
Besoin d'aide pour automatiser vos tâches SEO avec Claude Code ?
Vous avez installé Claude Code mais vous ne savez pas par où commencer pour automatiser vos tâches SEO répétitives ? Je vous propose un échange de 30 minutes pour identifier vos tâches chronophages et vous montrer exactement comment les automatiser avec Claude Code. Vous repartirez avec 3-5 scripts prêts à l'emploi pour votre activité.
Planifier un échange











