Comment utiliser Claude Code : tuto débutant en 9 étapes

Comment utiliser Claude Code en cinq temps

L'entreprise de l'exemple est inventée : Muddy Paws Grooming, un salon de toilettage pour chiens. Remplacez-la par la vôtre, ou par celle d'un ami, et vous finirez avec quelque chose d'utile.

Ce qu'il vous faut avant de commencer

• Claude Code installé et connecté. Si ce n'est pas encore fait, suivez d'abord les étapes pour installer Claude Code sur Mac et Windows.
• Un forfait Claude payant, puisque le forfait gratuit n'inclut pas Claude Code. (Le faire tourner sur un modèle ouvert gratuit est possible à titre d'essai : voir Claude Code avec Ollama.)
• Les informations sur l'entreprise : le nom, ce qu'elle vend, trois prestations avec leurs prix, les horaires d'ouverture, le secteur, le numéro de téléphone, un lien de réservation s'il y en a un, et deux ou trois vrais avis clients.
• Deux sessions de travail concentrées : une le samedi pour construire, une le dimanche pour peaufiner.

J'utilise le terminal ci-dessous ; l'onglet Code de l'application de bureau a les mêmes commandes, avec le sélecteur de mode sous la zone de saisie.

Samedi matin : préparer le projet

Étape 1 : lancer Claude Code dans un dossier de projet

Chaque projet a son propre dossier. Claude Code peut lire tout ce qui se trouve dans le dossier où vous le lancez, donc un dossier propre met vos autres fichiers hors de sa portée.

Voici comment lancer Claude Code dans le terminal sur Mac :

$ mkdir -p ~/claude-projects/muddy-paws
$ cd ~/claude-projects/muddy-paws
$ claude
$ 

Sur Windows, dans PowerShell :

PS> mkdir -Force "$HOME\claude-projects\muddy-paws"
PS> cd "$HOME\claude-projects\muddy-paws"
PS> claude
PS> 

Dans l'application de bureau, ouvrez l'onglet Code, cliquez sur le sélecteur d'environnement sous la zone de saisie et choisissez la première entrée sous Local. Cliquez ensuite sur le sélecteur de dossier juste à côté, choisissez Open folder… et sélectionnez le même dossier.

Étape 2 : choisir un mode de permission

Claude Code a des modes de permission : des réglages qui décident des actions qu'il peut faire sans vous demander. Vous passez de l'un à l'autre avec Maj+Tab (Alt+M sur certaines configurations Windows), la ligne sous la zone de saisie affiche le mode en cours, et les versions actuelles démarrent les nouvelles sessions de terminal en mode auto.

Accept edits ou mode auto, c'est la différence qui compte : Accept edits ne saute les questions que pour les modifications de fichiers et les commandes de fichiers simples, alors que le mode auto lance aussi d'autres commandes, après sa vérification de sécurité.

Vous pouvez aussi choisir le mode au démarrage, pour ne jamais commencer en mode auto par accident. Voici de vraies lignes de l'écran d'aide de Claude Code :

Quand Claude Code a besoin de votre accord, il affiche une demande comme celle-ci, tirée d'une vraie session lancée pendant l'écriture de ce guide :

• Yes approuve cette seule action.
• Yes, and don't ask again enregistre une règle : cette commande s'exécute désormais sans demander dans ce projet, alors que les approbations de modifications de fichiers durent jusqu'à la fin de la session.
• Yes, and switch to auto mode confie les approbations courantes au contrôleur en arrière-plan.
• No refuse (Échap fait la même chose). Appuyez sur Tab pour ajouter une note comme « Non : utilise les photos du dossier images », et Claude s'adapte.

Étape 3 : rédiger le brief en mode plan de Claude Code

Le raccourci du mode plan est Maj+Tab : appuyez dessus jusqu'à ce que la barre d'état affiche ⏸ plan mode on, ou tapez /plan au début de votre message. Collez ensuite un brief comme celui-ci, avec vos propres informations :

Je veux un site d'une page pour Muddy Paws Grooming, un salon de toilettage pour chiens à [VILLE].

Public : des propriétaires de chiens pressés qui habitent à proximité et réservent surtout depuis leur téléphone.
Objectif : les amener à toucher « Réserver un toilettage » ([LIEN DE RÉSERVATION]) ou à appeler le [NUMÉRO DE TÉLÉPHONE].

Sections, dans cet ordre :
1. Un titre qui dit ce que nous faisons et où, avec le bouton de réservation
2. Trois prestations avec leurs prix : [PRESTATION ET PRIX] x3
3. Horaires d'ouverture et adresse
4. Deux avis clients : [COLLER DE VRAIS AVIS]
5. Contact : téléphone, e-mail et lien vers une carte

Style : chaleureux et épuré, beaucoup d'espace blanc, du texte en grand, facile à utiliser sur un téléphone.
Contraintes : un fichier index.html et un fichier styles.css. Aucun framework. Aucune photo que je n'ai pas validée.
Terminé signifie : je peux ouvrir index.html dans mon navigateur, tout ce qui précède y figure, et c'est lisible sur un téléphone.

Avant d'écrire quoi que ce soit, pose-moi jusqu'à cinq questions sur ce qui manque, puis propose un plan.

Claude lit le dossier vide, pose ses questions, puis présente un plan : les fichiers qu'il va créer, ce que contient chaque section et ce qu'il lui faut encore de votre part. Appuyez sur Ctrl+G pour modifier le plan dans votre éditeur de texte.

Quand nous avons lancé ce brief avec des informations de test, Claude a posé exactement cinq questions : l'adresse, les horaires d'ouverture, l'e-mail pour la section contact, s'il devait construire le lien de carte à partir de l'adresse, et si nous avions des couleurs de marque ou un logo. Son plan listait les deux fichiers, chaque section dans l'ordre et la façon dont il vérifierait la page en largeur téléphone, plus un bonus facultatif : une barre Réserver et Appeler fixée en bas de l'écran sur téléphone.

Quand nous avons relancé le même brief dans une session interactive, il a regroupé l'adresse et les horaires en une seule question et affiché les questions sous forme d'onglets, chacun avec des réponses suggérées :

Samedi après-midi : construire, regarder, réagir

Étape 4 : approuver la construction pas à pas

Claude crée maintenant index.html, puis styles.css, et avant chaque fichier il montre ce qu'il s'apprête à écrire et attend votre réponse. Approuvez quand c'est conforme au plan, et regardez de plus près toute commande qui supprime des fichiers ou sort du dossier.

Quand il a fini, ouvrez la page en double-cliquant sur index.html dans le Finder ou l'Explorateur de fichiers, ou, sur Mac, tapez ! open index.html dans Claude Code. Le ! au début vous permet de lancer une commande vous-même, sans passer par Claude.

Voici ce qu'a pris notre propre exécution de ce brief, du premier prompt aux deux fichiers terminés :

La page a fonctionné du premier coup, à un détail près. Notre construction tournait en mode Accept edits sans personne au clavier, donc la commande de navigateur que Claude voulait lancer pour une capture en largeur téléphone n'a jamais reçu d'accord : il a sauté cette vérification et nous l'a signalé. Dans une session normale, vous verriez la demande et pourriez l'approuver, une raison de plus de construire votre premier projet en mode manuel.

Lors de notre session interactive, nous avons vu cette demande, nous l'avons approuvée, et Claude a vérifié lui-même la page en largeur téléphone. Son message final nous disait exactement ce qui restait provisoire :

Étape 5 : faire des retours comme un client

C'est là que se joue l'essentiel. Réagissez comme le ferait un client exigeant : court, précis, une chose à la fois.

Taper @ suivi d'un nom de fichier, par exemple @brand.txt, dirige Claude vers ce fichier précis pour qu'il le lise avant d'agir. Pour montrer un problème au lieu de le décrire, faites une capture d'écran et collez-la dans Claude Code avec Ctrl+V dans la plupart des terminaux, Cmd+V dans iTerm2 ou Alt+V sous Windows.

Vous n'avez pas à attendre en silence : tapez une correction et appuyez sur Entrée, et Claude la lit après son étape en cours, ou appuyez sur Échap pour l'arrêter immédiatement.

Étape 6 : annuler la dernière modification avec rewind

Tôt ou tard, une modification empire les choses. Vous avez trois façons de revenir en arrière :

1. Demander. « Annule cette dernière modification » suffit pour les cas simples.
2. Rembobiner. Appuyez deux fois sur Échap avec une zone de saisie vide, ou tapez /rewind (/undo fait la même chose), choisissez le message d'avant le problème, puis ce qu'il faut restaurer.
3. Revenir à une version enregistrée, si vous utilisez git, un outil gratuit qui garde des instantanés nommés d'un projet.

Voici l'écran de rewind d'une session sur un autre projet d'entraînement, après avoir choisi le message où revenir :

Pour un vrai filet de sécurité, demandez-en un. La plupart des Mac ont déjà git ; sous Windows, installez d'abord Git for Windows.

Transforme ce dossier en dépôt git et enregistre la version actuelle avec une description claire de ce qui fonctionne.

Dimanche : rendre le tout solide

Étape 7 : noter ce que vous avez décidé

Enregistrez les décisions prises sur les couleurs, le ton et « toujours vérifier en largeur téléphone » pour ne jamais avoir à les répéter :

Crée un fichier CLAUDE.md pour ce projet avec les informations sur l'entreprise, les règles de style sur lesquelles on s'est mis d'accord, et une règle qui t'oblige à vérifier la page en largeur téléphone avant de dire que tu as fini.

CLAUDE.md est un simple fichier texte que Claude Code lit au début de chaque session dans ce dossier, et les modifications que vous y faites en cours de session prennent effet après /clear ou à la session suivante. La commande intégrée /init en rédige un à partir de ce qu'elle trouve dans le dossier, mais le prompt ci-dessus capture les décisions prises ensemble, qu'une analyse des fichiers ne peut pas voir. Le guide sur le fichier CLAUDE.md montre quoi y mettre, avec des modèles.

Étape 8 : demander une relecture avec preuves

Relis la page comme un client exigeant. Vérifie que chaque section de mon brief est là, que tous les liens et le numéro de téléphone fonctionnent, que le texte est lisible en largeur téléphone, que les images ont un texte alternatif, et qu'aucun nom, prix ou horaire ne diffère de mon brief. Corrige ce que tu peux, puis liste ce que tu as modifié et ce qu'il te faut encore de ma part.

Puis vérifiez vous-même : cliquez sur chaque lien, réduisez la fenêtre à la largeur d'un téléphone, et lisez chaque prix en le comparant à votre grille tarifaire. Si vous avez mis en place git à l'étape 6, /diff montre ce qui a changé depuis la dernière version enregistrée.

Étape 9 : décider où le mettre en ligne

La mise en ligne est un travail à part entière : un nom de domaine, un hébergement et quelques réglages pour que les moteurs de recherche trouvent la page. Le guide pour créer un site avec l'IA couvre la publication avec Claude Code et Vercel.

10 astuces Claude Code pour débutants

1. Un résultat par message. « Mets le bouton de réservation en pleine largeur sur téléphone » vaut mieux qu'un paragraphe de cinq souhaits.
2. Montrez, ne décrivez pas. @styles.css fait lire le bon fichier à Claude au lieu de le laisser le chercher.
3. Laissez-le vous interviewer. Pour tout ce qui dépasse une retouche, terminez par « pose-moi des questions jusqu'à avoir tout ce qu'il te faut ».
4. Planifiez quand vous ne savez pas le dire en une phrase. Sautez le plan pour les petites corrections, où il ne fait qu'ajouter des étapes.
5. Arrêtez tôt. Appuyez sur Échap dès qu'il part dans la mauvaise direction, car attendre ne fait qu'alourdir le nettoyage.
6. Deux échecs, on repart à zéro. Si vous avez corrigé deux fois la même chose, lancez /clear et écrivez un meilleur premier prompt avec ce que vous avez appris.
7. Une tâche par session. Utilisez /clear entre deux travaux sans rapport ; /resume retrouve l'ancienne conversation plus tard.
8. Demandez des preuves, pas des paroles rassurantes. « Liste les fichiers que tu as modifiés » ou « montre-moi d'où vient ce chiffre » vaut mieux que « c'est fini ? ».
9. Gardez les questions annexes à part. /btw répond à une question rapide sans l'ajouter à la conversation principale.
10. Laissez l'outil vous former. /powerup lance de courtes leçons interactives, et notre aide-mémoire Claude Code rassemble les raccourcis utiles sur une seule page.

Problèmes courants et solutions

Les accrocs les plus fréquents chez les débutants, avec la solution pour chacun. Les messages viennent de la référence des erreurs d'Anthropic.

Vous atteignez souvent la limite de session ? Le guide des limites d'usage de Claude Code montre ce qui consomme le plus et comment faire durer votre forfait.

Que faire ensuite

Choisissez un deuxième petit projet pour le week-end prochain, idéalement quelque chose que vous paieriez sinon ou que vous repoussez sans cesse, et reprenez la même boucle : brief en mode plan, construction en mode manuel, relecture avec preuves, et ce que vous avez appris enregistré dans CLAUDE.md. Notre liste d'idées de projets Claude Code propose des options qui vont d'une heure à un week-end. Si vous préférez être guidé sur tout le parcours, la formation Claude Code va de l'installation jusqu'à une landing page publiée, une vidéo IA et un agent de facturation, et notre sélection des meilleures formations Claude Code passe en revue les alternatives gratuites et payantes.