Introduction
Claude Code est un outil d'interface en ligne de commande (CLI) développé par Anthropic qui vous permet d'interagir directement avec Claude dans votre terminal. Au lieu d'ouvrir un navigateur, discuter avec l'IA, puis copier manuellement le code — Claude Code permet à Claude de travailler directement dans votre répertoire de projet : lire des fichiers, écrire du code, exécuter des commandes et expliquer les erreurs, le tout dans un flux continu.
Cette leçon se concentre sur trois tâches spécifiques : installer Claude Code, attacher une clé API, et taper votre première commande pour confirmer que tout fonctionne correctement.
Prérequis
Claude Code fonctionne sur Node.js, donc votre machine a besoin de Node.js version 18 ou supérieure. Vérifiez avec la commande :
Si vous ne l'avez pas ou si votre version est inférieure à 18, téléchargez Node.js sur nodejs.org (choisissez la version LTS). Vous aurez également besoin d'un compte Anthropic et d'une clé API — inscrivez-vous sur console.anthropic.com si vous n'en avez pas. Les clés API commencent par sk-ant-... ; gardez cette clé secrète et ne la committez jamais dans git.
Installer Claude Code
Claude Code est distribué via npm. Exécutez la commande suivante pour l'installer globalement :
Après l'installation, vérifiez avec :
Le terminal affichera le numéro de version actuel, par exemple 1.x.x. Si vous obtenez une erreur de permission lors de l'installation globale sur macOS/Linux, utilisez nvm pour gérer Node au lieu d'installer Node directement — cela évite la plupart des erreurs liées aux permissions.
Configurer la clé API
Claude Code a besoin d'une clé API pour s'authentifier auprès d'Anthropic. L'approche la plus simple consiste à définir la variable d'environnement ANTHROPIC_API_KEY avant de l'exécuter :
Ceci est temporaire — vous devrez la redéfinir à chaque fois que vous ouvrez un nouveau terminal. Pour la sauvegarder de façon permanente, ajoutez la ligne ci-dessus au fichier de configuration de votre shell :
Si vous utilisez bash au lieu de zsh, changez ~/.zshrc en ~/.bashrc. Sur Windows avec PowerShell, utilisez la commande :
De plus, Claude Code prend en charge un fichier .env.local dans votre répertoire de projet — utile lorsque vous souhaitez utiliser différentes clés pour différents projets.
Exécuter votre première commande
Naviguez vers n'importe quel répertoire de projet (ou créez-en un nouveau), puis démarrez Claude Code :
Lors de la première exécution, Claude Code vous demandera de confirmer certaines conditions d'utilisation. Vous verrez ensuite l'invite de commande de Claude. Essayez de taper votre premier message :
Claude créera un fichier hello.py avec le contenu approprié directement dans le répertoire courant, après quoi vous pourrez le tester :
Si vous voyez la ligne Hello, Claude Code! s'afficher, tout fonctionne correctement.
Erreurs courantes
L'erreur la plus courante au début est une erreur d'authentification ou une clé API invalide. Cela est généralement causé par une clé copiée avec des caractères en trop ou manquants, ou la variable d'environnement qui n'est pas chargée. Exécutez la commande suivante pour vérifier si la clé a été prise en compte :
Si le terminal n'affiche rien, la variable n'a pas été définie dans la session actuelle — réexécutez la commande export ou sourcez le fichier de configuration de votre shell.
La deuxième erreur courante est command not found: claude après l'installation via npm. Cela se produit parce que le répertoire bin global de npm n'est pas dans votre PATH. Vérifiez avec :
Copiez le chemin affiché et ajoutez-le au PATH dans le fichier de configuration de votre shell.
Résumé
Après cette leçon, vous avez Claude Code qui fonctionne sur votre machine avec la clé API correctement configurée. Le processus se compose de trois étapes principales : installer via npm, définir la variable d'environnement ANTHROPIC_API_KEY, puis exécuter claude dans votre répertoire de projet. À partir d'ici, les leçons suivantes approfondiront les fonctionnalités pratiques de Claude Code dans des projets réels.
Point de contrôle de la leçon