Traduire en fr : Crochet d'utilisation de l'outil de publication personnalisé pour le chargement à la demande de CLAUDE.md en dehors de l'arborescence du projet

Comportement de chargement de CLAUDE.md dans Claude Code

La source détaille comment Claude Code gère les fichiers CLAUDE.md dans différentes conditions :

• Chargement hiérarchique : Lors du démarrage d'une session dans un sous-répertoire, les fichiers CLAUDE.md locaux et ceux du répertoire parent sont chargés. Exemple : une session dans racine/a/ charge à la fois racine/a/CLAUDE.md et racine/CLAUDE.md.
• Chargement à la demande des répertoires enfants : Les répertoires enfants du répertoire racine de la session actuelle chargent leurs fichiers CLAUDE.md lorsque Claude accède aux fichiers de ces répertoires. Exemple : une session dans racine/ charge racine/CLAUDE.md initialement, puis charge racine/a/CLAUDE.md lorsque Claude lit un fichier dans racine/a/.
• Accès à des répertoires supplémentaires via des drapeaux : L'utilisation de --add-dir avec CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1 permet d'accéder aux fichiers CLAUDE.md dans des répertoires en dehors de l'arborescence du projet, mais ceux-ci se chargent au démarrage de la session plutôt qu'à la demande.

Le problème : les fichiers CLAUDE.md des répertoires externes ne se chargent pas à la demande

L'auteur note que lorsqu'on travaille sur un projet et qu'on demande à Claude de lire des fichiers provenant de répertoires en dehors de l'arborescence de la session, les fichiers CLAUDE.md présents dans ces répertoires externes ne se chargent pas automatiquement. Cela crée des problèmes pour la divulgation progressive du contexte et nécessite une intervention manuelle à chaque fois.

Solution : crochet PostToolUse personnalisé

La solution implique la création d'un crochet PostToolUse qui :

• Vérifie si Claude opère en dehors de l'arborescence du projet à chaque appel d'outil
• Remonte depuis ce répertoire pour chercher des fichiers CLAUDE.md
• Si trouvés, sort avec le code 2 pour renvoyer des instructions à Claude lui demandant de les lire
• Suivi des fichiers déjà présentés dans un fichier temporaire à portée de session pour éviter les instructions répétées

Un crochet SessionStop nettoie le fichier temporaire utilisé pour le suivi. L'auteur fournit un script appelé check_claude_md.py (source liée dans le post original) qui implémente cette fonctionnalité de crochet PostToolUse.

Implémentation pratique

Cette approche répond à la limitation spécifique où les fichiers CLAUDE.md des répertoires externes ne se chargent qu'au démarrage de la session lors de l'utilisation du drapeau --add-dir avec CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1. En interceptant les appels d'outils et en vérifiant les opérations en dehors de l'arborescence du projet, le crochet permet un chargement à la demande similaire au fonctionnement des répertoires enfants au sein de l'arborescence du projet.

Ce type de crochet personnalisé est utile pour les développeurs qui travaillent fréquemment sur plusieurs projets ou qui ont besoin de référencer des fichiers de contexte partagés depuis des répertoires externes sans avoir à demander manuellement à Claude de lire les fichiers CLAUDE.md à chaque fois.