Los hilos de mensajes de Claude no son memoria — Qué guarda la API durante cinco minutos y por qué la compactación debe iniciar un nuevo hilo (2026)

Antes de los hilos, cada solicitud a la API de Messages transportaba la conversación completa. El anuncio describe el costo: "Un agente de programación podría realizar cientos de solicitudes en una sesión, y cada solicitud reenvía cada mensaje anterior y resultado de herramienta".

Con un hilo, se añade un parámetro, thread, a una solicitud de la API de Messages. La documentación establece el patrón en tres pasos:

• Crear. Su primera solicitud lleva la conversación completa, el system y las tools, además de un campo thread con el tipo create. "La API almacena la conversación, incluida la respuesta de Claude, bajo el id de la respuesta".
• Continuar. "Envíe solo los mensajes desde la respuesta anterior". También pasa el id de la respuesta anterior y omite system y tools, porque el hilo mantiene los valores de la solicitud de creación.
• Repetir (Replay). Cuando el hilo no se puede continuar, envía la conversación completa de nuevo en una nueva solicitud de creación.

Los hilos están disponibles en la Claude Platform nativa, Claude Platform en AWS, Claude en Microsoft Foundry y Claude Models en Google Cloud (gestionado por Anthropic). Anthropic afirma: "Se aplican las tarifas estándar de tokens de Claude y los límites de velocidad existentes".

El propio resumen de la documentación es: "Un hilo de mensajes mantiene una conversación en el servidor por un corto tiempo".

Cinco minutos después de la última solicitud. "Un hilo funciona bajo el principio de mejor esfuerzo. Caduca 5 minutos después de su última solicitud y la API lo elimina no más de 1 hora después de su último uso. Cada respuesta que la API almacena reinicia los 5 minutos".

En memoria, no en disco. El anuncio dice: "Entre turnos, mantenemos cada hilo en memoria, donde está cifrado y no se escribe en el disco". La sección de retención de datos añade que la API "nunca lo escribe en almacenamiento duradero".

Sin forma de mirar dentro. La lista de limitaciones es directa: "No existe una API para listar, leer o eliminar un hilo".

Vinculado al emisor. Entre las razones por las que falla una solicitud de continuación, la documentación enumera una solicitud de "una organización o espacio de trabajo diferente" y una de "un usuario o cuenta de servicio diferente al que creó el hilo".

Por lo tanto, el servidor guarda una conversación, para un emisor, durante unos minutos de inactividad, en un formato que solo se puede extender. Eso es útil para un bucle de agente rápido. No es un registro al que se pueda volver mañana.

Anthropic responde a la pregunta en la instrucción más importante de la página: "Su aplicación sigue siendo la fuente de verdad de la conversación. Mantenga su propia copia de cada mensaje y construya la ruta de repetición desde el principio".

También explica por qué no puede omitir la copia: "Ninguna respuesta, ya sea a una solicitud de creación o de continuación, indica si la API almacenó ese turno. Se entera en la siguiente solicitud de continuación". Un hilo puede desaparecer por razones que usted no controla. La documentación enumera varias, incluyendo que "El hilo caducó", que la API sirvió un turno sin almacenarlo o que un modelo de respaldo escribió la respuesta anterior.

Compare eso con las herramientas que Anthropic sí describe para guardar información. Su herramienta de memoria está documentada como una forma de "Permitir que Claude almacene y recupere información a través de conversaciones implementando las operaciones de archivo de la herramienta de memoria en su aplicación". Su nota de retención de datos llama a eso "Almacenamiento de memoria del lado del cliente donde usted controla la retención de datos". Lo que persiste está de su lado, en el almacenamiento que usted gestiona.

El nombre también puede inducir a error de otra manera. La documentación incluye una nota: "Los hilos de mensajes son diferentes de los hilos de sesión en Claude Managed Agents". Los hilos de sesión pertenecen a las sesiones de Managed Agents, que Anthropic describe como "recursos con estado; las transcripciones persisten hasta que las elimine". Misma palabra, diferente tiempo de vida.

Nuestra guía sobre por qué una ventana de contexto larga no es memoria cubre la distinción más amplia entre lo que un modelo puede contener en una solicitud y lo que guarda entre ellas.

Las sesiones largas de agentes eventualmente necesitan compactación: reemplazar los turnos más antiguos con un resumen para que la conversación quepa. Los hilos cambian la forma de hacerlo.

"Un hilo es de solo adición (append-only), por lo que no puede reemplazar sus turnos anteriores con un resumen. Para compactar una conversación, inicie un nuevo hilo a partir del resumen. Escriba el resumen en su código y envíelo como un mensaje ordinario en una nueva solicitud de creación, con system y tools".

La opción del lado del servidor tampoco está disponible. "La compactación bajo demanda no está disponible con los hilos". Una solicitud que incluya thread y pida compactación devuelve un error 400. La edición de contexto está en la misma situación: los hilos no la admiten, con una excepción para una configuración de bloque de pensamiento (thinking-block).

En la práctica, una sesión larga con hilos parece una cadena. Un hilo se ejecuta hasta que la conversación necesita compactarse, su código escribe el resumen y se inicia un nuevo hilo a partir de ese resumen. Cada vez, el hilo antiguo caduca en cuestión de minutos. Lo que se traslada es lo que usted pone en el resumen, además de su propia copia de los mensajes.

La misma regla se aplica a la edición. "Para editar o ramificar un mensaje anterior, inicie un nuevo hilo con una solicitud de creación". Cambiar system o tools también requiere un nuevo hilo, ya que la solicitud de continuación los omite.

Nuestra guía sobre cómo teletransportar una sesión compactada de Claude Code muestra qué traslada y qué no traslada un resumen una vez que una conversación ha sido compactada.

La documentación enumera funciones que no se combinan con los hilos. Algunas son importantes para los desarrolladores de agentes:

• El almacenamiento en caché de prompts no es automático. "Un hilo no almacena en caché su prompt por usted". Todavía debe colocar puntos de interrupción de caché, y un cache_control de nivel superior solicita el almacenamiento en caché en cada turno.
• Lotes (Batches) y conteo de tokens. Un elemento de lote con thread falla, y una solicitud de conteo de tokens con thread devuelve un error 400. Anthropic sugiere contar la conversación completa en su lugar.
• Algunas organizaciones. Los hilos no están disponibles para organizaciones con la preparación para HIPAA habilitada o con ganchos de inferencia (Inference hooks) activados.

Cuando una solicitud utiliza algo que los hilos no admiten, la API devuelve un error 400 con el código thread_unsupported_request, y la documentación aconseja: "Si recibe un valor que no reconoce, envíe la conversación completa sin thread".

Para los equipos con requisitos de retención de datos, los metadatos de la función son explícitos: "Los hilos de mensajes no son elegibles para ZDR. El uso de esta función no afecta el uso de otras funciones elegibles para ZDR".

La nota completa dice: "El contenido de un hilo (la conversación, el prompt del sistema y las herramientas) se mantiene en memoria, cifrado bajo una clave gestionada por el servidor, nunca se escribe en almacenamiento duradero y se elimina no más de 1 hora después del último uso del hilo".

Si su organización depende de la retención de datos cero (zero data retention), consulte con el responsable de esa política antes de activar los hilos. El SDK puede recurrir a solicitudes sin hilos, lo cual la documentación cubre en su sección de recuperación.

El anuncio menciona a Claude Code en una línea: "Con los hilos de mensajes activados por defecto para la mayoría de los usuarios de Claude Code", seguido de una cifra de latencia para solicitudes largas.

Eso cambia cómo viajan las solicitudes. No cambia dónde vive su historial de Claude Code. La documentación de Claude Code sigue diciendo: "Claude Code almacena las sesiones en ~/.claude/projects/<encoded-cwd>/*.jsonl". Esas transcripciones locales son las que lee /resume, y la memoria automática (auto memory) permanece en su propia carpeta en el disco. Las páginas de documentación de Claude Code que revisamos no describen una configuración para los hilos de mensajes.

Anthropic no describe cómo maneja Claude Code un hilo que caduca mientras usted no está. En la API, la ruta documentada tras la caducidad es una repetición: la siguiente solicitud envía la conversación completa de nuevo e inicia un nuevo hilo. Nuestra guía sobre cómo compartir contexto entre sesiones de Claude Code cubre las partes que sí persisten entre sesiones.

Tratar el ID del hilo como un ID de conversación. Un hilo caduca minutos después de su última solicitud. Almacene su propio ID de conversación y sus mensajes.

Eliminar la copia del lado del cliente. La documentación dice que ninguna respuesta le indica si se almacenó un turno. Sin una copia, no puede realizar la repetición.

Llamar a la compactación en un hilo. Devuelve un error 400. Compacte en su código e inicie un nuevo hilo a partir del resumen.

Esperar que los hilos almacenen en caché los prompts. El almacenamiento en caché todavía necesita puntos de interrupción establecidos por usted.

Asumir que una configuración ZDR cubre los hilos. Los hilos no son elegibles para ZDR.

Buscar una forma de volver a leer un hilo. No existe una API para listar, leer o eliminar uno, en palabras de Anthropic.

Paso 1: Almacene cada mensaje antes de enviarlo

Mantenga su propia copia de la conversación, con system y tools, en un almacenamiento que usted controle. Úsela para repetir en caso de un error 404 y para recuperarse después de que el hilo caduque. Anthropic señala que "El ayudante de hilos del SDK mantiene esta copia en memoria mientras exista el objeto ayudante, y no la guarda en ningún otro lugar", por lo que si su proceso puede reiniciarse, escriba la copia también en algún lugar duradero.

Paso 2: Compactar en un nuevo hilo

Cuando una conversación se alargue, escriba el resumen en su código, inicie un nuevo hilo con una solicitud de creación que lo incluya y mantenga el historial completo en su propio almacén. Decida qué debe conservar el resumen antes de que lo necesite.

Paso 3: Mantenga los hechos duraderos fuera de la conversación

Las decisiones, convenciones y hechos sobre el usuario o el proyecto no deben depender de que una sola conversación sobreviva. Colóquelos donde su agente pueda cargarlos al inicio de cada nuevo hilo, como una herramienta de memoria respaldada por su almacenamiento o un archivo en el repositorio. En Claude Code, ese papel lo desempeñan CLAUDE.md y la memoria automática; nuestra guía sobre la memoria automática de Claude Code explica qué se carga al inicio de cada sesión.

Los hilos hacen que el turno activo sea más rápido. Los hechos que un agente necesita a través de sesiones, compactaciones y herramientas todavía necesitan un hogar que no caduque después de cinco minutos de inactividad.

MemoryLake es una capa de memoria para mantener esos hechos en un solo lugar que usted mantiene, disponible para los asistentes que conecte, como ChatGPT, Claude Code y Codex.

Usted mismo escribe las entradas, con sus propias palabras. No se lee nada de, ni se escribe en, ni se elimina de sus hilos de mensajes, sus conversaciones de API, sus sesiones de Claude Code, sus archivos de herramientas de memoria o el almacén de cualquier proveedor. Los hilos de mensajes siguen funcionando de la manera que Anthropic los describe.

Paso 1: Crear una clave de API

Inicie sesión y genere una clave desde el panel de control. La clave pertenece a su espacio de trabajo de MemoryLake y es independiente de sus claves de Claude Platform.

Paso 2: Subir sus primeras memorias

Comience con lo que cada nuevo hilo debería saber desde su primer turno: decisiones del proyecto, restricciones y convenciones. Un punto por entrada, con fecha.

Paso 3: Conectar su IA y agentes

Conecte Claude Code y cualquier otro asistente que utilice. Las mismas entradas estarán disponibles cuando comience un hilo, después de una compactación o en una herramienta diferente.

La primera diferencia son roles más claros. El hilo se encarga de la velocidad para el bucle activo, su almacén de mensajes es el registro y los hechos de larga duración residen en una capa propia.

La segunda es una compactación más segura. Dado que cada compactación inicia un nuevo hilo, los hechos importantes no dependen de qué tan bien se escribió un solo resumen.

La tercera es menos explicaciones repetitivas entre herramientas. Si el mismo proyecto se ejecuta en Claude Code y Codex, nuestra guía sobre el uso conjunto de Claude Code y Codex cubre cómo mantener a ambos trabajando desde el mismo contexto.

Trate un hilo como una caché de corta duración. Caduca cinco minutos después de su última solicitud.

Construya la ruta de repetición primero. Espere errores 404 y reenvíe desde su copia.

Use la misma clave y espacio de trabajo para todo un hilo. Un emisor diferente no puede continuarlo.

Compacte en su código. Inicie un nuevo hilo a partir del resumen.

Establezca los puntos de interrupción de caché usted mismo. Los hilos no almacenan en caché por usted.

Verifique los requisitos de retención. Los hilos no son elegibles para ZDR.

Mantenga los hechos duraderos fuera. Cárguelos al inicio de cada hilo.

Los hilos de mensajes permiten que un agente envíe solo lo nuevo en cada turno. Anthropic mantiene la conversación en memoria, cifrada, durante cinco minutos después de la última solicitud, y la elimina en una hora. No existe una API para volver a leer un hilo, y la documentación le indica que mantenga su propia copia de cada mensaje.

Eso convierte a un hilo en una función de velocidad para una sesión activa, no en memoria. La compactación significa escribir un resumen e iniciar un nuevo hilo, por lo que lo que se traslada es lo que usted conserva: su almacén de mensajes, sus resúmenes y los hechos que almacena en algún lugar que sobreviva a cualquier conversación individual.