Memorias persistentes para subagentes en Claude Code
Por defecto, un subagente empieza cada sesión desde cero: no recuerda qué encontró la última vez ni qué decisiones tomaste. Las memorias persistentes cambian eso: un subagente con memoria recuerda patrones, decisiones y contexto acumulado, disponibles desde la primera línea de la siguiente sesión. Se configura con el campo memory en el frontmatter del subagente.
Cuándo SÍ y cuándo NO: para muchos subagentes, empezar de cero es correcto (un Bash o Explore que verifica un build o busca un patrón no necesita memoria). La memoria cambia la utilidad de los que gestionan procesos recurrentes, aprenden preferencias en el tiempo o coordinan varias skills sobre el mismo dominio.
Los tres niveles de memoria
La memoria se declara en el frontmatter del subagente con memory. Hay tres niveles:
| Nivel | Dónde se almacena | Cuándo usarlo |
|---|---|---|
user |
~/.claude/agent-memory/<agente>/ (compartido entre tus proyectos) |
El mismo subagente se usa en varios proyectos y necesita un perfil consistente |
project |
.claude/agent-memory/<agente>/ (dentro del proyecto, versionable) |
El conocimiento es específico del proyecto y debe versionarse con él |
local |
.claude/agent-memory-local/<agente>/ (sin versionar) |
Preferencias o contexto que no deben compartirse con el equipo |
La configuración es directa:
---
name: newsletter-agent
description: Gestiona la producción del newsletter semanal
memory: project
---
[system prompt del subagente]
Cuándo vale la pena
- Procesos recurrentes: un subagente que gestiona una tarea periódica y debe recordar el estado entre ejecuciones.
- Aprendizaje de preferencias: uno que afina su comportamiento según lo que funcionó antes.
- Coordinación de dominio: uno que orquesta varias skills sobre el mismo tema y acumula contexto.
Para todo lo demás, el subagente sin memoria es lo correcto: más simple y sin estado que mantener.
Preguntas frecuentes
¿Los subagentes de Claude Code recuerdan cosas entre sesiones?
Por defecto no: cada subagente empieza desde cero. Pero puedes darle memoria persistente con el campo memory en su frontmatter, y entonces recuerda patrones, decisiones y contexto acumulado desde la primera línea de la siguiente sesión.
¿Cómo le doy memoria a un subagente en Claude Code?
Añadiendo el campo memory en el frontmatter del archivo del subagente, con uno de tres valores: user, project o local. Cada uno define dónde se almacena la memoria y si se comparte o se versiona.
¿Cuál es la diferencia entre memory user, project y local?
user guarda la memoria en tu carpeta de usuario y la comparte entre tus proyectos. project la guarda dentro del proyecto y se versiona con él (la comparte el equipo). local la guarda en el proyecto pero sin versionar, para contexto que no debe compartirse.
¿Todos los subagentes necesitan memoria?
No. Para subagentes que verifican un build o buscan un patrón, empezar de cero es lo correcto. La memoria solo aporta en los que gestionan procesos recurrentes, aprenden preferencias o coordinan varias skills sobre un mismo dominio.
Recursos relacionados
- Subagentes en Claude Code y subagentes built-in.
- CLAUDE.md: la memoria del proyecto: la otra forma de memoria en Claude Code.
- Guía completa para dominar Claude Code.
Tu siguiente paso
Los comandos de subagentes y decenas más están en la Cheat Sheet de Claude Code: una hoja imprimible, en español.
Descargar la Cheat Sheet gratis
Es el resumen de Ship with Claude Code, la guía de Takren (14 módulos, 190 capítulos, actualizaciones gratuitas).