Qué es CLAUDE.md: las reglas que Claude Code lee siempre
Cada sesión de Claude Code empieza de cero: no se acuerda de lo que le corregiste ayer. Por eso existe un archivo con nombre propio, CLAUDE.md, donde dejas escrito lo que no quieres volver a explicar. Claude lo lee al empezar cada sesión. Aquí va qué es, en qué se diferencia de la memoria automática, dónde se guarda y qué poner para que de verdad lo siga.
- 01Qué esEl archivo que Claude lee al empezar
- 02Qué esCLAUDE.md o memoria automática
- 03DecidirDónde se guarda: para ti, para el proyecto o para el equipo
- 04Paso a pasoCrear el tuyo en 3 comandos
- 05DecidirQué poner (y qué no) para que lo siga
- 06PromptsUn prompt para escribirlo a partir de tus correcciones
- 07CuidadoLo honesto
Qué es CLAUDE.md: el archivo que Claude lee al empezar
La documentación oficial lo dice así: cada sesión de Claude Code empieza con una ventana de contexto nueva, vacía. Para que el conocimiento pase de una sesión a otra hay dos mecanismos, y CLAUDE.md es el que escribes tú: un archivo de texto con instrucciones permanentes que Claude lee al empezar cada sesión. (Claude Code Docs · memory)
Se escribe en texto normal (formato Markdown: títulos con # y listas con guiones). Un ejemplo corto:
# Reglas de este proyecto
- Escribe en español de Latinoamérica, trato de tú, sin voseo.
- Los precios vienen de precios.json: nunca los inventes.
- Antes de terminar, corre el control de la web y dime el resultado.Piensa en el manual del puesto. Cada sesión es un empleado nuevo muy capaz que no sabe nada de tu negocio. CLAUDE.md es lo que le das a leer el primer minuto.
CLAUDE.md o memoria automática: quién escribe cada una
Claude Code tiene dos sistemas de memoria. Los dos se cargan al empezar cada sesión: (Claude Code Docs · memory)
| CLAUDE.md | Memoria automática | |
|---|---|---|
| Quién la escribe | Tú | Claude, a partir de tus correcciones |
| Qué guarda | Instrucciones y reglas | Aprendizajes: tus preferencias, correcciones, contexto del proyecto |
| Cuánto se carga | El archivo entero (lo recomendado: menos de 200 líneas) | Las primeras 200 líneas o 25 KB de su índice, lo que llegue antes |
| Cómo se revisa | Con /memory o abriendo el archivo | Con /memory; son archivos de texto que puedes editar o borrar |
La memoria automática viene activada por defecto y se guarda por proyecto en tu computadora. Cuando le dices a Claude «recuerda que…», lo guarda ahí; si quieres que vaya a CLAUDE.md, pídeselo con esas palabras: «añade esto a CLAUDE.md».
Dónde se guarda CLAUDE.md: para ti, para el proyecto o para el equipo
Puede haber varios CLAUDE.md a la vez. No se pisan: Claude los junta todos. Estos son los tres que vas a usar: (Claude Code Docs · memory)
| Archivo | Vale para | Úsalo para |
|---|---|---|
~/.claude/CLAUDE.md (en tu carpeta de usuario) | Todos tus proyectos, solo tú | Cómo trabajas tú: tono, idioma, preferencias |
CLAUDE.md en la carpeta del proyecto | Ese proyecto, y todo el equipo si lo guardas en git | Reglas del proyecto: comandos, convenciones, dónde está cada cosa |
CLAUDE.local.md en la carpeta del proyecto | Ese proyecto, solo tú | Tus datos de prueba o direcciones personales; la documentación recomienda sacarlo de git |
Existe un cuarto nivel para empresas, que instala el área de sistemas en todas las computadoras. Y si tu proyecto crece, puedes partir las reglas por temas en la carpeta .claude/rules/, incluso para que algunas solo se carguen al tocar ciertos archivos.
Cómo crear tu CLAUDE.md en 3 comandos
Dentro de una sesión de Claude Code, en la carpeta de tu proyecto:
- Genera un primer borrador. Claude revisa tu proyecto y escribe un CLAUDE.md con lo que descubre. Si ya tienes uno, sugiere mejoras en vez de reemplazarlo.
/init - Ábrelo y complétalo con lo que Claude no puede adivinar: tus reglas, tu tono, tus «nunca hagas esto».
/memory - Comprueba que se cargó. Aparece en la lista de «Memory files».
/context
(Claude Code Docs · memory: /init, /memory y /context)
Qué poner en CLAUDE.md (y qué no) para que lo siga
La documentación da una regla muy práctica: CLAUDE.md es el lugar donde escribes lo que de otro modo volverías a explicar. Añade algo cuando:
- Claude comete el mismo error por segunda vez.
- Escribes en el chat la misma corrección que ya escribiste la sesión anterior.
- Alguien nuevo en el proyecto necesitaría saberlo para empezar.
Y para que lo siga de verdad, tres consejos de la misma documentación:
| Consejo | Mal | Bien |
|---|---|---|
| Concreto, que se pueda comprobar | «Formatea bien el código» | «Usa 2 espacios de sangría» |
| Corto: menos de 200 líneas | Un archivo que crece sin revisar | Lo largo, partido en .claude/rules/ o en una skill |
| Sin contradicciones | Dos reglas que dicen lo contrario | Revisarlas de vez en cuando y borrar las viejas |
Si dos reglas se contradicen, Claude puede elegir cualquiera de las dos. Y lo que es un procedimiento de muchos pasos, mejor en una skill: solo se carga cuando hace falta. (Claude Code Docs · memory)
Nuestro ejemplo real: en IActn, la primera regla de nuestro CLAUDE.md general es el tono: español de Latinoamérica, trato de tú, sin voseo. Entró ahí en mayo de 2026, después de que se colara voseo argentino en una pieza publicada. Desde entonces vale en todos los proyectos sin que nadie lo repita.
Un prompt para escribir tu CLAUDE.md a partir de tus correcciones
Es nuestro, no de Anthropic.
De correcciones sueltas a reglas permanentes
Cuándo usarlo: al final de una sesión en la que corregiste a Claude varias veces.
Lo honesto
- CLAUDE.md no es una orden, es contexto. La documentación lo dice claro: Claude lo lee e intenta seguirlo, pero no hay garantía, sobre todo con reglas vagas o contradictorias. Lo que tiene que pasar sí o sí va en un hook.
- Ocupa espacio en cada sesión. Todo lo que escribes se carga siempre, así que un CLAUDE.md enorme te gasta ventana de contexto y hace que siga peor las reglas.
- La memoria automática tiene un tope que no avisa bien. Solo se cargan las primeras 200 líneas o 25 KB de su índice: lo que pase de ahí no se lee al empezar. Nos pasó el 15-09-2026: el índice creció de más, la última entrada quedó fuera de lo que se carga y nada avisó. Desde entonces lo mantenemos por debajo del tope a propósito.
- Es de Claude Code, no del chat. En claude.ai lo equivalente son tus instrucciones, la memoria del chat y los proyectos: lo explicamos en Configura tu IA.
- Los comandos cambian con las versiones. Los de esta guía (
/init,/memory,/context) son los de la documentación al 30-09-2026.
La segunda vez que corriges a Claude en lo mismo, escríbelo en CLAUDE.md: corto, concreto y sin contradicciones. Y lo que no puede fallar nunca, no se lo pidas: conviértelo en un hook, la siguiente guía de la serie.
¿Y ahora qué?
Tres formas de seguir, según lo que prefieras.
El mensaje para tu grupo
¿Le sirve a alguien de tu equipo o de tu grupo? Cópialo tal cual o ábrelo directo en WhatsApp.
Te paso esta guía: Qué es CLAUDE.md. Lo que no quieres volver a explicar, escrito una vez. https://iactn.com/arsenal/claude-md/Fuentes, leídas el 30-09-2026
- How Claude remembers your project · Claude Code Docs. Qué es CLAUDE.md, la memoria automática y su tope de 200 líneas o 25 KB, dónde se guarda cada archivo,
/init,/memory,/context, cuándo añadir algo, el consejo de menos de 200 líneas y que no es una regla obligatoria. - Automate actions with hooks · Claude Code Docs. Por qué lo que debe pasar siempre va en un hook.