Tutoriel Claude Code 5 : Comment installer Claude Code ?

Comment installer Claude Code

L'installation de Claude Code ne comporte pas d'interface graphique avec des boutons "Suivant" ; tout se fait en ligne de commande. Si vous utilisez habituellement npm, le processus ne prendra pas plus de deux minutes.

Prérequis

Avant de commencer, assurez-vous d'avoir les éléments suivants :

Node.js 18 ou version ultérieure
Vérification : exécutez node -v dans le terminal. Si la version est inférieure à 18, mettez à jour avec nvm, fnm ou directement sur nodejs.org.
Un compte Anthropic
Inscrivez-vous à l'adresse https://console.anthropic.com. Le compte fournira une clé API nécessaire après l'installation. L'inscription est gratuite, les coûts réels sont basés sur l'utilisation.
Un accès réseau aux endpoints API d'Anthropic
Le domaine par défaut est api.anthropic.com. Si votre environnement nécessite un proxy, configurez HTTP_PROXY ou HTTPS_PROXY dans le terminal.

Méthode d'installation 1 : Installation globale avec npm

C'est la méthode la plus courante ; une fois installé, vous pouvez l'utiliser partout.

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

Une fois terminé, exécutez claude --version ; si un numéro de version s'affiche, l'installation est réussie. Après une installation globale, la commande claude est accessible depuis n'importe quel répertoire.

En cas d'erreur de permission (fréquente sur macOS dans /usr/local/lib), deux solutions :

Utiliser sudo pour l'installation (pratique mais controversé en termes de sécurité).
Configurer npm pour utiliser un répertoire utilisateur afin d'éviter sudo :
bash mkdir -p ~/.npm-global npm config set prefix '~/.npm-global'
Puis ajoutez ~/.npm-global/bin à votre PATH et redémarrez le terminal.

Méthode d'installation 2 : Utilisation ponctuelle avec npx

Si vous ne voulez rien installer globalement ou si vous souhaitez juste essayer temporairement, npx est plus direct.

npx @anthropic-ai/claude-code

npx téléchargera temporairement le dernier paquet, l'exécutera sans laisser de commande globale. Chaque utilisation vérifie les mises à jour, vous êtes donc toujours à jour. L'inconvénient est une légère lenteur (téléchargement à chaque fois) et ce n'est pas adapté aux scripts automatisés fréquents.

Cas d'usage : première prise en main, utilisation temporaire sur une machine tierce, ou utilisation occasionnelle.

Vérification du lancement

Après l'installation, ne vous précipitez pas sur l'authentification. Exécutez une commande simple pour voir si l'outil démarre :

claude --help

Si l'aide s'affiche, le binaire fonctionne. L'étape suivante consiste à connecter votre compte, cela sera abordé plus tard.

Le corps de l'installation est le même pour les deux méthodes ; l'authentification et l'utilisation ultérieures sont identiques. Choisissez celle qui vous convient le mieux.

Problèmes courants

Version de Node trop ancienne
En dessous de 18, une erreur s'affiche directement, pas un avertissement. Mettez Node à jour pour résoudre le problème.
Délai d'attente réseau
Que ce soit pour npm ou pour la connexion ultérieure à l'API, un proxy ou un pare-feu peut bloquer. Vérifiez d'abord que curl https://api.anthropic.com fonctionne avant de continuer.
Utilisation directe de cmd natif sur Windows
Bien que théoriquement possible, il est recommandé d'utiliser Git Bash, WSL2 ou Windows Terminal pour éviter des problèmes étranges de chemin d'accès.