Gancho Personalizado PostToolUse para Carga Bajo Demanda de CLAUDE.md Fuera del Árbol del Proyecto

Comportamiento de Carga de CLAUDE.md en Claude Code
La fuente detalla cómo Claude Code maneja los archivos CLAUDE.md bajo diferentes condiciones:
- Carga jerárquica: Al iniciar una sesión en un subdirectorio, se cargan tanto el archivo CLAUDE.md local como los archivos CLAUDE.md del directorio padre. Ejemplo: Sesión en
root/a/carga tantoroot/a/CLAUDE.mdcomoroot/CLAUDE.md. - Carga bajo demanda de directorios hijos: Los directorios hijos del directorio raíz de la sesión actual cargan sus archivos CLAUDE.md cuando Claude accede a archivos en esos directorios. Ejemplo: Sesión en
root/cargaroot/CLAUDE.mdinicialmente, luego cargaroot/a/CLAUDE.mdcuando Claude lee un archivo enroot/a/. - Acceso a directorios adicionales mediante banderas: Usar
--add-dirconCLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1permite acceder a archivos CLAUDE.md en directorios fuera del árbol del proyecto, pero estos se cargan al inicio de la sesión en lugar de bajo demanda.
El Problema: Archivos CLAUDE.md de Directorios Externos No Se Cargan Bajo Demanda
El autor señala que al trabajar en un proyecto e instruir a Claude para que lea archivos de directorios fuera del árbol de directorios de la sesión, cualquier archivo CLAUDE.md en esos directorios externos no se cargará automáticamente. Esto crea problemas para la divulgación progresiva del contexto y requiere intervención manual cada vez.
Solución: Enlace Personalizado PostToolUse
La solución implica crear un enlace PostToolUse que:
- Verifica si Claude está operando fuera del árbol del proyecto en cada llamada de herramienta
- Recorre hacia arriba desde ese directorio buscando archivos CLAUDE.md
- Si se encuentran, sale con el código 2 para enviar instrucciones de vuelta a Claude diciéndole que los lea
- Realiza un seguimiento de qué archivos ya se han presentado en un archivo temporal de alcance de sesión para evitar instrucciones repetidas
Un enlace SessionStop limpia el archivo temporal utilizado para el seguimiento. El autor proporciona un script llamado check_claude_md.py (fuente enlazada en la publicación original) que implementa esta funcionalidad de enlace PostToolUse.
Implementación Práctica
Este enfoque aborda la limitación específica donde los archivos CLAUDE.md de directorios externos solo se cargan al inicio de la sesión cuando se usa la bandera --add-dir con CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1. Al interceptar las llamadas de herramientas y verificar operaciones fuera del árbol del proyecto, el enlace permite la carga bajo demanda similar a cómo funcionan los directorios hijos dentro del árbol del proyecto.
Este tipo de enlace personalizado es útil para desarrolladores que trabajan frecuentemente en múltiples proyectos o necesitan hacer referencia a archivos de contexto compartidos desde directorios externos sin tener que instruir manualmente a Claude para que lea los archivos CLAUDE.md cada vez.
📖 Read the full source: r/ClaudeAI
👀 Ver también

Hábitos Prácticos para una Interacción Crítica con LLM
Una publicación de Reddit describe técnicas específicas para evitar el sesgo de confirmación al trabajar con LLMs, incluyendo modos de instrucción personalizados como 'strawberry' para explicaciones neutrales y 'socrates' para escrutinio adversario, además de evaluar la composición de los datos de entrenamiento.

Optimizando CLAUDE.md para Reducir la Ansiedad de Contexto en Claude AI
Un debate en Reddit destaca estrategias prácticas para mejorar la efectividad de CLAUDE.md, incluyendo mantener archivos por debajo de 200 líneas, usar instrucciones específicas y verificables, y aprovechar las funciones de memoria automática de Claude para evitar bucles de corrección que desperdician tokens.

Construir con Codex, Ejecutar con OpenClaw: Una División Práctica que Funciona
Un desarrollador comparte cómo superó la frustración con OpenClaw al construir la lógica de automatización con Codex y usar OpenClaw puramente como la capa de ejecución, además de cómo Apple Messages vía CarPlay lo acercó a un asistente tipo Jarvis.

11 consejos profundos de Claude de un usuario diario de 18 meses
Un desarrollador senior comparte 11 consejos no obvios sobre Claude tras 18 meses de uso diario, incluyendo Projects, Custom Styles, Memory, Sonnet 4.6 vs Opus 4.7, Haiku 4.5 para trabajo por lotes, subagentes de Claude Code y Artifacts llamando a la API.