Premiers pas

Prérequis et installation

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.

Nouveau avec les ordinateurs ?

Si les mots "terminal", "Node.js" ou "clé API" vous semblent mystérieux, commencez par notre page pré-requis pour grands débutants. Elle explique tout en langage humain, avec des analogies concrètes.

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 ou utilisez un gestionnaire de versions comme nvm.

La page nodejs.org propose deux versions : LTS (recommandée) et Current

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 compte Anthropic

Vous avez besoin soit d'une clé API (pay-as-you-go via la console Anthropic), soit d'un abonnement Claude Max/Pro/Team qui inclut l'accès à Claude Code.

Créez votre compte sur console.anthropic.com.

La console Anthropic permet de créer et gérer vos clés API

Vérifiez votre version de Node.js

Ouvrez votre terminal et tapez la commande suivante :

Version trop ancienne ?

Si vous voyez un numéro inférieur à v18.0.0, ou si la commande n'est pas reconnue, vous devez installer ou mettre à jour Node.js. Consultez la section Troubleshooting en bas de cette page.

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.

Pourquoi le flag -g ?

Le flag -g signifie "global". Sans ce flag, le paquet serait installé uniquement dans le dossier courant. Avec -g, Claude Code devient un outil système accessible partout, comme git ou node.

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.

Générez une clé API

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

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

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.

Sécurité de votre clé API

Ne partagez jamais votre clé API. Ne la commitez jamais dans un dépôt Git. Si vous pensez qu'elle a été exposée, régénérez-la immédiatement depuis console.anthropic.com.

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.

Lancez Claude Code

Exécutez simplement la commande claude dans votre terminal :

claude

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)

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.

Quel abonnement choisir ?

L'abonnement Max ($100/mois) offre une utilisation intensive de Claude Code. L'abonnement Pro ($20/mois) donne un accès limité. La clé API (pay-as-you-go) est idéale pour tester ou pour un usage ponctuel, comptez environ $5-15 par jour d'utilisation active.

Comparaison des offres

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.

Ne jamais utiliser sudo avec npm

La commande sudo npm install -g est une mauvaise pratique qui crée des problèmes de permissions en cascade. Utilisez plutôt l'une des solutions ci-dessous.

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