Si vous voulez être votre propre patron, vous devriez vous réserver 30 minutes.
Car aujourd'hui, je vais vous expliquer comment construire un agent IA vraiment fonctionnel en un après-midi, sans aucune connaissance en programmation.
Ne confondez pas ce que je m'apprête à vous dire avec un chatbot. Un chatbot attend une question et donne une réponse. Un agent fonctionne différemment : vous lui donnez un objectif, et il définit lui-même les étapes, lit des fichiers, exécute des commandes et continue tout seul jusqu'à ce que la tâche soit terminée. Vous ne gérez pas chaque mouvement ; vous tracez simplement la route.
Cette différence est importante car vous n'écrivez plus des prompts un par un. Pendant que vous vous occupez d'autre travail, la tâche avance toute seule.
DE QUOI AVEZ-VOUS BESOIN ?
Tout ce dont vous avez besoin avant l'installation se trouve ici :
- Un abonnement Claude payant (Pro, 20 $/mois, inclut Claude Code)
- Mac (macOS), Windows ou Linux
- Une connexion Internet
- 30 à 45 minutes de temps libre
Aucune connaissance en programmation n'est requise. Chaque commande est écrite en entier ; il vous suffira de copier-coller et d'appuyer sur Entrée.
Il n'y a pas de frais supplémentaires. Vous ne dépensez pas un centime en dehors de l'abonnement.
INSTALLATION : APPLICATION DE BUREAU, PAS DE TERMINAL
La façon la plus simple pour un débutant est l'application de bureau. Elle met toute la puissance de Claude Code entre vos mains sans avoir à apprendre le terminal.
Téléchargez l'application de bureau adaptée à votre système d'exploitation via claude.ai. Sur Mac, ouvrez le fichier .dmg et faites glisser Claude dans le dossier Applications ; sur Windows, exécutez l'installateur. Ouvrez l'application, connectez-vous avec votre compte, puis cliquez sur l'onglet Code en haut au centre.
Si l'onglet Code vous demande une mise à niveau de votre forfait, cela signifie que votre forfait actuel ne couvre pas Claude Code. S'il demande une connexion en ligne, effectuez la connexion et redémarrez l'application. Dans les deux cas, vous atterrirez finalement dans un espace de travail vide.
Le succès ici signifie : une zone de saisie vide, un onglet Code actif et aucun message d'erreur. Tout ce que vous construirez à partir de maintenant vivra dans cet espace.
QU'ALLONS-NOUS CONSTRUIRE ?
Nous allons construire un agent unique et clair ; nous procéderons avec le même agent jusqu'à la fin de l'article.
Sa tâche est la suivante : il lira les fichiers texte d'un dossier, trouvera ceux dont le titre est manquant et rédigera un rapport nommé missing-titles.txt listant les fichiers qui doivent être corrigés pour vous.
Une tâche petite mais réelle. Elle inclut les trois choses de base qu'un agent doit faire : lire des fichiers, prendre des décisions et écrire une sortie. Et elle est suffisamment simple pour que vous puissiez vérifier de vos propres yeux si cela fonctionne ou non.
ÉTAPE 1 : CONFIGURATION DU DOSSIER DE TRAVAIL
Créez un dossier nommé my-agent sur votre bureau. L'agent travaillera ici ; il ne pourra voir et toucher que l'intérieur de ce dossier, donc tout reste sécurisé.
À l'intérieur de my-agent, créez un second dossier nommé articles. L'agent cherchera les fichiers qu'il doit vérifier ici.
Créez quatre fichiers texte brut à l'intérieur de articles : post-one.txt, post-two.txt, post-three.txt, post-four.txt. Ouvrez deux d'entre eux et écrivez ceci tout en haut :
Title: My Article
Laissez les deux autres complètement vides. Le travail de l'agent est précisément de trouver ces fichiers vides.
Votre structure de dossiers doit être my-agent/articles/, contenant quatre fichiers .txt, deux avec des titres et deux sans.
ÉTAPE 2 : RÉDIGEZ LE FICHIER D'INSTRUCTION CLAUDE.md
CLAUDE.md est un fichier texte brut que Claude Code lit au début de chaque session. Considérez-le comme les instructions fixes de votre agent, une description de poste qu'il n'oublie jamais.
À l'intérieur du dossier my-agent (pas à l'intérieur d'articles), créez un nouveau fichier nommé CLAUDE.md. Ouvrez-le dans n'importe quel éditeur de texte — Notepad sur Windows, TextEdit sur Mac — et collez ceci exactement :
# My File Check Agent ## Your Task Check every .txt file in the /articles folder.
## What to look for A valid file starts with this line: Title: If the first line does not start with "Title:", the file's title is missing.
## What to do 1. Read every .txt file inside /articles one by one. 2. Note which files have missing titles. 3. Create a file named missing-titles.txt in the main folder. 4. Write each filename that failed the check into this file, one per line. 5. If all files are valid, write "All files have titles." into missing-titles.txt.
## What not to do Do not edit any article files. Only read. Only write to the missing-titles.txt file.
Enregistrez-le. C'est l'intégralité du cerveau de votre agent. Claude Code lira ceci avant toute autre chose.
Le fichier my-agent/CLAUDE.md est créé et contient les instructions ci-dessus, c'est tout.
ÉTAPE 3 : DIRIGEZ CLAUDE CODE VERS LE DOSSIER
Ouvrez l'application de bureau Claude Code, cliquez sur l'icône du dossier ou l'option "Ouvrir un dossier", et accédez au dossier my-agent. Sélectionnez et confirmez.
Claude Code lira automatiquement votre fichier CLAUDE.md. Vous ne verrez aucun message de confirmation ; cela se produit silencieusement en arrière-plan chaque fois que vous ouvrez un dossier.
Si vous utilisez un terminal, ouvrez le terminal et exécutez ceci :
cd ~/Desktop/my-agent claude
La commande cd signifie "change directory" ; elle vous déplace à l'intérieur du dossier my-agent. Taper claude démarre la session à partir de ce dossier.
ÉTAPE 4 : LANCEZ L'AGENT
Tapez exactement ceci dans la zone de saisie en bas de l'interface Claude Code :
Read every .txt file in the articles folder. Find any file missing a Title line at the top. Write the results to missing-titles.txt as instructed in CLAUDE.md.
Appuyez sur Entrée. Et regardez.
Claude Code vous montrera tout ce qu'il fait pendant qu'il travaille : quel fichier 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 étrange.
Claude lit les quatre fichiers, détecte les deux sans titres et crée le fichier missing-titles.txt dans votre dossier my-agent. Lorsque vous l'ouvrez, vous devriez voir les deux noms de fichiers écrits l'un en dessous de l'autre.
ERREUR LA PLUS COURANTE : L'AGENT DIT "TERMINÉ" MAIS LE FICHIER EST VIDE
Cela se produit généralement lorsque l'agent crée le fichier missing-titles.txt mais n'écrit rien à l'intérieur. La raison est presque toujours que l'instruction dans CLAUDE.md est trop vague.
Solution : Ouvrez CLAUDE.md et rendez les instructions de sortie plus concrètes. Au lieu de "Listez les fichiers", écrivez "écrivez chaque nom de fichier sur sa propre ligne, par exemple : post-two.txt." Mettre un exemple concret dans l'instruction rend la sortie concrète à chaque fois.
Si l'agent écrit le mauvais nom de fichier ou en saute un, assurez-vous que vos fichiers articles ont vraiment l'extension .txt, et non .txt.txt. Cela arrive souvent sur Windows lorsque les extensions de fichier sont masquées. Activez "Afficher les extensions de fichier" dans les paramètres de l'Explorateur de fichiers et vérifiez.
ÉTAPE 5 : VÉRIFIEZ ET ÉLARGISSEZ
Ouvrez le fichier missing-titles.txt et vérifiez que les deux fichiers que vous avez laissés vides sont listés. Si c'est correct, cela signifie que votre agent a fonctionné correctement du début à la fin.
Maintenant, vous avez un agent fonctionnel. Il vit dans my-agent, prend ses instructions de CLAUDE.md, et vous pouvez l'exécuter à nouveau avec le même prompt lorsque vous déposez de nouveaux fichiers dans le dossier articles.
La prochaine étape logique : mettez à jour CLAUDE.md et faites-lui également vérifier si chaque fichier fait plus de cinq lignes. Ajoutez ceci sous l'en-tête "What to look for" :
**A valid file also contains content longer than 5 lines. If a file is 5 lines or shorter, also mark it as "too short" next to the title check.**
Exécutez à nouveau l'agent avec le même prompt. Maintenant, il vérifiera deux choses au lieu d'une ; vous n'avez apporté aucune modification à votre prompt, seul le fichier d'instructions a changé.
QU'AVEZ-VOUS FAIT ET POURQUOI EST-CE IMPORTANT ?
Vous avez construit un agent qui lit des fichiers, prend des décisions, écrit une sortie, et fait tout cela sans que vous supervisiez chaque étape. C'est le modèle de base pour chaque agent plus avancé que vous construirez à partir de maintenant.
La partie qui évolue est CLAUDE.md. Chaque nouvelle règle, nouvelle vérification et nouveau format de sortie que vous y ajoutez modifie ce que fait l'agent sans que vous changiez la façon dont vous l'exécutez. Le prompt reste le même, l'instruction évolue.
Les étapes naturelles à partir de là : vérifier plus de types de fichiers, rédiger le rapport dans un format différent comme CSV, ou faire en sorte que la vérification se répète automatiquement à certains intervalles.
Félicitations, vous avez fait le premier pas ; le reste est entre vos mains, proportionnel à votre imagination.
Agissez avant que l'écart ne se creuse.
N'oubliez pas de sauvegarder et de partager, et de soutenir en commentant.
