Ir al contenido
Mastering Claude

Inicio / Una instalación estructurada

Una instalación estructurada9 minApplication

CLAUDE.md global, una constitución

El CLAUDE.md global ahora apunta a una longitud en líneas en lugar de en kilobytes, y no prevalece sobre los demás CLAUDE.md por sobrescritura: las cuatro escalas, gestionada, usuario, proyecto, local, se concatenan en el contexto de la más amplia a la más específica.

La documentación actual de Claude Code apunta a una longitud en líneas para un CLAUDE.md, no a un peso en kilobytes: menos de 200 líneas por archivo, consultado el 2 de septiembre de 2026, porque un archivo más largo consume más contexto y reduce la adherencia a las reglas que contiene. Existe además un límite duro separado de este objetivo, un archivo de más de 4 MiB se ignora por completo, pero ese límite no sirve como objetivo a alcanzar, solo como frontera a la que nunca hay que acercarse.

Un apilamiento, no una sobrescritura

Un CLAUDE.md global no actúa solo. La documentación distingue cuatro escalas cargadas en un orden preciso, de la más amplia a la más específica: la política gestionada por una organización, las instrucciones de usuario del archivo ~/.claude/CLAUDE.md, las instrucciones de proyecto del archivo en la raíz del repositorio, y luego las instrucciones locales del archivo CLAUDE.local.md. Estos cuatro archivos, cuando existen, se concatenan en el contexto en lugar de sobrescribirse unos a otros: el que se carga en último lugar simplemente lo lee el modelo en último lugar, no elimina nada de lo anterior.

# CLAUDE.md global, extracto (menos de 200 líneas en total)
## Reglas absolutas
- Nunca hacer commit sin que se pida explícitamente.
## Rutina de sesión
- Leer la memoria de archivos antes de responder a la primera pregunta.
## Punteros
- Ver skills/ para los flujos de trabajo recurrentes del proyecto en curso.

Regenerar en lugar de reescribir desde cero

El comando /init genera un CLAUDE.md de partida analizando realmente el repositorio abierto, comandos de build, instrucciones de test, convenciones descubiertas. Si ya existe un CLAUDE.md, /init propone mejoras en lugar de sobrescribirlo. Una variable de entorno reciente, CLAUDE_CODE_NEW_INIT=1, activa un modo interactivo en varias fases que explora el repositorio mediante subagente antes de proponer un archivo para validar, ausente en las versiones más antiguas del comando.

Antes de cada reescritura del archivo global, archiva la versión que reemplazas en lugar de sobrescribirla: es la única forma de volver atrás si la nueva versión elimina una regla que importaba. El mapa del módulo ubica esta constitución como el segundo de los siete elementos, justo después del motor instalado y conectado en la lección anterior.

Figure 1

El orden de carga de un CLAUDE.md, de lo más amplio a lo más específico

01
Política gestionada
El ámbito más amplio, fijado por una organización, cargado primero en el contexto.
02
Instrucciones de usuario
El archivo ~/.claude/CLAUDE.md, válido para todos los proyectos de una misma persona, cargado en segundo lugar.
03
Instrucciones de proyecto
El archivo CLAUDE.md en la raíz del repositorio abierto, cargado en tercer lugar.
04
Instrucciones locales
El archivo CLAUDE.local.md, el más específico, cargado en último lugar y leído en último lugar por el modelo.
Los cuatro archivos no se sobrescriben entre sí cuando todos existen, se concatenan en el contexto según este orden, y el último cargado simplemente lo lee el modelo en último lugar, no es el único aplicado.
Calíbralo tú mismo

Una desarrolladora abre su archivo CLAUDE.md global y cuenta 340 líneas. Traslada la mitad del contenido a una nota separada, y luego relanza una sesión en un repositorio donde ya existe un CLAUDE.md de proyecto en la raíz.

Escribe en una frase lo que esta situación establece, y en una frase lo que no establece.

Lo que hay que recordar
  • El objetivo de longitud de un CLAUDE.md se mide ahora en líneas, menos de 200, en lugar de en kilobytes, con un límite duro separado de 4 MiB por encima del cual el archivo entero se ignora.
  • Las cuatro escalas de CLAUDE.md, política gestionada, usuario, proyecto, local, no se sobrescriben entre sí, se concatenan en el contexto según un orden de la más amplia a la más específica.
  • Un archivo local cargado en último lugar no anula ninguna regla fijada por los archivos más amplios, simplemente se añade después de ellas en lo que lee el modelo.
  • El comando /init genera un CLAUDE.md a partir de un análisis real del repositorio abierto, y propone mejoras en lugar de sobrescribir un archivo ya presente.
  • Archivar la versión reemplazada antes de cada reescritura del CLAUDE.md global sigue siendo la única forma de volver atrás si la nueva versión elimina una regla que importaba.
Hazlo ahora

Abre tu CLAUDE.md global ahora mismo y cuenta sus líneas con tu editor: por encima de 200, traslada el excedente a una nota señalada por el archivo en lugar de dejarlo crecer, y archiva la versión que reemplazas antes de escribir la nueva.

Verificar en la fuente

Cada afirmación datable de esta lección remite aquí al texto público que la respalda. Una fuente que no se abre no prueba nada.