apprenez à installer Claude Code, à écrire votre premier agent de A à Z, et à obtenir un résultat concret : un agent fonctionnel qui lit un dossier, repère les problèmes et rédige un rapport, sans aucune expérience en programmation nécessaire.
un chatbot attend que vous posiez une question et y répond. un agent IA est différent : vous lui donnez un objectif, et il détermine les étapes, lit les fichiers, exécute des commandes et agit de lui-même jusqu'à ce que la tâche soit accomplie. vous ne pilotez pas chaque mouvement. vous définissez la destination.
cette distinction est importante car elle change ce que vous pouvez automatiser. vous ne tapez pas des invites une par une. vous construisez quelque chose qui fait le travail pendant que vous vous concentrez ailleurs.
Ce Dont Vous Avez Besoin Avant de Commencer
voici tout ce qui est nécessaire avant de toucher à une seule commande :
- un compte Claude avec un forfait payant (Pro à 20 $/mois est le minimum ; Claude Code est inclus)
- un Mac sous macOS 13 ou version ultérieure, ou un PC Windows, ou une machine Linux
- une connexion internet
- environ 30 à 45 minutes pour la configuration complète et la première construction
aucune expérience préalable en programmation n'est nécessaire. chaque commande de ce guide est écrite en entier. vous copiez, collez et appuyez sur Entrée.
coût pour suivre ce guide : 0 $ en plus de votre abonnement. Claude Code est inclus dans tous les forfaits Claude payants.
Installer Claude Code (Via l'Application de Bureau, Sans Terminal Requis)
le chemin le plus simple pour un débutant est l'application de bureau. elle vous donne toute la puissance de Claude Code sans avoir à apprendre les commandes du terminal au préalable.
allez sur claude.ai et téléchargez l'application de bureau pour votre plateforme. sur macOS, ouvrez le fichier .dmg et faites glisser Claude dans votre dossier Applications. sur Windows, exécutez l'installateur. lancez l'application, connectez-vous avec votre compte Claude, et cliquez sur l'onglet Code en haut au centre de l'écran.
si l'onglet Code vous demande de mettre à niveau votre forfait, c'est que votre forfait actuel n'inclut pas Claude Code. s'il vous demande de vous connecter en ligne, terminez la connexion et redémarrez l'application. dans les deux cas, vous arriverez dans un espace de travail vierge une fois connecté.
à quoi ressemble le succès : vous voyez une zone de saisie vide avec un onglet Code actif et aucun message d'erreur. c'est votre espace de travail agent. tout ce que vous construisez vit ici.
Ce Que Vous Allez Construire
vous allez construire un agent spécifique, et vous l'utiliserez tout au long de ce guide.
le travail de l'agent : lire un dossier de fichiers texte, trouver tout fichier auquel il manque une ligne de titre en haut, et écrire un rapport appelé \missing-titles.txt\ listant chaque fichier qui nécessite une correction.
c'est une tâche réelle et utile. elle montre chaque comportement fondamental d'un agent : lire des fichiers, prendre des décisions et écrire une sortie. et elle est assez simple pour être vérifiée visuellement quand elle fonctionne.
Étape 1 : Créez Votre Dossier de Travail
créez un nouveau dossier sur votre Bureau appelé \my-agent\. c'est là que l'agent travaillera. il ne peut voir et toucher que les fichiers à l'intérieur de ce dossier, ce qui garde tout en sécurité et contenu.
à l'intérieur de \my-agent\, créez un second dossier appelé \articles\. c'est là que l'agent cherchera les fichiers à vérifier.
créez maintenant quatre fichiers texte bruts à l'intérieur de \articles\. nommez-les \post-one.txt\, \post-two.txt\, \post-three.txt\ et \post-four.txt\. ouvrez deux d'entre eux et ajoutez ceci comme toute première ligne :
\\`
Title: My Article
\\`
laissez les deux autres fichiers complètement vides. le travail de l'agent est de trouver ceux qui sont vides.
à quoi ressemble le succès : la structure de votre dossier est \my-agent/articles/\ et il contient quatre fichiers .txt, deux avec une ligne de titre et deux sans.
Étape 2 : Écrivez le Fichier d'Instructions CLAUDE.md
CLAUDE.md est un fichier texte brut que Claude Code lit au début de chaque session. ce sont les instructions permanentes de votre agent, l'équivalent d'une description de poste qu'il n'oublie jamais.
à l'intérieur du dossier \my-agent\ (pas à l'intérieur de \articles\), créez un nouveau fichier appelé \CLAUDE.md\. ouvrez-le dans n'importe quel éditeur de texte, y compris le Bloc-notes sur Windows ou TextEdit sur Mac, et collez ceci exactement :
\\`
My File Checker Agent
Votre travail
Vérifiez chaque fichier .txt à l'intérieur du dossier /articles.
Que rechercher
Un fichier valide commence par une ligne qui se lit exactement : Title:
Si la première ligne ne commence pas par "Title:", le fichier n'a pas de titre.
Que faire
- Lisez chaque fichier .txt dans /articles un par un.
- Notez quels fichiers n'ont pas la ligne Title.
- Écrivez un fichier appelé missing-titles.txt dans le dossier principal.
- Dans ce fichier, listez chaque nom de fichier qui a échoué au contrôle, un par ligne.
- Si tous les fichiers réussissent, écrivez "All files have titles." dans missing-titles.txt à la place.
Ce qu'il ne faut pas faire
Ne modifiez aucun des fichiers articles. Lisez seulement. Écrivez seulement dans missing-titles.txt.
\\`
enregistrez le fichier. c'est tout le cerveau de votre agent. Claude Code lira ceci avant de faire quoi que ce soit.
à quoi ressemble le succès : vous avez un fichier à \my-agent/CLAUDE.md\ et il contient les instructions ci-dessus.
Étape 3 : Pointez Claude Code Vers Votre Dossier
ouvrez l'application de bureau Claude Code et cliquez sur l'icône du dossier ou l'option "Ouvrir un dossier" pour naviguer vers votre dossier \my-agent\. sélectionnez-le et confirmez.
Claude Code lira votre fichier CLAUDE.md automatiquement. vous ne verrez pas de message de confirmation pour cela, cela se produit silencieusement en arrière-plan chaque fois que vous ouvrez un dossier.
si vous utilisez le terminal au lieu de l'application de bureau, ouvrez votre terminal et exécutez :
\\`bash
cd ~/Desktop/my-agent
claude
\\`
la commande \cd\ signifie "changer de répertoire". elle vous déplace dans votre dossier \my-agent\. taper \claude\ démarre la session de l'agent depuis ce dossier.
Étape 4 : Exécutez l'Agent
dans la zone de saisie en bas de l'interface Claude Code, tapez ceci exactement :
\\`
Lisez chaque fichier .txt dans le dossier articles. Trouvez tout fichier auquel il manque une ligne Title en haut. Écrivez les résultats dans missing-titles.txt comme indiqué dans CLAUDE.md.
\\`
appuyez sur Entrée. regardez ce qui se passe.
Claude Code vous montrera son travail au fur et à mesure : quels fichiers il lit, ce qu'il trouve dans chacun, et ce qu'il écrit. cette transparence est intentionnelle. vous pouvez voir chaque action avant qu'elle ne se produise et l'arrêter si quelque chose semble anormal.
à quoi ressemble le succès : Claude lit quatre fichiers, identifie deux sans titre, et crée \missing-titles.txt\ dans votre dossier \my-agent\. ouvrez ce fichier et vous devriez voir les deux noms de fichiers listés, un par ligne.
Erreur Courante de Débutant : L'Agent Dit Avoir Fini Mais le Fichier est Vide
cela se produit lorsque l'agent écrit \missing-titles.txt\ mais n'y met rien. la cause est presque toujours une instruction CLAUDE.md trop vague.
la solution : ouvrez CLAUDE.md et rendez les instructions de sortie plus explicites. au lieu de "lister les fichiers", écrivez "écrivez chaque nom de fichier sur sa propre ligne, comme ceci : post-two.txt". des exemples concrets dans vos instructions produisent une sortie concrète à chaque fois.
si l'agent écrit les mauvais noms de fichiers ou en oublie un, vérifiez que vos fichiers articles ont bien l'extension \.txt\ et non \.txt.txt\, ce qui peut arriver sur Windows lorsque les extensions de fichier sont masquées. activez "afficher les extensions de fichier" dans les paramètres de votre Explorateur de fichiers pour vérifier.
Étape 5 : Vérifiez et Étendez
ouvrez \missing-titles.txt\ et confirmez qu'il liste exactement les deux fichiers que vous avez laissés vides. si c'est le cas, votre agent a fonctionné correctement de bout en bout.
vous avez maintenant un agent fonctionnel. il vit dans \my-agent\, il lit depuis \CLAUDE.md\, et il peut être exécuté à tout moment lorsque vous déposez de nouveaux fichiers dans le dossier \articles\ et exécutez la même invite.
la prochaine étape évidente : mettez à jour CLAUDE.md pour également vérifier que chaque fichier fait plus de cinq lignes. ajoutez ceci sous "Que rechercher" :
\\`
Un fichier valide a également plus de 5 lignes de contenu.
Si un fichier a 5 lignes ou moins, signalez-le comme "trop court" en plus du contrôle du titre.
\\`
exécutez à nouveau l'agent avec la même invite. il vérifiera maintenant deux choses au lieu d'une, sans aucun changement dans votre invite, juste un changement dans le fichier d'instructions.
Ce Que Vous Venez de Construire et Pourquoi C'est Important
vous avez construit un agent qui lit des fichiers, prend des décisions et écrit une sortie, sans que vous supervisiez chaque étape. c'est le modèle central derrière chaque agent plus avancé que vous construirez jamais.
le fichier CLAUDE.md est la partie qui passe à l'échelle. chaque nouvelle règle, nouveau contrôle ou nouveau format de sortie que vous y ajoutez change ce que l'agent fait sans que vous changiez la façon dont vous l'exécutez. l'invite reste la même. les instructions évoluent.
à partir de là, les extensions naturelles sont : vérifier plus de types de fichiers, écrire le rapport dans un format différent comme CSV, ou exécuter la vérification selon un calendrier en utilisant la fonctionnalité Routines intégrée de Claude Code.
des questions sur une étape ? déposez-les ci-dessous.
