Build
Guide · le tout début

L'app Claude ou Claude Code ? Ce ne sont pas deux versions du même truc.

La moitié des gens qui « utilisent Claude » n'ont jamais lancé Claude Code. Pas par manque d'envie, parce que personne ne leur a dit que c'était un logiciel différent, ni où on l'ouvre.

À la fin de ce guide tu auras une session ouverte dans ton propre dossier, et tu sauras à quoi sert chacune des deux. Compte vingt minutes. Tu n'as besoin de savoir coder à aucun moment.

Avant tout : lequel des deux tu as déjà ?

Si tu parles à Claude dans une fenêtre de conversation, sur le site ou dans l'application, tu as le premier. Si tu n'as jamais vu de fenêtre noire avec du texte qui défile, tu n'as pas encore le second. C'est le cas de la plupart des gens. Ce n'est pas un retard.

Le piège

Croire que Claude Code est une version payante de l'autre, ou une option cachée dans les réglages de l'application. Ce sont deux logiciels séparés. Tu peux avoir le premier depuis un an sans jamais tomber sur le second.

01

La différence tient en une image

L'application parle. Claude Code fait. C'est toute la différence, et elle change tout ce qui vient après.

L'APPLICATION CLAUDE Il répond. Tu copies. Puis tu colles à la main, dans le bon fichier, sans te tromper. CLAUDE CODE $ claude lecture index.html modifié 3 lignes terminé tout passe Il ouvre tes fichiers. Il écrit dedans.
Le premier te donne un texte. Le second travaille dans ton dossier.

Ça paraît un détail. En pratique c'est la différence entre passer ta soirée à recopier des bouts de code au bon endroit, ou décrire ce que tu veux puis relire ce qui a été fait.

Le piège

Vouloir abandonner l'application. Elle reste meilleure pour réfléchir, rédiger, ou trancher une question. Claude Code est meilleur dès qu'il y a des fichiers en jeu. Ce sont deux outils, pas un remplaçant.

02

Ouvrir un terminal, sans en avoir peur

C'est ici que la plupart des gens s'arrêtent, donc on ralentit. Un terminal est juste une fenêtre où on tape des ordres au lieu de cliquer. Il est déjà installé sur ta machine, tu n'as rien à télécharger.

WINDOWS Win puis tape terminal puis Entrée MAC Cmd + Espace terminal puis Entrée
Deux touches sur chaque système. C'est tout ce qu'il y a a retenir.

Une fenêtre s'ouvre avec quelques mots puis un curseur qui clignote. Elle attend. Tu ne peux rien casser en tapant dedans : tant que tu n'appuies pas sur Entrée, rien ne se passe.

Le piège

Sur Windows, chercher « invite de commandes » parce que c'est le nom qu'on voit dans les vieux tutoriels. Tape terminal tout court, tu tomberas sur le bon. Et si rien ne sort, essaie powershell.

03

Installer Claude Code

Deux commandes. La première vérifie que Node est présent, parce que Claude Code s'installe avec lui.

$ node --version
→ ça doit répondre un numéro, par exemple v24.15.0

Si tu obtiens une erreur au lieu d'un numéro, installe Node depuis nodejs.org, prends la version marquée LTS, puis ferme et rouvre ton terminal. Ensuite seulement :

$ npm install -g @anthropic-ai/claude-code
Le piège, sur Mac

Cette commande échoue souvent sur Mac avec une erreur qui parle de permissions, du genre EACCES. C'est le problème le plus courant sur Mac. Il n'existe pas sur Windows. Ne le règle pas avec sudo : ça installe le programme en tant qu'administrateur puis crée d'autres soucis derrière. Le plus simple est de réinstaller Node depuis nodejs.org, qui pose les bons droits tout seul.

Vérifié sur Windows 11 seulement. Cette partie Mac vient de ce qui est documenté, pas d'un test chez nous.

Bon à savoir

Ça marche directement sur Windows. Les tutoriels qui t'imposent d'installer Linux à côté datent d'avant, tu peux les ignorer.

Le piège

Installer Node puis lancer la commande dans la même fenêtre. Le terminal ne découvre les nouveaux programmes qu'à son ouverture, donc il te répondra que npm n'existe pas alors qu'il vient d'être installé. Ferme la fenêtre, rouvre-la, ça passe. C'est l'erreur la plus fréquente de tout ce guide.

À lire juste aprèsLes 5 réglages à faire avant d'écrire une ligne
!!

« La commande n'existe pas » alors que ça vient de s'installer.

C'est de loin le blocage le plus fréquent. L'explication habituelle (« redémarre ton terminal ») ne dit jamais pourquoi. Voilà la vraie raison.

Claude Code ne s'installe pas là où npm range ses autres programmes. Vérifié sur une machine réelle : le fichier se trouve dans ~/.local/bin/. Le dossier global de npm n'en contient aucune trace.

$ npm config get prefix
→ le dossier ou npm pose ses programmes... mais pas celui-ci

$ ls ~/.local/bin
→ c'est ICI que claude est reellement pose

L'installateur ajoute bien ~/.local/bin à ton PATH, c'est à dire à la liste des endroits où le terminal va chercher les programmes. Mais une fenêtre déjà ouverte ne relit jamais cette liste. Elle en a pris une copie au démarrage, elle la garde jusqu'à sa fermeture.

La solution, dans l'ordre

1. Ferme complètement la fenêtre du terminal puis rouvres-en une neuve. Ça règle le cas neuf fois sur dix.

2. Si ça persiste, vérifie que le programme est bien là avec ls ~/.local/bin. S'il y est, c'est uniquement une histoire de PATH, pas d'installation.

3. Lance-le par son chemin complet pour t'en assurer : ~/.local/bin/claude. Si ça démarre, tout est en place, il ne manque que la ligne de PATH.

Le piège

Réinstaller trois fois de suite en croyant que l'installation a raté. Elle n'a pas raté. Chaque réinstallation repose le même fichier au même endroit, pendant que le terminal continue de ne pas savoir où chercher. Ce n'est pas un problème d'installation, c'est un problème d'adresse.

04

Ta première minute, ligne par ligne

Avant de lancer quoi que ce soit, il faut se placer dans le bon dossier. Claude Code voit le dossier depuis lequel tu le démarres. Rien au-dessus.

$ cd Documents/mon-projet
$ claude

Au premier lancement il te demande de te connecter. Un abonnement Claude suffit, tu n'as pas besoin d'une clé séparée. Ensuite tu écris en français, normalement.

Il te faut un abonnement Claude

Claude Code s'installe gratuitement, mais il faut un compte Claude actif pour s'en servir. Si tu n'en as pas encore, ce lien t'ouvre une semaine offerte pour essayer avant de payer quoi que ce soit :

Essayer Claude une semaine →

C'est un lien de parrainage : tu gagnes ta semaine, j'en gagne une aussi. Je te le dis parce que c'est la règle ici. Tu peux évidemment t'abonner directement sur claude.com sans passer par lui, ça marche pareil.

> ajoute un titre à ma page je lis index.html modifier index.html ? 1. oui 2. toujours 3. non titre ajouté, ligne 12 terminé 1 Tu écris en français. 2 Il demande avant d'agir. 3 Il dit ce qu'il a fait, puis où.
Il annonce ce qu'il lit, il demande avant de modifier, puis il rend des comptes.
Le piège

Le lancer depuis n'importe où, en général depuis ton dossier utilisateur. Il ne voit alors aucun de tes fichiers, donc il invente des réponses plausibles au lieu de lire. Si ses réponses semblent à côté de la plaque dès le début, c'est presque toujours ça.

05

Les quatre portes d'entrée

Une fois installé, Claude Code s'ouvre de plusieurs façons. C'est le même moteur derrière, avec la même mémoire et les mêmes réglages. Seule la fenêtre change.

Le terminal L'application L'éditeur VS Code, JetBrains Le navigateur Le même moteur mêmes fichiers, mêmes réglages
Quatre fenêtres, un seul moteur. Ce que tu règles d'un côté vaut partout.

Commence par le terminal quand même. C'est la seule porte où tu vois exactement ce qu'il fait, ligne par ligne, au moment où il le fait. Les autres cachent une partie du travail pour être plus jolies, ce qui est confortable une fois que tu sais lire ce qui défile. Trompeur avant.

Le piège

Commencer par l'application parce qu'elle ressemble à ce que tu connais. Tu gagnes une heure de confort puis tu perds une semaine à ne pas comprendre pourquoi il fait ce qu'il fait.

Premium

Ton premier projet en ligne, de bout en bout

Voir ce qu'il y a dedans →
06

Et le site du début, alors ?

C'est la question que tu te poses depuis la vidéo, donc autant y répondre tout de suite. Ce site a été construit exactement avec ce que tu viens d'installer : un dossier vide, une session lancée dedans, puis une demande écrite en français.

$ mkdir mon-site
$ cd mon-site
$ claude
→ puis, dans la session :
> fais-moi une page qui presente [ce que tu fais], avec un titre,
  trois arguments et un bouton de contact. Fais-moi un plan avant
  de coder.

En vingt minutes tu as une page qui s'ouvre dans ton navigateur. Ce qui prend plus de temps, c'est la suite : la mettre en ligne à une adresse publique, lui donner un nom de domaine, puis réparer les six endroits où ça casse.

Le piège

Demander « fais-moi un beau site ». Tu obtiendras un gabarit générique que tu n'utiliseras jamais. Décris ce que tu fais, à qui tu parles, puis ce que le visiteur doit comprendre en dix secondes. Le reste suit.

Si tu ne retiens qu'une chose

Lance-le depuis le dossier de ton projet. Pas depuis le bureau, pas depuis ton dossier utilisateur. Neuf problèmes sur dix des trois premiers jours viennent de là. Ils ressemblent tous à « il raconte n'importe quoi » alors qu'il ne voit simplement rien.

Le prochain guide part sur les réglages.

Un guide par semaine, tous ouverts, sans e-mail à donner. La formation complète ouvre bientôt à 39 € par mois ou 199 € l'année. Les inscrits ont l'accès en premier et gardent ce tarif.

Accès anticipé