Comment installer Claude Code depuis le site officiel

Qu’est-ce que Claude Code, et pourquoi fonctionne-t-il dans le terminal ?#

Le terminal fait peur à presque toutes les personnes qui se lancent dans le vibe coding sans formation en développement logiciel. Il ressemble à une fenêtre noire de film de hackers, mais en réalité, ce n’est qu’une ligne dans laquelle on saisit des commandes. Claude Code en a précisément besoin pour ouvrir vos fichiers, les modifier et effectuer des vérifications tout seul pendant que vous lui décrivez la tâche avec des mots.

Anthropic décrit le produit ainsi.

La différence avec un chat classique est simple. Dans un navigateur, vous copiez le code à la main, dans les deux sens entre la fenêtre et votre éditeur. Claude Code accède directement au dossier du projet, lit les fichiers dont il a besoin, effectue la modification et vous montre ce qu’il a changé. C’est toujours vous qui décidez et approuvez ; il se charge du travail mécanique.

Si vous ne voulez vraiment pas utiliser le terminal, Anthropic propose une application de bureau avec une fenêtre classique et une version Web à l’adresse claude.ai/code, qui fonctionne directement dans le navigateur. Mais l’option la plus puissante et la plus flexible reste la version pour terminal, qui est le sujet de tout cet article.

Où se trouve le site officiel de Claude Code, et que faut-il télécharger ?#

La première source de confusion pour les débutants est de savoir où se trouve le site officiel de Claude Code et sur quoi cliquer pour le télécharger. Voici un tableau de toutes les adresses officielles d’Anthropic, pour ne pas avoir à deviner.

Vous ne téléchargez pas un programme d’installation depuis le site comme vous le feriez pour un logiciel classique, ce qui va à l’encontre des attentes. Vous l’installez avec une commande de terminal, qui télécharge ensuite la version adaptée à votre système. Cet article contient les commandes exactes pour Mac, Windows et Linux.

Un piège fréquent concerne le nom : on le voit souvent mal orthographié sous les formes clode code, clade code, слод код ou clode design. Le produit s’appelle Claude Code, avec au. Gardez-le à l’esprit lorsque vous cherchez le site officiel : les domaines aux graphies similaires appartiennent à quelqu’un d’autre.

Il est également utile de connaître le nom exact du paquet npm. Le paquet canonique est @anthropic-ai/claude-code, avec le préfixe @anthropic-ai/. Anthropic détient le nom court claude-code sans préfixe : c’est son pointeur officiel vers le même paquet. La règle est simple : l’éditeur doit être Anthropic, et le nom à utiliser pour l’installation comporte le préfixe.

Ce qu’il faut pour l’installer : configuration requise#

La configuration requise pour Claude Code est modeste : les serveurs d’Anthropic font le gros du travail ; votre machine envoie et reçoit simplement des requêtes.

Quelques mots à part sur Node.js, car c’est le sujet du plus grand nombre de mythes. L’installateur natif, celui recommandé par Anthropic, n’a pas du tout besoin de Node.js : il s’installe sous la forme d’un seul fichier autonome. Node.js n’est requis que si vous installez Claude Code avec npm ; dans ce cas, il vous faut la version 22 ou ultérieure. Les anciens articles parlent de « Node 18 et versions ultérieures » : c’est obsolète ; prenez 22+ comme référence.

Vous avez besoin d’un terminal pour la version principale. Si vous ne voulez pas en utiliser, installez l’application de bureau avec sa fenêtre classique ou utilisez la version Web à l’adresse claude.ai/code. La version pour terminal offre toujours davantage de fonctionnalités ; la suite de cet article explique donc comment l’installer.

Installer Claude Code, c’est comme prendre un outil en main. Mais, à lui seul, il hallucine souvent : il oublie votre projet, invente des choses et perd le fil en plein milieu d’une tâche. La combinaison de trois éléments le rend fiable : un clone IA, un Second Brain et l’ingénierie du contexte. Ce sont les trois piliers qui empêchent l’IA d’halluciner.

Comment installer Claude Code sur macOS ?#

Ouvrez Terminal (il est fourni avec chaque Mac : appuyez sur Cmd+Space pour ouvrir Spotlight et saisissez « Terminal »), puis collez cette ligne :

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

La commande télécharge l’installateur depuis l’adresse officielle d’Anthropic et installe Claude Code. Node.js n’est pas nécessaire. La méthode native est également pratique pour ses mises à jour.

Si vous utilisez déjà Homebrew, une deuxième option est possible :

brew install --cask claude-code

La différence entre les deux tient à la gestion des mises à jour : l’installateur natif se met à jour lui-même, contrairement à Homebrew ; vous devrez donc le mettre à jour manuellement avec la commande brew upgrade claude-code. Le programme lui-même est le même ; choisissez la méthode à laquelle vous êtes habitué. En cas de doute, prenez la première.

Comment installer Claude Code sur Windows ?#

Commencez par déterminer où vous vous trouvez. Windows a deux shells, chacun avec sa propre commande. Ouvrez une fenêtre et observez le début de l’invite : PS C:\> indique PowerShell, tandis que C:\> sans PS indique l’invite de commandes (CMD).

Pour PowerShell (le plus simple est de l’ouvrir en cliquant avec le bouton droit sur le bouton Démarrer et en choisissant « Terminal ») :

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

Pour l’invite de commandes (CMD) :

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

Une troisième option consiste à utiliser le gestionnaire de paquets WinGet intégré :

winget install Anthropic.ClaudeCode

Si vous disposez déjà d’un environnement fonctionnel dans WSL (Linux dans Windows), installez Claude Code directement dans WSL avec la même commande que sous Linux. WSL présente une particularité concernant Node, que j’aborderai plus bas dans la section sur les erreurs fréquentes.

Comment installer Claude Code sur Linux ?#

La méthode de base est la même pour toutes les distributions courantes : l’installateur autonome.

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

Node.js n’est pas nécessaire ; le programme se présente sous la forme d’un seul fichier et se met ensuite à jour automatiquement.

Si vous avez l’habitude d’installer les programmes uniquement avec le gestionnaire de paquets du système, vous pouvez ajouter les dépôts officiels d’Anthropic : apt pour Debian et Ubuntu, dnf pour Fedora et RHEL, et apk pour Alpine. Ils sont signés avec une clé et proposent des canaux stable et latest. C’est excessif pour un débutant ; je laisse les détails à la documentation dans la section des sources et recommande par défaut la commande ci-dessus.

Un problème peut se poser sur les serveurs bon marché. Si la machine dispose de très peu de mémoire libre, l’installation peut s’arrêter en affichant le mot Killed (code 137) : le système a tué le processus parce qu’il manquait de mémoire. La solution consiste à ajouter un fichier swap : Claude Code a besoin d’environ 512 MB de mémoire libre pour s’installer.

Comment lancer Claude Code pour la première fois ?#

Le premier lancement prend quelques minutes. Voici les étapes.

1. Accéder au dossier du projet

   Dans le terminal, utilisez la commande cd path-to-project pour accéder au dossier avec lequel vous souhaitez travailler, puis saisissez claude.

2. Vous connecter à votre compte

   Un navigateur s’ouvrira sur une fenêtre de connexion. S’il ne s’ouvre pas automatiquement, appuyez sur c pour copier le lien, puis collez-le manuellement dans un navigateur. Si le navigateur affiche un code (cela peut arriver dans WSL et sur des serveurs distants), collez ce code dans le terminal.

3. Attendre la confirmation

   Une fois connecté, le terminal affichera Login successful et vous demandera d’appuyer sur Entrée.

4. Poser votre première question

   Posez une question simple sur le projet, par exemple « À quoi sert ce projet ? ». Claude lira les fichiers et répondra.

5. Approuver la première modification

   Lorsque vous lui demandez de modifier quelque chose, Claude vous montre les changements proposés et vous demande confirmation. Vous pouvez changer de mode d’accès avec Shift+Tab.

Il est utile d’apprendre dès le début quelques commandes de base dans la session : /help affiche les commandes, /clear efface l’historique de la conversation et /exit quitte la session (appuyer deux fois sur Ctrl+D fait la même chose). Claude vous montrera tout cela si vous saisissez /help.

Connexion avec un abonnement ou une clé API : que choisir ?#

C’est la première question qui se pose au moment de la connexion.

Il existe deux façons de se connecter, qui diffèrent par le mode de paiement.

Pour vous connecter avec un abonnement, utilisez simplement votre compte Claude.ai. Pour vous connecter avec une clé API, obtenez une clé depuis Claude Console (platform.claude.com) ; les frais sont déduits de votre solde prépayé au fur et à mesure de votre utilisation. Définissez la clé dans la variable d’environnement ANTHROPIC_API_KEY pour que Claude Code n’ouvre pas le navigateur à chaque fois.

Vous pouvez changer de compte dans une session avec /login et vous déconnecter avec /logout.

Claude Code ne se lancera toutefois pas sans accès payant. Si vous n’avez pas encore de compte, renseignez-vous d’abord sur l’adresse e-mail à utiliser pour vous inscrire : vous ne pourrez pas la changer ensuite.

Comment vérifier que l’installation s’est bien déroulée ?#

Il y a trois commandes à connaître dès le départ.

La première vérifie la version :

claude --version

Une installation fonctionnelle renvoie un numéro au format X.Y.Z (Claude Code). Les chiffres précis changent d’une version à l’autre ; l’important est que la commande renvoie bien un numéro de version. Une réponse « command not found » indique un autre problème, abordé dans la section suivante.

La deuxième sert au diagnostic en cas de problème.

La troisième est /status, à utiliser dans une session : elle indique comment vous vous êtes connecté, quelle adresse e-mail ou organisation est associée, et si votre accès a expiré. Enfin, claude update applique immédiatement la dernière mise à jour au lieu d’attendre la mise à jour en arrière-plan.

Pourquoi la commande claude est-elle introuvable après l’installation ?#

C’est la plainte la plus fréquente des débutants, et elle paraît plus inquiétante qu’elle ne l’est. Le terminal ne recherche pas les commandes dans tout l’ordinateur : il ne vérifie que les dossiers indiqués dans PATH. Claude Code se place dans ~/.local/bin/claude (sur Mac et Linux) ou %USERPROFILE%\\.local\\bin\\claude.exe (sur Windows), et si ce dossier n’est pas dans PATH, le terminal ne peut tout simplement pas voir le programme.

Sur Mac et Linux, ajoutez le dossier à la liste. Ouvrez le fichier de paramètres de votre shell (~/.zshrc pour Zsh, ~/.bashrc pour Bash) et ajoutez cette ligne à la fin :

export PATH="$HOME/.local/bin:$PATH"

Fermez ensuite le terminal et rouvrez-le (ou exécutez source ~/.zshrc). Après cela, claude sera reconnu.

Erreurs fréquentes lors de l’installation et du premier lancement#

Passons-les en revue dans l’ordre ; ils sont tous tirés du guide de dépannage officiel d’Anthropic.

1. Ancienne version de Node pour une installation par npm. Le paquet @anthropic-ai/claude-code exige Node.js 22 ou une version ultérieure. Sous Windows, npm peut échouer en signalant que les scripts sont désactivés : la stratégie de PowerShell empêche leur exécution. Dans WSL, une erreur fréquente est exec: node: not found : WSL utilise Node pour Windows au lieu de Node pour Linux. Si npm vous pose problème, passez à l’installateur natif ; il n’a pas besoin de Node.
2. Installateur inadapté au shell. 'irm' is not recognized signifie que vous avez collé une commande PowerShell dans l’invite de commandes. The token '&&' is not a valid statement separator signifie que vous avez fait l’inverse et exécuté une commande CMD dans PowerShell. A parameter cannot be found that matches parameter name 'fsSL' signifie que vous avez exécuté la commande Mac/Linux dans PowerShell. Vérifiez le début de l’invite : PS C:\ correspond à PowerShell, et C:\ à CMD.
3. Une ancienne clé API prend le pas sur l’abonnement. Si votre abonnement est actif mais qu’une ancienne clé est toujours définie dans l’environnement, vous verrez API Error: 400 ... This organization has been disabled. La clé est prioritaire sur la connexion par abonnement. Supprimez-la avec unset ANTHROPIC_API_KEY (dans PowerShell, utilisez Remove-Item Env:ANTHROPIC_API_KEY), vérifiez ~/.zshrc et ~/.bashrc, puis saisissez /status.
4. Mémoire insuffisante sur un serveur peu puissant. L’installation s’arrête avec le mot Killed et le code 137 : cela signifie qu’il n’y a pas assez de RAM. Il faut environ 512 MB de mémoire libre ; ajouter du swap résout le problème.
5. L’installateur a renvoyé autre chose. L’erreur syntax error near unexpected token '<' ou une référence à <!DOCTYPE html> signifie que l’URL d’installation a renvoyé une page Web au lieu du script d’installation, généralement en raison de votre région, d’un pare-feu d’entreprise ou d’une panne temporaire. Essayez une autre méthode (Homebrew, WinGet) ou réessayez dans quelques minutes.

Pour chacune de ces erreurs, commencez de la même manière : exécutez claude doctor. Il vous indiquera ce qui ne fonctionne pas et où chercher.

Un détail de diagnostic mérite d’être signalé : un simple 403 pendant l’installation peut également provenir d’un pare-feu ou d’un proxy d’entreprise. Si vous êtes sur le réseau de votre bureau, vérifiez d’abord qu’il ne bloque pas l’accès.

Que faire après l’installation : premières étapes#

L’installation n’est que le début. Le vrai travail commence ensuite, et le premier obstacle concerne la mémoire. Un modèle de langage ne se souvient pas de vous d’une conversation à l’autre : dans un nouveau chat, il ne connaît que ce que vous avez placé dans son contexte.

La première véritable étape après l’installation consiste donc à créer un fichier CLAUDE.md à la racine de votre projet. C’est un fichier texte contenant les règles et le contexte du projet que Claude Code lit à chaque lancement. Décrivez une fois ce que vous faites, comment le projet est organisé et ce qui compte ; vous n’aurez plus à le répéter dans chaque conversation.

Dans un guide séparé, j’explique comment préparer ce fichier et personnaliser Claude : comment personnaliser Claude. J’ai également préparé une vue d’ensemble des outils de vibe coding pour 2026.

Quelles autres questions les gens posent-ils ?#

Le cadre complet du vibe coding : clone IA + Second Brain + ingénierie du contexte.