Claude Code sí recuerda tu proyecto entre sesiones, pero no funciona como una memoria única y permanente. La documentación actual de Anthropic, revisada el 8 de abril de 2026, separa el sistema en dos capas integradas: CLAUDE.md para las instrucciones que escribes tú y auto memory para los patrones que Claude aprende a partir de correcciones repetidas.
La confusión aparece cuando todo eso se mete dentro de la misma etiqueta de “Claude Code memory”. Hay cosas que deben guardarse como reglas explícitas. Hay cosas que Claude puede aprender con repetición. Y hay necesidades que en realidad ya no pertenecen a la memoria integrada de Claude Code, sino a una capa externa para continuidad entre herramientas o entre máquinas. Cuando separas esos trabajos, memory deja de parecer magia y empieza a parecer una configuración práctica.
La regla operativa más útil es sencilla: si perder esa regla te costaría caro, escríbela en CLAUDE.md; si Claude puede aprenderla con correcciones repetidas, deja que la mantenga auto memory; si necesitas continuidad entre herramientas, máquinas o un retrieval mucho más amplio, entonces sí tiene sentido pensar en un plugin. Antes de decir que Claude “olvidó” algo, abre /memory y /context para ver qué se cargó de verdad.
Qué debe recordar Claude Code y qué no
La pregunta correcta no es “si Claude Code tiene memoria”, sino “qué debe recordar cada capa”.
CLAUDE.md es la capa de reglas explícitas. Aquí van el workflow del repositorio, los comandos de prueba, los límites de seguridad, los directorios sensibles y las reglas de trabajo que deben estar presentes desde el primer turno. Pero Anthropic deja una advertencia importante en su documentación actual: CLAUDE.md es contexto, no enforcement duro. Si el archivo es vago, contradictorio o demasiado largo, Claude seguirá desviándose.
auto memory es la capa de aprendizaje. Sirve mejor para patrones que pueden consolidarse con repetición: qué comando sueles correr primero, cómo se nombran ciertas cosas en el proyecto, qué clase de review comment se espera o qué convenciones internas se corrigen una y otra vez. Es útil, pero también tiene un límite claro: hoy sigue siendo machine-local, no una memoria universal que te siga automáticamente por todas partes.
Los plugins y capas externas de memoria son otra categoría. El marketplace de Anthropic ya muestra productos de memory extension, y por eso la SERP mezcla memoria integrada con soluciones tipo second brain. Pero eso no significa que el plugin sea la respuesta por defecto. Si tu problema real es que Claude recuerde reglas del repositorio y hábitos repetidos dentro de este entorno, la capa integrada debe ser el punto de partida.
La idea más importante puede resumirse así: lo que debe sobrevivir sin duda se escribe, lo que puede aprenderse se deja aprender y solo se escala fuera cuando la frontera integrada realmente rompe el flujo.
Qué se carga al iniciar y qué no
No todos los archivos de memoria entran al contexto del mismo modo. Muchas veces el problema no es que memory no exista, sino que se asumió que todo se cargaba por igual.
La documentación actual de Anthropic dice que CLAUDE.md se carga al inicio de cada conversación. Por eso las reglas que deben estar visibles desde el primer momento tienen que vivir ahí. No es el lugar para “a ver si Claude luego lo descubre”.
Con auto memory el comportamiento es más selectivo. La carpeta de memoria usa un MEMORY.md índice y archivos temáticos opcionales. El contrato oficial actual dice que al inicio solo se cargan las primeras 200 líneas de MEMORY.md, o los primeros 25KB. Los topic files se leen on demand. En otras palabras: que un archivo exista no significa que ya esté dentro de la sesión actual.
Por eso /memory y /context son herramientas de diagnóstico reales, no simples extras. /memory muestra qué CLAUDE.md, CLAUDE.local.md y rules files están cargados, y te deja inspeccionar la carpeta de memoria. /context muestra el desglose vivo del contexto. Si Claude parece haber olvidado algo, primero confirma si esa información realmente entró al contexto.
También hay que decir pronto el límite machine-local. Anthropic documenta un path local bajo tu home directory. Eso hace que la memoria integrada sea inspeccionable y práctica, pero no la convierte en una memoria sincronizada automáticamente entre máquinas o entornos remotos.
Cómo estructurar CLAUDE.md sin convertirlo en un cajón de sastre
El mejor CLAUDE.md no es el más grande, sino el que tiene una división de trabajo clara.
El CLAUDE.md del proyecto debe contener lo que el repositorio necesita siempre: flujo de pruebas, reglas de cambios, directorios delicados, restricciones arquitectónicas o convenciones que importan para todo el equipo. No debería convertirse en una enciclopedia. La recomendación de Anthropic de mantenerlo relativamente corto existe porque los archivos inflados degradan la obediencia y ensucian el contexto.
El ~/.claude/CLAUDE.md del usuario sirve para preferencias personales entre proyectos: tono de explicación, cuándo pedir confirmación primero o hábitos tuyos que no pertenecen al repositorio. Ese es tu espacio de defaults, no la política del repo.
CLAUDE.local.md encaja mejor para notas privadas de proyecto que no deben entrar en version control. La utilidad de esta capa es la precisión, no crear un segundo archivo gigante.
Si una regla solo aplica a un path o a un workflow muy concreto, .claude/rules/ suele ser mejor que seguir apilando excepciones en el archivo principal. Así Claude ve la regla correcta cuando de verdad importa.
Otro detalle fácil de perder: Claude Code no lee AGENTS.md directamente. La recomendación actual de Anthropic es importarlo desde CLAUDE.md si otro sistema ya gobierna las instrucciones del repo. Si no haces ese puente, luego parece que “había reglas y Claude no las respetó”, cuando en realidad nunca las cargó.
Si todavía estás estabilizando instalación o autenticación, conviene empezar por nuestra guía de instalación de Claude Code. Ordenar memory es mucho más fácil cuando la base del CLI ya funciona bien.
Cómo funciona auto memory en la práctica
auto memory se sobrevende con facilidad porque su nombre suena a “memoria a largo plazo que se arregla sola”. En la práctica es una capa de aprendizaje visible, ordenable y controlable.
No es una caja negra. Anthropic documenta el path de almacenamiento, el índice MEMORY.md y los archivos temáticos. Eso significa que puedes inspeccionar lo que Claude aprendió en lugar de adivinarlo. Si la calidad de memory cae, a veces el problema no es que Claude no recuerde, sino que la propia carpeta de memoria se volvió desordenada.
Tampoco es una capa sin límites. Al inicio solo entra una parte de MEMORY.md; los topic files se leen cuando toca. Si una instrucción debe estar siempre presente, esconderla en un archivo temático profundo es la manera equivocada de usar el sistema. Esa instrucción debe volver a CLAUDE.md.
Además hay superficie de control. La documentación actual de Anthropic menciona /memory, la opción autoMemoryEnabled: false y la variable CLAUDE_CODE_DISABLE_AUTO_MEMORY=1. Eso sirve para aislar problemas: distinguir entre “la capa integrada no alcanza” y “la configuración está sucia”.
La tentación es preguntar si auto memory es “lo bastante inteligente”. Una pregunta mejor es si lo que intentas que recuerde pertenece de verdad a esta capa. auto memory funciona bien con hábitos repetidos y preferencias operativas. Funciona mal cuando le pides ser a la vez policy engine, knowledge base compartida, almacenamiento multi-equipo y retrieval universal.
Por qué Claude olvida cosas tras /compact o entre sesiones
La mayoría de los casos de “Claude olvidó” no prueban que la memoria no exista. Lo que prueban es que la capa correcta no estaba cargando el trabajo correcto.
La primera rama es no se cargó. Empieza por /memory. Quizá el CLAUDE.md que dabas por supuesto no estaba en la sesión. Quizá asumiste que un topic file se cargaba al inicio cuando el contrato oficial dice lo contrario.
La segunda rama es la regla era demasiado vaga o conflictiva. Anthropic deja claro que CLAUDE.md es contexto, no enforcement duro. Frases blandas o reglas que tiran en direcciones opuestas se sienten como memoria rota, cuando en realidad el problema es de claridad.
La tercera rama es solo existía en la conversación. Esta es probablemente la regla de diagnóstico más útil del sistema. Si algo desaparece después de /compact, la explicación oficial es que probablemente vivía solo en el chat y no en CLAUDE.md. Si de verdad importa, no puede quedarse solo en la conversación.
La cuarta rama es aquí ya tocaste el límite real. Si necesitas continuidad entre herramientas, entre máquinas o un retrieval mucho más amplio, ahí sí un plugin puede tener sentido. Pero solo después de descartar carga, calidad de reglas y persistencia conversacional.
El orden seguro es este:
- Revisar
/memory. - Confirmar si esa información debería vivir en
CLAUDE.md. - Reescribir reglas vagas o conflictivas.
- Mirar
/contextsi la sesión está inflada. - Solo al final preguntar si la frontera integrada ya no alcanza.
Si el problema real se parece más a presión de contexto o gasto de usage que a división de memory, sigue nuestra guía de uso y límites de Claude Code. Desde fuera, ambos problemas se parecen.
Cuándo un plugin ayuda de verdad y cuándo solo complica
Un plugin ayuda cuando tu necesidad ya es mayor que la memoria integrada de Claude Code: continuidad entre herramientas, entre máquinas, retrieval más rico o una capa de conocimiento compartido.
Un plugin es exagerado cuando todavía no separaste bien las capas integradas. Si aún no distingues CLAUDE.md de auto memory, si no miraste /memory o si sigues tratando la conversación como si fuera memoria duradera, la capa externa suele tapar la confusión en lugar de resolverla.
La postura más segura es conservadora: primero exprime bien la memoria integrada y solo después escala, cuando puedas nombrar con precisión la frontera que de verdad te está frenando.
Preguntas frecuentes
¿Claude Code recuerda el proyecto entre sesiones?
Sí, pero a través de capas integradas, no de una memoria única y permanente.
¿Qué debería ir en CLAUDE.md?
Las reglas duraderas: workflow, pruebas, límites de seguridad y convenciones importantes del proyecto.
¿Dónde está MEMORY.md?
Según la documentación actual de Anthropic, la auto memory integrada se guarda bajo ~/.claude/projects/<project>/memory/, con un índice MEMORY.md y archivos temáticos opcionales.
¿Por qué Claude olvidó algo después de /compact?
Porque lo más probable es que esa instrucción solo viviera en la conversación y no en CLAUDE.md. Tras /compact, Claude vuelve a leer la capa duradera desde disco.
¿Necesito un plugin de memoria?
No por defecto. Empieza por la memoria integrada. Piensa en un plugin solo cuando necesites continuidad o retrieval más allá del modelo local incorporado.
La memoria de Claude Code funciona mejor cuando dejas de pedirle que sea un cerebro infinito. Usa CLAUDE.md para lo que debe estar siempre explícito, deja que auto memory absorba patrones repetidos, inspecciona la sesión con /memory y /context, y escala a un plugin solo cuando la frontera integrada sea de verdad el problema.