¿Por qué Claude Code olvida el contexto de mi proyecto?

Claude Code olvida el contexto del proyecto porque cada nueva sesión comienza con una ventana de contexto nueva, CLAUDE.md se carga como reglas estáticas (no memoria), y --resume tiene errores documentados donde el contexto de conversación anterior no se restaura completamente. La Memoria Automática captura notas breves, no transcripciones. Una capa de memoria de proyecto persistente mantiene el contexto completo cargable en cada ejecución.

Claude Code está construido en torno a la idea de que cada sesión es un agente nuevo. Tres mecánicas impulsan el olvido:

1. Cada sesión comienza con una ventana de contexto vacía. Claude Code inicia cada ejecución con una pizarra limpia, luego carga CLAUDE.md, cualquier archivo referenciado y tu aviso. La ventana en sí —típicamente 200K tokens en Claude Sonnet 4.5/4.6/4.7— es generosa pero por sesión. Las largas ejecuciones del agente que leen muchos archivos la llenan más rápido de lo que esperas.

2. `CLAUDE.md` son reglas, no memoria. La propia documentación de Anthropic describe CLAUDE.md como un archivo de incorporación estático que el agente lee al inicio de la sesión. Es perfecto para "usar pnpm, escribir pruebas con Vitest, nunca editar /legacy/*". No es un almacén de transcripciones. La razón detrás de las decisiones no pertenece allí, y la sustancia de las sesiones pasadas no vive allí.

3. `--continue` y `--resume` tienen problemas conocidos de pérdida de contexto. Un problema ampliamente discutido en GitHub (anthropics/claude-code #43696) informa que las sesiones reanudadas pueden comenzar frescas como si fueran una nueva conversación, perdiendo el contexto acumulado. Incluso cuando la reanudación funciona, las sesiones no pueden verse entre sí — no hay búsqueda entre sesiones.

El resultado: las reglas se mantienen, el estado del agente se evapora.

Cada nueva invocación de claude te cuesta reorientación:

• La razón detrás de las decisiones desaparece. "Elegimos mantener la tabla users_v1 de solo lectura debido al costo de migración" estaba en la sesión de ayer. El Claude Code de hoy sugiere escribir en ella.
• El trabajo en múltiples sesiones pierde el hilo. Las refactorizaciones que abarcan tres sesiones necesitan el plan frente al agente cada vez. Con CLAUDE.md puedes fijar un párrafo; no puedes fijar un plan de 12 pasos con justificación.
• Gastan tokens recargando los mismos archivos. Cada sesión vuelve a leer las mismas especificaciones, redescubre las mismas convenciones, vuelve a hacer las mismas preguntas aclaratorias.

Claude Code ofrece tres características destinadas a la persistencia. Cada una ayuda; ninguna reemplaza la verdadera memoria del proyecto.

`CLAUDE.md` es la herramienta adecuada para reglas estables y incorporación. Se carga en cada sesión. La guía oficial de Anthropic es poner instrucciones duraderas allí, no en mensajes anteriores. El lado negativo: CLAUDE.md es mejor mantenerlo corto — compite con todo lo demás por espacio de contexto — lo que lo convierte en el hogar equivocado para la historia del proyecto en evolución.

Memoria Automática permite a Claude guardar sus propias notas durante las sesiones, organizadas en preferencias de usuario, comentarios, contexto del proyecto y punteros de referencia. Útil para "el usuario prefiere diferencias concisas". No está diseñado para transcripciones completas o registros de decisiones.

`/resume` y `--continue` están destinados a retomar sesiones anteriores con contexto completo. En la práctica, los usuarios han informado (problema #43696, abril de 2026) que las sesiones reanudadas pueden comenzar en blanco, y incluso cuando funcionan, las sesiones no pueden verse entre sí.

Puedes leer la documentación oficial de Claude Code para conocer el conjunto completo de funciones.

Para reglas estables, los nativos son sólidos. Para el contexto del proyecto que abarca sesiones y herramientas, se quedan cortos.

El problema más profundo: la mayoría de los equipos que utilizan Claude Code también usan Cursor para iteraciones rápidas, Cascade para flujos de trabajo ajustados a IDE, y ChatGPT para discusiones de diseño. CLAUDE.md no viaja a ninguno de ellos. Cada herramienta obtiene su propia copia de las reglas del proyecto y su propia historia aislada. Los fragmentos de contexto se distribuyen entre herramientas y el proyecto paga.

La memoria necesita seguir al proyecto, no al editor.

MemoryLake es una capa de memoria entre modelos que se conecta a Claude Code a través del soporte nativo de MCP. En lugar de depender de un CLAUDE.md estático, le das al proyecto su propia memoria y Claude Code lee de ella en cada sesión.

• Memoria por proyecto, no por archivo. Especificaciones, ADRs, transcripciones pasadas de claude y registros de decisiones viven en el proyecto. Claude Code obtiene lo que es relevante por turno en lugar de intentar encajar todo en CLAUDE.md.
• 10,000× más contexto que la indicación en bruto. El motor de recuperación de MemoryLake lee de miles de millones de tokens de memoria del proyecto y devuelve solo las partes que importan. Dejas de gastar tokens recargando las mismas especificaciones.
• Portátil a cualquier otra IA. La misma memoria del proyecto funciona en Cursor, Windsurf, Claude Desktop, ChatGPT y Gemini. Cambia de herramientas a mitad de proyecto y tu contexto sigue.

MemoryLake obtuvo un 94.03% en el benchmark de contexto largo LoCoMo — el mejor resultado publicado hasta 2026 — con recuperación en milisegundos y cifrado de extremo a extremo AES-256.

1. Crea un proyecto y carga tu contexto. Inicia sesión en MemoryLake, abre Gestión de Proyectos, haz clic en Crear Proyecto y nómbralo según tu repositorio (por ejemplo, "acme-api — proyecto de Claude Code"). Sube tus especificaciones, ADRs y transcripciones pasadas de claude a través del Document Drive (PDF, Markdown, Word, Excel, imágenes, todo soportado). Agrega instrucciones breves en la pestaña de Memorias — mantén CLAUDE.md ligero y deja que MemoryLake contenga el contexto en formato largo.
2. Genera un endpoint de servidor MCP. Abre la pestaña de Servidores MCP dentro de tu proyecto, haz clic en Agregar Servidor MCP, nómbralo "integración de Claude Code" y haz clic en Generar. MemoryLake devuelve un ID de clave API, secreto y URL de endpoint. Copia el secreto de inmediato — solo se muestra una vez.
3. Agrega el servidor a la configuración MCP de Claude Code. Ejecuta claude mcp add memorylake --transport http <endpoint-url> y agrega el token Bearer cuando se te pida. (También puedes editar ~/.claude.json directamente si lo prefieres — ten cuidado con las comas finales; JSON no las permite.) Reinicia claude. El agente ahora tiene una herramienta memorylake que puede llamar al inicio de cada sesión para cargar el contexto del proyecto.