Démarrer

Prérequis et installation

  • Tutoriel
  • Outils

Installez Claude Code en quelques minutes. Prérequis (Node.js 18+, terminal, compte Anthropic), installation npm, authentification API key ou Max, et résolution des erreurs courantes.

Mis à jour mai 2026

Trois changements à connaître avant d'installer en mai 2026 :

  • Node.js 22 recommandé (Node 18 est en fin de support en avril 2026, certains scripts d'outillage du projet exigent désormais Node 20+).
  • Le plan Claude Max est devenu la voie d'authentification la plus économique pour un usage individuel régulier (vs ANTHROPIC_API_KEY au prorata des tokens). À choisir selon votre profil de consommation.
  • L'installation via npm i -g @anthropic-ai/claude-code reste la seule officielle. Méfiez-vous des forks ou packages non vérifiés. Voir la page sécurité pour les vérifications de provenance.

Prérequis

Avant d'installer Claude Code, vérifiez que vous avez ces trois éléments. Si l'un d'entre eux vous manque, pas de panique, on vous explique tout juste en dessous.

Node.js 18 ou supérieur

Claude Code fonctionne grâce à Node.js, le moteur JavaScript qui permet d'exécuter du code côté serveur. Vous avez besoin de la version 18 minimum (la version 22 LTS est recommandée).

Téléchargez-le sur nodejs.org (ouvre un nouvel onglet) ou utilisez un gestionnaire de versions comme nvm.

La page nodejs.org/download propose un installeur Windows officiel (.msi) ainsi qu'une distribution binaire. Pour la majorité des utilisateurs, l'installeur Windows fait l'affaire.

Un terminal

Claude Code vit dans le terminal. Sur macOS, utilisez Terminal ou iTerm2. Sur Windows, utilisez PowerShell ou WSL (Windows Subsystem for Linux). Sur Linux, n'importe quel émulateur de terminal fera l'affaire.

Un abonnement Claude

Le plus simple et le plus rentable : un abonnement Claude Pro, Max ou Team depuis claude.com (ouvre un nouvel onglet). Pro inclut déjà Claude Code, Max ajoute 5× ou 20× la capacité de Pro, Team est conçu pour les équipes avec un workspace partagé.

Si tu préfères payer à l'usage exact (utilisation très ponctuelle), tu peux à la place créer une clé API sur console.anthropic.com (ouvre un nouvel onglet). Voir la section Authentification plus bas pour les deux méthodes.

Vérifiez votre version de Node.js

Ouvrez votre terminal et tapez la commande suivante :

Installation de Claude Code

L'installation se fait en une seule commande. Ouvrez votre terminal et exécutez :

Cette commande installe Claude Code globalement sur votre machine. Cela signifie que la commande claude sera disponible depuis n'importe quel dossier de votre système.

Vérifiez l'installation

Après l'installation, vérifiez que tout fonctionne :

Si la commande est reconnue et affiche un numéro de version, l'installation est réussie.

Authentification

Lors du premier lancement, Claude Code vous demandera de vous authentifier. Deux méthodes sont disponibles.

Méthode 1 : Clé API (pay-as-you-go)

C'est la méthode la plus flexible. Vous payez uniquement ce que vous consommez.

1

Générez une clé API

Rendez-vous sur console.anthropic.com (ouvre un nouvel onglet), connectez-vous, puis allez dans API Keys et cliquez sur Create Key. Copiez la clé générée (elle commence par sk-ant-).

2

Configurez la variable d'environnement

Ajoutez votre clé API dans votre fichier de configuration shell :

# Ajoutez cette ligne à votre ~/.bashrc ou ~/.zshrc
export ANTHROPIC_API_KEY="sk-ant-votre-clé-ici"


# Rechargez votre configuration
source ~/.bashrc  # ou source ~/.zshrc
3

Lancez Claude Code

Placez-vous dans un dossier de projet et lancez la commande claude. L'authentification sera automatique grâce à la variable d'environnement.

Méthode 2 : Abonnement Claude Max / Pro / Team

Si vous avez un abonnement Claude (Max, Pro ou Team), vous pouvez utiliser Claude Code sans clé API séparée.

1

Lancez Claude Code

Exécutez simplement la commande claude dans votre terminal :

claude
2

Choisissez la méthode d'authentification

Claude Code vous propose deux options. Sélectionnez Claude App :

? How would you like to authenticate?
> Claude App (Max subscription)
  Anthropic Console (API key)
3

Connectez-vous dans votre navigateur

Un navigateur s'ouvre automatiquement. Connectez-vous avec votre compte Claude. Une fois authentifié, retournez dans le terminal, Claude Code est prêt.

Comparaison des offres

Extrait de claude.com/pricing au 9 mai 2026. Pro inclut Claude Code, Max ajoute 5x ou 20x la capacité de Pro. Pour les chiffres à jour, ouvrez claude.com/pricing.

Essai gratuit

Gratuitcrédit de démarrage inclus

Pour tester Claude Code avant de vous engager. Crédit offert à l'inscription.

  • Crédit d'essai à l'inscription
  • Accès à Claude via clé API
  • Facturation à l'usage après le crédit
  • Pas d'abonnement requis
  • Idéal pour découvrir l'outil
Créer un compte
Recommandé pour commencer

Claude Max

~20 €par mois

L'abonnement idéal pour une utilisation régulière de Claude Code. Accès inclus sans clé API séparée.

  • Accès illimité à Claude Code
  • Pas de clé API à gérer
  • Claude.ai web inclus
  • Annulation à tout moment
  • Idéal pour un usage quotidien
S'abonner à Claude Max

Claude Code API

À l'usageselon la consommation

Pour les développeurs qui préfèrent payer exactement ce qu'ils consomment, sans abonnement fixe.

  • Paiement à l'utilisation
  • Clé API nécessaire
  • Contrôle fin des coûts
  • Intégration dans des scripts
  • Idéal pour des usages ponctuels
Voir les tarifs API

Les prix sont indicatifs et peuvent varier. Consultez anthropic.com/pricing pour les tarifs officiels.

Troubleshooting : erreurs courantes

"command not found: node" ou version trop ancienne

Node.js n'est pas installé ou votre version est trop ancienne.

# Installer nvm (gestionnaire de versions Node.js)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash


# Redémarrer le terminal, puis :
nvm install 22
nvm use 22


# Vérifier
node --version
# v22.x.x

"EACCES: permission denied"

npm n'a pas les permissions pour installer des paquets globaux.

Solution 1 : Configurer le préfixe npm (recommandé)

mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc


# Relancez l'installation
npm install -g @anthropic-ai/claude-code

Solution 2 : Utiliser nvm

Si vous utilisez nvm, les problèmes de permissions sont gérés automatiquement.

"command not found: claude"

Le terminal ne trouve pas la commande claude après l'installation.

# Vérifiez où npm installe les paquets globaux
npm config get prefix


# Le sous-dossier bin/ de ce chemin doit être dans votre PATH
# Si vous avez configuré ~/.npm-global :
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

Si vous avez fermé et rouvert votre terminal après l'installation et que le problème persiste, vérifiez que le dossier bin de npm est bien dans votre variable PATH.

"API key not found" ou "Invalid API key"

# Vérifiez que la variable est définie
echo $ANTHROPIC_API_KEY


# Si rien ne s'affiche, la variable n'est pas configurée
# Vérifiez votre fichier de configuration shell
cat ~/.bashrc | grep ANTHROPIC


# Assurez-vous que la clé commence par sk-ant-
# et qu'elle n'a pas été révoquée sur console.anthropic.com

Prochaines étapes

Claude Code est installé et vous êtes authentifié. Passons à la configuration de votre environnement pour tirer le meilleur parti de l'outil.

Précédent

Qu'est-ce que Claude Code ?

Suivant

Configuration de l'environnement