Dans le chapitre précédent, tu as appris à laisser Claude Code modifier tes fichiers.

Cependant, tu vas vite remarquer qu'il te proposera parfois d'exécuter des phrases bizarres comme ls ou npm install.

C'est ce qu'on appelle des "commandes shell". Pour un débutant, cela peut être très impressionnant. Nous allons donc apprendre à les lire et à les comprendre sans aucune peur.

1. Qu'est-ce qu'une commande shell ?

Le mot "shell" (qui veut dire "coquille" en anglais) est juste le nom technique de l'interpréteur de ton terminal.

Imagine que ton terminal est une personne très obéissante mais qui ne parle qu'un langage robotique. Une commande shell est simplement une instruction très précise donnée dans ce langage.

Par exemple, au lieu de dire "Ferme la porte", tu dirais une commande shell comme porte --action fermer.

Astuce

Une commande shell n'est rien d'autre qu'un ordre écrit pour demander à ton ordinateur de faire une tâche spécifique.

2. Pourquoi Claude Code exécute des commandes ?

Claude Code est intelligent, mais il est "aveugle" par défaut. Il ne peut pas deviner l'état exact de ton projet.

Il doit parfois agir comme un humain :

  • afficher la liste des fichiers pour voir comment ton projet est rangé.
  • lancer une vérification pour voir si le code contient des erreurs.
  • récupérer l'état de tes sauvegardes (Git).

Au lieu de te demander de faire ces manipulations toi-même, il te propose de lancer ces commandes pour lui.

3. Les commandes les plus courantes

Voici les commandes d'observation inoffensives que tu verras le plus souvent. Elles se contentent de lire ou de lister des informations.

La commande ls (pour list) demande simplement : "Montre-moi les fichiers présents ici". Elle est totalement sans danger.

La commande dir (pour directory) fait exactement la même chose que ls, mais sur les systèmes Windows.

La commande pwd (pour Print Working Directory) demande : "Dans quel dossier suis-je actuellement ?". Elle est sans risque.

La commande git status permet à Claude de voir quels fichiers ont été modifiés récemment.

La commande npm test (ou npm run build) permet de vérifier si le code fonctionne correctement. Cela peut prendre un peu de temps, mais c'est généralement sans risque pour tes fichiers sources.

4. Les commandes qui modifient réellement le projet

Il existe une différence fondamentale entre observer et modifier.

Les commandes que nous venons de voir ne font que regarder. D'autres commandes vont ajouter ou télécharger de nouveaux éléments sur ton ordinateur.

La plus célèbre est npm install. Cette commande indique à ton ordinateur d'aller télécharger sur internet des outils supplémentaires dont ton projet a besoin.

Elle n'est pas dangereuse en soi, mais elle va modifier la taille de ton dossier en y ajoutant beaucoup de fichiers.

5. Les commandes qui doivent attirer ton attention

Certaines commandes suppriment définitivement des éléments. Elles ne sont pas mauvaises, mais tu dois les vérifier avec attention.

Les mots clés à surveiller sont :

  • rm, rmdir, ou del : Ces mots signifient "Remove" ou "Delete" (Supprimer).
  • git reset ou git clean : Ces commandes effacent tes dernières modifications de code.
  • format : Cette commande efface totalement un support de stockage.

Si tu vois l'un de ces mots, la règle est claire : lis attentivement avant de valider.

6. Comment lire une commande proposée par Claude Code

Quand Claude Code te propose une commande, il t'affiche un encadré avec le texte exact qu'il veut lancer.

Prends trois secondes pour te poser ces questions :

  1. Est-ce que le premier mot fait partie de la liste inoffensive (ls, pwd, git status) ?
  2. Est-ce que je vois le mot "rm" ou "delete" ?
  3. Est-ce que le nom des fichiers concernés me semble correct ?

7. Quand répondre Oui

Tu peux taper y (Oui) en toute tranquillité quand Claude veut :

  • afficher la liste de tes fichiers.
  • lancer une vérification de ton code.
  • lancer un build (une compilation).
  • vérifier l'état de Git.

Dans 90% des cas, ses propositions seront tout à fait logiques par rapport à ce que tu lui as demandé de faire juste avant.

8. Quand répondre Non

Tu dois taper n (Non) dans les cas suivants :

  • la commande te paraît complètement étrangère à ce que tu viens de demander.
  • la commande contient le mot "rm" et cible un fichier ou un dossier important.
  • tu n'as absolument aucune idée de ce que la commande va faire.
Bonnes pratiques

Le refus n'est jamais une mauvaise chose. Il vaut toujours mieux refuser une commande obscure et demander une précision, plutôt que de valider au hasard.

9. Demander une explication avant d'accepter

C'est une excellente habitude à prendre.

Si Claude te propose une commande complexe, refuse-la en tapant n.

Ensuite, écris-lui simplement :

"Explique-moi cette commande avant de l'exécuter. Que va-t-elle modifier exactement ?"

Claude se fera un plaisir de t'expliquer chaque mot de la commande en français clair. Si son explication te rassure, tu pourras lui dire : "D'accord, tu peux la lancer."

10. Les erreurs fréquentes des débutants

La première erreur est de valider trop vite. On appuie sur Entrée par réflexe pour avancer plus vite, sans lire l'écran.

La seconde erreur est inverse : avoir peur de toutes les commandes. Le terminal est un outil puissant, mais une commande ls ou npm test ne cassera jamais ton ordinateur.

Il faut apprendre à faire la différence entre la lecture (observation) et l'écriture (modification).

11. Les bonnes habitudes

Garde toujours ces principes en tête :

  • Toujours lire l'écran.
  • Toujours comprendre ce que tu valides.
  • Ne jamais te précipiter.
  • Demander une explication lorsqu'un doute apparaît.

12. FAQ

C'est une simple mesure de sécurité. Claude ne veut pas exécuter d'actions sur ton ordinateur sans ton accord explicite. Cela t'évite de mauvaises surprises.
Si tu as déjà tapé 'y' et que la commande est en cours, tu peux essayer de l'arrêter avec le raccourci clavier Ctrl + C. Si la commande est déjà terminée, il faudra trouver une autre commande pour annuler ses effets (ou utiliser Git).
Absolument rien. La commande ne sera pas exécutée. Claude te dira qu'il a compris ton refus, et il te proposera généralement de formuler ta demande autrement.
Par défaut, non. Il attendra toujours ton 'y'. Il existe un mode avancé pour le laisser faire tout seul, mais il est très fortement déconseillé aux débutants.
Oui et non. Les commandes d'observation (comme lister les fichiers) sont totalement inoffensives. Les commandes de suppression (comme rm ou del) sont définitives. D'où l'importance de toujours lire ce qui est écrit à l'écran.

Maintenant que tu n'as plus peur des commandes shell, tu es prêt à utiliser Claude pour accomplir des tâches plus complexes. Dans le prochain chapitre, nous verrons comment déboguer du code avec Claude Code.

Chapitre terminé