La plupart des utilisateurs de Claude Code négligent le seul fichier que l'IA lit toujours avant de commencer une tâche.
Ce fichier s'appelle « CLAUDE.md ».
La documentation officielle d'Anthropic le précise clairement : si un fichier CLAUDE.md existe dans le dossier, Claude Code le chargera toujours avant de commencer à travailler, même si vous ne le lui demandez pas.
En d'autres termes, ce que vous écrivez ici modifie le comportement initial de l'IA à 100 %. Alors que vous devez retaper vos instructions à chaque fois, CLAUDE.md fonctionne pour toutes les conversations une fois qu'il est rédigé.
L'effet de levier est d'un tout autre niveau.
À l'inverse, si vous n'organisez pas ce fichier, peu importe à quel point vous peaufinez vos instructions, les bénéfices seront quasi nuls. L'IA déviera à chaque fois. Vous devrez réexpliquer les prémisses à chaque fois. Même pour une tâche identique, la qualité variera d'un jour à l'autre. La cause n'est ni le modèle ni votre compétence en matière d'instructions, c'est ce fichier.
Aujourd'hui, je vais vous révéler exactement « quoi et comment écrire » dans CLAUDE.md, avec des exemples prêts à être copiés-collés.
Pour ceux dont les performances sont médiocres, CLAUDE.md n'est qu'un « pense-bête »
Pour être honnête, j'ai moi aussi eu du mal au début.
Pendant un moment sur X, il y avait beaucoup d'articles disant « le contenu du dossier est important » ou « CLAUDE.md est important ». Je les ai vus et j'ai ouvert mes dossiers.
Le contenu était en désordre.
Je ne savais pas où se trouvait quoi. Des données similaires étaient éparpillées un peu partout. L'IA ne trouvait pas les connaissances dont elle avait besoin, et à chaque fois qu'elle générait une sortie, ce n'était pas la réponse que je voulais.
CLAUDE.md était pareil. Les règles pour savoir où enregistrer quoi n'étaient pas finalisées. Je ne comprenais même pas ce qu'était CLAUDE.md au départ. Alors, je me contentais d'ajouter des instructions par le haut au fur et à mesure qu'elles me venaient à l'esprit.
En conséquence, il a atteint 300 ou 400 lignes. Il dépassait facilement les 200 lignes.
Il est recommandé de garder CLAUDE.md à 200 lignes maximum.
Un CLAUDE.md trop long devient un « long texte où l'IA ne sait pas ce qui est important ».
Dans cet état, l'IA relit l'intégralité du fichier à chaque fois et essaie de deviner : « Alors, quelle partie s'applique à cette tâche ? » Quand il y a des suppositions, l'incohérence s'ensuit. Naturellement.
CLAUDE.md n'est pas un « bloc-notes ». C'est une « carte pour le jugement » à laquelle l'IA se réfère à chaque fois. Changer votre perception de cela, c'est déjà la moitié de la bataille.
N'écrivez que ces 5 choses dans CLAUDE.md
Inutile de trop compliquer les choses. Un centre de commandement solide contient invariablement ces cinq éléments :
- ① Règles prioritaires : La déclaration principale à suivre avant toute sortie
- ② Table de routage Mot-clé → Emplacement : Quels travaux vont où
- ③ Arbre de décision pour les emplacements : Comment juger les éléments qui ne sont pas dans le tableau
- ④ Gestion des tâches : Comment et où enregistrer ce qui doit être fait
- ⑤ Gestion des informations confidentielles : Définir la limite de ce qui ne doit pas être partagé
Lorsque ces cinq éléments sont en place, l'IA cesse de « deviner » et commence à « se référer ». La racine de l'incohérence disparaît.
Voyons maintenant comment écrire chacun d'eux avec des exemples concrets.
Réglage ① Déclarez les « Règles prioritaires » en haut
La toute première chose à écrire est une déclaration pour fixer le mouvement initial de l'IA. C'est un avertissement : « Avant de penser, suivez d'abord les règles ci-dessous. »
▼ Exemple d'écriture
Priorité : Avant de produire ou d'enregistrer quoi que ce soit, vérifiez toujours les règles ci-dessous avant d'agir. Les emplacements doivent être déterminés à l'aide du « Tableau des mots-clés » et de l'« Arbre de décision » ci-dessous. Si vous ne pouvez pas décider, n'avancez pas seul ; posez une question.
En plaçant simplement cela en haut, l'IA cesse de « bouger les mains sans réfléchir ». Elle commence à vérifier les règles à chaque fois avant d'agir. Cela fixe le point de départ.
Réglage ② Incluez un tableau de correspondance « Mot-clé → Emplacement »
La chose la plus efficace ensuite est un tableau de répartition du travail. Liez « si cette demande arrive, mettez-la ici / regardez ici » en utilisant des mots-clés.
▼ Exemple d'écriture
Mot-clé → Emplacement ・Blog/Articles → Publication/Blog/ ・Dépenses/Reçus → Comptabilité/Justificatifs/ ・Comptes rendus/Notes de réunion → Archives/Comptes rendus/
L'astuce est de l'écrire exactement avec les mots que vous utilisez habituellement. L'IA regarde les mots dans le tableau et peut choisir l'emplacement sans hésitation.
Le conseil pour l'axe de répartition est de couper par « fonction (tâche) » plutôt que par « activité ». Ainsi, même si les activités ou les produits augmentent, le tableau ne se brisera pas.
Réglage ③ Incluez un « Arbre de décision » pour quand il est perdu ← C'est le plus efficace
Parmi les cinq, c'est celui qui a le plus d'impact. Comment gérer les choses qui ne sont pas dans le tableau ou qui sont ambiguës.
Les humains comme l'IA s'arrêtent quand ils sont perdus. Ils dévient parce qu'ils sont perdus. Alors, éliminez simplement la place à l'hésitation. Laissez-les suivre un chemin OUI/NON depuis le début.
▼ Exemple d'écriture
Avant d'enregistrer, suivez ces étapes dans l'ordre : Q1. S'agit-il d'informations confidentielles (clés API/mots de passe) ? → OUI : Aller dans .env. Fin. Q2. S'agit-il de données brutes juste téléchargées de l'extérieur ? → OUI : Aller dans Assets/. Q3. De quel travail s'agit-il ? → Aller dans l'un des dossiers : Publication / Ventes / Comptabilité / Archives. → Si un seul emplacement ne peut pas être déterminé à la fin, n'avancez pas ; posez exactement 2 questions.
Alors, comment le comportement change-t-il avant et après l'ajout d'un arbre de décision ? Concrètement, de deux manières.
Changement 1 : Il effectue la même action pour la même demande à chaque fois.
Claude Code fonctionne sur la probabilité. Il ne se souvient pas de la conversation précédente lorsque le chat change. Donc, sans arbre de décision, même pour la même demande « enregistrer le compte rendu », il fluctue.
Sans arbre de décision :
- 1ère fois → Enregistré dans Meeting/
- 2ème fois → Memo/Comptes rendus/
- 3ème fois → Pour une raison quelconque, le dossier Assets
Avec un arbre de décision :
- À chaque fois, il suit le même chemin : Q1→Q2→Q3 → Toujours au même endroit
Le comportement passe d'une « fluctuation probabiliste » à une « procédure fixe ». La reproductibilité signifie que vous pouvez construire dessus.
Changement 2 : Il cesse de faire des erreurs avec excès de confiance quand il est perdu.
Le comportement le plus effrayant de l'IA est d'« avoir tort avec confiance ». Comme jeter un enregistrement vidéo et le compte rendu qui en est tiré au même endroit.
- Le forcer à passer par la supposition → ❌
- S'arrêter et vérifier avec 2 questions → ✓
La dernière ligne est subtilement efficace. En écrivant simplement « Si vous ne pouvez pas décider, ne vous précipitez pas, demandez », vous réduisez structurellement la production en masse de livrables hors cible.
Plus l'IA est intelligente, meilleures sont ses performances lorsqu'on lui donne un « modèle » plutôt qu'une liberté totale.
Réglages ④ et ⑤ Gestion des tâches et Confidentialité
Les deux autres peuvent être courts. Mais vous devez les écrire.
④ Fixez « où et comment laisser » les tâches. Sans cela, les choses à faire se dispersent à chaque conversation.
▼ Exemple d'écriture
Gestion des tâches ・Consolider toutes les tâches à faire dans un seul fichier « tasks.md ». ・Une fois terminé, ne pas supprimer ; déplacer dans « Terminé » et laisser un résultat d'1 ligne.
⑤ Écrivez clairement les limites des informations confidentielles. C'est la bouée de sauvetage pour la prévention des accidents.
▼ Exemple d'écriture
Informations confidentielles ・Écrire les clés API/mots de passe uniquement dans .env. ・Ne jamais les coller dans les chats, le code ou les enregistrements.
Avec ces deux éléments, les tâches ne se dispersent pas et les choses qui ne devraient pas sortir restent à l'intérieur. Ils fonctionnent comme vos deux boucliers défensifs.
Gardez CLAUDE.md à « moins de 200 lignes ». S'il déborde, déplacez-le dans un autre fichier.
Certains d'entre vous ont peut-être réalisé que si vous écrivez tout dans CLAUDE.md, il deviendra de plus en plus long.
C'est exact. C'est important. Si vous rendez CLAUDE.md trop long, il devient en fait moins efficace. Comme l'IA lit ce fichier du début à la fin à chaque fois, s'il est trop long, le sens de « ce qui est important » se dilue.
La ligne directrice est de moins de 200 lignes.
Si cela ne tient pas, déplacez les règles détaillées dans un fichier séparé (par exemple, « regles_detail.md »). Ensuite, en haut de CLAUDE.md, donnez des instructions sur « quand le lire ».
▼ Exemple d'écriture (Ajoutez simplement une ligne à la déclaration du haut)
Priorité : Avant de produire/enregistrer, suivez toujours les règles ci-dessous. Lire « regles_detail.md » uniquement lors de la rédaction d'un article de blog.
L'astuce ici est d'ajouter une condition comme « seulement quand... » plutôt que « toujours lire ». Ainsi, l'IA n'ouvrira pas ce fichier pour des tâches non liées, mais pour les tâches nécessaires, elle suivra le chemin « CLAUDE.md → regles_detail.md ».
Cela permet de garder le corps principal léger tout en vous permettant d'ajouter autant de règles détaillées que vous le souhaitez. Le principe est d'en faire un système d'appel à la demande.
CLAUDE.md est « l'Entrée et le Commandant », et les détails sont « des fichiers séparés appelés à la demande ». Si vous retenez cette division des rôles, vos règles ne s'effondreront pas, quelle que soit leur augmentation.
Pour être honnête, cela ne deviendra pas une bête différente d'un seul coup
Je vais être honnête ici.
J'ai réorganisé un fouillis de 300 à 400 lignes en 5 blocs. Après cela, la première chose que j'ai ressentie n'a pas été un « changement dramatique ».
D'abord, il a simplement cessé de se perdre. C'est tout.
Le monde ne change pas d'un seul coup. Cela s'installe progressivement. Il renvoie le même mouvement pour la même demande, les résultats hors cible diminuent et les connaissances s'accumulent. Avant de vous en rendre compte, il se déplace comme une bête différente. C'est ainsi que cela fonctionne.
Si vous vous attendez à une magie flashy, vous serez déçu. Mais la reproductibilité s'accumulera définitivement.
Résumé : Pour ceux qui pensent que tout faire est une corvée
Ne réfléchissez pas trop. Ce que vous devez faire aujourd'hui, c'est ouvrir votre CLAUDE.md (ou en créer un si vous n'en avez pas). C'est tout.
Pour ceux qui trouvent que tout faire est une corvée, voici la liste de priorités avec des estimations de temps :
- 5 premières minutes : Écrivez 3 questions pour l'③ Arbre de décision (Le plus gros impact)
- +7 minutes : Ajoutez les ① Règles prioritaires et le ② Tableau de routage
- +3 minutes : Ajoutez les limites pour la ④ Tâche et la ⑤ Confidentialité
Total 15 minutes. Cela les alignera dans l'ordre ①→②→③→④→⑤. Si cela semble dépasser 200 lignes, déplacez les détails dans un fichier séparé et faites-le lire depuis le haut. C'est tout.
Vous n'avez pas besoin de trop en mettre. Organisez-le simplement. Avec cela seulement, le même Claude Code que vous utilisiez hier commencera à se déplacer comme quelque chose d'entièrement différent.
Les personnes qui veulent améliorer les performances de Claude Code cherchent toujours des techniques d'instructions. Mais le véritable effet de levier est en amont. C'est le seul fichier que l'IA lit en premier à chaque fois.
La différence entre les 5 % du haut et les 95 % restants n'est pas le talent ou la compétence en matière d'instructions. C'est simplement le fait d'avoir organisé un fichier CLAUDE.md ou de l'avoir laissé tranquille.
Commencez par copier et coller les 3 questions de l'arbre de décision de cet article.
Pour finir
Pour finir, laissez-moi vous avouer une chose.
Les diapositives que je publie habituellement sont toutes fabriquées par l'IA. Je n'ai plus une seule diapositive faite à la main.
Et aujourd'hui, je donne l'IA qui peut les fabriquer avec exactement la même qualité.
Si vous avez lu jusqu'ici, vous avez probablement déjà réalisé. Tout ce dont j'ai parlé dans cet article se résume à une chose :
« Ne laissez pas l'IA se perdre. »
L'IA n'échoue pas parce que ses capacités sont faibles. Elle échoue parce qu'elle est perdue.
Donnez-lui du contexte. Concevez les instructions. Ne laissez aucune place à l'IA pour se demander. En d'autres termes, formez-la comme un secrétaire. Dans cet article, nous l'avons fait avec Claude Code.
Ce que je vais distribuer est un ChatGPT GPTs. Pour être clair : le texte principal parlait de Claude Code, et ceci est un ChatGPT GPTs. Les outils sont différents.
Mais la racine est la même. Ce qui est nécessaire, ce n'est pas la technologie. C'est juste une conception qui ne laisse pas l'IA se perdre.
Ce GPTs est un produit fini qui pousse cette philosophie à l'extrême dans le seul domaine de la « création de diapositives ». J'ai déjà terminé tout le travail de conception du contexte.
Je le garantis. Tout ce que vous avez à faire est de taper le thème. Ensuite, le GPTs minutieusement conçu produira des diapositives sans hésitation.
L'article qui a présenté ce GPTs pour la première fois a enregistré 400 000 impressions. C'est le nombre de personnes qui ont réagi, disant « c'est différent ».
https://x.com/masaki_aihack/status/2068646555524223366
Et pour une durée limitée seulement, j'offre un ensemble de « 20 bonus » incluant ce GPTs.
La façon de le recevoir est simple. Commencez par rejoindre le LINE Open Chat ci-dessous.
Je vais être honnête : ce GPTs n'a pas été terminé en un seul coup. J'ai échoué plus de 50 fois. Il m'a fallu une semaine pour enfin arriver à un point où « tout le monde peut l'utiliser ». Je donne ce manuel tel quel.
Permettez-moi de le dire encore une fois. Ce qui est nécessaire, ce n'est pas la technologie. C'est juste l'ingéniosité pour ne pas laisser l'IA se perdre.
Pourquoi ne pas mettre fin à l'épuisement de la création de diapositives dès aujourd'hui ?
