Claude Code pour les nuls : dix notions et un premier projet

Les dix notions à connaître avant de commencer

Vous n'avez pas besoin d'apprendre à programmer. Vous avez besoin de comprendre dix mots. Les voici, dans l'ordre où vous les rencontrerez.

1. Le dossier de projet. Claude Code travaille dans un dossier de votre ordinateur, et seulement là. Un projet, un dossier. Vous le choisissez au lancement, dans l'application Claude pour ordinateur ou dans le terminal.

2. La demande, ou prompt. C'est le texte que vous écrivez à Claude. En français, avec un contexte (qui vous êtes, quel est le projet), un objectif (ce que vous voulez obtenir), des contraintes (ce qu'il ne faut pas faire) et le résultat attendu. Plus elle est précise, meilleur est le travail.

3. Les autorisations. Avant une action sensible (modifier un fichier, lancer une commande), Claude Code vous demande votre accord. Vous pouvez l'accorder pour la session en cours quand vous avez confiance. C'est votre ceinture de sécurité.

4. Le fichier CLAUDE.md. Un fichier texte à la racine du dossier, qui contient vos consignes permanentes : la langue, le ton, ce qu'il ne faut jamais toucher. Claude le relit à chaque session, ce qui vous évite de tout répéter.

5. La commande /init. Tapée dans Claude Code, elle propose un fichier CLAUDE.md adapté à votre dossier. Un bon point de départ, à relire et à compléter.

6. Le mode plan. Un mode où Claude propose un plan d'action avant de toucher aux fichiers. Vous validez, corrigez ou refusez. À utiliser pour toute modification importante.

7. /clear. Repart d'une conversation vide. Utile quand vous changez de sujet ou quand Claude semble s'embrouiller dans un long historique.

8. /compact. Résume la conversation en cours pour alléger la mémoire de travail de Claude, sans tout perdre.

9. claude --continue. Dans le terminal, reprend la dernière conversation du dossier. Pratique pour revenir le lendemain.

10. Git. Un outil d'historique des modifications. S'il est installé, Claude Code peut s'en servir pour enregistrer chaque étape et revenir en arrière en cas de problème. Vous n'avez pas à l'apprendre : demandez à Claude de l'utiliser pour vous.

Si vous voulez d'abord comprendre ce qu'est l'outil et ce qu'il ne fait pas, lisez Claude Code, c'est quoi ?.

Un premier projet en vingt minutes

Prenons un cas simple et utile : une page web de présentation de votre activité, que vous verrez dans votre navigateur. Pas de mise en ligne aujourd'hui ; juste comprendre le cycle demande, résultat, correction.

Préparation (cinq minutes). Installez Claude Code si ce n'est pas fait (Installer Claude Code sur Windows ou Installer Claude Code sur Mac). Créez un dossier vide « Ma page » dans vos Documents. Ouvrez Claude Code dans ce dossier.

Première demande (cinq minutes). Copiez-collez ceci en adaptant les éléments entre crochets :

Je suis [votre métier] à [votre ville]. Crée dans ce dossier une page web de présentation en un seul fichier HTML, en français, avec : un titre, trois phrases qui présentent mon activité, mes horaires, mon adresse e-mail de contact [adresse] et un style sobre, lisible sur téléphone. Pas d'image. Avant d'écrire le fichier, montre-moi les textes que tu proposes et attends ma validation.

Claude vous propose les textes. Relisez-les, corrigez ce qui ne vous ressemble pas, puis validez. Il crée le fichier et vous demande l'autorisation d'écrire : acceptez.

Voir le résultat (deux minutes). Demandez-lui simplement : « Comment je fais pour voir cette page dans mon navigateur ? » Il vous expliquera comment ouvrir le fichier, ou proposera de lancer un petit serveur local. Dans ce cas, il vous demandera l'autorisation de lancer la commande.

Corriger (cinq minutes). Regardez la page et dites ce qui cloche, comme à un collègue :

La page est bien, mais : le titre est trop gros, je préfère une couleur de fond crème plutôt que blanche, et ajoute une ligne « Sur rendez-vous uniquement » sous les horaires. Ne change rien d'autre.

Fixer les règles (trois minutes). Tapez /init et laissez Claude proposer un fichier CLAUDE.md. Ajoutez-y vos consignes : « Toujours en français », « Ne jamais ajouter d'image sans me demander », « Me montrer les textes avant de les écrire ». La prochaine session commencera avec ces règles.

Vous venez de faire le tour complet : demander, relire, valider, corriger, mémoriser. Tout le reste, un site complet, une boutique, un outil, n'est que ce cycle répété sur des projets plus grands.

Les erreurs de débutant et comment les éviter

Elles sont toujours les mêmes, et elles se corrigent vite.

Demander trop vague. « Fais-moi un site » donne un site générique. Dites qui vous êtes, pour qui est le site, quelles pages il contient, quel ton vous voulez, ce que vous refusez. Le cahier des charges tient en dix lignes, mais il doit exister.

Lancer Claude Code dans le mauvais dossier. Jamais à la racine du disque, jamais dans votre dossier personnel entier. Un dossier dédié, vide au départ. Sinon Claude lit des centaines de fichiers inutiles et vous risquez une modification au mauvais endroit.

Tout valider sans lire. Les demandes d'autorisation ne sont pas une formalité. Lisez ce que Claude s'apprête à faire. Vous attraperez une erreur sur deux avant qu'elle n'arrive.

Ne pas sauvegarder. Avant toute modification importante d'un projet qui compte, copiez le dossier, ou demandez à Claude d'utiliser Git pour enregistrer l'état actuel. Une sauvegarde qui n'existe pas ne sert à rien le jour où l'on en a besoin.

Laisser filer une conversation interminable. Quand Claude se répète ou oublie des consignes, la conversation est trop longue. Tapez /compact pour la résumer, ou /clear pour repartir à neuf, après avoir noté dans CLAUDE.md ce qui doit survivre.

Croire tout ce qu'il dit. Claude peut affirmer qu'une chose fonctionne alors qu'elle ne fonctionne pas. Testez vous-même : ouvrez la page, cliquez, remplissez le formulaire. La vérification finale est la vôtre.

Mettre en ligne le jour même. Un premier site mérite une nuit de recul, une relecture des textes et une vérification des obligations légales (mentions légales, protection des données). Ce n'est pas Claude qui portera la responsabilité du site : c'est vous.

Et ensuite ?

Une fois ce premier cycle maîtrisé, les projets plus ambitieux suivent la même logique : un cahier des charges en français, un plan validé, des étapes courtes, une relecture à chaque fois. Le fichier CLAUDE.md s'enrichit, vous accordez les autorisations plus vite, et Claude Code devient un collègue dont vous connaissez les forces et les faiblesses.

Pour aller plus loin : le parcours Claude Code sans coder.