Claude Memory: Memory, CLAUDE.md y Auto Memory

¿Qué es la memoria de Claude y por qué tiene tres capas?#

El martes abres Claude.ai y le hablas de tu público, el formato de respuesta y tu estilo de escritura. El jueves vuelves en un chat nuevo y Claude ya lo recuerda. Eso es Memory en acción.

Abres Claude Code en el terminal, pasas dos semanas intentando entender un proyecto y explicas la estructura de carpetas, las reglas de despliegue y tus bibliotecas favoritas. Cierras la sesión y vuelves a abrirla una hora después, y el agente empieza desde cero. Aquí Memory no funciona. Para cambiar eso, necesitas CLAUDE.md.

En 2026 apareció una tercera capa. Auto Memory en Claude Code permite que el agente escriba por sí mismo notas sobre tu proyecto: qué comandos funcionan, qué pruebas pasan y qué rutas del repositorio son sensibles. Estas notas se guardan localmente en tu disco y se cargan automáticamente en la siguiente sesión.

La principal confusión: alguien oye que «Claude ahora recuerda» y piensa que funciona automáticamente en todas partes. No es así. Memory de claude.ai no se transfiere a Claude Code: la documentación oficial de Claude Code describe dos mecanismos de memoria, y Chat Memory no es uno de ellos. CLAUDE.md y Auto Memory funcionan en Claude Code; son sistemas completamente distintos. Lo mismo ocurre con la API de Anthropic: tiene una herramienta Memory independiente, sin relación con la memoria del chat.

Esta guía explica los tres sistemas para que sepas qué poner en cada lugar y por qué Claude de repente «olvida» un proyecto aunque hayas «configurado la memoria».

¿Qué es Memory en Claude.ai y quién la tiene gratis en 2026?#

Cómo recopila información Memory

Anthropic llama a este proceso Memory Synthesis. Aproximadamente una vez al día, Claude procesa tus conversaciones recientes, identifica qué puede ser útil a largo plazo y añade breves resúmenes a tu perfil de Memory. No son citas textuales de tus mensajes, sino afirmaciones condensadas como «el usuario es especialista en marketing, lleva un proyecto en línea y prefiere respuestas breves y sin relleno».

En tu siguiente conversación, estos resúmenes se añaden automáticamente al principio del contexto. Claude sabe quién eres, a qué te dedicas y qué estilo de respuesta te gusta, sin que tengas que repetirlo en cada chat.

Qué planes son compatibles con Memory

Anthropic lanzó Memory por etapas: 11 de septiembre de 2025: Team y Enterprise; 23 de octubre de 2025: Pro y Max; 2 de marzo de 2026: gratis en todos los planes, además de la herramienta de importación desde ChatGPT, Gemini y Grok.

Esto es importante: Memory funciona donde hay una interfaz web de Claude.ai o una aplicación móvil. Si utilizas Claude mediante tu propio código o la CLI, no tendrás Memory.

Dónde verla y editarla

En claude.ai: Ajustes → Funciones → Memory. URL directa: claude.ai/settings/capabilities?modal=memory. Se abrirá una lista con todo lo que Claude ha guardado sobre ti. Hay tres botones:

• Pausar: Claude conservará la memoria acumulada, pero dejará de usarla y añadir información.
• Restablecer la memoria: lo borra todo.

  Una vez que selecciones esta opción y hagas clic en «Restablecer memoria», no podrás deshacerlo.

• Editar entradas individuales: puedes borrar entradas concretas manualmente.

Los controles integrados funcionan directamente en el chat: dile a Claude «recuerda X» u «olvida Y» y Memory se actualizará sin que tengas que ir a Ajustes.

Otro dato importante: los proyectos de Claude.ai tienen memoria independiente.

Eso significa que las conversaciones de un proyecto no se incorporan a la memoria general, y viceversa.

Puedes preguntárselo directamente a Claude

En cualquier chat, escribe: «¿Qué recuerdas sobre mí?». Claude enumerará lo que recuerda para esa conversación. Es la forma más rápida de comprobar qué ha llegado a tu perfil de Memory.

Privacidad

Anthropic afirma explícitamente que tu memoria es privada y solo está asociada a tu cuenta; no se comparte con otros usuarios. De forma predeterminada, Anthropic puede utilizar tus conversaciones (incluidas las que se incorporan a Memory) para mejorar sus modelos. Puedes desactivar esta opción en los ajustes de privacidad, dentro de Controles de datos.

¿Qué es CLAUDE.md en Claude Code y en qué se diferencia de Memory?#

Memory recopila información sobre ti como persona: tu estilo, tus preferencias y tu profesión. CLAUDE.md se refiere a un proyecto concreto: este repositorio, estos comandos y estas reglas para trabajar con el código. La diferencia es fundamental: Memory reúne «quién soy en general», mientras que CLAUDE.md indica «cómo está organizado este trabajo».

Dónde busca Claude Code el archivo CLAUDE.md

En cuatro ubicaciones a la vez, ordenadas de menor a mayor prioridad:

Los cuatro archivos se cargan a la vez y se concatenan; no se sobrescriben entre sí.

El orden va del ámbito más general al más específico. Proyecto y Local van al final, así que quedan al final del contexto, más cerca de la solicitud. Por eso conviene incluir todo lo esencial en el CLAUDE.md del proyecto.

Qué suele incluirse

• Pila tecnológica del proyecto: Next.js / Prisma / PostgreSQL / Redis
• Comandos: cómo ejecutar las pruebas, compilar y desplegar
• Rutas sensibles: qué carpetas no se deben tocar sin una solicitud explícita
• Convenciones: estilo de los commits, formato de los nombres de archivo
• Reglas de negocio: qué es importante para el proyecto (por ejemplo, no codificar nunca los precios directamente)
• Referencias de contexto: «para la lógica de negocio, consulta docs/business/; para el sistema de diseño, consulta docs/design/» (puedes elegir los nombres de las carpetas; lo importante es no meterlo todo en un solo archivo)

Para ver una explicación completa, consulta la guía de CLAUDE.md, que incluye una plantilla lista para usar.

En qué se DIFERENCIA CLAUDE.md de Memory

En una frase: Memory es tu cabeza; CLAUDE.md son las instrucciones del proyecto colgadas en la pared de la oficina.

¿Qué es Auto Memory en Claude Code y dónde se almacena?#

En qué se diferencia Auto Memory de CLAUDE.md

CLAUDE.md contiene tus instrucciones. Auto Memory contiene notas que el agente escribe para sí mismo. Son tipos de contenido distintos.

Tú escribes CLAUDE.md a mano: «responde siempre en el idioma preferido del usuario», «publica con npm run deploy», «no toques la carpeta legacy/». Son reglas que estableces de antemano.

Auto Memory recoge lo que Claude aprende mientras trabaja. Ejecuta una prueba que falla porque falta un paquete; Claude anota: «en este proyecto, ejecuta npm install antes de las pruebas». Así no repetirá el mismo error en la siguiente sesión.

Dónde se almacena

Localmente en tu disco, en una carpeta distinta para cada proyecto:

~/.claude/projects/[project-name]/memory/

El archivo principal es MEMORY.md. Un detalle importante: Claude Code carga CLAUDE.md íntegramente, pero MEMORY.md tiene un límite: solo se cargan las primeras 200 líneas o 25KB, lo que ocurra primero. Así se evita que Claude se ahogue en sus propias notas acumuladas durante meses. Las notas persisten en un directorio local fuera del repositorio del proyecto. El texto cargado forma parte del contexto enviado al servicio de modelos configurado; la persistencia local no promete procesamiento sin conexión. No guardes secretos en estos archivos.

Cuándo funciona

Auto Memory funciona en Claude Code a partir de la versión v2.1.59+ y viene activado de forma predeterminada en las instalaciones nuevas. Para comprobar su estado y gestionarlo, utiliza el comando:

/memory

Este comando abre un editor para todas las capas de memoria, tanto CLAUDE.md como MEMORY.md. Puedes ver qué ha registrado Claude sobre tu proyecto, editarlo o borrarlo. Para desactivar Auto Memory por completo, establece autoMemoryEnabled: false en ~/.claude/settings.json o utiliza la variable de entorno CLAUDE_CODE_DISABLE_AUTO_MEMORY=1.

Qué suele incluirse

• Comandos que han funcionado o fallado
• La estructura del proyecto que el agente ha descubierto
• Antipatrones que ha encontrado
• Nombres de archivos y funciones clave

La documentación oficial de Claude Code de Anthropic explica directamente la diferencia:

En otras palabras: CLAUDE.md = instrucciones que escribes. Auto Memory = notas que Claude escribe para sí mismo basándose en tus correcciones y preferencias.

Memory o CLAUDE.md: ¿qué sistema se ocupa de cada tarea?#

Matriz de decisión

Memory y CLAUDE.md no duplican su función. Funcionan en productos distintos y guardan cosas distintas. Son como un calendario personal y una política de empresa: ambos son útiles, pero nadie los confunde.

Cuándo activar Memory: 3 situaciones en las que realmente ayuda#

Situación 1. Utilizas claude.ai como asistente personal

Escribes a Claude todos los días: reformula un correo, analiza una hoja de cálculo, propón una idea. Los temas cambian, pero tú eres la misma persona. Memory te evita tener que decir: «Hola, soy especialista en marketing, llevo un proyecto en línea y este es el estilo de respuesta que me gusta».

Después de una semana, Claude conoce tu profesión, el formato de respuesta, tus formatos favoritos, la longitud y el tono que prefieres. Cada nuevo chat empieza con esa información. Ahorras 30–60 segundos por conversación.

Situación 2. Redactas mucho contenido con el mismo estilo

Anuncios, publicaciones para redes sociales, boletines por correo electrónico: la misma voz de marca. Memory aprenderá tu estilo: qué palabras evitar, qué tono emplear y qué longitud deben tener los párrafos.

Una vez, a lo largo de un par de semanas, dile a Claude: «en nuestros textos, nada de rayas, tono cordial y no más de 3 párrafos». Quedará registrado. Después, cada nuevo texto ya respetará tu estilo sin que tengas que recordárselo.

Situación 3. Necesitas contexto sobre tu función

Eres diseñador y utilizas una pila concreta: Figma + Sketch, no Photoshop. Eres responsable de producto SaaS, no de comercio electrónico.

Memory recogerá ese contexto sobre tu función y adaptará automáticamente las respuestas. Habrá menos respuestas genéricas y más respuestas que encajen con tu trabajo concreto.

Cuándo no necesitas Memory

Si trabajas principalmente con Claude Code en el terminal, Memory no te aporta nada. Simplemente no funciona allí. Utiliza CLAUDE.md en su lugar y no confundas ambos sistemas.

Tampoco funciona allí si utilizas Claude mediante la API en tu código. Añade las instrucciones manualmente al prompt del sistema.

Si tienes un único tipo de tarea y no te importa repetir el contexto al principio de cada chat, Memory no es esencial. Es una comodidad, no un requisito.

¿Qué debes poner en CLAUDE.md y qué recogerá Auto Memory por su cuenta?#

Qué debe ir en CLAUDE.md

1. Descripción del proyecto en un párrafo: qué es, para quién y por qué.
2. Tecnologías del proyecto: qué frameworks, bibliotecas y bases de datos utiliza.
3. Comandos: pruebas, compilación y publicación. Los comandos exactos.
4. Directorios sensibles: qué no se debe tocar sin una solicitud explícita.
5. Convenciones: estilo de los commits, formato de los nombres de archivo e idioma de las respuestas.
6. Referencias de contexto: por ejemplo, «la lógica de negocio está en docs/business/; el diseño, en docs/design/». Tú eliges los nombres de las carpetas.

Qué puedes dejar para Auto Memory

1. Detalles del entorno local: en este equipo, Python está en /usr/local/bin/python3.11.
2. Cambios en el proyecto: qué comando falló ayer y por qué.
3. Descubrimientos provisionales: dónde están las pruebas de un módulo concreto.
4. Consejos sobre el flujo de trabajo: qué script ejecutar después de cada paso.

Qué no debe ir en ninguno de los dos

• Claves de API, contraseñas y tokens: van en .env, no en archivos de memoria.
• Datos personales de los clientes.
• Información que pronto puede quedar desactualizada (precios, fechas de cohortes, campañas temporales).
• Prompts para tareas puntuales: sobrecargan el contexto.

La regla de las 200 líneas

En su documentación, Anthropic recomienda que CLAUDE.md tenga unas 100–200 líneas. A partir de 200 líneas, Claude la lee con menos eficacia: un contexto largo consume recursos y reduce la precisión. Cuando el archivo crezca, mueve secciones a archivos .md independientes que estén cerca y deja referencias breves en CLAUDE.md: «para el estilo del código, consulta docs/code-style.md».

Para ver un desglose detallado de la estructura del archivo, consulta la guía para crear un Second Brain para Claude Code, que explica cómo la estructura pasa de CLAUDE.md a cinco carpetas de contexto.

¿Cuáles son los 5 errores que estropean la memoria de Claude y cómo puedes evitarlos?#

Error 1. Confundir Memory con CLAUDE.md

Es el error más habitual. Alguien oye que «Claude ahora recuerda», activa Memory en claude.ai, luego abre Claude Code en el terminal y se pregunta por qué el agente vuelve a «olvidarlo» todo.

Memory en claude.ai no se transfiere a Claude Code. Son productos distintos con arquitecturas diferentes. Si quieres que Claude recuerde un proyecto en el terminal, escribe CLAUDE.md. Si quieres que Claude te recuerde en el navegador, activa Memory.

Cómo evitarlo. Antes de configurar la memoria, decide dónde trabajas principalmente. Si es en claude.ai, utiliza Memory. Si es con Claude Code, utiliza CLAUDE.md y Auto Memory. Si usas ambos, configura los dos sistemas en lugar de intentar combinarlos.

Error 2. Olvidar que los nombres de archivo distinguen entre mayúsculas y minúsculas

El nombre de archivo CLAUDE.md distingue entre mayúsculas y minúsculas. El archivo en mayúsculas CLAUDE.md será leído por el agente. claude.md y Claude.md no. Lo mismo ocurre con CLAUDE.local.md. Es un fallo típico de quienes configuran Claude Code por primera vez: crean un archivo, escriben instrucciones y se preguntan por qué no funciona, pero el nombre está en minúsculas.

Cómo evitarlo. Comprueba las mayúsculas y minúsculas antes de guardar. En Mac, selecciona el archivo en Finder y pulsa Intro para ver el nombre completo. En el terminal: ls -la CLAUDE*. Si aparece claude.md, cámbiale el nombre: mv claude.md CLAUDE.md.

Error 3. CLAUDE.md ha crecido hasta las 800 líneas

Consigues una plantilla lista para usar, añades todas las reglas que parecen importantes y acabas con un archivo de 800 líneas. Ahora Claude tarda más en leerlo, pero la calidad de las respuestas empeora. Un contexto largo consume la atención del modelo.

Cómo evitarlo. Mantén CLAUDE.md en unas 100–200 líneas. A partir de 200, mueve secciones a archivos .md independientes y deja referencias en CLAUDE.md: «para el estilo del código, consulta docs/code-style.md». Es el mismo principio que se aplica a cualquier documentación para personas: no lo metas todo en un solo archivo.

Error 4. Guardar secretos en CLAUDE.md o Auto Memory

Las claves de API, las contraseñas y los tokens no deben estar en archivos de memoria. CLAUDE.md suele guardarse en git, por lo que los secretos acabarán filtrándose al repositorio. Auto Memory se almacena localmente, pero su contenido podría aparecer en una captura de pantalla, una conversación compartida o una filtración a través de un servidor MCP con acceso al disco.

Cómo evitarlo. Guarda los secretos en .env (y añade .env a .gitignore). En CLAUDE.md, menciona solo los nombres de las variables: «clave de API en STRIPE_KEY; obtenerla de .env».

Error 5. Esperar que Auto Memory descubra por sí sola la lógica de negocio

Auto Memory recopila observaciones técnicas: comandos, errores y estructura. No aprenderá por sí sola las reglas de negocio («en una inmobiliaria, no aceptar pedidos por debajo de cierto límite», «no usar ciertas palabras en los textos»). Esas reglas deben ir en CLAUDE.md o en archivos .md independientes a los que haga referencia CLAUDE.md.

Cómo evitarlo. Sepáralas: los detalles técnicos se añaden automáticamente a Auto Memory. Escribe a mano en CLAUDE.md las reglas de negocio, el estilo y las convenciones. No esperes que un sistema sustituya al otro.

¿Cómo configurar Memory + CLAUDE.md en una tarde (guía paso a paso)?#

1. Activa Memory en Claude.ai. Abre Ajustes → Funciones → Memory. Activa el interruptor. Comprueba enseguida los ajustes de privacidad: decide si permites que Anthropic use tus conversaciones para entrenar modelos. Tú eliges.

2. Háblale a Claude de ti. En tus próximos 2–3 chats, cuéntale quién eres, a qué te dedicas y qué estilo de respuesta te gusta. Memory Synthesis lo registrará en el plazo de un día.

3. Comprueba al día siguiente qué se ha registrado. En cualquier chat, escribe: «¿Qué recuerdas sobre mí?». Claude enumerará sus recuerdos. Si algo no te gusta, bórralo en Ajustes → Memory o pídele a Claude que lo olvide.

4. Crea CLAUDE.md en tu proyecto. En la raíz de tu proyecto principal, crea un archivo llamado CLAUDE.md (con mayúsculas). La plantilla lista para usar de la guía de CLAUDE.md tiene 6 secciones y, según Anthropic, se recomienda que ocupe unas 200 líneas.

5. Rellena las secciones de tu proyecto. Describe la pila tecnológica, los comandos, las rutas sensibles y las convenciones. No más de 200 líneas: a partir de ahí, Claude leerá el archivo con menos eficacia.

6. Comprueba Auto Memory. En Claude Code, escribe el comando /memory. Se abrirá un editor para todas las capas. Auto Memory es una de ellas. Lee lo que Claude ya sabe sobre tu proyecto.

7. Guarda CLAUDE.md en git. Forma parte del proyecto. Si trabajas en equipo, todos podrán ver las reglas.

8. Sigue trabajando como siempre. Después de cada error del agente, añade una línea a CLAUDE.md que diga «no hagas eso». Al cabo de un mes tendrás un conjunto de reglas vivo y Claude dejará de caer en los mismos errores.

Qué no funciona: 3 patrones que la memoria de Claude no retiene#

El estado de la sesión no se conserva al cambiar de modelo

Trabajas en Claude Code con Opus 4.8 y luego cambias a Sonnet 4.6: el contexto de la sesión puede restablecerse porque los modelos tienen ventanas de contexto distintas. CLAUDE.md y Auto Memory se cargarán automáticamente en la nueva sesión, pero no la conversación activa.

Los archivos que no has mostrado no se cargan

Claude solo ve lo que está en CLAUDE.md, lo que hay en Auto Memory y lo que hayas abierto explícitamente en la sesión actual. Si tu proyecto tiene 500 archivos y escribes «mira cómo gestiono los pagos», el agente no sabe qué archivo debe revisar. Tienes que proporcionar la ruta explícitamente o añadir una referencia en CLAUDE.md.

Memory no funciona en conversaciones puntuales a través de la API

Cada solicitud a la API de Claude está aislada. No se carga ninguna memoria. Si creas un chatbot mediante la API, debes pasar manualmente el prompt del sistema y el historial de mensajes. Memory, CLAUDE.md y Auto Memory no sirven en este caso.

Qué hacer después: la memoria como punto de partida para un Second Brain#

CLAUDE.md y Auto Memory le dan a Claude una memoria de cómo está organizado el código. Es suficiente para tareas técnicas: refactorizaciones, errores, migraciones y pruebas.

Pero en cuanto necesitas tomar decisiones de negocio —a quién enviar un correo, cómo formular una oferta o qué precio fijar—, la memoria técnica no basta. Necesitas contexto: quiénes son tus clientes, cómo toman decisiones y cómo funciona la economía de tu negocio.

Eso es el Second Brain: una carpeta de conocimientos empresariales junto al proyecto, a la que Claude accede mediante referencias en CLAUDE.md. Memoria del código más memoria del negocio: el agente deja de ser «un asistente inteligente que alucina» y se convierte en tu coautor.