← Volver al blog
Aiaprox. 7 min de lectura

claude-mem guarda lo que tu agente olvida, con letra pequeña

Publicado 2 nov 2026
claude-mem guarda lo que tu agente olvida, con letra pequeña

Todos los agentes de programación tienen la misma costumbre vergonzosa. Te pasas una tarde explicando por qué no se puede tocar el middleware de autenticación, dónde vive la configuración heredada y cuáles dos tests fallan a propósito. Luego cierras el portátil. A la mañana siguiente el agente te saluda como a un desconocido y sugiere, muy contento, refactorizar justo el archivo que le dijiste que dejara en paz.

Ese hueco es el que ataca claude-mem, y las cifras sugieren que mucha gente lo nota. El repositorio ronda las 110.000 estrellas, ha sumado unas 5.850 en la última semana y lleva días en lo más alto de la lista de tendencias semanales de GitHub. El proyecto de Alex Newman se define como un «sistema de compresión de memoria persistente» para Claude Code, y la palabra clave es compresión, no almacenamiento.

Qué se guarda en realidad

El mecanismo es menos mágico que el discurso. claude-mem se engancha a los hooks de ciclo de vida que Claude Code ya expone: SessionStart, UserPromptSubmit, PreToolUse, PostToolUse, Stop y SessionEnd. Cada hook es un solo comando, claude-mem hook claude-code <event>, que ejecuta un pequeño lanzador que el instalador deja en tu PATH.

Mientras trabajas, las llamadas a herramientas se convierten en «observaciones»: notas semánticas breves sobre lo que hizo el agente y lo que pasó. Un servicio en segundo plano, gestionado por Bun, las escribe en SQLite. Cuando arranca una sesión nueva, las observaciones más relevantes se inyectan en el contexto antes de que escribas nada.

También hay una base de datos vectorial Chroma para búsqueda semántica, junto al FTS5 de SQLite para búsqueda por palabra clave. En la práctica lo híbrido importa: «aquel script de migración del martes» es una consulta por palabra clave, «lo del token que falla en silencio» es semántica, y vas a escribir las dos.

Hay dos detalles que merecen mención porque demuestran que el proyecto se ha usado de verdad. Uno: la etiqueta <private>, y lo que va dentro nunca se guarda. Dos: las capturas de pantalla son opcionales y están desactivadas por defecto, y solo llegan al modelo observador si la inferencia de imagen está habilitada aparte. Alguien pensó en el modo de fallo en el que una herramienta de memoria se convierte, sin avisar, en una herramienta de vigilancia.

A wooden card catalog drawer pulled open, index cards fanned out under soft blue light

El truco de recuperación en tres capas

La parte que de verdad me parece bien diseñada es la superficie de búsqueda. En lugar de volcar recuerdos al contexto y confiar en que el modelo los ordene, claude-mem expone un flujo MCP de tres pasos.

search devuelve un índice compacto con identificadores, de unos 50 a 100 tokens por resultado. timeline te da contexto cronológico alrededor de un hallazgo interesante. get_observations trae el detalle completo, de 500 a 1.000 tokens cada uno, pero solo para los identificadores que hayas elegido. El README habla de un ahorro de tokens de unas 10 veces por filtrar antes de recuperar, que es la forma correcta de plantear la afirmación: es un argumento contable, no de capacidad.

Ahí está la diferencia entre un sistema de memoria y una ventana de contexto. Una ventana más grande es un coste plano que pagas en cada turno. La revelación progresiva es un coste que pagas solo cuando vas a buscar algo. Quien haya visto una sesión larga quemar tokens con salidas de herramientas ya obsoletas reconocerá cuál de las dos escala.

La instalación es una línea, y de eso se trata

El camino feliz es:

npx claude-mem install

Funciona con --ide opencode, --ide t3code, --ide pi, --ide antigravity y algunos más, además de un modo Grok Bot que vigila los registros de chat porque ese anfitrión no tiene hooks. Dentro de Claude Code también puedes pasar por el mercado de plugins:

/plugin marketplace add thedotmack/claude-mem
/plugin install claude-mem

Necesitas Node 20 o superior. Bun y uv se instalan solos si faltan. En Windows, el instalador coloca un lanzador en %LOCALAPPDATA%\claude-mem\bin y lo añade al PATH del usuario; si los hooks se quejan de que falta un ejecutable, npx claude-mem doctor es el punto de entrada para diagnosticar.

Una trampa que el README repite y conviene repetir: npm install -g claude-mem instala solo el SDK. No registra hooks ni levanta el worker, así que no pasa nada y tú concluyes que la herramienta está rota.

La parte que me incomoda

Durante la instalación te piden iniciar sesión con un enlace mágico por correo, sin tarjeta. Al hacerlo se aprovisiona una clave de memoria y se desbloquea un observador alojado con 30 días de prueba; cuando la prueba termina, la memoria vuelve a tu plan de Anthropic salvo que te suscribas. Puedes saltarte todo el asunto pasando --provider, poniendo CLAUDE_MEM_ONLINE_OPTIN=false o ejecutando en CI. Hasta aquí, bien.

Luego, cerca del final del README, hay una sección titulada «What About CMEM?» que explica que CMEM es un token creado por un tercero y «adoptado oficialmente» por el autor del proyecto, con su dirección de contrato incluida.

No creo que eso haga malo el software. El código es Apache-2.0, la arquitectura está documentada y la elección de licencia se justifica explícitamente como una apuesta por incrustar memoria duradera en las herramientas de desarrollo. Pero un sistema de memoria que se envía con un memecoin y te pide iniciar sesión antes de empezar a recordar está pidiendo un tipo muy concreto de confianza, y conviene decidir si se la das antes de apuntarlo a un repositorio privado. La vía local existe. Úsala a propósito, no por accidente.

¿La memoria mejora de verdad a los agentes?

La respuesta honesta es que los hace menos repetitivos. No es lo mismo. Una observación recordada es una afirmación sobre el pasado, y puede que el código haya cambiado desde entonces. Si el contexto inyectado dice «la migración está en db/legacy.ts» y alguien partió ese archivo hace tres semanas, no le has dado conocimiento al agente: le has dado confianza en un dato caducado.

El planteamiento del propio claude-mem ayuda aquí: las observaciones se citan por identificador y puedes inspeccionarlas en el visor local, en la URL del worker. Trátalas como notas, no como verdad. Los proyectos que saquen partido de esto serán los que poden, no los que solo acumulan.

Hay también un efecto de segundo orden, y es el que yo vigilaría. La memoria cambia lo que un agente está dispuesto a hacer sin preguntar. Un agente con historial seguirá adelante tan tranquilo con suposiciones heredadas de la semana pasada. Es una ganancia de productividad hasta que se convierte en un malentendido carísimo.

A quién le sirve

Si tus sesiones con el agente son cortas y autónomas, pásalo de largo. El sobrecoste no compensa y un contexto limpio es una ventaja.

Si trabajas varios días sobre un mismo repositorio, si repites una y otra vez las mismas decisiones de arquitectura, o si tienes agentes en paralelo que necesitan saber a qué llegaron los otros, esta es la implementación abierta más completa de esa idea ahora mismo, y la instalación en una línea hace que el experimento te cueste diez minutos.

Solo entra con la expectativa correcta. claude-mem no le da memoria a tu agente. Le da un archivador, una herramienta de búsqueda y la costumbre de apuntar las cosas. Si las notas siguen siendo ciertas es, como siempre, tu problema.

Artículos relacionados