|

¿Cómo instalar claude-mem, con 100.000 estrellas? Conecta la memoria en 3 pasos y evita errores al probarlo

¿Cómo instalar claude-mem, con 100.000 estrellas? Conecta la memoria en 3 pasos y evita errores al probarlo

Cada vez que cierras y vuelves a abrir Claude Code, olvida lo que cambió en la sesión anterior. Por eso, muchas personas instalan claude-mem, que tiene 100 000 estrellas. Puedes instalarlo, pero no te limites a pulsar Enter en todas las opciones del instalador. En octubre de 2026, el instalador de v15 selecciona por defecto el observador alojado CMEM Pro, que cuesta $30 al mes después de una prueba de 30 días. Si no quieres pagar una cuota mensual, añade --provider claude durante la instalación o, una vez instalado, configura el observador para usar tu propia clave.

Este no es un artículo promocional que prometa «instálalo y recordará todo para siempre». A continuación, distingo entre «datos declarados por el proyecto / caso individual de terceros / mis propias pruebas / datos desconocidos». Todos los datos se verificaron el 2026-10-30.

claude-mem-cross-session-memory-install-guide-es-image-0


Puntos clave de claude-mem

Primero, una tabla para que decidas si quieres seguir leyendo.

Punto Detalle Qué implica para ti
Popularidad Repositorio de GitHub thedotmack/claude-mem, 105.017 estrellas, licencia Apache-2.0 (datos de la API de GitHub del 30-10-2026) Las estrellas solo indican popularidad; tendrás que probarlo para saber si te resulta útil
Versión La última versión tanto en npm como en GitHub Releases es la 15.6.0 (29-10-2026); la insignia del README dice 15.7.0, así que no coinciden Toma como referencia la versión de npm, no te dejes llevar por la insignia
Pago por defecto El instalador selecciona CMEM Pro por defecto: prueba de 30 días y después 30 $/mes Si no quieres una suscripción, elige otra opción
Sin cuota mensual Usa --provider claude con tu propio plan de Claude o configura tu propia clave después de instalar El consumo se descuenta de tu plan o de tu saldo de API
No es completamente local El modelo observer lee el contenido de tus llamadas a herramientas Si trabajas con repositorios sensibles, valora bien las implicaciones antes de usarlo

📷 Espacio para captura, añadir durante la edición: página principal del repositorio de GitHub (thedotmack/claude-mem, con el número de estrellas y la última release visibles)

Qué recuerda exactamente claude-mem

En pocas palabras: claude-mem es una capa de memoria que se ejecuta en tu equipo. No es un nuevo modelo de chat ni una aplicación de notas en la nube. Captura lo que ocurre durante una sesión, lo comprime y lo almacena para volver a dárselo a Claude cuando inicias otra sesión.

El proceso tiene 5 etapas:

  1. hooks (ganchos del ciclo de vida): Claude Code activa eventos al iniciar una sesión, enviar un prompt, antes y después de las llamadas a herramientas, al detenerse y al finalizar. claude-mem conecta sus hooks a esos eventos.
  2. worker: un servicio HTTP que se ejecuta localmente con Bun y recibe los eventos de los hooks. El puerto predeterminado es 37700 + (uid % 100), así que no siempre será 37700.
  3. observer (modelo observador): el worker envía las llamadas a herramientas originales a un modelo, que las comprime en una observation estructurada.
  4. observation (registro de observación): cada registro incluye un tipo, un título, una descripción y los archivos involucrados. Se guarda en ~/.claude-mem/claude-mem.db (SQLite), mientras que el índice vectorial se almacena en ~/.claude-mem/chroma/ (Chroma es una base de datos vectorial que se usa para búsquedas semánticas).
  5. Inyección en el siguiente SessionStart: al iniciar una nueva sesión, se inyectan automáticamente las observations recientes y relevantes del proyecto actual, hasta un máximo de 50 por defecto. Claude también puede recuperar memorias anteriores cuando las necesite mediante herramientas MCP, en tres niveles: search → timeline → get_observations.

Ten en cuenta que solo registra el contenido capturado por los hooks. Las ideas que se te ocurran fuera de la sesión y las conversaciones que no pasen por llamadas a herramientas no entrarán automáticamente en la base de datos. Además, la memoria nativa de Claude Code (MEMORY.md) y claude-mem son dos sistemas distintos: por defecto funcionan en paralelo, pero no son lo mismo.

claude-mem-cross-session-memory-install-guide-es-image-1


Tres requisitos imprescindibles antes de instalar claude-mem

Si no cumples cualquiera de estos tres puntos, no te apresures a instalarlo:

  1. Claude Code ≥ 2.1.139: en versiones anteriores, se ignoran los args de los hooks, lo que provoca que no se registre nada y no aparezca ningún aviso. Es el problema más difícil de detectar. Ejecuta primero claude --version y, si la versión es demasiado antigua, ejecuta claude update.
  2. Node 20+: el paquete npm declara ^20.19.0 || >=22.12.0; compruébalo con node -v. El instalador instala automáticamente Bun (≥1.1.31) y uv. En una prueba independiente realizada en Ubuntu 26.04, Bun, uv y Chroma ocuparon en conjunto unos 1,2 GB de disco.
  3. Aceptar que el observer vea el contenido de las llamadas a herramientas: elijas la ruta que elijas, tus llamadas a herramientas, indicaciones y contenido para los resúmenes se enviarán al proveedor de observer seleccionado. Si tu repositorio contiene claves, datos de clientes o código no publicado, espera antes de activarlo.

Los hooks en Windows no necesitan Git Bash, pero después de la instalación tendrás que reiniciar la terminal o el IDE para que se aplique el nuevo PATH.


Cómo elegir entre las 3 rutas de instalación de claude-mem

claude-mem-cross-session-memory-install-guide-es-image-2

Ruta ¿Necesita cuenta de cmem? ¿De dónde sale el dinero? ¿A quién se envía el contenido? ¿Para quién?
A: CMEM Pro predeterminado Sí, y la prueba requiere vincular una tarjeta Desde $30/mes, con 30 días de prueba Observer alojado por cmem.ai Quienes no quieren configurar una clave y necesitan sincronización en la nube o varios equipos
B: --provider claude No Consume la cuota del plan de Claude Anthropic Quienes ya tienen una suscripción a Claude
C: instalar con B y luego cambiar a una clave propia No Se factura según el uso del proveedor El endpoint que configures, por ejemplo, APIYI apiyi.com Quienes quieren controlar los costos o ya tienen saldo para la API

El marketplace de plugins es otra forma de instalación; más abajo se explica por separado como la ruta C’. Para seguir la tercera ruta, primero hay que pasar por la B: openai-compatible no es una opción de --provider en el instalador, así que solo se puede configurar manualmente después de la instalación.

Ruta A: CMEM Pro predeterminado (opción por defecto del instalador de claude-mem)

  1. Ejecuta npx claude-mem install.
  2. Qué verás: en el primer paso, el instalador preselecciona los agentes detectados e instala el runtime. En el segundo, muestra un código de dispositivo XXXX-XXXX y abre el navegador para autorizar el acceso mediante OAuth; no te saltes el inicio de sesión. En el tercero, CMEM Pro aparece seleccionado por defecto como proveedor de memoria. Al confirmarlo, se abre la página de pago o de prueba.
  3. Condiciones que debes tener en cuenta (verificadas en la página oficial de precios el 30 de octubre de 2026):
  4. La prueba requiere una tarjeta de crédito o débito; no se aceptan tarjetas de prepago.
  5. La facturación comienza cuando termina la prueba o se agota la cuota incluida, lo que ocurra primero.
  6. La configuración de actualización automática puede subir la suscripción de Pro a Heavy ($70/mes) o Max ($100/mes). Muchos tutoriales solo dicen «no se requiere tarjeta» y omiten este punto.
  7. Cómo comprobar que todo salió bien: al terminar, el instalador muestra Version, Plugin dir, IDEs, Account, Cloud sync y Worker URL. Después, realiza las cinco comprobaciones que aparecen más adelante.

Ruta B: --provider claude, instalación de claude-mem sin cuota mensual

  1. Ejecuta npx claude-mem install --provider claude.
  2. Si solo quieres mantener un sistema de memoria, usa npx claude-mem install --provider claude --disable-auto-memory. Este parámetro establece CLAUDE_CODE_DISABLE_AUTO_MEMORY=1 y desactiva la memoria automática nativa de Claude Code.
  3. Qué verás: Skipping claude-mem login: --provider claude runs memory on your own Anthropic plan., Cloud sync: OFF (local) y Auto-memory: left enabled (si no agregaste el parámetro de desactivación). El instalador también te pedirá que elijas un modelo observer: elige Haiku, no Opus.
  4. Cómo comprobar que todo salió bien: no aparece ninguna página de inicio de sesión de cmem ni de pago durante el proceso, y npx claude-mem doctor muestra todas las comprobaciones como correctas.

En el código fuente, solo los proveedores claude y host funcionan sin iniciar sesión. En pruebas de terceros, --provider openrouter se queda en Waiting for OAuth login in the browser…. Así que, si quieres usar una clave de un tercero, el orden correcto es completar primero la instalación con la ruta B y después cambiar la configuración.

Opción C’: mercado de plugins de Claude Code

  1. En Claude Code, introduce /plugin marketplace add thedotmack/claude-mem.
  2. Después, introduce /plugin install claude-mem y reinicia Claude Code.
  3. Qué verás: durante la primera sesión, el launcher todavía puede estar compilándose, así que es posible que no haya ningún recuerdo. Para evitar ese intervalo, ejecuta también npx claude-mem install --provider claude.
  4. No uses npm install -g claude-mem: solo instala la biblioteca SDK, no registra los hooks ni inicia el worker y, además, puede ocultar el launcher correcto.

Cómo comprobar que claude-mem está bien instalado: 5 verificaciones

Recuerda: la primera sesión es para recopilar información. Todavía no hay historial que inyectar; verás los recuerdos a partir de la segunda sesión. Si esperas que «se acuerde de ti» desde la primera, podrías pensar que la instalación falló.

# Verificación Comando / operación Resultado esperado
1 doctor npx claude-mem doctor Bun, uv, Plugin, Hook launcher, Worker, Claude Code version (2.1.139+) y Chroma aparecen con ✓
2 status npx claude-mem status El worker está activo y muestra el número de puerto
3 viewer Abre http://127.0.0.1:<PORT>/ en el navegador; los recuerdos están en /viewer La página se abre y muestra entradas después de completar una sesión
4 sqlite count sqlite3 ~/.claude-mem/claude-mem.db "select count(*) from observations;" El valor devuelto es mayor que 0 después de la primera sesión
5 context inject curl "http://127.0.0.1:<PORT>/api/context/inject?project=<项目名>" El contenido devuelto corresponde a los recuerdos que se inyectarán en la próxima sesión

El puerto se obtiene de CLAUDE_MEM_WORKER_PORT en ~/.claude-mem/settings.json. También puedes confirmarlo con curl http://127.0.0.1:<PORT>/api/health. En la salida de doctor, la línea que más problemas suele dar es Hook launcher. Si aparece not on PATH o is not the claude-mem hook launcher, resuélvelo antes de revisar los demás puntos.

📷 Espacio para captura, añadir durante la edición: página del viewer del worker (/viewer, con la lista de observaciones)


Coste de claude-mem: el «ahorro del 96 %» oficial frente a los «+4.226 tokens» de una prueba independiente

Ambas cifras son correctas, pero miden cosas distintas y no deben confundirse.

  • Estimación oficial: 4 observaciones ocupan unos 1.093 tokens, frente a los 26.447 tokens del trabajo original; de ahí el «ahorro de aproximadamente el 96 %». La búsqueda de tres capas de MCP «ahorra unas 10 veces más que la inyección completa». Son estimaciones del propio proyecto, no una auditoría independiente.
  • Prueba individual de un tercero (ComputingForGeeks, 2026-10-24, claude-mem 15.0.2, Sonnet vía OpenRouter): con la misma indicación, «Reply with the single word ready», la entrada consumió 28.489 tokens sin claude-mem. Al activarlo, incluso con la memoria vacía, la entrada consumió 32.715 tokens: 4.226 tokens más (aproximadamente un 14,8 %) y un coste adicional de $0.010. Es una prueba realizada una sola vez, en una sola máquina y con un solo proyecto; no representa necesariamente tu factura.

La conclusión, de entrada: el «ahorro» se refiere a que la memoria es más compacta que los registros originales; el «aumento» se refiere al coste fijo adicional que hay que asumir en cada sesión. Cuanto más activo sea el proyecto y más entradas se inyecten, mayor será ese coste. En los issues #618 y #2469 de la primera mitad de 2026, varios usuarios señalaron que los tokens se agotaban rápidamente. Esa fue su experiencia con versiones anteriores y no equivale a la situación actual de la 15.6.0, pero demuestra que la memoria nunca es gratis.

claude-mem-cross-session-memory-install-guide-es-image-3

5 ajustes de claude-mem para controlar los costos

  1. CLAUDE_MEM_CONTEXT_OBSERVATIONS: el valor predeterminado es 50. Reducirlo a 10–20 disminuye directamente la cantidad de memoria que se inyecta.
  2. CLAUDE_MEM_SEMANTIC_INJECT: mantén el valor predeterminado false. Si lo activas, se añadirán recuerdos relevantes a cada indicación.
  3. CLAUDE_MEM_SESSION_START_INCLUDE_ALL_SOURCES: mantén el valor predeterminado false; de lo contrario, se inyectarán los recuerdos de todos los hosts.
  4. CLAUDE_MEM_DISABLE_TOOL_HOOKS=1: desactiva las observaciones a nivel de llamada a herramientas y conserva solo los resúmenes de sesión. Así ahorras tokens y recursos de procesamiento.
  5. CLAUDE_MEM_OPENAI_COMPAT_OBSERVATION_BATCH_SIZE: el valor predeterminado es 1. Auméntalo gradualmente si se acumulan eventos; no lo configures en 32 desde el principio.

Comparación de costos de las tres opciones

Opción Facturación Precio (USD) Ideal para
CMEM Pro Suscripción $30/mes, prueba de 30 días (Heavy $70, Max $100) Usuarios intensivos que necesitan sincronización en la nube
Plan de Claude Consume la cuota de la suscripción Sin cargo adicional, pero comparte cuota con las tareas de programación Quienes ya tienen una suscripción a Claude
APIYI claude-haiku-5-5 Por uso Entrada $0.1 / salida $0.5 / lectura de caché $0.01 por millón de tokens (hasta 100,000 tokens por solicitud; por encima de 100,000 tokens, entrada $0.5/1M, con precios por tramos) Usuarios de baja o media frecuencia

Los precios proceden de la tabla general de precios de APIYI en apiyi.com (página actualizada el 27 de octubre de 2026 a las 14:50 UTC+8). Consulta la lista de modelos de la plataforma para conocer los modelos y precios vigentes; los cargos reales se reflejan en la consola. Como referencia, en la misma plataforma, claude-haiku-4-5-20251001 cuesta $1 de entrada / $5 de salida / $0.1 de lectura de caché; claude-sonnet-5-5, $2 / $10 / $0.1; y claude-opus-5-5, $4 / $20 / $0.2. El observer realiza tareas pequeñas, estructuradas y frecuentes, por lo que un modelo de nivel Haiku es suficiente. La facturación por uso conviene a quienes usan el servicio con baja o media frecuencia; si lo usas intensivamente, calcula tu consumo real durante una semana y compáralo con los $30/mes.


Cambiar el observer de claude-mem a APIYI

Esta es la ruta C completa, pensada para desarrolladores en China que ya tienen saldo de API y no quieren contratar una suscripción aparte para la memoria. APIYI admite recargas en yuanes y aplica un tipo de cambio fijo de 1:7, según su página oficial de precios.

  1. Primero, instala claude-mem siguiendo la ruta B: npx claude-mem install --provider claude.
  2. Abre ~/.claude-mem/settings.json y añade estas cuatro claves:
  3. "CLAUDE_MEM_PROVIDER": "openai-compatible"
  4. "CLAUDE_MEM_OPENAI_COMPAT_BASE_URL": "https://api.apiyi.com/v1"
  5. "CLAUDE_MEM_OPENAI_COMPAT_MODEL": "claude-haiku-5-5"
  6. "CLAUDE_MEM_OPENAI_COMPAT_API_KEY": "sk-tu-clave-de-APIYI"
  7. Si no quieres guardar la clave en texto plano en settings, puedes ponerla en ~/.claude-mem/.env: OPENAI_COMPAT_API_KEY=sk-tu-clave-de-APIYI (permisos 0700 para el directorio y 0600 para el archivo).
  8. Ejecuta npx claude-mem restart. Las credenciales solo se leen cuando arranca el worker, así que el cambio no tendrá efecto hasta que lo reinicies.
  9. Cómo comprobar que funciona: npx claude-mem doctor muestra openai-compatible como proveedor. La siguiente observation generada en una sesión nueva aparece en el visor.

Hay dos problemas que conviene evitar. Primero, la URL base debe incluir /v1 y no debe terminar en una barra; de lo contrario, se formará una doble barra que provocará un error 404. Puedes consultar las diferencias entre los tres tipos de URL base en: help.apiyi.com/apiyi-base-url-v1-claude-gemini-endpoint-config-guide.html. Segundo, si falta cualquiera de las cuatro claves, claude-mem volverá silenciosamente a la ruta de Claude: todo parecerá funcionar con normalidad, pero el consumo se descontará de tu plan.

Prueba de la API (realizada con una clave de APIYI el 2026-10-30):

  • GET /v1/models devolvió 200 y un total de 259 modelos, incluido claude-haiku-5-5.
  • POST /v1/chat/completions con claude-haiku-5-5 y response_format: {type: "json_object"} devolvió 200 en unos 2,0 segundos, con un JSON válido y un consumo de 59 tokens.
  • Al incluir el campo reasoning: {enabled: false} que envía claude-mem, también devolvió 200, sin ningún error 400.
  • El endpoint nativo de Anthropic /v1/messages también devolvió 200.

Alcance de la conclusión: estas pruebas solo verifican que «el endpoint de APIYI acepta el formato de las solicitudes que necesita claude-mem». No completé una prueba local de todo el flujo de observation de claude-mem; que la API responda correctamente no significa que se haya verificado toda la cadena del plugin.

🚀 Recomendación para empezar: crea primero una clave independiente en la consola de APIYI apiyi.com y úsala exclusivamente para claude-mem. Así, después de una semana podrás revisar su consumo por separado y decidir si el pago por uso te sale más rentable que una suscripción. Si también piensas conectar Claude Code, puedes consultar: help.apiyi.com/claude-code-apiyi-integration-tutorial.html.


Privacidad en claude-mem: qué permanece en local y qué se envía fuera

Almacenamiento local (todo está en ~/.claude-mem/; puedes cambiar la ubicación con CLAUDE_MEM_DATA_DIR): claude-mem.db (sessions, observations, summaries, prompts), el índice vectorial chroma/, logs/, settings.json y el directorio de capturas media-v1/, desactivado por defecto.

Contenido que sale de tu equipo:

  • Invocaciones de observer: el contenido de las llamadas a herramientas, las indicaciones y el material para los resúmenes se envían al proveedor que elijas. Si eliges Anthropic, se envían a Anthropic; si eliges CMEM, a cmem.ai; y si eliges APIYI, a APIYI.
  • La telemetría está activada por defecto: los datos se envían a PostHog con un UUID de instalación aleatorio, y la información de los errores se anonimiza. Para desactivarla, ejecuta npx claude-mem telemetry disable o establece DO_NOT_TRACK=1. El instalador también te pregunta al respecto al finalizar.
  • La sincronización en la nube requiere activación manual: está desactivada por defecto. Al activarla, se suben a cmem.ai las observaciones, los resúmenes de sesiones y el texto completo de las indicaciones.

Controles que tienes a tu disposición:

  • El contenido incluido entre <private>...</private> se elimina en la capa de hooks y no llega a la base de datos.
  • La anonimización automática está desactivada por defecto. Debes establecer CLAUDE_MEM_REDACT_ENABLED=true para activar los 16 patrones integrados de claves y credenciales (AWS, PAT de GitHub, claves de OpenAI y Anthropic, JWT, PEM, etc.). Si además estableces CLAUDE_MEM_REDACT_GENERIC_ENABLED=true, se añaden tres patrones genéricos. No des por hecho que anonimizará los datos por ti.

Tabla de solución de problemas frecuentes de claude-mem

Problema Causa Solución
Cada hook muestra Executable not found in $PATH: "claude-mem" El launcher no está en PATH Ejecuta npx claude-mem install para reinstalarlo y reinicia la terminal, el IDE y Claude Code
La sesión muestra memory hooks are not active El launcher no está activo Sigue los pasos anteriores y después ejecuta npx claude-mem doctor para revisar la línea Hook launcher
No se registra nada ni aparece ningún error La versión de Claude Code es anterior a la 2.1.139 Ejecuta claude update
Otro programa oculta el comando claude-mem Se ejecutó anteriormente npm install -g claude-mem Localízalo con which -a claude-mem y después ejecuta npm uninstall -g claude-mem
No se puede abrir el visor El puerto no es 37700 o el worker no está iniciado Consulta el puerto en settings y ejecuta curl http://127.0.0.1:<PORT>/health
El puerto está ocupado Conflicto con otro proceso Ejecuta export CLAUDE_MEM_WORKER_PORT=38000 y reinicia el worker
El endpoint personalizado devuelve un error 404 La URL base es incorrecta Para endpoints compatibles con OpenAI, usa /v1; para Anthropic nativo, usa el dominio raíz. Comprueba que el ID del modelo aparezca en /v1/models
Se configuró una clave de terceros, pero se sigue usando Claude No se completaron las cuatro claves y se recurrió a Claude sin aviso Completa settings y ejecuta npx claude-mem restart
La observación está vacía o truncada El modelo pequeño no respeta la estructura JSON o alcanza el límite de salida Aumenta CLAUDE_MEM_OBSERVER_MAX_OUTPUT_TOKENS (4096 por defecto) o cambia a un modelo más estable
Tiempos de espera agotados repetidamente La solicitud de streaming se abandona si pasan 90 segundos sin recibir tokens Aumenta CLAUDE_MEM_LLM_STREAM_IDLE_TIMEOUT_MS o cambia a un modelo más pequeño
El hook detiene el worker continuamente Las versiones del plugin y del worker no coinciden (#3857, #3940; ya corregido) Ejecuta npx claude-mem update y, si es necesario, npx claude-mem@latest install
Dos sistemas de memoria entran en conflicto La memoria automática nativa y claude-mem funcionan en paralelo Añade --disable-auto-memory al reinstalar

Riesgos de claude-mem y responsabilidad ante bloqueos de cuenta

Lee esta sección antes de instalarlo.

  1. Proyecto comunitario, sin respaldo: claude-mem es un proyecto de código abierto de la comunidad, no un producto oficial de APIYI. APIYI no lo respalda ni ofrece un SLA para él.
  2. Envío de contenido a terceros: el contenido de las llamadas a herramientas se envía al observer que elijas. Si el repositorio contiene claves, datos de clientes o código no publicado, es mejor no activarlo por ahora.
  3. Consumo de cuota: puede consumir muchos tokens o una parte importante de la cuota de tu plan. Prueba primero con un proyecto pequeño durante una semana y revisa la facturación antes de decidir.
  4. Controles de seguridad y límites de uso: los hooks que se activan con frecuencia, las cuentas compartidas y las claves de proxy pueden activar los controles de seguridad o los límites de uso de la plataforma. Se recomienda hacer la prueba con una clave independiente, una cuenta secundaria y un solo proyecto. Las consecuencias son responsabilidad del lector. En cuanto a APIYI, este artículo solo confirma que la interfaz pasó las pruebas; no garantiza que no se apliquen límites de uso.
  5. Quedan archivos tras la desinstalación: después de ejecutar npx claude-mem uninstall, ~/.claude-mem permanece en el equipo. Contiene la base de datos y posiblemente alguna clave guardada, por lo que debes ejecutar manualmente rm -rf ~/.claude-mem. Además, según pruebas de terceros, ~/.bun y ~/.cache/uv ocupan alrededor de 1,1 GB; si ningún otro proyecto los usa, también puedes eliminarlos.

Preguntas frecuentes sobre claude-mem

Q1: ¿Tener 100 000 estrellas significa que claude-mem es necesariamente bueno?

No. Las estrellas solo indican popularidad. Conviene evaluar por cuenta propia el consumo de tokens, los límites de privacidad y el ritmo de publicación de versiones. Tampoco hay una auditoría independiente que confirme si el crecimiento de estrellas es auténtico.

Q2: ¿claude-mem y la memoria integrada de Claude Code son lo mismo?

No. La memoria nativa usa MEMORY.md, mientras que claude-mem funciona de forma independiente con hooks y una base de datos. Por defecto, ambos sistemas funcionan en paralelo. Si solo quieres conservar uno, añade `–disable-auto-memory` durante la instalación.

Q3: ¿Hay memoria desde la primera sesión después de instalarlo?

No. La primera sesión se encarga de recopilar y comprimir la información; la memoria se inyecta a partir de la segunda. Para comprobarlo, usa los puntos 4 (sqlite count) y 5 (context inject) de la lista de verificación.

Q4: ¿Se puede usar claude-mem sin asociar una tarjeta ni contratar una suscripción?

Sí. Instálalo con `–provider claude` y consumirá la cuota de tu plan de Claude. También puedes cambiar el observer después de instalarlo y usar una clave de pago por uso de APIYI, en apiyi.com: se factura según los tokens consumidos y los usuarios nuevos tienen crédito gratuito para probarlo.

Q5: ¿Qué modelo conviene usar para el observer?

Usa un modelo de la categoría Haiku, como `claude-haiku-5-5`. Las observaciones son tareas pequeñas, estructuradas y frecuentes. Un modelo de gama alta como Opus resulta caro y, además, puede gastar el presupuesto de salida en razonamiento.

Q6: ¿Se pueden usar solo modelos locales?

Sí. Basta con configurar `openai-compatible` para que apunte a Ollama, LM Studio o vLLM. Eso sí, el modelo pequeño debe generar de forma consistente la estructura JSON de las observaciones; de lo contrario, producirá registros vacíos.

Q7: ¿Cómo se activan las observaciones en chino?

En la configuración, establece `»CLAUDE_MEM_MODE»: «code–zh»` —es un modo integrado, no hace falta instalar nada más— y reinicia Claude Code.


Puntos clave de claude-mem

  • Cómo funciona: los hooks capturan las llamadas a herramientas, el observer las comprime y las guarda en SQLite para inyectarlas en la siguiente sesión.
  • Ojo con la opción predeterminada: el instalador de v15 preselecciona CMEM Pro. La prueba requiere una tarjeta y después cuesta $30 al mes.
  • Sin cuota mensual: instala con --provider claude y, si lo necesitas, modifica settings para usar tu propia clave.
  • Coste: el proyecto afirma que «ahorra un 96 %», mientras que un caso individual de un tercero registra «+4.226 tokens». Son mediciones con criterios distintos.
  • Privacidad: el observer envía contenido fuera del equipo; la telemetría está activada por defecto; tanto la anonimización como la sincronización en la nube requieren activación manual.
  • Para empezar: crea una clave independiente en APIYI apiyi.com, úsala con claude-haiku-5-5 bajo pago por uso durante una semana y calcula el coste.

Resumen: memoria entre sesiones con claude-mem, quién debería instalarlo y quién no

3 perfiles a los que les conviene instalarlo:

  1. Quienes mantienen el mismo proyecto a largo plazo y suelen cerrar y volver a abrir sesiones de Claude Code.
  2. Quienes necesitan responder a menudo preguntas como «¿por qué hicimos este cambio la última vez?» o «¿cómo resolvimos ese bug al final?».
  3. Quienes están dispuestos a dedicar 10 minutos a configurarlo y aceptan que el observer lea el contenido de las llamadas a herramientas.

3 perfiles a los que no les conviene instalarlo:

  1. Quienes solo ejecutan scripts puntuales y no trabajan en proyectos con continuidad. Usar CLAUDE.md y notas propias sale más barato.
  2. Quienes trabajan con código o datos que no pueden salir del equipo local o de una región específica por requisitos normativos.
  3. Quienes usan equipos con poco espacio en disco o capacidad de CPU, y quienes esperan que «se vuelva más inteligente nada más instalarlo».

Si decides instalarlo, sigue este orden para evitar problemas: «ruta B → comprobación de 5 puntos → reducir el número de entradas inyectadas → cambiar de observer si hace falta». Si quieres comprobar el coste del observer con pago por uso, puedes utilizar primero el crédito gratuito de APIYI apiyi.com para probarlo en un proyecto pequeño.


📚 Referencias

  1. Repositorio de claude-mem en GitHub: código fuente, versiones y reportes
  2. Enlace: github.com/thedotmack/claude-mem
  3. Detalles: número de estrellas, versiones y reportes #618, #2469, #3857 y #3940, entre otros.

  4. Documentación oficial de claude-mem: instalación, configuración y solución de problemas

  5. Enlace: docs.claude-mem.ai/installation
  6. Detalles: requisitos del sistema, valores predeterminados de configuración y configuración del proveedor compatible con OpenAI.

  7. Página de precios de CMEM: condiciones de CMEM Pro / Heavy / Max

  8. Enlace: cmem.ai/pricing
  9. Detalles: prueba de 30 días, requisito de registrar una tarjeta y fecha de inicio de la facturación (verificado el 30 de octubre de 2026).

  10. Prueba independiente de ComputingForGeeks: instalación de la versión 15.0.2 y consumo de tokens

  11. Enlace: computingforgeeks.com/claude-mem-claude-code
  12. Detalles: fuente del dato de +4.226 tokens en una única prueba (24 de octubre de 2026).

  13. Documentación de modelos de APIYI: lista de modelos y precios

  14. Enlace: docs.apiyi.com/models
  15. Detalles: consulta la lista de la plataforma para conocer los modelos y precios vigentes.

Autor: equipo técnico de APIYI
Consultas técnicas: si tienes problemas con un endpoint o un modelo durante la configuración, puedes contactarnos desde la página principal de APIYI. Encontrarás más información sobre la integración en el centro de documentación de docs.apiyi.com.

Artículos relacionados

Publicaciones Similares