Context engineering pour Claude 5 : les nouvelles règles d'Anthropic

Le 24 juillet 2026, Anthropic a publié sur son blog officiel un constat peu habituel pour un éditeur de modèles IA : l'entreprise a supprimé plus de 80 % du system prompt de Claude Code pour la nouvelle génération de modèles Claude 5, dont Claude Opus 5 et Claude Fable 5, sans perte mesurable sur ses évaluations de code. Dans la foulée, Anthropic publie un guide de context engineering qui bouscule plusieurs habitudes prises par les développeurs qui construisent des agents IA depuis deux ans.

Pour ceux qui découvrent le terme : le context engineering regroupe tout ce qui entoure le message envoyé à un modèle. Le system prompt, les fichiers CLAUDE.md, les Skills, la mémoire persistante, les descriptions d'outils. Contrairement à un prompt ponctuel, ce contexte s'applique à des centaines de requêtes différentes, donc il ne peut jamais être aussi précis qu'une instruction ciblée. Anthropic explique que les modèles Claude 5 ont suffisamment progressé en jugement pour qu'une grande partie des règles rigides imposées jusqu'ici deviennent contre-productives : elles créent des instructions contradictoires que le modèle doit arbitrer avant même de traiter la vraie question.

Six changements de doctrine à connaître

Anthropic détaille six bascules « avant / maintenant » dans son article. Voici ce que chacune change concrètement si vous construisez des agents sur l'API Claude ou si vous utilisez Claude Code au quotidien.

• Des règles strictes vers le jugement du modèle. L'ancien system prompt de Claude Code contenait des consignes rigides comme « ne jamais écrire de commentaires » ou « ne jamais créer de documents de planification sauf demande explicite ». Ces règles évitaient les pires scénarios avec les anciens modèles, mais produisaient de mauvais résultats dès que le contexte réel du projet demandait l'inverse. La nouvelle consigne tient en une phrase : écrire du code qui se lit comme le code environnant, en respectant sa densité de commentaires, son nommage, son idiome.
• Des exemples vers une conception d'interface. Anthropic recommandait de donner des exemples d'usage pour chaque outil. Avec Claude 5, cette pratique enferme le modèle dans l'espace d'exploration montré par l'exemple. La recommandation devient de soigner la conception de l'outil lui-même : dans l'outil de gestion de tâches d'Anthropic, limiter le statut à une énumération stricte (pending, in_progress, completed) et préciser qu'un seul élément peut être in_progress à la fois suffit à cadrer le comportement, sans exemple de conversation associé.
• Tout mettre en amont vers la divulgation progressive. Le system prompt de Claude Code embarquait autrefois des instructions détaillées de revue de code et de vérification, utiles seulement dans une fraction des sessions. Anthropic a déplacé ce contenu dans des Skills que Claude Code appelle à la demande. Même logique côté outils : certains sont désormais en chargement différé, et le modèle doit les rechercher via ToolSearch avant de pouvoir les utiliser. Anthropic recommande d'appliquer le même principe à vos propres fichiers CLAUDE.md et Skill.md : plutôt qu'un fichier unique qui liste toutes les pratiques possibles, construisez une arborescence de fichiers chargés au bon moment.
• Se répéter vers des descriptions d'outils simples. Les anciens modèles suivaient mieux les instructions placées en fin de contexte, ce qui poussait à dupliquer les consignes d'usage d'un outil à la fois dans le system prompt et dans sa description. Cette redondance a été supprimée : les instructions d'usage vivent désormais uniquement dans la description de l'outil.
• La mémoire dans CLAUDE.md vers la mémoire automatique.Anthropic encourageait auparavant l'écriture manuelle dans CLAUDE.md via un raccourci dédié. Claude sauvegarde désormais automatiquement les éléments de mémoire pertinents pour le travail en cours, sans action manuelle de l'utilisateur.
• Des spécifications simples vers des références riches. En mode plan, Claude Code s'appuyait sur de simples fichiers markdown pour stocker ses plans. Anthropic indique que Claude 5 peut désormais s'appuyer sur des références plus riches : artefacts HTML, suites de tests détaillées, fonctions d'un autre projet à porter, ou encore des rubriques qui permettent à des agents vérificateurs de juger un résultat par rapport à des critères de qualité définis à l'avance.

Comment appliquer ça à vos propres agents

Si vous construisez votre propre agent avec l'API Claude, Anthropic distingue deux niveaux à travailler en priorité. Le system prompt est directement lié au produit dans lequel Claude opère : à quoi sert cet agent, dans quel contexte. Si vous développez votre propre harnais d'agent, c'est l'endroit où investir le plus de temps de conception. Le CLAUDE.md doit rester léger : une description brève de l'objet du dépôt, puis l'essentiel des tokens consacrés aux pièges spécifiques du code, pas à un référentiel exhaustif de bonnes pratiques génériques.

Concrètement, si vous utilisez déjà Claude Code, Anthropic a intégré ces recommandations dans une commande : lancez /doctor (ou claude doctor en ligne de commande) pour auditer et redimensionner vos Skills et vos fichiers CLAUDE.md existants à l'aune de ces nouvelles règles.

Notre lecture chez CZSyn

Chez CZSyn, nous voyons cette évolution comme un changement de posture plus qu'une simple optimisation de tokens. Pendant deux ans, la meilleure pratique consistait à sur-contraindre les agents IA par précaution, quitte à accumuler des règles contradictoires au fil des correctifs. Ce que dit Anthropic ici, c'est que cette dette d'instructions devient un coût net avec les modèles Claude 5 : elle ralentit le raisonnement du modèle sans réduire les erreurs.

Pour une PME française qui commence à intégrer des agents IA dans son workflow (support client automatisé, revue de code interne, agents de qualification de leads), la leçon pratique est simple : n'accumulez pas les CLAUDE.md fourre-tout ni les system prompts de dix pages « au cas où ». Documentez les pièges réels de votre codebase ou de votre métier, laissez le modèle inférer le reste, et testez régulièrement avec un outil comme /doctor pour repérer ce qui est devenu superflu. C'est aussi un rappel utile que le context engineering est un chantier vivant : ce qui était une bonne pratique il y a un an peut devenir une contrainte inutile avec la génération de modèles suivante.

Sources primaires

• Anthropic, blog officiel, « The new rules of context engineering for Claude 5 generation models », 24 juillet 2026.
• Documentation officielle, « Claude Code overview ».
• Anthropic, page produit Claude Code.