Première utilisation : Faites tourner votre premier exemple
📚 Navigation de la série : L'article précédent 06 Coding Plan : Formules d'abonnement et Facturation vous a aidé à comprendre la question de l'argent. Cet article passe à la pratique - depuis l'ouverture du terminal jusqu'à la réussite de la première tâche, pour vous offrir votre premier « succès ».
Les amis, les articles précédents n'étaient que de la préparation : installation, connexion, choix du forfait.
L'outil est là, mais vous appréhendez peut-être encore un peu : Comment ça s'utilise au juste ? J'ouvre le terminal, et ensuite ?
Pour être honnête, la première fois que l'on lance Claude Code, beaucoup restent bloqués près d'une minute devant le curseur clignotant, sans savoir quoi taper. De peur qu'une phrase maladroite ne ruine le code.
Ne stressez pas. Aujourd'hui, nous allons suivre le processus le plus simple : créer un petit projet de quelques lignes de code, demander à Claude de le comprendre, puis de modifier une ligne. Le tout en moins de cinq minutes, et vous obtiendrez votre première expérience réussie « Claude m'a aidé à modifier le code et il l'a bien fait ». C'est suffisant : une fois que ça marche une fois, la suite viendra naturellement.
Après avoir lu cet article, vous obtiendrez :
- Une séquence complète d'actions, de l'ouverture du terminal à l'exécution de la première tâche, qu'il suffit de suivre pas à pas
- Comprendre chaque partie de l'« écran de bienvenue » qui s'affiche au lancement de Claude Code
- Un exercice pratique de niveau « Hello World » qui fonctionne et donne le résultat attendu
- Quelques rappels cruciaux pour « ne pas tomber dans les pièges la première fois » (comment accorder les permissions, comment annuler les erreurs)
01 Créer d'abord un « Projet Jouet »
Conclusion immédiate : Pour votre première utilisation, n'utilisez pas votre vrai projet, créez un projet jouet.
Pourquoi ? Parce qu'un vrai projet contient de nombreux fichiers et dépendances complexes. Claude va lire pendant un moment, et vous ne comprendrez pas clairement ce qu'il fait. Un projet jouet ne contient que deux ou trois fichiers, ce qu'il modifie saute aux yeux — c'est ainsi que l'on apprend.
Analogie : Apprendre à conduire sur un parking vide. Personne ne prend l'autoroute juste après avoir obtenu son permis. On cherche d'abord un espace vide, on se familiarise avec l'accélérateur et le frein, on apprend combien il faut braquer le volant pour tourner. Le projet jouet, c'est votre parking : Si vous le cassez, ce n'est pas grave, il suffit d'en recréer un autre.
Pour ceux qui n'ont jamais utilisé la ligne de commande, quiconque s'exerce pour la première fois avec le projet de l'entreprise finit par paniquer — le simple défilement de l'écran pendant que Claude lit les fichiers suffit à donner des sueurs froides. Changez de méthode : créez d'abord un petit fichier de trois lignes de code, faites tout fonctionner en cinq minutes, et la confiance viendra immédiatement.
Ouvrez votre terminal (sur Mac c'est « Terminal », sur Windows il est recommandé d'utiliser Git Bash ou PowerShell), et tapez ces quelques lignes :
mkdir hello-claude
cd hello-claudeCes deux lignes signifient : Créer un dossier nommé hello-claude, puis y entrer. mkdir = make directory (créer un dossier), cd = change directory (entrer dans le dossier).
Ensuite, créez un fichier Python très simple. Sur Mac / Linux, utilisez :
echo 'def add(a, b):
return a + b' > main.pyDans Windows PowerShell, écrire plusieurs lignes avec echo est un peu fastidieux, vous pouvez simplement ouvrir le Bloc-notes, créer un main.py, y coller ces deux lignes et sauvegarder :
def add(a, b):
return a + b💡 En un mot : La première fois que vous utilisez Claude Code, créez d'abord un projet jouet de deux ou trois lignes comme « terrain de conduite », si ça casse vous reconstruisez, sans stress ni panique.
02 Lancer Claude, comprendre l'écran de bienvenue
Le projet est créé, maintenant lancez Claude Code dans le même dossier. Assurez-vous que votre terminal se trouve dans le répertoire hello-claude (vous y êtes toujours si vous venez de faire cd), et tapez :
claudeAttention : Il faut absolument lancer claude dans le répertoire du projet, ne le lancez pas depuis le Bureau ou votre répertoire personnel. En effet, Claude Code considère le répertoire où vous vous trouvez comme son espace de travail : là où vous le lancez, c'est là qu'il lira les fichiers. C'est le premier piège dans lequel tombent les débutants : ils le lancent depuis le répertoire principal, puis demandent « que fait ce projet », et Claude est perdu car le répertoire principal n'est pas un projet.
Analogie : Inviter un artisan pour des rénovations, il faut d'abord l'amener dans la maison à rénover. Vous ne pouvez pas lui expliquer au portail de la résidence, il doit être à l'intérieur pour savoir quel mur abattre ou où faire passer les câbles. Faire un cd dans le répertoire du projet puis lancer claude, c'est « faire entrer l'artisan ».
Au lancement, vous verrez un écran de bienvenue. Selon la documentation officielle, il affiche les informations de votre session, les conversations récentes et les dernières mises à jour. Pour un débutant, il vous suffit de repérer trois éléments :
| Ce que vous voyez | Ce que c'est | Ce que vous devez faire |
|---|---|---|
| La zone de saisie / Le curseur tout en bas | L'endroit où vous parlez à Claude | Tapez simplement du texte et appuyez sur Entrée pour envoyer |
L'indice pour /help | Voir toutes les commandes disponibles | Tapez-le si vous oubliez une commande |
L'indice pour /resume | Continuer une conversation précédente | Ignorez-le pour la première utilisation |
La zone de saisie est le champ de bataille principal. Vous n'avez pas besoin d'apprendre une syntaxe spéciale, considérez-la comme une fenêtre de discussion capable de lire votre code — exprimez vos besoins en langage naturel.
Pour vérifier que vous êtes au bon endroit, posez-lui la question la plus simple :
Que fait ce projet ?Claude ira lire de lui-même les fichiers du répertoire actuel (ici main.py), puis vous expliquera l'objectif du projet. Pendant tout ce processus, vous n'avez pas besoin de lui « donner » manuellement les fichiers — la documentation officielle est claire : Claude Code lit les fichiers du projet selon ses besoins, vous n'avez pas à ajouter de contexte manuellement.
💡 En un mot : Lancez
claudedans le répertoire du projet, repérez « la zone de saisie +/help» et c'est parti ; Il lit les fichiers de lui-même, il vous suffit de formuler vos demandes en langage clair.
03 Demander d'abord à Claude d'expliquer le code
La première vraie tâche n'est pas de lui demander de modifier du code, mais de l'expliquer.
Pourquoi l'explication en premier ? Pour deux raisons : Premièrement, pour vous assurer que Claude a bien lu votre fichier (et n'invente pas des choses) ; Deuxièmement, les tâches d'explication sont à risque zéro — il ne fait que lire et parler, il ne touchera à aucune virgule, c'est idéal pour un premier essai.
Analogie : Le premier jour d'un nouveau collègue, vous ne lui confiez pas le remaniement du module principal. Vous lui dites plutôt « Lisez le code et expliquez-moi à quoi sert cette partie ». En l'écoutant, vous saurez s'il a compris et s'il est fiable. Demander à Claude d'expliquer le code, c'est cette action du « premier jour ».
Dans la zone de saisie, tapez :
Explique ce que fait le fichier main.py, en utilisant des termes simples pour un débutantAppuyez sur Entrée. Claude va lire main.py et vous répondre en termes simples, en gros : Il définit une fonction add qui prend deux paramètres a et b, et renvoie la somme des deux.
Si cette étape réussit, deux choses sont confirmées : Claude Code est bien installé, la connexion est normale, et il lit effectivement vos vrais fichiers. Les bases sont solides, vous pouvez maintenant lui demander de modifier quelque chose en toute sérénité.
Classez les commandes pour Claude Code en trois catégories, et vous saurez comment l'utiliser :
| Type de commande | À quoi ça sert | Exemple | Risque |
|---|---|---|---|
| Explicative | Lui demander de lire et d'expliquer | « Explique ce code » | Zéro risque, ne touche pas aux fichiers |
| Modificatrice | Lui demander de modifier du code existant | « Refactorise cette fonction » | Touche aux fichiers, nécessite une approbation |
| Générative | Lui demander d'écrire du nouveau contenu | « Ajoute un cas de test » | Crée / modifie des fichiers, nécessite une approbation |
💡 En un mot : Pour la première tâche, essayez une commande « explicative » — Confirmez qu'il lit bien vos fichiers, assurez vos arrières, puis laissez-le agir.
04 Demander à Claude de modifier une ligne de code (Crucial : Il vous demandera d'abord)
Nous atteignons maintenant le point culminant : Demander à Claude de modifier réellement le code.
À la suite de la conversation précédente, tapez directement :
Ajoute des annotations de type à cette fonction, et ajoute une gestion des erreurs de baseÀ ce moment-là arrive la scène la plus importante — Claude ne va pas modifier directement votre fichier. Il va :
- Trouver le fichier à modifier (ici
main.py) - Vous montrer ce qu'il a l'intention de modifier, sous la forme d'un diff (comparaison des différences)
- S'arrêter et attendre votre approbation
- Si vous cliquez sur « Accepter (Yes) », il enregistre la modification
C'est une règle d'or sans cesse répétée dans la documentation officielle :
Claude Code demande toujours la permission avant de modifier des fichiers. Vous pouvez approuver une seule modification, ou activer le mode « Tout accepter » pour la session en cours.
Analogie : Le stagiaire qui demande avant d'agir. Un stagiaire fiable ne modifiera pas le code de production sans votre accord — il viendra avec son brouillon : « Chef, je voudrais modifier ça comme ça, c'est bon ? » Vous hochez la tête et il s'exécute. Par défaut, Claude Code est ce stagiaire « qui demande avant d'agir ».
Vous verrez une invite avec des choix, dont la signification est généralement la suivante :
| Votre choix | Effet | Quand l'utiliser |
|---|---|---|
| Accepter / Yes | Appliquer cette modification | Vous avez compris le diff, ça vous semble correct |
| Accepter et ne plus demander pour cette session | Les futures modifications seront appliquées automatiquement | Vous lui faites confiance, vous voulez aller plus vite |
| Refuser / No, et lui dire pourquoi | Ne pas modifier, vous pouvez ajouter des exigences | Il y a quelque chose que vous ne voulez pas dans le diff |
Pour la première fois, je vous recommande vivement de rester sage et de choisir « Accepter », ne vous précipitez pas sur le « Tout accepter ». Pour être honnête, quand on débute, on veut souvent aller vite et on donne les permissions maximales (comme avec --dangerously-skip-permissions que nous verrons plus tard, qui « saute dangereusement les permissions »). Résultat : il modifie cinq ou six fichiers sans que vous ayez regardé attentivement, et quand vous vous en rendez compte, vous ne savez plus ce que vous vouliez et ce qu'il a ajouté de sa propre initiative. La leçon est simple : Moins vous êtes familier, plus vous devez le faire avancer pas à pas.
Petite astuce pour lire un diff : Les lignes en rouge ou commençant par - sont les anciennes lignes supprimées, celles en vert ou commençant par + sont les nouvelles lignes ajoutées. Votre main.py passera d'environ ceci :
def add(a, b):
return a + bÀ quelque chose comme cela (la syntaxe exacte de Claude peut varier, tant que le sens est là) :
def add(a: float, b: float) -> float:
if not isinstance(a, (int, float)) or not isinstance(b, (int, float)):
raise TypeError("a et b doivent être des nombres")
return a + bIl a ajouté des annotations de type (a: float) et une gestion des erreurs de base (renvoie une erreur si ce n'est pas un nombre). À ce moment précis, vous venez de réaliser votre première « modification de code en collaboration homme-machine ».
💡 En un mot : Avant de modifier un fichier, Claude vous demandera toujours votre avis — pour la première fois, choisissez sagement « Accepter » après avoir compris le diff, ne cédez pas à la tentation du mode automatique.
05 Comment faire en cas d'erreur : Deux « pilules magiques »
La plus grande peur des débutants est : Que se passe-t-il s'il se trompe, s'il met le désordre, et que je ne m'en rends pas compte ? Comment réparer ?
Rassurez-vous, il existe deux solutions pour revenir en arrière, et elles sont très pratiques.
La première : Dites-lui directement « Remets comme avant » dans le chat. Claude se souvient de ce qu'il a fait pendant la session. Si vous n'êtes pas satisfait, dites-lui en termes simples :
Je ne suis pas satisfait de la dernière modification, remets-la comme avantIl va annuler la modification. Analogie : Dire à un collègue « Ta dernière version ne va pas, on reprend l'ancienne » — pas besoin de corriger ligne par ligne vous-même.
La deuxième : Utiliser les points de contrôle (Checkpoint) pour revenir en arrière. C'est le système de « sauvegarde de jeu » de Claude Code — il enregistre automatiquement l'état du fichier avant chaque modification, et vous pouvez y revenir en un clic.
Analogie : Sauvegarder et charger une partie de jeu vidéo. Vous sauvegardez avant le boss, si vous perdez, pas besoin de tout recommencer, il suffit de charger la sauvegarde. Les points de contrôle sont des sauvegardes que Claude crée discrètement avant d'agir.
Comment les déclencher ? Selon la documentation officielle :
/rewindOu quand la zone de saisie est vide, appuyez deux fois de suite sur la touche Échap (Esc), cela fera apparaître le menu de retour en arrière.
⚠️ Un détail (explicitement mentionné dans la doc) : Si la zone de saisie contient du texte, appuyer deux fois sur Échap effacera le texte et n'ouvrira pas le menu de retour en arrière. Assurez-vous que la zone de saisie est vide avant de revenir en arrière.
Il y a une autre chose à bien comprendre : Les points de contrôle ne peuvent annuler que les modifications effectuées par Claude avec ses outils d'édition, ils ne remplacent pas Git. Le conseil officiel est très pertinent :
Considérez les checkpoints comme une « annulation locale », et Git comme un « historique permanent ».
Autrement dit, les points de contrôle sont bons pour se rattraper immédiatement sur un « Oups, cette étape est ratée, retour en arrière » ; la vraie progression, c'est avec un commit Git qu'elle doit être sauvegardée (nous verrons Git en détail plus tard).
| Pilule magique | Comment l'utiliser | Scénario adapté | Limite |
|---|---|---|---|
| Dire « Remets comme avant » | Taper dans le chat | Juste après la modif, une ou deux choses à changer | Dépend de sa compréhension |
Point de contrôle /rewind | Taper /rewind ou double-Échap (si vide) | Pour revenir à un état précis | Uniquement les modifs de Claude, pas Git |
💡 En un mot : Pas de panique en cas d'erreur, un simple « remets comme avant » ou un point de contrôle
/rewindvous sauvent ; mais la vraie progression doit être archivée avec Git.
06 Pratique : Cinq minutes pour réussir votre première tâche
La théorie ne suffit pas, place à la pratique. Voici une séquence complète que vous pouvez suivre pas à pas, avec des résultats prévus. Ouvrez le terminal et suivez le guide.
Première étape : Créer le projet jouet (Mac / Linux)
mkdir hello-claude
cd hello-claude
echo 'def add(a, b):
return a + b' > main.pyUtilisateurs Windows : Tapez mkdir hello-claude et cd hello-claude, puis créez main.py avec le Bloc-notes et collez-y le code Python.
Résultat attendu : Le dossier hello-claude contient un main.py avec les deux lignes de la fonction add. Vous pouvez taper ls (Windows : dir) pour confirmer la présence du fichier.
Deuxième étape : Lancer Claude Code
claudeRésultat attendu : L'écran de bienvenue apparaît avec la zone de saisie en bas. Si on vous demande de vous connecter, reprenez les étapes de connexion de l'article 02.
Troisième étape : Lui demander d'expliquer le code
Dans la zone de saisie :
Explique ce que fait le fichier main.py, en utilisant des termes simples pour un débutantRésultat attendu : Claude lit main.py et vous explique en termes simples qu'il s'agit d'une fonction qui « additionne deux nombres ». Le voir expliquer avec précision le rôle de la fonction add = succès.
Quatrième étape : Lui demander de modifier le code et approuver
Ajoute des annotations de type à cette fonction, et ajoute une gestion des erreurs de baseRésultat attendu : Claude affiche un diff (rouge - ancienne ligne, vert + nouvelle ligne), et attend votre choix. Après avoir compris, choisissez « Accepter / Yes ».
Cinquième étape : Confirmer les modifications
Quittez Claude (tapez exit ou appuyez sur Ctrl+D), revenez au terminal et regardez le fichier :
cat main.py(Sur Windows PowerShell, utilisez type main.py)
Résultat attendu : main.py contient désormais les annotations de type (comme a: float) et la gestion d'erreur (raise TypeError(...)). Si cela correspond au diff que vous avez approuvé = l'ensemble du processus est un succès, félicitations !
⚠️ Si vous êtes bloqué par une erreur de permission (sur Mac / Linux, du genre
Error: EACCES: permission denied), la solution dépend du contexte et sera détaillée dans la section « Problèmes fréquents », sachez simplement que c'est un piège possible.
💡 En un mot : Suivez les cinq étapes, réussir à aller jusqu'au bout est plus important que de tout comprendre — obtenez cette première expérience réussie « Claude m'a aidé à bien modifier le code », la suite viendra naturellement.
07 Résumé
Dans cet article, vous avez fait une chose : Vous avez accompli de bout en bout votre première tâche avec Claude Code — de la création du projet au lancement, de l'explication du code à sa modification et approbation.
Revue des actions clés :
| Étape | Action | Point clé |
|---|---|---|
| Créer le projet | mkdir + cd + création de fichier | S'exercer d'abord sur un projet jouet |
| Lancement | Taper claude dans le dossier du projet | Il lit là où vous le lancez |
| Explication | « Explique le fichier xxx » | Zéro risque, vérifier qu'il a bien lu |
| Modification | Décrire le besoin en langage naturel | Il donne le diff et attend votre accord avant d'agir |
| Annulation | « Remets comme avant » / /rewind | Le point de contrôle est l'annulation locale, Git est l'historique permanent |
Vous devriez maintenant être capable de : Ouvrir le terminal, lancer Claude dans le bon dossier, lui demander d'expliquer et de modifier du code en langage naturel, comprendre le diff proposé, et savoir comment revenir en arrière en cas d'erreur. Cette séquence d'actions sera le cœur de toutes vos futures utilisations de Claude Code — les fonctionnalités plus complexes ne seront que des ajouts à cette boucle « demande → diff → approbation / annulation ».
L'article suivant, 08 « Intégration VS Code » — Vous avez maîtrisé la ligne de commande, mais vous préférez peut-être écrire du code dans votre éditeur, où les diffs sont plus clairs. Dans le prochain article, nous vous montrerons comment intégrer Claude Code à VS Code, pour qu'il travaille côte à côte avec votre code.