Claude-Mem: cómo conserva contexto un agente de programación
Mapa del código Claude-Mem: manifiestos, hooks y API
Localizar las rutas ejecutables desde configuración y contratos fijados
Qué aprenderás
- Empezar por el paquete
- Seguir el hook local
- Leer worker, contexto y contrato del servidor
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
- Los hooks son configuración ejecutable.
- Algunos fallos dejan operativo al cliente.
- La generación puede continuar tras responder HTTP.
Empezar por el paquete
`package.json` define la CLI, rangos de motores y scripts de compilación. El manifiesto identifica el plugin Claude Code; `plugin/hooks/hooks.json` enumera eventos, comandos y límites de tiempo.
Compilar el paquete no demuestra que todos los clientes carguen sus hooks. Para otro cliente, siga su adaptador y el archivo generado correspondiente.
Seguir el hook local
La configuración incluye comandos Shell que buscan scripts del plugin en caché e invocan Bun runner. Algunas rutas permiten que el cliente continúe si el worker falta.
Ese comportamiento se observa en la configuración; no ejecutamos los comandos, comprobamos todas las ramas de error ni auditamos cada script invocado.
Leer worker, contexto y contrato del servidor
`worker-service.ts` inicializa por pasos la base de datos, Chroma y rutas de búsqueda. `ContextBuilder.ts` selecciona cronología e ID de observaciones completas, y limita la salida. `docs/api.md` separa rutas antiguas `/api` de endpoints beta `/v1`.
Las estadísticas usan los registros seleccionados; la generación del servidor puede continuar tras la respuesta HTTP. Crear la primera clave exige otra revisión de seguridad. No ejecutamos ramas de error ni certificamos autenticación, tiempos o conservación de datos.
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
Revisar motores y entrada CLI.
- 2
Vincular un hook con script y timeout.
- 3
Separar worker local de API beta.
Ejemplo para copiar
package bin -> installer
plugin.json -> hooks.json -> worker-service
ContextBuilder -> selected timeline -> bounded contextPreguntas frecuentes
¿Dónde se conecta Claude Code?
En `plugin/hooks/hooks.json` de la revisión fijada.
¿La respuesta API confirma el resumen terminado?
Puede quedar trabajo en cola para otro proceso según la documentación.
Fuentes
- Claude-Mem / package.jsonFuente verificada 2026-10-08
- Claude-Mem / plugin/.claude-plugin/plugin.jsonFuente verificada 2026-10-08
- Claude-Mem / plugin/hooks/hooks.jsonFuente verificada 2026-10-08
- Claude-Mem / docs/architecture-overview.mdFuente verificada 2026-10-08
- Claude-Mem / docs/api.mdFuente verificada 2026-10-08
- Claude-Mem / src/services/worker-service.tsFuente verificada 2026-10-08
- Claude-Mem / src/services/context/ContextBuilder.tsFuente verificada 2026-10-08