Inicio / Fundamentos y bucle del agente

CLAUDE.md, la memoria del proyecto

CLAUDE.md se lee automáticamente al inicio de cada sesión en el repositorio donde se encuentra, y sus reglas se leen como contexto, sin garantía de aplicación estricta.

CLAUDE.md es un archivo de texto colocado en la raíz de un repositorio. Claude Code lo lee automáticamente al inicio de cada sesión abierta en ese repositorio, sin que nadie necesite mencionarlo. El archivo se entrega como un mensaje de usuario después del prompt de sistema, no como una parte del prompt de sistema en sí: Claude lee estas reglas e intenta seguirlas, sin garantía estricta de cumplimiento. Para bloquear una acción sea cual sea lo que Claude decida, hace falta un hook PreToolUse en lugar de una línea de CLAUDE.md.

Lo que produce /init

El comando /init lanza un análisis real del repositorio en curso, no la copia de una plantilla genérica. Recorre la estructura de las carpetas, los scripts declarados en los archivos de configuración y las convenciones ya establecidas, y luego propone un primer borrador de CLAUDE.md a partir de lo que encuentra. Este primer borrador queda por releer y recortar: un archivo corto con reglas absolutas sirve mejor que una larga descripción de lo que el repositorio ya contiene por otra parte.

# Comandos
npm test lanza la suite de tests
npm run build produce la carpeta dist

# Convenciones
Los componentes React viven en src/components, un archivo por componente

# Reglas absolutas
Nunca hacer commit de la carpeta dist
Siempre pasar por npm run lint antes de un commit

Una variante más amplia detrás de una variable de entorno

Al 2026-09-02, activar la variable de entorno CLAUDE_CODE_NEW_INIT=1 antes de lanzar /init desencadena un recorrido interactivo más amplio que el simple CLAUDE.md: cubre también las skills, los hooks y los archivos de memoria personales, y propone importar la configuración de otro agente detectado en el repositorio, por ejemplo un archivo AGENTS.md ya presente. Sin esta variable, /init conserva su comportamiento habitual y solo produce un CLAUDE.md.

Por qué gana un archivo corto

Un CLAUDE.md cargado por completo en cada sesión pesa sobre el contexto disponible para el resto de la tarea. Las reglas que realmente importan son las que, ausentes, harían perder tiempo o producirían un error: el comando exacto para lanzar los tests, el lugar donde viven los componentes, lo que nunca hay que hacer commit. El resto, el historial del proyecto o la lista completa de dependencias, se encuentra mejor en un archivo leído a demanda que en una memoria cargada en cada vuelta del bucle de agente, y un comando dedicado también permite verificar lo que realmente está cargado en la sesión en curso, ver los comandos slash esenciales.