CLAUDE.md

CLAUDE.md es un archivo markdown de instrucciones persistentes que Claude lee al INICIO de cada sesión. Ubicaciones verificadas, en orden de carga de la más general a la más específica: política administrada (/Library/Application Support/ClaudeCode/CLAUDE.md en macOS, /etc/claude-code/CLAUDE.md en Linux y WSL, C:\Program Files\ClaudeCode\CLAUDE.md en Windows); instrucciones del usuario (~/.claude/CLAUDE.md); instrucciones del proyecto (./CLAUDE.md o ./.claude/CLAUDE.md); instrucciones locales (./CLAUDE.local.md, que debería estar en gitignore). Todos los archivos descubiertos se CONCATENAN en el contexto en lugar de anularse entre sí, subiendo por el árbol de directorios desde su directorio de trabajo. Los archivos pueden importar otros con la sintaxis @path/to/import, relativa al archivo que importa, con una profundidad máxima de cuatro saltos. Sin embargo, las importaciones no guardan contexto, ya que los archivos importados también se cargan al inicio. Apunte a menos de 200 líneas: los archivos más largos consumen más contexto y reducen la adherencia.

Hecho mecánico clave: el contenido de CLAUDE.md se entrega como un mensaje de usuario DESPUÉS del prompt del sistema, no como parte de él. Claude lo lee e intenta seguirlo, pero no hay garantía de cumplimiento estricto. Es contexto, no configuración forzada. Para bloquear una acción independientemente de lo que Claude decida, use un hook PreToolUse en su lugar. Ejecute /init para generar un CLAUDE.md inicial. El CLAUDE.md raíz del proyecto sobrevive a la compactación: después de /compact, Claude lo vuelve a leer del disco y lo reinyecta. Este mecanismo está relacionado con cómo los archivos agents-md proporcionan instrucciones persistentes para los agentes. A diferencia de un archivo de configuración estricto, CLAUDE.md funciona más como un conjunto de directrices dentro de la context-window, influyendo en el comportamiento pero sin forzarlo rígidamente. Considérese una forma de auto-memory que persiste entre sesiones.