CLAUDE.md y memoria — que no tengas que repetirte

Crea el CLAUDE.md de tu proyecto con /init, qué poner (y qué no), dónde van tus preferencias personales y cómo funciona la memoria automática.

Fundamentos
10 min
6 pasos
Revisada el 25 de septiembre de 2026

Al terminar sabrás

Crear el CLAUDE.md de un proyecto con /init y mejorarlo a mano
Saber qué va en el CLAUDE.md del proyecto, en el personal y en CLAUDE.local.md
Entender la memoria automática y revisarla con /memory

Cada sesión empieza sin recordar las anteriores. Para no tener que explicarle cada día cómo es tu proyecto, existen dos mecanismos:

CLAUDE.md: instrucciones que escribes tú. Se cargan al empezar cada sesión.
Memoria automática: notas que Claude toma solo a partir de tus correcciones y preferencias.

Crea el CLAUDE.md de tu proyecto

Dentro de tu proyecto, en Claude Code:

Pídeselo a Claude

/init

Claude analiza el proyecto y crea un CLAUDE.md con los comandos para arrancarlo, la estructura y las convenciones que detecta. Si ya existe, te propone mejoras.

Luego edítalo tú. Es un archivo de texto normal (Markdown) en la raíz del proyecto.

Qué poner

Lo que un compañero nuevo necesitaría saber el primer día y no puede deducir leyendo el código:

Archivo Markdown

# Web de Fisio Marta

- Web estática: HTML + CSS, sin frameworks. No añadas dependencias sin preguntar.
- Tono de los textos: cercano, de tú. Nunca inventes opiniones ni cifras.
- Colores: verde #2F7D5B como principal. Tipografía: Inter para todo.
- Para verla: abre index.html en el navegador.
- Antes de dar algo por terminado, comprueba que se ve bien a 375 px de ancho.

Qué no poner

Cosas que ya se ven en el código (la lista de archivos, qué hace cada función).
Instrucciones vagas («haz buen código»).
Novelas: la recomendación oficial es menos de 200 líneas. Si crece, divídelo (ver abajo).
Contraseñas o claves. Nunca.

Los distintos CLAUDE.md

Archivo	Para qué	¿Se comparte?
`./CLAUDE.md` (o `./.claude/CLAUDE.md`)	Reglas del proyecto	Sí, va con el proyecto
`./CLAUDE.local.md`	Tus preferencias en este proyecto	No (añádelo a `.gitignore`)
`~/.claude/CLAUDE.md`	Tus preferencias en todos tus proyectos	No

Todos se suman; no se pisan unos a otros.

Importar otros archivos

Un CLAUDE.md puede traer otros con @ruta:

Archivo Markdown

Visión general del proyecto: @README.md
Comandos disponibles: @package.json

Reglas por temas

En proyectos grandes, crea la carpeta .claude/rules/ con un archivo por tema (textos.md, diseno.md…). Se cargan igual que el CLAUDE.md y son más fáciles de mantener.

Memoria automática

Está activada por defecto. Claude guarda notas en ~/.claude/projects/<proyecto>/memory/ sobre lo que aprende de ti: «prefiere respuestas cortas», «el cliente no quiere fotos de stock». Son archivos Markdown normales.