Claude-Mem: cómo conserva contexto un agente de programación
Arquitectura de Claude-Mem: del evento al recuerdo buscable
Examinar hooks, cola, almacenamiento y búsqueda como etapas separadas
Qué aprenderás
- Capturar eventos
- Procesar y almacenar
- Recuperar contexto seleccionado
Antes de empezar
- Un proyecto ficticio de dos sesiones
- Un cliente compatible
- Un proveedor de memoria elegido
Usar dos sesiones ficticias y verificar exclusión, borrado y retirada
Conclusiones clave
- La configuración contiene más detalle que el diagrama.
- Almacenamiento y búsqueda tienen funciones distintas.
- El recuento de herramientas en README no coincide.
Capturar eventos
El `plugin/hooks/hooks.json` fijado incluye Setup, SessionStart, UserPromptSubmit, PostToolUse, PostToolUseFailure, PreToolUse, Stop y SessionEnd. Algunos handlers arrancan scripts mediante Bun runner.
El panorama arquitectónico agrupa un ciclo simplificado. Para contar eventos configurados, consulte el archivo de hooks, que puede contener handlers más nuevos o específicos.
Procesar y almacenar
La arquitectura local describe un worker que recibe sesiones y eventos, una cola pendiente y un agente SDK que genera observaciones estructuradas. SQLite guarda sesiones y resúmenes; Chroma apoya la búsqueda vectorial.
Un mensaje en cola, la observación generada y un acierto de búsqueda son objetos distintos. El documento explica recuperación tras errores, pero no probamos fallos ni reintentos.
Recuperar contexto seleccionado
El README propone buscar primero un índice compacto, revisar una cronología y abrir después observaciones por ID. Otros clientes nativos pueden capturar por rutas propias.
La misma sección anuncia cuatro herramientas MCP y luego nombra tres. Compruebe lo que expone el cliente instalado en lugar de repetir esa cifra contradictoria.
Cómo elegir
| Criterio | Opción A | Opción B |
|---|---|---|
| Best when | You need predictable behavior and easy auditing | You need adaptive optimization and have reliable telemetry |
| Main risk | May leave performance on the table | Can become difficult to explain or debug |
Pasos de implementación
- 1
Identificar evento y handler.
- 2
Seguir cola y registro persistido por separado.
- 3
Abrir solo observaciones necesarias.
Ejemplo para copiar
host -> hook or adapter -> worker queue
worker -> SQLite observation + Chroma index
search index -> timeline -> selected observationPreguntas frecuentes
¿Todos los clientes usan los mismos hooks?
No. Adaptadores nativos y observadores de transcripciones siguen otras rutas.
¿Un acierto confirma la exactitud del resumen?
Contraste la información crítica con el archivo o transcripción original.
Fuentes
- Claude-Mem / README.mdFuente verificada 2026-10-08
- Claude-Mem / docs/architecture-overview.mdFuente verificada 2026-10-08
- Claude-Mem / plugin/hooks/hooks.jsonFuente verificada 2026-10-08
- Claude-Mem / docs/native-harness-integrations.mdFuente verificada 2026-10-08