Guide · débuter

Tu viens d'installer Claude Code. Les 5 réglages à faire avant d'écrire une ligne.

L'installation prend une commande. C'est après que tout se joue. Sorti de la boîte, Claude Code travaille sans mémoire, il code avant d'avoir réfléchi puis il te réclame une validation toutes les trente secondes.

Pour chaque réglage tu as l'endroit exact, la commande à taper, et l'erreur qui te fera croire que ça ne marche pas. Compte une soirée pour les cinq.

Tu débutes vraiment ? Commence iciL'app Claude ou Claude Code ? Ce n'est pas la même chose →

Avant tout : vérifie que Node est là

Claude Code s'installe avec npm, donc il lui faut Node. Si Node manque, la commande d'installation échoue avec un message qui ne dit jamais « installe Node ». Des gens abandonnent à cette ligne.

$ node --version

Si ça répond un numéro de version, tu peux continuer. Sur la machine qui a servi à écrire ce guide, c'est v24.15.0.

Le piège

Avoir Node mais une version trop ancienne. Là l'installation passe. C'est au lancement que ça casse. Si node --version te renvoie un chiffre en dessous de 18, mets Node à jour avant d'aller plus loin.

Installer, puis lancer au bon endroit

Une seule commande, puis tu lances claude depuis un terminal.

$ npm install -g @anthropic-ai/claude-code
$ claude

Où ça

Dans le terminal, positionné à la racine du dossier de ton projet. Pas dans ton dossier utilisateur, pas sur le bureau.

Au premier lancement il te demande de te connecter. Un abonnement Claude suffit, tu n'as pas besoin d'une clé API séparée.

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.

Le piège, sur Mac

Cette commande échoue souvent sur Mac avec une erreur 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 administrateur puis crée d'autres soucis derrière. Réinstalle plutôt 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.

Le piège

Le lancer depuis n'importe où. Claude Code lit le dossier dans lequel tu le démarres. Rien au-dessus. Lancé du mauvais endroit il ne voit aucun de tes fichiers, donc il invente. C'est l'erreur numéro un des trois premiers jours.

Écrire ton CLAUDE.md, le réglage qui change tout

C'est un fichier texte qu'il relit au démarrage de chaque session. Sans lui, tu réexpliques ton projet et tes habitudes à chaque conversation. Avec lui, il arrive en sachant déjà.

Le plus simple est de le faire écrire par Claude. Dans une session ouverte à la racine de ton projet :

/init

Il parcourt le projet puis écrit un premier CLAUDE.md. Ensuite tu le corriges à la main. C'est cette correction qui fait toute la valeur.

Où ça

CLAUDE.md à la racine du projet pour ce qui concerne ce projet. ~/.claude/CLAUDE.md pour tes règles valables partout.

Le piège

Y décrire ton code. Ton code, il sait le lire tout seul. Écris-y ce qu'il ne peut pas deviner : tes conventions, tes interdits, les commandes pour lancer les tests. Et surtout ce qui a déjà cassé une fois. Un CLAUDE.md qui raconte l'arborescence ne sert à rien. Un CLAUDE.md qui dit « ne touche jamais à ce fichier, on l'a payé cher » vaut de l'or.

Le mode plan, pour qu'il réfléchisse avant de coder

Par défaut, tu demandes et il attaque. Sur une tâche à trois étapes ou plus, c'est là que ça part de travers : il code une moitié de solution puis il bricole autour. Le mode plan l'oblige à te proposer une marche à suivre que tu valides avant qu'il touche à quoi que ce soit.

Où ça

Shift + Tab dans une session fait tourner les modes. Tu peux aussi simplement écrire « fais-moi un plan d'abord, ne code rien ».

Le piège

Valider le plan sans le lire. Le plan est le seul moment où une erreur coûte une phrase au lieu d'une heure. Lis-le. Si un point te paraît flou, c'est qu'il l'est pour lui aussi.

Les permissions, pour arrêter de valider en boucle

Au début il demande l'autorisation à chaque fichier lu puis à chaque commande. C'est fatigant, donc au bout d'une heure les gens valident sans regarder, ce qui est exactement le contraire du but.

/permissions

Où ça

La commande /permissions dans une session, ou le fichier ~/.claude/settings.json pour que ça vaille pour tous tes projets.

Le piège

Tout autoriser d'un coup pour avoir la paix. Autorise ce qui est réversible, comme lire des fichiers ou lancer les tests. Garde la demande sur ce qui ne se rattrape pas : supprimer, pousser sur une branche, envoyer quelque chose vers l'extérieur.

Ton premier skill, taillé pour ton travail

Un skill est un mode d'emploi que Claude charge tout seul quand la tâche correspond. Tu l'écris une fois, il s'applique ensuite sans que tu recolles tes consignes. C'est ce qui remplace le document de prompts que tout le monde garde dans un coin.

Où ça

Un dossier par skill dans ~/.claude/skills/, avec un fichier SKILL.md dedans.

Là encore, fais-le écrire par Claude plutôt que de partir de zéro :

Crée-moi un skill pour une tâche que je refais tout le temps :
[décris-la en deux phrases].

Pose-moi les questions dont tu as besoin avant d'écrire quoi que
ce soit. Je te joins deux exemples de ce que j'ai déjà produit,
pour que le résultat sonne comme moi.

Quand tu auras assez d'informations, écris le skill et donne-lui
une description qui dit précisément dans quels cas il doit se
déclencher.

Le piège

Une description vague. C'est elle seule qui décide du déclenchement. « Aide à la rédaction » ne partira jamais au bon moment. « Rédige les comptes rendus de réunion client au format de mon cabinet » si.

Premium

Le système qui empêche Claude de refaire la même erreur

Le fichier de leçons, puis quoi faire quand il devient trop gros
Le hook qui ressort la bonne leçon au moment du geste
173 leçons réelles, tirées d'un an de production

Voir ce qu'il y a dedans →

« 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.

Si tu n'en fais qu'un

Le CLAUDE.md. Les quatre autres te font gagner du confort, celui-là change la qualité de tout ce qui sort. C'est la différence entre un outil qui redémarre de zéro chaque matin. Et un outil qui connaît ton projet mieux que la personne qui te remplacera pendant tes vacances.

Ce guide est le premier d'une série.

Les suivants sortent chaque semaine. Ils restent ouverts. 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é