Claude Code ahora recorta los archivos CLAUDE.md largos de subdirectorios: qué instrucciones deja de ver Claude y cómo comprobar los tuyos (2026)

La documentación de memoria de Anthropic ahora incluye una entrada de resolución de problemas para este caso, titulada "Claude ignores the end of my subdirectory CLAUDE.md" (Claude ignora el final de mi CLAUDE.md de subdirectorio). Describe el comportamiento directamente: "Cuando un CLAUDE.md de subdirectorio o un archivo de reglas que se carga bajo demanda supera el límite de tamaño por archivo, Claude solo recibe el inicio del mismo. Esa parte termina con una nota que le indica a Claude que lea el resto con la herramienta Read, y hasta que Claude decida hacerlo, las instrucciones posteriores no estarán en su contexto".

La misma entrada termina con la línea de versión: "Antes de la v2.1.309, Claude Code no aplicaba este límite a los archivos que se cargan bajo demanda".

Por lo tanto, el cambio es acotado. La nota de lanzamiento describe una sola cosa: un archivo grande bajo demanda ahora se entrega parcialmente en lugar de completo. La regla para el archivo raíz se describe por separado y es mucho más amplia.

La nota de lanzamiento explica el motivo: las sesiones se compactaban repetidamente después de que Claude leyera archivos bajo un CLAUDE.md anidado muy grande. Un archivo de instrucciones grande que se carga cuando Claude accede a una carpeta puede forzar la compactación de la sesión, para luego cargarse de nuevo la próxima vez que Claude trabaje allí.

Así pues, el límite soluciona un problema real. La contrapartida es que ahora el final del archivo es lo que se descarta, y la nota que describe la documentación está dirigida a Claude, no a ti.

La documentación enumera los archivos que se cargan bajo demanda y que están sujetos al límite:

• "CLAUDE.md y CLAUDE.local.md en un subdirectorio del directorio donde iniciaste Claude Code, y los archivos que importan con @path"
• "Archivos de reglas en el directorio .claude/rules/ de un subdirectorio"
• "Reglas con alcance de ruta en el directorio .claude/rules/ de tu proyecto o en ~/.claude/rules/"

Hay dos detalles fáciles de pasar por alto. Los archivos importados están cubiertos por la misma entrada. Y las reglas con alcance de ruta están cubiertas incluso en la carpeta principal .claude/rules/ de tu proyecto, porque se cargan cuando Claude trabaja con un archivo coincidente, en lugar de hacerlo al inicio.

Los archivos que se cargan al inicio funcionan de manera diferente. La documentación indica que el límite de MEMORY.md "se aplica solo a MEMORY.md. Claude recibe la totalidad de cada archivo CLAUDE.md que se carga al inicio, siempre que el archivo sea de 4 MiB o menor". Añade que "Claude Code omite cualquier archivo que supere los 4 MiB y no carga nada de él". Luego señala la nueva regla: "Las reglas con alcance de ruta y los archivos CLAUDE.md en subdirectorios tienen su propio límite por archivo, que es más pequeño".

Por lo tanto, el CLAUDE.md de la raíz se carga por completo hasta un tamaño muy grande, mientras que un CLAUDE.md una carpeta más abajo se carga parcialmente una vez que supera un límite mucho menor.

El límite depende de la ventana de contexto con la que se ejecute tu sesión. La documentación ofrece estos valores:

• Ventana de contexto de 200K: 40,000 caracteres
• Ventana de contexto de 1M: 200,000 caracteres en Claude Opus 4.6 y Claude Sonnet 4.6, y 150,000 caracteres en modelos posteriores

La unidad de medida son los caracteres. El consejo de Anthropic sobre el tamaño está expresado en líneas ("apuntar a menos de 200 líneas por archivo CLAUDE.md"), pero un archivo de 200 líneas con líneas largas puede seguir siendo grande.

La ventana también importa. Varios modelos actuales se ejecutan con la ventana de 1M por defecto, pero puedes desactivarla. La página de configuración de modelos de Anthropic dice: "Para mantener las sesiones en una ventana de 200K, establece CLAUDE_CODE_DISABLE_1M_CONTEXT=1 en tu terminal o en un archivo de configuración". Si tú o tu equipo configuran esa variable, tus sesiones usarán el límite de 40,000 caracteres, y un archivo que se carga por completo para un colega con la ventana de 1M podría cargarse solo parcialmente para ti. Lo mismo ocurre si trabajas con un modelo que se ejecuta a 200K.

Claude recibe el principio del archivo y una nota que le indica que el resto se puede leer con la herramienta Read. Las instrucciones posteriores no están en el contexto de Claude "hasta que Claude decida" leerlas. Que Claude lea el resto depende de la tarea que tenga por delante. Si la instrucción que te interesa es una convención para nombres de pruebas al final de un archivo largo services/payments/CLAUDE.md, y Claude está corrigiendo un error en lugar de escribir pruebas, es posible que no tenga motivos para abrir el resto.

De esto se desprenden tres consecuencias:

1. El orden dentro del archivo ahora importa. El contenido al principio de un archivo que supera el límite llega a Claude. El contenido al final podría no llegar.
2. Las importaciones aumentan el tamaño. La guía de Anthropic señala que las importaciones "te ayudan a organizar un archivo largo pero no reducen su costo de contexto, porque los archivos importados se cargan junto con el CLAUDE.md que los importa".
3. La nota es para Claude. La entrada de resolución de problemas describe una nota al final de la parte entregada, indicándole a Claude dónde está el resto. No describe un aviso para ti, y la misma entrada te ofrece una forma de comprobar el archivo por ti mismo.

El nuevo límite se suma a las reglas de carga que ya eran diferentes de las del archivo raíz.

Se cargan cuando Claude accede a la carpeta. Claude Code busca archivos CLAUDE.md en subdirectorios bajo tu directorio de trabajo y, "en lugar de cargarlos al inicio, Claude Code carga cada uno una vez que Claude lee, escribe o edita otro archivo en ese subdirectorio".

Se suman en lugar de sobrescribirse. Anthropic señala que "todos los archivos descubiertos se concatenan en el contexto en lugar de sobrescribirse entre sí". Un archivo de subdirectorio no reemplaza al archivo raíz, sino que se suma a él.

No aparecen en la lista de inicio. La sección de resolución de problemas señala que "un CLAUDE.md en un subdirectorio de tu directorio de trabajo no aparece bajo Memory files, porque se carga bajo demanda en lugar de al inicio. Cuando se carga, aparece una línea Loaded con su ruta en la terminal".

La compactación los trata como conversación. La página de la ventana de contexto dice: "Las reglas con alcance de ruta y los archivos CLAUDE.md anidados se cargan en el historial de mensajes cuando Claude lee, escribe o edita su archivo desencadenante, por lo que la compactación los resume junto con todo lo demás". Se cargan de nuevo la próxima vez que Claude accede a un archivo coincidente. Su consejo: "Si una regla debe persistir tras la compactación, elimina el frontmatter paths: o muévela al CLAUDE.md de la raíz del proyecto". Nuestra guía para orientar la compactación automática hacia lo que necesitas conservar cubre esa lista en su totalidad, y nuestra guía sobre la compactación por inactividad cubre el caso en que ocurre mientras no estás.

Por lo tanto, una instrucción en un archivo de subdirectorio puede quedar fuera del contexto de Claude por tres razones: Claude aún no ha accedido a esa carpeta, la compactación la resumió o está más allá del recorte.

Codex también limita los archivos de instrucciones. La documentación de Codex de OpenAI dice: "Codex omite los archivos vacíos y deja de añadir archivos una vez que el tamaño combinado alcanza el límite definido por project_doc_max_bytes (32 KiB por defecto)".

Codex limita toda la cadena de archivos AGENTS.md en conjunto, por lo que los archivos más cercanos a tu directorio de trabajo corren peligro. Claude Code ahora limita cada archivo bajo demanda por separado, por lo que el final de cada archivo grande corre peligro. Ambos evitan que los archivos de instrucciones saturen el trabajo y, en ambos casos, las últimas líneas se descartan primero. Nuestra guía para evitar que Codex omita tus reglas de AGENTS.md cubre el lado de Codex.

Asumir que el archivo es demasiado pequeño para importar. Un archivo de 200 líneas puede superar los 40,000 caracteres si sus líneas son largas, y ese es el límite en una ventana de 200K. Cuenta caracteres, no líneas.

Comprobar /context. Los archivos de subdirectorios no aparecen bajo Memory files porque se cargan bajo demanda.

Mover todo al CLAUDE.md de la raíz. Eso evita el límite por archivo, pero el archivo raíz se carga en cada sesión, y Anthropic advierte que "los archivos más largos consumen más contexto y reducen la adherencia".

Añadir una línea que le indique a Claude que lea todo el archivo. Si esa línea está cerca del final de un archivo que supera el límite, estará en la parte que Claude podría no recibir.

Paso 1: Encuentra tus archivos bajo demanda y cuenta sus caracteres

Enumera los archivos que cubre el límite: archivos CLAUDE.md y CLAUDE.local.md debajo de la carpeta donde inicias Claude Code, cualquier cosa que importen con @path, archivos de reglas en las carpetas .claude/rules/ de los subdirectorios y cualquier archivo de reglas con un campo paths:, ya sea en el proyecto o en ~/.claude/rules/.

La instrucción de Anthropic para el conteo es corta: "En Bash o Zsh, ejecuta wc -m ruta/al/CLAUDE.md para imprimir el conteo de caracteres de tu archivo". Compáralo con el límite de tu sesión: 40,000 caracteres en una ventana de 200K, y 150,000 o 200,000 en una ventana de 1M según el modelo.

Para ver qué archivos se cargan realmente y cuándo, Anthropic sugiere un hook: "Usa el hook InstructionsLoaded para registrar qué archivos CLAUDE.md y de reglas se cargan, cuándo se cargan y por qué". También puedes estar atento a la línea Loaded en la terminal cuando Claude comienza a trabajar en una carpeta.

Paso 2: Recorta, divide o mueve las líneas importantes hacia arriba

Para un archivo que supera el límite, la documentación ofrece dos opciones: "recortar el archivo o mover parte de él a uno o más archivos de reglas, cada uno de los cuales cuenta para el límite por su cuenta".

La división funciona porque cada archivo de reglas tiene su propio límite. Un archivo api/CLAUDE.md de 60,000 caracteres puede convertirse en un CLAUDE.md más corto más dos archivos de reglas con alcance limitado a las rutas correspondientes. Cada uno se carga cuando Claude accede a un archivo coincidente y se mantiene por debajo del límite.

Coloca las reglas más importantes cerca de la parte superior de cada archivo, de modo que el inicio siga llegando a Claude si el archivo crece más adelante. Anthropic ofrece el mismo consejo para las habilidades (skills), que se recortan del final tras la compactación: "El truncamiento conserva el inicio del archivo, así que coloca las instrucciones más importantes cerca de la parte superior de SKILL.md".

Dos herramientas integradas ayudan con el recorte. /doctor prompt-audit busca "instrucciones escritas para modelos más antiguos, referencias a archivos o comandos que no existen y archivos que se contradicen entre sí", y propone ediciones sin cambiar nada hasta que lo solicites. En monorepositorios grandes donde se recopilan archivos de otros equipos, claudeMdExcludes te permite omitir archivos CLAUDE.md específicos por ruta o patrón glob.

Paso 3: Mantén el contexto de fondo fuera del archivo de instrucciones

La propia herramienta de recorte de Anthropic muestra qué pertenece al archivo. El chequeo de /doctor "elimina el contenido que Claude puede deducir del código base, como distribuciones de directorios, listas de dependencias y resúmenes de arquitectura, y conserva los errores comunes, la justificación y las convenciones que difieren de los valores predeterminados de las herramientas". Por lo tanto, una justificación de una sola línea junto a su regla se conserva.

Lo que puede desaparecer es el historial largo: la historia completa de por qué el servicio de pagos reintenta dos veces, qué migraciones se abandonaron, quién defendió la distribución de las pruebas. Muévelo a un documento de decisiones o a la solicitud de extracción (pull request) que introdujo la regla. Para procedimientos que solo importan para algunas tareas, Anthropic señala las habilidades: "Para instrucciones específicas de tareas que no necesitan estar en el contexto todo el tiempo, usa habilidades en su lugar, que solo se cargan cuando las invocas o cuando Claude determina que son relevantes para tu prompt". El archivo se vuelve más pequeño y el historial sigue quedando registrado.

El nuevo límite refuerza un punto que la documentación ya mencionaba en otros lugares: un archivo de instrucciones es un espacio para reglas cortas, y Claude lo recibe bajo ciertas condiciones. Se carga cuando Claude accede a una carpeta, se resume mediante la compactación y ahora se recorta cuando es largo. El extenso contexto de fondo detrás de tus reglas es lo primero que queda fuera.

MemoryLake es una capa de memoria para mantener ese contexto de fondo en una única lista que tú gestionas, disponible para Claude Code y los demás asistentes que conectes, como ChatGPT y Codex.

Tú mismo escribes las entradas, con tus propias palabras. No se lee, escribe ni elimina nada de tus archivos CLAUDE.md, tus archivos de reglas, tu carpeta de memoria automática ni del almacenamiento de ningún proveedor. Para repositorios de trabajo, sigue la política de tu organización sobre lo que guardas fuera de ellos.

Paso 1: Crea una clave API

Inicia sesión y genera una clave desde el panel de control. La clave pertenece a tu espacio de trabajo de MemoryLake y es independiente de tu cuenta de Anthropic.

Paso 2: Sube tus primeras memorias

Comienza con lo que retiraste de tus archivos de instrucciones en el Paso 3 de la solución: el historial detrás de las reglas, los enfoques abandonados, las decisiones sobre un servicio. Un punto por entrada, con fecha y etiquetado con la carpeta o servicio al que se aplica.

Paso 3: Conecta tu IA y agentes

Conecta Claude Code y los demás asistentes que utilices. El contexto de fondo estará disponible cuando una tarea lo requiera, y tus archivos CLAUDE.md se mantendrán lo suficientemente cortos como para cargarse por completo.

La primera diferencia es que sabes cuáles de tus archivos se vieron afectados por el cambio, porque los has comparado con el límite de tu sesión.

La segunda es que las reglas que te interesan llegan a Claude. Se ubican cerca de la parte superior de archivos cortos o en archivos de reglas con alcance limitado, por lo que el crecimiento de un archivo no las empuja más allá del recorte.

La tercera es que tus archivos de instrucciones dejan de cumplir dos funciones. Las reglas permanecen en CLAUDE.md, y el historial detrás de ellas vive en otro lugar. Si también mantienes un archivo AGENTS.md para otras herramientas, nuestra guía sobre cómo Claude Code lee AGENTS.md cubre qué archivo tiene prioridad.

Cuenta los caracteres. El límite es de 40,000 caracteres en una ventana de 200K y de 150,000 o 200,000 en una ventana de 1M.

Comprueba la ventana que utiliza tu sesión. CLAUDE_CODE_DISABLE_1M_CONTEXT=1 y los modelos de 200K te sitúan en el límite inferior.

Coloca las reglas más importantes primero. Si un archivo supera el límite, el inicio es lo que recibe Claude.

Divide en archivos de reglas con alcance limitado. Cada archivo de reglas cuenta para el límite por su cuenta.

Mantén los historiales largos fuera de los archivos de instrucciones. Una justificación de una sola línea puede quedarse. La historia completa pertenece a un lugar donde no compita por el contexto.

Si trabajas en varios árboles de trabajo (worktrees), nuestra guía sobre lo que carga cada sesión de árbol de trabajo cubre cómo se comportan allí los archivos de instrucciones y la memoria automática.

Claude Code v2.1.309 añadió un límite de tamaño por archivo para los archivos de instrucciones que se cargan bajo demanda: archivos CLAUDE.md y CLAUDE.local.md de subdirectorios, sus importaciones, reglas en carpetas .claude/rules/ de subdirectorios y reglas con alcance de ruta. Un archivo que supera el límite llega a Claude como su inicio más una nota, y el resto permanece fuera del contexto hasta que Claude lo lee. El archivo CLAUDE.md de la raíz del proyecto se sigue cargando por completo hasta 4 MiB.

Cuenta los caracteres de tus archivos bajo demanda, compáralos con el límite de tu ventana de contexto y divide o recorta los que lo superen. Coloca primero las reglas importantes y mueve el extenso contexto de fondo a un lugar donde no tenga que competir por espacio.