Comment inviter efficacement le code Claude

était un sujet très brûlant il y a quelques années. C’est ici que vous modifierez votre invite, ne serait-ce qu’un peu – par exemple, le format de votre invite, quelle est la dernière phrase de votre invite, et ainsi de suite. Vous pourriez obtenir des résultats très différents avec les LLM. Cependant, au cours des années qui ont suivi, les LLM sont devenus beaucoup plus puissants et plus intelligents, et sont désormais beaucoup moins susceptibles de modifier les résultats uniquement en fonction du format, de l’ordre du texte ou d’éléments similaires dans l’invite.

Cependant, l’incitation est toujours très importante, et les connaissances sur la manière d’inciter efficacement les LLM sont toujours extrêmement importantes. De nos jours, il faut simplement un ensemble de compétences différent et une façon de penser différente pour inciter efficacement les agents.

Il convient de noter que, probablement, dans un an ou deux, la façon dont vous incitez vos agents aura encore évolué, et il vous suffit de suivre tous les changements qui surviennent dans les modèles afin de savoir comment les inciter efficacement et obtenir les meilleurs résultats des modèles.

Dans cet article, j’expliquerai comment j’invite les LLM avec lesquels je travaille à leur faire effectuer efficacement une grande partie du travail, et je discuterai essentiellement de mon flux de travail pour accomplir les tâches d’ingénierie.

Pourquoi optimiser la façon dont vous invitez

Tout d’abord, vous pourriez penser que la façon dont vous rédigez les invites n’a plus vraiment d’importance parce que les LLM sont devenus si forts qu’ils peuvent de toute façon vous comprendre. Dans une certaine mesure, je suis d’accord avec cette façon de penser. Cependant, il existe encore de bonnes et de mauvaises façons d’inciter les modèles.

Par exemple, une bonne invite serait :

• Soyez explicite sur ce que vous voulez
• Inclure comment tester la mise en œuvre
• Clarifier toute ambiguïté

Alors qu’une mauvaise invite serait, par exemple :

• Soyez vague
• Faire des hypothèses qui ne correspondent pas à la base de code existante

De plus, l’invite n’est pas seulement une chose unique que vous faites pour un fil de discussion spécifique. L’invite est également la science qui consiste à travailler de manière itérative avec le modèle pour élaborer un plan d’implémentation de la fonctionnalité, par exemple. Ainsi, une bonne invite pourrait également inclure des éléments tels que demander au modèle de découvrir toute ambiguïté et d’en discuter avec vous. Ou dire au modèle quelles hypothèses faire.

Comment j’invite Claude Code

Je vais maintenant passer à la façon dont j’invite spécifiquement Claude Code. Je vais vous présenter quelques-unes des techniques que j’utilise pour inciter efficacement et tirer le meilleur parti de Claude Code, bien que ces techniques soient très générales et s’appliquent également à tous les autres agents de codage, tels que le Codex.

Transcription

Le premier sujet que j’aimerais aborder est que j’utilise un outil de transcription pour intégrer toutes mes réflexions dans les agents de codage. Actuellement, j’utilise un outil de transcription appelé FluidVoice, qui est un modèle que vous pouvez exécuter localement gratuitement et qui est incroyablement bon, à la fois rapide et précis pour transcrire du texte anglais.

Désormais, les outils de transcription sont évidemment très précieux car ils sont plus rapides que la saisie manuelle. Bien sûr, la vitesse dépend de la vitesse à laquelle vous pouvez réellement taper à la main, mais il est juste de supposer que vous pouvez parler, en moyenne, deux à trois fois plus vite que vous ne pouvez taper sur votre ordinateur. Et bien sûr, vous bénéficiez de l’avantage de ne pas vous fatiguer les mains et de ne pas avoir à vous concentrer sur la frappe.

Cependant, un autre avantage que j’ai remarqué est que je suis plus disposé à inclure tout le contexte dont mon agent de codage a besoin pour effectuer une tâche. Quand je devais tout taper à la main, il y avait des moments où je ne voulais pas écrire tout le contexte, simplement parce que la saisie prenait beaucoup de temps. C’est bien sûr très mauvais car si vous ne donnez pas à Claude Code le contexte dont il a besoin pour résoudre une tâche, il lui est très difficile de réellement résoudre cette tâche. Cependant, maintenant que je transcris au lieu de taper, il est beaucoup plus facile pour moi d’inclure tout le contexte que je dois inclure, et cela demande également très peu d’effort.

Dans l’ensemble, les outils de transcription sont très efficaces car ils vous font gagner beaucoup de temps et vous permettent d’inclure plus facilement tout le contexte dont vous avez réellement besoin pour fournir à l’agent de codage une tâche efficace.

Dire au modèle comment tester

Un autre point très important est d’indiquer au modèle comment tester. Supposons donc que vous demandiez au modèle d’implémenter la fonctionnalité A. C’est bien sûr génial. Vous lui dites ce que comprend la fonctionnalité ; vous devez inclure pourquoi vous souhaitez créer cette fonctionnalité. Vous devez inclure tout contexte autour de la fonctionnalité, la manière dont la fonctionnalité est liée à d’autres parties de votre application, etc.

Cependant, vous devez également indiquer au modèle comment tester la fonctionnalité. Par exemple, si vous implémentez une fonctionnalité de chat dans votre application, vous devez indiquer au modèle qu’il doit ouvrir le chat dans Chrome, saisir lui-même une requête et garantir que l’IA répond correctement et que les jetons sont diffusés, par exemple.

Essentiellement, vous devez indiquer au modèle comment il peut savoir qu’il a correctement implémenté la fonctionnalité. Cela vous fera gagner beaucoup de temps car vous n’aurez pas à tester autant la fonctionnalité vous-même, et le modèle vous présentera immédiatement une fonctionnalité plus fonctionnelle.

Avoir une discussion avec le modèle

Une idée fausse courante lorsqu’il s’agit d’inviter les agents de codage est que vous leur fournissez simplement une invite unique et que vous la déclenchez, puis que vous les laissez travailler jusqu’à ce qu’ils aient terminé. Si vous disposez d’une configuration d’invite parfaite, cela est possible car les agents sont très capables de travailler pendant de nombreuses heures et d’accomplir beaucoup de travail. Cependant, cela ne prend pas en compte la manière de créer l’invite parfaite.

Pour un humain, il est fondamentalement impossible de créer une invite parfaite, et la simple raison en est que vous, en tant qu’humain, ne pouvez pas avoir le contexte complet de l’ensemble de la base de code, et il y a tout simplement trop de code, trop de choses à penser et un contexte que vous pourriez oublier, ce qui n’est pas possible dans votre mémoire à court terme. Cependant, pour les agents codeurs, ils sont effectivement capables de stocker tout cela dans leur mémoire, ce qui en fait un très bon interlocuteur.

Fondamentalement, ce que vous devez faire chaque fois que vous démarrez avec un agent de codage, qu’il s’agisse d’implémenter une nouvelle fonctionnalité, de résoudre un bug ou toute autre chose, c’est d’avoir une discussion avec votre agent de codage. Vous devriez demander à votre agent de codage de rechercher le sujet, de vérifier les journaux, de rechercher en ligne s’il y a quelque chose de pertinent, etc. Et demandez à l’agent de vous poser des questions sur tout ce qui est ambigu.

Lorsque les agents de codage écrivent du code pour vous, ils font de nombreuses hypothèses. Bien plus d’hypothèses que vous n’en avez conscience. La raison en est qu’il y a beaucoup trop de décisions dans le codage pour que l’agent de codage puisse vous le demander à chaque fois. Lorsque les humains codent également, ils doivent également faire un certain nombre d’hypothèses auxquelles ils pensent parfois, et parfois ce sont simplement des hypothèses inconscientes. Cependant, lors de la planification, vous souhaitez que le modèle partage au moins toutes les hypothèses importantes qu’il émet.

---

Un exemple d’une telle hypothèse pourrait être de savoir s’il faut implémenter l’infrastructure directement via une CLI, par exemple pour AWS, ou la mettre en œuvre sous forme de CDK, donc de code. Ce n’est pas un exemple parfait car dans presque tous les cas, la bonne réponse est que vous devez l’implémenter sous forme de code et non directement via la CLI. Mais ceci est un exemple de décision dont vous, en tant qu’humain, voulez être conscient afin que l’agent de codage ne fasse rien que vous ne vouliez pas qu’il fasse. En gros, vous avez cette discussion avec votre agent de codage pour aligner la mise en œuvre dans votre tête avec ce que l’agent de codage va réellement mettre en œuvre.

Vous avez eu une discussion avec votre agent de codage pour vous assurer que vous êtes aligné sur la tâche à mettre en œuvre et sur la manière de la mettre en œuvre.

Rapports HTML

Une dernière chose que je souhaite aborder dans cet article concerne les rapports HTML. Ainsi, lorsque les agents de codage fonctionnent, il y a bien sûr beaucoup d’informations. L’agent écrira beaucoup de résultats sur votre terminal, dont la plupart ne vous concernent pas, par exemple, des appels d’outils ou simplement des jetons de réflexion, etc. Cependant, vous devez parfois revoir ce que fait l’agent de codage. Cela pourrait, par exemple, être le plan qu’il a élaboré lors de la dernière tâche dans laquelle vous souhaitez discuter avec un modèle sur la façon d’implémenter une fonctionnalité. Dans ces cas, vous devez presque toujours demander au modèle de créer des rapports HTML pour visualiser ce dont vous discutez, ce qui permet à vous, en tant qu’humain, de donner beaucoup plus facilement vos commentaires au modèle.

Permettez-moi d’être très précis ici. Disons que j’implémente la fonctionnalité A, mais le modèle souhaite discuter de nombreuses décisions avec moi avant de commencer l’implémentation. Si tel est le cas, je fais en sorte que le modèle génère un rapport HTML avec chaque décision répertoriée, y compris un contexte tel que :

• Quelles sont les différentes options pour cette décision
• Sur quoi porte la décision
• Avantages et inconvénients de la décision
• Un simple bouton pour que je décide quelle option choisir pour la décision

Cela me permet de comprendre incroyablement simplement quelles sont les différentes options pour chaque décision et d’avoir un aperçu des décisions globales qui doivent être prises. Et c’est bien plus simple que de lire et de comprendre cela via le terminal, par exemple. Un autre avantage des rapports HTML est que vous pouvez créer des visuels, par exemple des diagrammes, des organigrammes, des SVG, etc.

---

Une autre remarque ici est que je crée également des rapports HTML à des fins de test. Disons donc que le modèle a implémenté une fonctionnalité que j’ai demandée ou corrigé le bug. Je lui fais créer un rapport HTML contenant les éléments suivants :

• Chaque partie de l’implémentation que je dois tester
• Liens directs vers le produit vers l’endroit exact où le tester. Par exemple, si je teste un chat, cela me donne un lien direct vers ce chat, je n’ai donc pas besoin de naviguer moi-même dans le produit.
• Deux boutons, un pour approuver la fonctionnalité et un pour dire qu’elle nécessite plus de travail
• Un champ de saisie dans lequel je peux donner mon avis sur la façon de résoudre le problème et ce qui ne va pas

J’ai alors également un bouton Copier sur le rapport HTML pour pouvoir simplement copier le résultat du rapport, c’est-à-dire ce que j’ai répondu pour les différentes parties du rapport, et je peux simplement le coller à nouveau dans Claude Code, le faire continuer à fonctionner, puis me présenter un nouveau rapport HTML afin que je puisse continuer ainsi jusqu’à ce que tout soit testé et approuvé. Si tel est le cas, je peux bien sûr tout fusionner et le mettre en production.

Conclusion

Dans cet article, j’ai expliqué comment inciter efficacement Claude Code et d’autres agents de codage. La science des agents de codage d’incitation a beaucoup changé au fil des ans ; Au début, la façon dont vous rédigiez vos invites ou l’ordre dans lequel vous aviez le texte dans votre invite importait beaucoup. De nos jours, cela n’a plus vraiment d’importance, mais l’incitation reste une compétence que vous devez maîtriser. Par exemple, vous devez indiquer aux agents comment tester leurs implémentations. Vous devez discuter avec les agents de la manière de procéder à une implémentation, de résoudre les ambiguïtés, etc. Je pense que la façon dont vous invitez les agents changera à nouveau au cours des deux prochaines années, et je me tiendrai simplement au courant de la manière la plus efficace de travailler avec les agents et publierai un autre article une fois que je pense que la façon dont j’interagis avec mes agents a suffisamment changé depuis cet article.

👋 Entrer en contact

👉 Mon eBook et mon webinaire gratuits :

🚀 10x votre ingénierie avec les LLM (cours gratuit par e-mail de 3 jours)

📚 Obtenez mon ebook gratuit sur les modèles de langage de vision

💻 Mon webinaire sur les modèles de langage de vision

👉 Retrouvez-moi sur les réseaux sociaux :

💌 Sous-pile

🔗 LinkedIn

🐦 X/Twitter