Installer Claude Code et lancer son premier projet
Installez Claude Code avec npm ou l'installeur natif, vérifiez votre configuration, lancez votre première session dans un projet et explorez le terminal.
- Installer Claude Code sur macOS, Windows ou Linux, avec npm ou l'installeur natif
- Vérifier l'installation avec claude --version et la diagnostiquer avec claude doctor
- Lancer une première session dans un projet, dialoguer dans le REPL et reprendre une conversation
Vous savez désormais ce qu’est Claude Code. Il est temps de passer à la pratique. Dans ce module, vous allez installer l’outil sur votre machine, le lancer dans un vrai projet et vivre ce petit moment magique où une IA explore votre code toute seule, puis vous l’explique. Vingt minutes suffisent : à la fin, Claude Code tournera chez vous, prêt à travailler.
Ce que vous allez apprendre
- Réunir les deux seuls prérequis : un terminal et un compte Claude
- Installer Claude Code avec npm, ou avec l’installeur natif si vous n’avez pas Node.js
- Vérifier votre installation avec
claude --versionet la diagnostiquer avecclaude doctor - Lancer votre première session dans un projet et dialoguer en langage naturel
- Reprendre une conversation interrompue avec
claude -cetclaude --resume
Les prérequis, en toute honnêteté
Bonne nouvelle : il vous faut très peu de choses. Deux, exactement.
D’abord, savoir ouvrir un terminal. Le terminal, c’est cette fenêtre de texte où l’on tape des commandes au lieu de cliquer sur des boutons. Voyez-le comme le guichet direct de votre ordinateur : au lieu de passer par les menus, vous parlez à la machine sans intermédiaire. Sur Mac, l’application s’appelle Terminal. Sur Windows, vous utiliserez PowerShell. Sous Linux, vous le connaissez sûrement déjà. Aucune expertise requise : ouvrir la fenêtre, taper une commande, valider avec Entrée. C’est tout ce que ce module vous demande. Et si des mots comme « terminal » ou « ligne de commande » restent un peu flous, notre glossaire les définit simplement.
Ensuite, un compte Claude. Deux formules existent.
La première : un abonnement Claude Pro ou Max, souscrit sur claude.ai. C’est la voie la plus simple. Un forfait mensuel, et Claude Code est utilisable avec votre compte. Recommandée pour découvrir et pour un usage quotidien.
La seconde : un compte Anthropic Console. Ici, vous créez une clé API — une sorte de badge d’accès numérique — et vous payez à l’usage, selon votre consommation réelle. Cette formule s’adresse plutôt aux développeurs qui automatisent des traitements ou aux équipes qui veulent une facturation centralisée.
Retenez la règle simple : abonnement pour l’usage humain au quotidien, Console pour le paiement à la consommation. Les deux fonctionnent parfaitement avec Claude Code. Et si le paysage des assistants IA vous semble encore brumeux, notre dossier IA et notre comparatif des IA vous aideront à y voir clair.
Installer Claude Code
Deux chemins mènent à l’installation. Choisissez selon ce qui est déjà présent sur votre machine.
Le chemin classique : npm
Si vous faites déjà du développement web, vous avez probablement Node.js sur votre poste. Node.js est un moteur qui exécute du JavaScript en dehors du navigateur, et il embarque npm, son gestionnaire de paquets — imaginez une boutique d’applications pour outils de développeurs, pilotée en ligne de commande. Dans ce cas, une seule commande suffit :
# Installe Claude Code globalement (necessite Node.js 18 ou plus recent)
npm install -g @anthropic-ai/claude-code
Le -g signifie « global » : Claude Code sera disponible partout sur votre machine, pas seulement dans un projet.
Le chemin sans Node.js : l’installeur natif
Pas de Node.js ? Aucun problème. Anthropic fournit un installeur autonome qui ne dépend de rien.
Sur macOS, Linux ou WSL — WSL, c’est le sous-système Linux intégré à Windows — ouvrez votre terminal et tapez :
# Installeur natif pour macOS, Linux et WSL
curl -fsSL https://claude.ai/install.sh | bash
Sur Windows, ouvrez PowerShell et tapez :
# Installeur natif pour Windows PowerShell
irm https://claude.ai/install.ps1 | iex
⚠️ Piège courant — Sous Windows, il existe deux terminaux : PowerShell et l’ancien CMD. La commande
irmne fonctionne que dans PowerShell. Si le message « irm n’est pas reconnu » s’affiche, vous êtes dans CMD. Repérez votre invite : elle commence par « PS » dans PowerShell. Ouvrez la bonne fenêtre et recommencez.
💡 Astuce — L’installeur natif a un avantage discret : il se met à jour automatiquement en arrière-plan. Vous profitez des nouveautés sans y penser.
Vérifier que tout fonctionne
Une installation ne se croit pas sur parole, elle se vérifie. Fermez votre terminal, rouvrez-le, puis tapez :
# Affiche le numero de version installe
claude --version
Si un numéro de version s’affiche, c’est gagné. Sinon, ou si quelque chose vous semble étrange plus tard, Claude Code embarque son propre médecin :
# Diagnostique l'installation et la configuration
claude doctor
Cette commande examine votre installation et signale ce qui cloche : version obsolète, problème de configuration, souci d’environnement. Gardez-la en tête, elle vous évitera bien des réinstallations inutiles.
Le premier lancement : toujours dans un projet
Voici le geste le plus important de ce module. Claude Code ne se lance pas n’importe où : il se lance dans le dossier de votre projet. Pourquoi ? Parce que ce dossier devient son périmètre de travail. C’est là qu’il lira vos fichiers, là qu’il comprendra votre code.
Concrètement, on se déplace avec cd — pour « change directory », changer de dossier — puis on lance l’outil :
# On se place dans le dossier du projet...
cd mon-projet
# ... puis on lance Claude Code
claude
Au tout premier démarrage, Claude Code vous invite à vous connecter. Suivez les instructions : votre navigateur s’ouvre, vous vous identifiez avec votre compte claude.ai ou votre compte Console, et c’est terminé. Vos identifiants sont mémorisés, vous ne referez pas cette manipulation à chaque session. Besoin de changer de compte plus tard ? La commande /login, tapée dans la session, relance la connexion. Et /logout vous déconnecte.
Une fois connecté, vous voici face à l’invite de Claude Code, avec la version, le modèle utilisé et le dossier courant affichés. Cette zone de saisie, c’est votre nouvel espace de conversation.
⚠️ Piège courant — Lancer
claudedepuis votre dossier personnel plutôt que depuis le projet. Aucune erreur ne s’affiche, tout semble normal… mais Claude ne voit pas vos fichiers, et ses réponses tombent à côté. Prenez le réflexe : d’abordcd mon-projet, ensuiteclaude.
Faites le tour du REPL
Ce mode interactif porte un nom : le REPL. L’acronyme vient de l’anglais Read-Eval-Print Loop, littéralement « lire, évaluer, afficher, boucler ». Traduction pour nous : une conversation en boucle. Vous écrivez, Claude répond, et ainsi de suite — comme une messagerie instantanée, mais installée dans votre terminal.
La règle d’or : on écrit en langage naturel. Pas de syntaxe à apprendre, pas de mots-clés obligatoires. Vous tapez vos demandes comme vous les diriez à un collègue.
Quatre raccourcis suffisent pour être à l’aise :
- Flèche haut : rappelle vos demandes précédentes, comme l’historique de votre navigateur. Pratique pour relancer ou corriger une question.
- Tab : complète les noms de fichiers. Tapez le début d’un nom, appuyez sur Tab, Claude Code termine pour vous. Fini les fautes de frappe dans les chemins.
- Ctrl+C : annule la saisie ou l’action en cours. Votre échappatoire quand vous changez d’avis.
- Ctrl+D : quitte proprement Claude Code et vous rend votre terminal.
Ajoutez-y une commande refuge : /help, qui affiche l’aide et la liste des commandes disponibles. Perdu ? /help. Toujours.
💡 Astuce — Parlez à Claude Code comme à un collègue compétent, pas comme à un moteur de recherche. « Explique-moi comment ce formulaire valide les emails » donnera toujours un meilleur résultat que « validation email ». Plus votre demande est précise et contextuelle, meilleure est la réponse.
Votre première vraie conversation
Le moment que vous attendiez. Votre projet est ouvert, Claude Code tourne. Tapez simplement :
explique-moi ce projet
Et regardez. Claude Code se met au travail : il parcourt l’arborescence, ouvre les fichiers importants, lit les configurations. Vous n’avez rien copié, rien collé, rien indiqué. Il explore tout seul et revient avec une synthèse : ce que fait le projet, avec quelles technologies, comment il est organisé.
C’est la grande différence avec un chat IA dans le navigateur. Là-bas, vous deviez coller des extraits de code un par un. Ici, l’IA vit dans votre projet et va chercher elle-même ce dont elle a besoin.
Continuez la conversation, creusez :
que fait ce code dans le fichier principal ?
où se trouve le point d'entrée de l'application ?
quelles technologies ce projet utilise-t-il ?
Chaque réponse s’appuie sur vos vrais fichiers, pas sur des généralités. Et comme la conversation garde le fil, vous pouvez enchaîner les questions sans tout réexpliquer : Claude se souvient de ce qui a été dit depuis le début de la session.
Quitter, revenir, reprendre
Une session de travail, ça s’interrompt : une réunion, une pause, un ordinateur qu’on éteint. Claude Code est prévu pour ça.
Vous quittez avec Ctrl+D. Plus tard, pour reprendre exactement là où vous en étiez :
# Continue la derniere conversation du dossier courant
claude -c
Le -c signifie « continue ». Claude rouvre la dernière conversation menée dans ce dossier, avec toute sa mémoire : vos questions, ses réponses, le contexte accumulé. Rien n’est perdu.
Et si la conversation à retrouver n’est pas la dernière ? Utilisez :
# Affiche la liste des sessions passees, a vous de choisir
claude --resume
Une liste de vos sessions précédentes s’affiche, vous choisissez celle à réveiller.
Deux variantes complètent la panoplie. Pour poser une question rapide sans ouvrir de session complète : claude "ta question". Et pour les scripts et l’automatisation, le mode dit « headless » — sans interface — affiche la réponse puis rend la main : claude -p "ton prompt". Rangez cette dernière dans un coin de votre tête, nous y reviendrons en fin de formation.
💡 Astuce —
claude -cest lié au dossier courant. Si vous travaillez sur plusieurs projets, chacun garde ses propres conversations : placez-vous dans le bon dossier avant de reprendre le fil.
En survol : /init, les IDE et l’app de bureau
Trois portes que nous ouvrirons plus tard, mais que vous devez connaître dès maintenant.
La commande /init, tapée dans une session, crée un fichier nommé CLAUDE.md à la racine de votre projet. Ce fichier, c’est la mémoire permanente de Claude sur votre projet : conventions, architecture, consignes. Un module entier lui est consacré — le module 6 — car bien rempli, il change tout.
Claude Code existe aussi hors du terminal. Une extension l’intègre à VS Code et aux IDE JetBrains, ces éditeurs de code que vous utilisez peut-être déjà. Une application de bureau existe pour Mac et Windows. Et une version web tourne sur claude.ai/code. Le cœur reste le même partout ; le terminal, lui, reste le meilleur endroit pour apprendre, car il montre tout sans rien cacher.
À vous de jouer
Place à la pratique. L’exercice fonctionne avec un vrai projet de code, mais aussi avec un simple dossier de fichiers texte — l’exploration marche pareil.
- Installez Claude Code avec la méthode de votre choix :
npm install -g @anthropic-ai/claude-codesi Node.js est présent, sinon l’installeur natif de votre système. - Vérifiez l’installation : tapez
claude --versiondans un nouveau terminal. Pas de numéro de version ? Lancezclaude doctoret lisez son diagnostic. - Préparez un terrain de jeu : ouvrez un projet existant, ou créez un dossier avec deux ou trois fichiers texte — par exemple des recettes de cuisine ou des notes de travail.
- Lancez votre session :
cdvers ce dossier, tapezclaude, connectez-vous quand l’outil vous y invite. - Faites-le parler : demandez « décris-moi le contenu de ce dossier », puis posez deux questions de suivi sur ce qu’il a trouvé. Observez comme il explore sans votre aide.
- Testez la reprise : quittez avec Ctrl+D, relancez avec
claude -c, et posez une question qui fait référence à votre échange précédent. La mémoire est là.
En résumé
- Deux prérequis seulement : savoir ouvrir un terminal, et un compte Claude — abonnement Pro ou Max sur claude.ai, ou compte Anthropic Console avec paiement à l’usage.
- Installation au choix :
npm install -g @anthropic-ai/claude-codeavec Node.js 18 ou plus, ou l’installeur natif — script curl sur macOS, Linux et WSL, commande irm sous Windows PowerShell. - Vérifiez avec
claude --version, diagnostiquez avecclaude doctor. - Le réflexe fondamental :
cd mon-projetd’abord,claudeensuite. Le dossier de lancement définit ce que Claude voit. - Dans le REPL : langage naturel, flèche haut pour l’historique, Tab pour compléter les fichiers, Ctrl+C pour annuler, Ctrl+D pour quitter.
- Pour reprendre le travail :
claude -ccontinue la dernière conversation,claude --resumelaisse choisir une session passée.
Claude Code est installé, connecté, et il a déjà exploré son premier projet. Dans le prochain module, nous le mettons vraiment au travail : vous allez lui confier vos premières missions concrètes sur du code, et découvrir comment il s’y prend pour les mener à bien.
Testez vos connaissances
Vous tapez npm install -g @anthropic-ai/claude-code et le terminal répond que la commande npm est introuvable. Quelle est la meilleure réaction ?
npm fait partie de Node.js : s'il est introuvable, c'est que Node.js n'est pas installé sur votre machine. Plutôt que de l'installer uniquement pour ça, utilisez l'installeur natif d'Anthropic — le script curl sur macOS, Linux et WSL, ou la commande irm sous Windows PowerShell — qui installe Claude Code sans aucune dépendance.
Vous lancez la commande claude depuis votre dossier personnel au lieu du dossier de votre projet. Que se passe-t-il ?
Claude Code travaille dans le dossier où vous le lancez : c'est son périmètre. Lancé au mauvais endroit, il démarre sans la moindre erreur, mais il ne voit pas les fichiers de votre projet. Le bon réflexe : toujours se placer dans le dossier du projet avec cd avant de taper claude.
Vous avez fermé votre terminal hier soir en plein travail. Ce matin, vous voulez reprendre exactement la même conversation avec Claude Code. Quelle commande tapez-vous ?
claude -c, comme continue, rouvre la dernière conversation menée dans le dossier courant, avec tout son contexte. Pour repêcher une session plus ancienne dans une liste, utilisez claude --resume. Quant à /clear, il fait l'inverse : il efface l'historique pour repartir de zéro.
Claude Code se comporte bizarrement sur votre machine et vous soupçonnez un problème d'installation. Quel est le bon outil de diagnostic ?
claude doctor examine votre installation et votre configuration, puis signale ce qui cloche. C'est le premier réflexe à avoir en cas de comportement anormal, bien avant d'envisager une réinstallation complète.
Dans le REPL, vous avez commencé à taper une longue demande, puis vous changez d'avis. Quel raccourci annule la saisie en cours sans quitter Claude Code ?
Ctrl+C annule la saisie ou l'action en cours tout en laissant la session ouverte. Ctrl+D, lui, quitte complètement Claude Code. Et Tab sert à compléter les noms de fichiers, pas à annuler.