Construire avec Claude Code : le guide de terrain d'un praticien
Un guide de praticien pour construire de vrais logiciels avec Claude Code : les habitudes de travail, l'architecture d'agents (outil vs skill vs sous-agent) et la discipline de prompting qui le rendent fiable.
Guillaume Rufenacht
Product Manager IA · Lisbonne
Claude Code n’est pas de l’autocomplétion de code. C’est un agent qui a accès à un ordinateur, et bien utilisé, il fait passer l’unité de travail de “taper plus vite” à “diriger une équipe d’agents.” Voici mon guide de praticien pour construire avec lui : les habitudes, l’architecture d’agents et le prompting, chacun renvoyant vers un article plus approfondi.
Je construis de vrais produits avec Claude Code, du système d’outbound IA aux pipelines LLM qui font tourner Geonimo. Voici la carte pour en tirer le maximum.
Key takeaways
- Traitez Claude Code comme 'Claude avec un ordinateur', pas comme une boîte d'autocomplétion de code.
- Corrigez le système (CLAUDE.md, skills) au lieu de re-prompter ; rendez la vérification native pour l'agent.
- Choisissez la bonne primitive à mesure que les agents grandissent : outil, skill ou sous-agent.
- Promptez comme un ingénieur : partez des évals, donnez des outils, énoncez les compromis.
Les habitudes : comment travailler vraiment avec lui
Les plus grands gains ne sont pas des astuces de prompt, ce sont des habitudes de travail : corriger le système au lieu de corriger une seule réponse, rendre la vérification quelque chose que l’agent peut faire lui-même, faire confiance à de bons défauts pour pouvoir faire tourner plusieurs agents à la fois, et garder le contexte léger. Tout cela vient directement de la façon de travailler de l’équipe d’Anthropic, détaillée dans comment l’équipe d’Anthropic utilise Claude Code.
L’architecture : outil, skill ou sous-agent
Les agents pourrissent quand on continue de greffer des capacités sur un system prompt qui enfle. La solution, c’est d’atteindre la bonne primitive : d’abord les primitives proches de l’humain (système de fichiers, exécution de code), puis les skills pour une divulgation progressive, puis les sous-agents seulement pour le parallélisme ou un regard neuf. Le cadre de décision est dans outil, skill ou sous-agent ?.
Le prompting : comme un ingénieur, pas comme un suppliant
Un bon prompting pour Claude Code est une discipline d’ingénierie : mesurer avec des évals, nettoyer la structure avant d’optimiser, donner des outils au modèle au lieu de le supplier, et énoncer les deux faces de chaque compromis. L’ensemble complet des techniques est dans le playbook de prompting Claude Code.
Tout assembler
Ces éléments se renforcent mutuellement. De bons prompts et les bonnes primitives gardent votre agent simple ; la vérification native pour l’agent lui permet de tourner sans surveillance ; corriger le système signifie qu’il s’améliore à chaque fois au lieu d’avoir besoin de vous à chaque fois. Le système de SDR IA est un exemple concret de tout cela fonctionnant ensemble.
L’essentiel à retenir
Voilà comment je livre avec Claude Code en production. Découvrez la stack avec laquelle je construis ou contactez-moi si vous voulez de l’aide pour construire de cette façon.
Questions fréquentes
Qu'est-ce que Claude Code ?
L'outil de codage agentique d'Anthropic, essentiellement Claude avec accès à un ordinateur (système de fichiers, exécution de code, recherche web). On l'utilise pour construire et livrer de vrais logiciels, pas seulement pour autocompléter du code.
Comment devenir bon avec Claude Code ?
Corrigez le système au lieu de re-prompter (utilisez CLAUDE.md et les skills), rendez la vérification native pour l'agent, promptez à partir des évals, et choisissez la bonne primitive (outil, skill ou sous-agent) à mesure que votre agent grandit.
Faut-il être ingénieur pour bien l'utiliser ?
Moins qu'on ne le croit. L'effet de levier réside dans le sens produit, un cadrage clair du problème et la vérification ; c'est l'agent qui écrit le code.
Travailler avec moi
Vous voulez un système comme celui-ci pour votre pipeline ?
J'aide les équipes à faire passer l'IA d'un prototype malin à une production fiable : moteurs d'outbound, intelligence des leads et les pipelines LLM en dessous. Voyez ce que j'ai livré ou écrivez-moi.