Claude Code prend en charge AGENTS.md comme solution de repli

Comment les instructions du projet sont désormais chargées

Claude Code dispose enfin d’un mécanisme de repli pratique pour AGENTS.md : si aucun fichier de la famille CLAUDE.md n’est trouvé, l’outil utilise le fichier d’instructions standard du projet. Au 24 septembre 2026, c’est le fonctionnement décrit dans la documentation de Claude Code. La modification est modeste, mais elle réduit nettement la maintenance de fichiers parallèles.

Claude Code recherche d’abord CLAUDE.md, .claude/CLAUDE.md et CLAUDE.local.md dans le répertoire de travail et dans toute la chaîne des répertoires parents. AGENTS.md n’est chargé que si aucun de ces fichiers n’existe. La documentation précise aussi le message affiché dans l’interface : Claude read AGENTS.md instead of CLAUDE.md.

Le point essentiel est qu’il s’agit bien d’un chemin de repli, et non d’une fusion automatique de toutes les instructions. Dès qu’un fichier de la famille CLAUDE.md est trouvé, AGENTS.md est ignoré par défaut. Le chargement conjoint peut être activé dans le paramètre Project instructions avec la valeur claude-md-and-agents-md.

Il faut vérifier non seulement qu’un fichier a été chargé, mais aussi quelles instructions sont prioritaires dans l’arborescence réelle du projet. Un ancien CLAUDE.local.md oublié à un niveau supérieur peut désactiver silencieusement le repli attendu. L’intérêt de cette fonction repose sur une recherche transparente : un seul fichier supplémentaire peut modifier la source de contexte de toute la session.

Ce que cela change pour les dépôts

Le principal avantage est simple : les projets qui utilisent AGENTS.md n’ont plus besoin d’un CLAUDE.md séparé uniquement pour assurer leur compatibilité avec Claude Code. Moins de duplication réduit le risque que deux jeux d’instructions divergent et imposent des règles contradictoires à l’agent.

Pour les équipes qui possèdent déjà un CLAUDE.md, le comportement ne change presque pas. En revanche, lors d’une migration progressive vers un AGENTS.md commun, il faut tenir compte de la condition stricte du repli : tant qu’un ancien fichier reste dans la chaîne de répertoires, la nouvelle source ne s’active pas. C’est un cas où une configuration oubliée compte davantage qu’une annonce soignée.

La mise à jour semble mineure, mais sa valeur d’ingénierie est réelle : Claude Code s’intègre plus facilement aux dépôts reposant sur un fichier unique d’instructions pour agents. Le problème restant n’est plus le format, mais la prévisibilité en cas de conflit entre réglages locaux et réglages parents.

Nous avons déjà expliqué comment des agents Claude Code parallèles peuvent examiner des pull requests et révéler des conditions de course dans les workflows CI/CD. Ce processus exige aussi des instructions claires à l’échelle du dépôt, ce qu’AGENTS.md simplifie désormais.