Blog/Vídeos

Claude Code Auto Dream: memoria persistente y tokens

Si trabajas con Claude Code, sabes lo frustrante que es repetir el contexto de tu proyecto en cada sesión. Esta amnesia recurrente no solo consume tu tiempo, sino también tus valiosos tokens, impidiendo que tu agente mejore con…

¿Qué es Claude Auto Dream?

Claude Auto Dream es una funcionalidad experimental de Anthropic que permite a Claude Code consolidar, podar y reorganizar la memoria del proyecto periódicamente. Actúa sobre Auto Memory para eliminar contexto obsoleto, optimizando el uso de tokens y mejorando la precisión de las interacciones en proyectos de larga duración.

El Problema de la Amnesia en Agentes de IA: Una Analogía Cerebral

He comprobado que uno de los mayores desafíos al trabajar con agentes de IA como Claude Code es su falta de memoria persistente. Cada nueva sesión es, en esencia, como si el agente te conociera por primera vez. Esto no solo es ineficiente, sino que tiene un coste directo en tiempo, tokens y la calidad de las interacciones. Para abordar esto, Anthropic ha lanzado en modo experimental una solución prometedora: Auto Dream.

Para entender la genialidad de Auto Dream, me gusta usar una analogía con el cerebro humano. ¿Por qué dormimos? No es solo para descansar. Mientras estamos despiertos, nuestro cerebro captura una avalancha de información desordenada en la memoria a corto plazo. Pero es durante el sueño cuando nuestro cerebro revisa, decide qué es importante, consolida recuerdos valiosos y elimina el ruido, reorganizando todo para un acceso eficiente al despertar. Sin este proceso, nuestra memoria sería un caos inmanejable.

Claude Code enfrentaba exactamente el mismo problema. Su memoria se acumulaba sin control, sin un mecanismo de poda o reorganización. Auto Dream replica este proceso:

  • Cerebro Humano Durmiendo: Consolida recuerdos, elimina información irrelevante, refuerza lo importante, reorganiza para acceso rápido.
  • Claude Code Auto Dream: Consolida la memoria del proyecto, poda el contexto obsoleto, prioriza decisiones clave, reorganiza para eficiencia.

No es una simple metáfora; es el mismo mecanismo trasladado a la arquitectura de un agente de IA.

Las Tres Capas de Memoria en Claude Code

Para comprender dónde encaja Auto Dream, es crucial entender las capas de memoria existentes y cómo esta nueva funcionalidad las complementa:

  1. Sesiones Normales (Sin Memoria)

    Este es el estado por defecto si no tienes ninguna configuración de memoria activa. Cada vez que abres Claude Code, la sesión comienza desde cero, sin contexto de conversaciones o decisiones previas. Es como conocer a alguien por primera vez en cada interacción.

  2. Auto Memory (Acumulación en Tiempo Real)

    Esta capa ya existía y es la más común. Mientras trabajas, Auto Memory captura en tiempo real decisiones, preferencias y contexto del proyecto, guardándolos en archivos con formato Markdown. Al inicio de cada nueva sesión, estos archivos se inyectan para proporcionar contexto. El problema fundamental es que solo acumula. No limpia, no poda, no reorganiza. Con el tiempo, esto lleva a un «bloat» de información innecesaria.

  3. Auto Dream (Consolidación y Poda Periódica)

    Esta es la novedad. Auto Dream no sustituye a Auto Memory, sino que actúa sobre ella. Periódicamente, cuando no estás utilizando Claude Code, Auto Dream consolida, poda y reorganiza la memoria generada por Auto Memory. Es el sistema de mantenimiento que transforma una memoria caótica en una memoria útil y eficiente. Literalmente, Claude «duerme» y al despertar, recuerda mucho mejor.

La Arquitectura Interna de Auto Dream: Un Subagente en Acción

Aquí es donde la mayoría de las explicaciones fallan y donde reside un detalle técnico crucial. Auto Dream no es un simple script; es un proceso de cinco pasos ejecutado por un subagente. Este subagente es, de hecho, una instancia real de Claude, lo que implica un consumo de tokens.

El Proceso de Cinco Pasos:

  1. Recopila: Lee todas las sesiones recientes de tu proyecto.
  2. Lee Memoria: Consulta los archivos Markdown de memoria existentes para no partir de cero.
  3. Analiza y Decide: El subagente (instancia de Claude) analiza la información y decide qué es importante guardar.
  4. Poda: Elimina duplicados y contexto obsoleto o irrelevante.
  5. Guarda: Actualiza los archivos Markdown de memoria, dejándolos limpios y al día, sin tocar nunca tu código fuente.

Es vital entender que este subagente consume tokens. En proyectos pequeños, el impacto es mínimo, pero en proyectos grandes, esto puede ser relevante para tu presupuesto de API. Planifica en consecuencia.

El Impacto Económico y de Eficiencia: Reducción del Consumo de Tokens

He comprobado un dato que rara vez se explica: cuando Claude Code inicia una sesión en un proyecto con mucho historial y sin Auto Dream, tiene que cargar toda esa memoria acumulada. Esta carga consume una parte significativa del contexto disponible, pudiendo ser entre el 60% y el 70% del contexto total antes de que hayas escrito una sola línea de código. Esto significa que Claude trabaja con menos «espacio mental» disponible para tus tareas actuales, resultando en respuestas menos precisas, decisiones más complejas y un coste por sesión mucho más alto.

Una memoria bien consolidada por Auto Dream puede reducir esa carga inicial al 30% o 40% del contexto. ¿El resultado? Más tokens disponibles para trabajar, respuestas más precisas y, en proyectos de larga duración (semanas o meses), un ahorro real y medible en costes de API si trabajas con Claude Code Pro o directamente con la API. Auto Dream no es solo una funcionalidad de comodidad; es una funcionalidad de eficiencia económica.

Arquitectura de Archivos del Proyecto y el Rol de cloud.md

Auto Dream interactúa con ciertos archivos de memoria dentro de tu proyecto, pero es crucial entender qué toca y qué no:

  • cloud.md: Este es el archivo más importante que debes crear manualmente en cualquier proyecto serio. Contiene las instrucciones permanentes para Claude (cómo quieres que trabaje, convenciones, qué nunca debe hacer). Auto Dream siempre lo respeta y nunca lo modifica. Es sagrado.
  • memory.md: Aquí es donde Auto Memory escribe continuamente. Auto Dream consolida y poda este archivo, ordenando la información.
  • decisions.md: Almacena decisiones técnicas importantes.
  • context.md: Contiene el contexto general del proyecto.
  • Código Fuente: Auto Dream nunca altera tu código fuente. Solo gestiona los archivos de memoria narrativa.

Los Cuatro Estados de Auto Dream

Auto Dream puede encontrarse en uno de estos cuatro estados:

  • Never Run: Nunca se ha ejecutado. Es el estado inicial para todos.
  • Configured: Está configurado y en espera, listo para ejecutarse cuando se cumplan las condiciones.
  • Dreaming: Se está ejecutando en ese momento. Puede tardar desde 30 segundos en proyectos pequeños hasta 10 minutos en proyectos grandes.
  • Last Run: Indica cuándo fue la última ejecución y confirma que el sistema funciona correctamente.

Cómo Activar Auto Dream

Existen tres formas de activar Auto Dream:

  1. Directamente a Claude Code: Puedes decirle a Claude Code en tu entorno (VS Code o terminal) que ejecute un Dream ahora. Por ejemplo, «Oye, ejecuta un Dream ahora con Auto Dream.»
  2. Comando del Terminal: Utiliza el comando
    /memory
    , selecciona la opción «Auto Dream» y lánzalo manualmente.
  3. Activación Automática: Puedes configurarlo para que se ejecute cada cierto tiempo o después de un número determinado de sesiones. Sin embargo, en su modo experimental actual, he notado que la ejecución automática no siempre es predecible. Si la previsibilidad es clave para tu proyecto, te recomiendo activarlo manualmente.

Guía Práctica: Cuándo Usar y Cuándo No Usar Auto Dream

Cuándo Hacer un Dream:

  • Cuando llevas cinco o más sesiones en un mismo proyecto.
  • Cuando Claude empieza a contradecirse con decisiones pasadas.
  • Antes de empezar una fase nueva del proyecto.
  • Al final de una semana de trabajo intensivo.
  • Cuando la memoria se sienta «ruidosa» o confusa.

Cuándo NO Hacer un Dream:

  • Cuando estás en medio de una sesión con contexto crítico activo.
  • Cuando el proyecto tiene menos de dos o tres sesiones de historial.
  • Cuando acabas de lanzar el proyecto por primera vez (no tiene sentido).
  • Cuando necesitas Claude Code inmediatamente (recuerda que puede tardar hasta 10 minutos).

Limitaciones Clave de Auto Dream (Modo Experimental)

Antes de lanzarte, es crucial conocer estas seis limitaciones:

  1. Modo Experimental: Anthropic no ha hecho un anuncio oficial. Puede cambiar, mejorar o desaparecer sin previo aviso.
  2. Rollout Gradual (Feature Flag): Es posible que tu cuenta aún no lo tenga activo. Si no lo ves, espera unos días.
  3. Consume Tokens: El subagente es una instancia real de Claude y consume tokens. Planifica tu presupuesto.
  4. Puede Podar de Más: La limpieza automática podría eliminar contexto que aún necesitabas. Por eso, el archivo cloud.md es tan importante.
  5. Duración Variable: En proyectos grandes, puede tardar hasta 10 minutos. Planifica los Dreams para momentos donde no necesites Claude Code de inmediato.
  6. Solo Actúa sobre Archivos Markdown: Auto Dream consolida la memoria narrativa, no el código fuente. No esperes que recuerde cambios técnicos que has hecho directamente en el código.

Demostración Práctica en VS Code

En mi demostración, he utilizado un proyecto de desarrollo web previo. Al ejecutar el comando

/memory
en el terminal de VS Code, se muestra el estado de Auto Memory y Auto Dream. Una vez activado Auto Dream, le pedí a Claude que me «hiciera un dream» sobre el proyecto y recordara de qué iba. Claude procedió a revisar los archivos, consolidar la memoria y, sin necesidad de repetir contexto, me proporcionó un resumen claro del proyecto, incluyendo los archivos principales y el objetivo de crear herramientas y webs con contenido scroll-stopping. Esto es una absoluta locura: sin explicaciones repetidas, Claude ya sabe dónde estamos, qué decisiones tomamos y qué viene ahora. Es un antes y un después en proyectos de larga duración.

Comparativa y Datos Clave

Para que tengas una visión clara, he preparado esta tabla comparativa:

CaracterísticaAuto MemoryAuto Dream
Cuándo ActúaEn tiempo real, mientras trabajasEn segundo plano, cuando no usas Claude
Qué HaceCaptura y añade continuamenteConsolida, poda y reorganiza periódicamente
Problema ResueltoMemoria crece sin control (bloat)Resuelve el crecimiento podando y reorganizando
Resultado FinalArchivos.md con mucho ruidoArchivos.md limpios y eficientes
Toca el CódigoNoNo (solo archivos de memoria.md)

Momentos Clave del Vídeo

Ve directo a la parte que más te interese:

  • 0:00 El problema de la amnesia en Claude Code y la introducción de Auto Dream.
  • 2:00 Analogía con el sueño del cerebro humano para explicar el funcionamiento de Auto Dream.
  • 3:45 Las tres capas de memoria en Claude Code: Sesiones Normales, Auto Memory y Auto Dream.
  • 5:00 El proceso interno de Auto Dream (5 pasos) y el consumo de tokens por el subagente.
  • 6:30 Reducción del 60-70% en el consumo de tokens inicial gracias a Auto Dream y su impacto económico.
  • 10:00 Cuándo usar y cuándo no usar Auto Dream, y sus seis limitaciones clave.
  • 14:00 Demostración práctica de activación y uso de Auto Dream en VS Code.

Preguntas frecuentes

¿Qué es Claude Auto Dream?

Es una funcionalidad experimental de Anthropic que permite a Claude Code consolidar, podar y reorganizar la memoria del proyecto periódicamente. Actúa sobre Auto Memory para eliminar contexto obsoleto y nunca altera tu código fuente.

¿Cuánto reduce Auto Dream el consumo de tokens?

Sin Auto Dream, la memoria acumulada puede ocupar entre el 60% y el 70% del contexto antes de escribir una línea de código. Una memoria consolidada reduce esa carga inicial al 30% o 40%. Ten en cuenta que el subagente que hace el proceso consume tokens, algo relevante en proyectos grandes.

¿Cómo se activa Auto Dream?

Hay tres formas: pedirle a Claude Code que ejecute un Dream, usar el comando /memory y seleccionar la opción Auto Dream, o configurar la activación automática. En su modo experimental la ejecución automática no siempre es predecible, así que el autor recomienda el modo manual si necesitas previsibilidad.

Conclusión

Auto Dream no es una funcionalidad menor; es la pieza que le faltaba a Claude Code para ser un agente verdaderamente eficaz en proyectos de larga duración. Sin una memoria persistente bien gestionada, tienes una herramienta potente pero con amnesia. Con Auto Dream, obtienes un colaborador que aprende, recuerda y mejora con el tiempo, optimizando tus costes y la precisión de tus interacciones. Si utilizas Claude Code de forma seria, te recomiendo activarlo hoy mismo. El proceso es rápido y el impacto en la eficiencia de tus proyectos es inmediato.

Aprende IA cada domingo, en directo

Únete gratis a las mentorías de los domingos: 90 minutos en directo con las novedades de la semana y casos prácticos.

Unirme gratis

Un comentario

Próximo directo: dom 15 nov · 19:00h (España)

Empieza este domingo.

El próximo domingo, personas que quieren accionar estarán en esta reunión aprendiendo a aplicar IA en su negocio. Tú eliges si estás o no estás.

Pon tu email real. Te enviaremos plantillas y regalos por email.

Datos protegidos · Sin spam · Cancelas cuando quieras

+3000 en el grupo
+20 países
100% gratis