Cómo hacer que Claude Code recuerde entre sesiones (y no repita errores)

Por Sebastián Téllez · Última actualización: 3 de octubre de 2026

Respuesta corta: cada sesión de Claude Code empieza con el contexto vacío. Lo que pasa de una sesión a otra son los archivos CLAUDE.md, que escribes tú, y la memoria automática, que Claude escribe por proyecto en tu equipo. Para que ese conocimiento llegue a otras máquinas y a tus otros agentes, conecta un servidor de memoria por MCP como NEXUS.

Qué recuerda Claude Code por sí solo

Según la documentación de Anthropic, Claude Code tiene dos mecanismos que se cargan al empezar cada sesión:

  • Archivos CLAUDE.md: instrucciones que escribes tú. Pueden ser del proyecto (./CLAUDE.md, que se comparte con tu equipo por control de versiones), personales (~/.claude/CLAUDE.md, para todos tus proyectos) o de la organización.
  • Memoria automática: notas que Claude escribe solo a partir de tus correcciones y preferencias, en ~/.claude/projects/<proyecto>/memory/. Al empezar cada sesión carga las primeras 200 líneas o 25 KB de MEMORY.md.

Los dos funcionan como contexto, no como configuración obligatoria: Claude los toma en cuenta, pero para impedir una acción pase lo que pase la propia documentación recomienda un hook de tipo PreToolUse.

Dónde se queda corto

  • Es local a tu máquina. La documentación lo dice tal cual: los archivos de la memoria automática no se comparten entre máquinas ni con entornos en la nube.
  • Es por repositorio. Lo que Claude aprendió en un proyecto no llega a otro.
  • Es solo de Claude Code. Claude en el navegador, ChatGPT o Cursor no lo ven.
  • Tiene tope de carga. Lo que pase de las primeras 200 líneas o 25 KB de MEMORY.md no entra al arrancar la sesión.

Para un solo desarrollador en una sola máquina suele bastar. El problema aparece cuando la misma decisión tiene que respetarla otro agente, en otra máquina o en otra herramienta.

Lo que importa no es recordar, es no repetir el error caro

Un agente que olvida una preferencia es una molestia. Uno que vuelve a hacer algo que ya salió mal cuesta dinero o tiempo. Ese es el caso que vale la pena cubrir.

Ejemplo ilustrativo: en una sesión se decidió que los registros de pagos nunca se borran, se archivan, porque contabilidad los audita. Semanas después, desde otra computadora, un agente propone borrar registros viejos para limpiar la tabla. Si la decisión vive solo en la memoria local de la primera máquina, el segundo agente no tiene forma de saberla.

Cómo conectar NEXUS a Claude Code

  • Crea una cuenta gratis en https://nexus.eblas.link/signup.
  • Agrega el servidor desde la terminal:
terminal
claude mcp add --transport http nexus-agi https://nexus.eblas.link/mcp
  • Dentro de Claude Code ejecuta /mcp y autoriza en el navegador. No hay que copiar tokens.
  • Opcional: pídele a tu agente la herramienta get_setup_kit. Devuelve unos hooks que recuperan la memoria al empezar la sesión y en cada mensaje, y guardan lo importante al terminar. Se instalan solo si tú lo apruebas.

El detalle de cada paso está en la documentación: https://nexus.eblas.link/documentacion

CLAUDE.md, memoria automática y NEXUS: cuándo usar cada uno

No se excluyen; cada uno resuelve una parte:

  • CLAUDE.md: reglas estables del proyecto que quieres versionar junto con el código.
  • Memoria automática: preferencias y aprendizajes de ese repositorio en esa máquina.
  • NEXUS: decisiones, reglas y errores que tienen que llegar a todos tus agentes y máquinas, con su vigencia: cuando algo deja de aplicar, se marca como no vigente en lugar de borrarse.

Límites que conviene saber

  • NEXUS sabe lo que se le cuenta. Sin los hooks, solo tiene lo que el agente guarda a propósito.
  • Un recuerdo puede quedar desactualizado: NEXUS marca la vigencia, pero no adivina que algo cambió fuera. Corrígelo cuando pase.
  • El plan Gratuito incluye hasta 150 memorias nuevas y 2 agentes al mes.

¿Claude Code tiene memoria entre sesiones?

Sí. Carga los archivos CLAUDE.md que tú escribes y una memoria automática que Claude mantiene por proyecto en tu equipo. Las dos se cargan al empezar cada sesión.

¿La memoria de Claude Code se comparte entre computadoras?

La memoria automática no: según la documentación de Anthropic es local a la máquina. Un CLAUDE.md de proyecto sí viaja con el repositorio por control de versiones. Para compartir decisiones y errores entre máquinas y herramientas hace falta una memoria externa, como un servidor MCP.

¿Tengo que instalar algo para usar NEXUS con Claude Code?

No. Basta con agregar el servidor con claude mcp add y autorizar con /mcp. Los hooks de captura automática son opcionales.

¿Cuánto cuesta NEXUS?

Hay un plan Gratuito con hasta 150 memorias nuevas y 2 agentes al mes. Los planes de pago son opcionales.