Comment installer Claude Code en 2026 : guide complet Mac/Windows/Linux

par | 9 Mar 2026 | Claude, Intelligence Artificielle

Installation Claude Code 2026 : guide complet testé sur Mac (curl script), Windows (PowerShell + Git Bash), Linux/WSL (bash). Prérequis : abonnement Claude Pro 20€/mois. Vérification : claude --version. 5 tests post-installation (Python, CSV, HTML, nettoyage fichiers). Résolution 5 erreurs courantes (command not found, Git Bash, authentication, permissions). Exemples SEO : nettoyer Screaming Frog, croiser Search Console × SEMrush, rapports automatisés.

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

+50 clients accompagnés

Prêt à structurer votre projet digital ?

Je vous propose un échange stratégique gratuit de 30 minutes pour faire le point sur votre projet : vision, objectifs, contraintes techniques, budget disponible.

Vous repartirez avec une vision claire de ce qu’il faut faire en priorité — que vous travailliez avec moi ou non.

Allez, on se retrouve de l’autre côté pour un Café Visio  ☕️

Envie de lire d’autres articles ?

Je vous partage sur mon blog mes tests, leçons et apprentissages, ainsi que des conseils pertinents pour votre activité.