Comment installer Claude Code sans se tromper ?

J’installe Claude Code avec une commande, puis je valide l’accès dans le navigateur et je lance l’outil dans le bon dossier projet. Le vrai sujet, ce n’est pas l’installation. C’est d’éviter les petits pièges de PATH, de compte, de quota et de dossier approuvé.

Quelle commande faut-il lancer ?

La commande dépend juste du terminal que vous utilisez. Je le fais sans sudo, sans terminal lancé en administrateur, et sans bricoler les droits système. Claude Code s’installe avec l’installateur natif prévu pour votre environnement.

Sur macOS, Linux ou WSL, je lance cette commande dans un terminal classique :

curl https://claude.ai/install.sh | bash

Sur Windows avec PowerShell, j’utilise plutôt celle-ci :

irm https://claude.ai/install.ps1 | iex

Sur Windows avec CMD, donc l’invite de commandes historique, la commande officielle est celle-là :

curl https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Le point important, c’est que cet installateur embarque son propre runtime. En clair, il apporte ce dont Claude Code a besoin pour tourner. Vous n’avez pas besoin d’installer Node.js avant, et vous n’avez pas besoin de vérifier votre version de npm.

La mention Node.js 22 ou plus concerne l’ancien paquet npm. Si vous suivez l’installation native actuelle, vous pouvez l’oublier. J’ai vu des gens perdre vingt minutes là-dessus, à mettre à jour Node, casser leur environnement front, puis revenir au point de départ. Ici, ce n’est pas nécessaire.

Pour le terminal, je reste simple. Je prends le terminal naturel de la machine, pas un mélange bizarre entre Windows, Git Bash, WSL et PowerShell dans la même session. C’est souvent là que les chemins se croisent mal.

Sur macOS : J’utilise Terminal ou iTerm2, puis la commande curl | bash.
Sur Linux : J’utilise le terminal de la distribution, puis la commande curl | bash.
Sur WSL : J’utilise le terminal Ubuntu ou Debian dans WSL, pas PowerShell, puis la commande curl | bash.
Sur Windows natif : J’utilise PowerShell avec irm | iex, ou CMD avec la commande dédiée si je préfère rester dans CMD.

Si l’installation échoue, je vérifie d’abord que je suis dans le bon terminal. Dans la majorité des cas, le problème vient de là, pas de Claude Code.

Comment corriger le PATH ?

Le PATH, c’est juste la liste des dossiers où votre terminal cherche les commandes. Donc si Claude Code est bien installé, mais que la commande claude n’est pas reconnue, le souci vient souvent de là. Cette étape est optionnelle, mais franchement utile quand l’installation s’est bien passée et que le terminal fait comme si rien n’existait.

Si vous utilisez Zsh, ce qui est le cas par défaut sur beaucoup de Mac récents, vous pouvez ajouter le dossier local au PATH avec cette commande :

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc

Si vous êtes sous Bash, remplacez simplement ~/.zshrc par ~/.bashrc. Bash et Zsh sont des shells, c’est-à-dire les programmes qui interprètent vos commandes dans le terminal. Le fichier .zshrc ou .bashrc sert à charger votre configuration à chaque ouverture du terminal.

Une fois que c’est fait, je vérifie toujours avec ces deux commandes :

claude --version
claude doctor

claude –version confirme que la commande est bien accessible et que Claude Code répond correctement. claude doctor lance un diagnostic plus complet. Il vérifie votre environnement, les dépendances et les points qui peuvent bloquer. C’est souvent la commande la plus utile quand quelque chose cloche sans message clair.

Les erreurs que je vois le plus souvent chez les clients sont assez simples. Le terminal n’a pas été relancé. Le mauvais shell est utilisé. Ou alors Claude a été installé dans WSL, mais testé dans le terminal Windows classique. Et parfois c’est l’inverse. Dans ce cas, tout peut être parfaitement installé, juste pas au même endroit que là où vous testez.

Problème	Cause probable	Action à faire
Commande claude introuvable	Le dossier ~/.local/bin n’est pas dans le PATH	Ajouter la commande PATH dans ~/.zshrc ou ~/.bashrc
La commande marche après source, puis disparaît	Le fichier de configuration du mauvais shell a été modifié	Vérifier le shell avec echo $SHELL puis modifier le bon fichier
Claude marche dans WSL mais pas dans Windows	L’installation a été faite côté Linux uniquement	Tester dans WSL ou installer Claude Code côté Windows
Claude marche dans Windows mais pas dans WSL	Les environnements Windows et WSL sont séparés	Installer Claude Code aussi dans WSL si vous travaillez depuis WSL
claude doctor signale encore une erreur	Une dépendance ou une configuration manque	Lire le message exact et corriger le point indiqué

Comment se connecter la première fois ?

La première fois que je lance Claude Code, je ne cherche pas à aller trop vite. Cette étape sert surtout à régler l’affichage, connecter le bon compte, puis autoriser l’outil à accéder à Claude depuis le terminal.

D’abord, Claude Code me demande de choisir un thème. Je navigue avec les flèches du clavier, puis je valide avec Entrée. Rien de compliqué, mais ça vaut le coup de prendre 10 secondes pour choisir un affichage lisible, surtout si vous passez vos journées dans le terminal.

Vous pouvez choisir un thème clair, sombre, ou plus contrasté.
Vous pouvez aussi prendre un thème adapté aux daltoniens si certaines couleurs sont difficiles à distinguer.
Vous pouvez choisir un mode ANSI-only, utile quand votre terminal affiche mal les couleurs modernes. ANSI, ici, veut juste dire un affichage basé sur des codes couleur très standards.

Si vous vous trompez, ce n’est pas grave. Vous pourrez changer le thème plus tard directement dans Claude Code avec cette commande.

/theme

Ensuite, Claude Code me demande comment je veux me connecter. Là, le bon choix dépend de ce que vous avez déjà.

Si vous avez un abonnement Claude Pro, Max, Team ou Enterprise, vous pouvez vous connecter avec votre compte Claude.
Si vous utilisez l’API Anthropic, il faut une facturation active côté Console.
Si votre entreprise passe par une plateforme cloud tierce, le choix peut dépendre de la configuration prévue par votre équipe technique.

Point important, et je le vois souvent chez des clients qui testent trop vite. Claude Code ne fonctionne pas avec un plan gratuit. Il faut un plan Pro, Max, Team, Enterprise, ou une facturation API active dans la Console Anthropic. Sinon, l’installation peut être correcte, mais l’usage sera bloqué.

Après le choix de connexion, Claude Code ouvre normalement un navigateur. Vous arrivez sur un écran de consentement. Vous vérifiez le compte utilisé, puis vous cliquez sur Authorize. Cette autorisation n’est pas juste décorative. Elle peut impacter l’usage, les limites, le quota et parfois la facturation associée au compte choisi.

Si vous êtes sur un serveur, une VM ou un environnement sans navigateur interactif, Claude Code affiche une URL ou un code dans le terminal. Je copie l’URL, je l’ouvre sur une autre machine, j’approuve l’accès, puis je récupère le code donné. Ensuite, je le colle dans le terminal. Même si rien ne s’affiche pendant la saisie, c’est normal. Le terminal masque parfois l’entrée pour éviter d’exposer un code sensible.

Pourquoi valider le bon dossier ?

Le dossier que vous validez, c’est la frontière de travail de Claude Code. Ce n’est pas juste une formalité à cliquer vite fait. C’est ce qui définit ce que l’outil peut lire, analyser et utiliser comme contexte pour vous aider.

Au premier lancement, Claude Code peut vous demander de confirmer votre adresse e-mail. Je prends le temps de le faire proprement, parce que ça rattache la session au bon compte, surtout si vous avez plusieurs accès, un perso et un pro par exemple. Ça évite les surprises bêtes du style “Pourquoi je suis limité ?” ou “Pourquoi ce n’est pas le bon abonnement ?”.

Ensuite, j’accepte généralement les paramètres recommandés du terminal. Leur intérêt est simple : éviter d’envoyer par erreur un prompt multilignes avant de l’avoir terminé. Sur macOS, par exemple, Option+Enter permet de créer une nouvelle ligne sans envoyer le message. C’est très pratique quand vous écrivez une demande un peu longue, avec du contexte, des contraintes, ou un bout de code.

Le moment important arrive avec Trust the folder. Là, je lis vraiment le chemin affiché. Je vérifie que je suis bien dans le dossier du projet, pas dans mon dossier utilisateur, pas dans Documents, pas dans un répertoire parent qui contient dix clients différents. Si le chemin est bon, j’accepte. Si j’ai le moindre doute, je refuse et je relance Claude Code au bon endroit.

Ma règle est simple : je lance toujours Claude Code directement depuis le dossier du projet.

cd ~/projets/mon-projet
claude

Je n’aime pas le lancer depuis un dossier trop large. J’ai déjà vu chez un client un assistant récupérer du contexte inutile juste parce qu’il était lancé trop haut dans l’arborescence. Ce n’est pas dramatique à chaque fois, mais c’est sale, lent, et ça augmente le risque de mélanger des infos qui n’ont rien à faire ensemble.

Une fois dans l’interface, je fais quelques vérifications rapides.

J’accepte le renderer fullscreen si Claude Code me le propose, parce que l’affichage est souvent plus confortable.
Je regarde le modèle utilisé, le compte connecté, le répertoire courant et les changements récents détectés.
Je tape ? pour afficher les raccourcis disponibles et éviter de chercher au hasard.
Je lance /init au début d’un projet pour créer le contexte initial de travail.
Je vérifie /usage rapidement pour garder un œil sur la consommation et les limites.

Ce petit contrôle prend moins d’une minute. Franchement, il évite beaucoup d’erreurs pénibles après.

Que vérifier après l’installation ?

Après l’installation, je ne pars jamais du principe que tout est bon. Je fais quelques vérifications simples, surtout pour éviter les bugs bêtes liés à une mauvaise version, un terminal mal configuré, ou un projet pas encore initialisé.

La première chose que je regarde, c’est la version installée. C’est basique, mais ça permet déjà de savoir si Claude Code répond bien dans le terminal.

claude --version

Ensuite, je lance le diagnostic. La commande doctor vérifie l’état de santé de l’installation : accès, configuration, dépendances, environnement terminal. C’est souvent là qu’on repère une install bancale.

claude doctor

Je vérifie aussi l’usage, surtout si le compte est nouveau ou si vous êtes sur une formule avec des limites. La commande se lance depuis Claude Code avec un slash, une fois dans l’interface interactive.

/usage

Dans un dossier projet, je lance souvent /init. Ça aide Claude Code à comprendre le contexte du projet, les fichiers importants, les conventions, parfois les scripts utiles. C’est là que l’outil commence vraiment à devenir intéressant, parce qu’il ne répond plus juste “dans le vide”, il travaille avec votre code.

/init

Côté mise à jour, les installations natives se mettent normalement à jour automatiquement. Si vous voulez forcer la mise à jour, vous pouvez utiliser :

claude update

Selon votre mode d’installation, vous pouvez aussi passer par un gestionnaire de paquets. Par exemple Homebrew sur macOS, WinGet sur Windows, ou apt, dnf, apk côté Linux. Je conseille juste de rester cohérent : si vous avez installé avec un gestionnaire de paquets, mettez à jour avec le même outil.

Petite parenthèse honnête : si vous ne voulez pas travailler en ligne de commande, Claude Desktop ou une autre interface peut très bien convenir. Mais Claude Code prend vraiment son sens dans le terminal, dans le dossier du projet, avec accès direct aux fichiers et aux commandes.

Vérification	Commande	Moment utile
Version installée	`claude --version`	Juste après l’installation
État de santé	`claude doctor`	Si quelque chose semble mal configuré
Usage et limites	`/usage`	Quand Claude Code est ouvert
Initialisation du projet	`/init`	Dans le dossier du projet
Mise à jour forcée	`claude update`	Si vous voulez récupérer la dernière version

On l’installe maintenant ?

Installer Claude Code, ce n’est pas compliqué. Une commande adaptée à votre système, un PATH à corriger si besoin, une vérification avec claude –version et claude doctor, puis le premier lancement. Là où je fais attention, c’est sur le compte utilisé, le consentement navigateur, les quotas, les réglages du terminal et surtout le dossier approuvé. Je lance toujours l’outil dans le dossier projet, puis je fais /init et /usage assez tôt. Vous gagnez du temps, vous évitez les erreurs bêtes, et vous démarrez avec un environnement propre pour coder avec Claude Code.

FAQ

Claude Code fonctionne-t-il avec un compte gratuit ?
Non. Il faut un plan Pro, Max, Team, Enterprise, ou une facturation API active via la Console Anthropic. C’est un point à vérifier avant de perdre du temps sur l’installation.
Faut-il installer Node.js pour utiliser Claude Code ?
Pas avec l’installation native. L’installateur inclut son runtime. Node.js version 22 ou plus concerne seulement l’ancien paquet npm, si vous passez par cette méthode legacy.
Que faire si la commande claude n’est pas reconnue ?
Je vérifie d’abord le PATH. Sur Zsh, il faut ajouter ~/.local/bin avec la commande prévue, puis relancer ou sourcer le terminal. Je vérifie aussi que je teste bien dans le même environnement que celui où j’ai installé Claude Code.
Pourquoi Claude Code demande de faire confiance au dossier ?
Parce que ce dossier devient le contexte de travail accessible par l’outil. Je recommande de lancer Claude Code directement dans le dossier du projet, pas dans un répertoire trop large, pour garder le contrôle.
Comment mettre Claude Code à jour ?
Les installations natives se mettent à jour automatiquement. Si besoin, claude update permet de forcer la mise à jour. Selon votre installation, vous pouvez aussi passer par votre gestionnaire de paquets comme Homebrew, WinGet, apt, dnf ou apk.

A propos de l’auteur

Je suis Franck Scandolera, expert et formateur en Tracking avancé server-side, Analytics Engineering, automatisation No/Low Code avec n8n, intégration de l’IA en entreprise et SEO/GEO. J’accompagne des équipes qui veulent utiliser l’IA proprement dans leurs vrais workflows, pas juste tester des outils dans un coin. J’ai travaillé avec des clients comme Logis Hôtel, Yelloh Village, BazarChic, la Fédération Française de Football ou Texdecor. Je dirige l’agence webAnalyste et l’organisme Formations Analytics. Si vous voulez cadrer Claude Code, l’IA ou l’automatisation dans votre business, contactez-moi.

Franck Scandolera

⭐ Analytics engineer, Data Analyst et Automatisation IA indépendant ⭐

Ref clients : Logis Hôtel, Yelloh Village, BazarChic, Fédération Football Français, Texdecor…

Mon terrain de jeu :

Data Analyst & Analytics engineering : tracking avancé (GTM server, e-commerce, CAPI, RGPD), entrepôt de données (BigQuery, Snowflake, PostgreSQL, ClickHouse), modèles (Airflow, dbt, Dataform), dashboards décisionnels (Looker, Power BI, Metabase, SQL, Python).
Automatisation IA des taches Data, Marketing, RH, compta etc : conception de workflows intelligents robustes (n8n, App Script, scraping) connectés aux API de vos outils et LLM (OpenAI, Mistral, Claude…).
Engineering IA pour créer des applications et agent IA sur mesure : intégration de LLM (OpenAI, Mistral…), RAG, assistants métier, génération de documents complexes, APIs, backends Node.js/Python.