Claude Code Memory: los 3 sistemas de memoria que la mayoria de los devs desconocen

Claude Code ahora tiene 3 sistemas de memoria distintos: Memory, Auto Memory y Agent Memory. La mayoria de los desarrolladores ni siquiera saben que existen -- y los que conocen CLAUDE.md piensan que eso es todo.

Y es curioso porque Anthropic no deja de adoptar patrones que ya existian en OpenClaw -- MEMORY.md, auto memory, agent memory, project rules. Feature tras feature, todo se repite.

La realidad es un sistema de 6 capas con una jerarquia precisa. Configurarlo mal significa dejar a Claude Code funcionando al 30% de su potencial.

Las 6 capas de memoria de Claude Code

Cada capa tiene un rol especifico y una prioridad en la resolucion de instrucciones:

Capa 1: Managed Policy

La capa mas alta en la jerarquia. Definida por Anthropic o tu organizacion si usas Claude Code en empresa. No puedes modificarla -- sirve como barrera de seguridad y politica global.

Capa 2: Project Memory (CLAUDE.md)

El archivo que todos conocen. Ubicado en la raiz de tu proyecto, contiene:

• Convenciones del proyecto (formato, nombres)
• Comandos de build y test
• Arquitectura del proyecto
• Reglas especificas de tu stack

El punto clave: este archivo se versiona con git. Todo tu equipo se beneficia.

# CLAUDE.md

## Build
- `pnpm dev` para desarrollo local
- `pnpm build` para produccion

## Convenciones
- TypeScript estricto
- Drizzle ORM para la BD
- Componentes en src/components/

Capa 3: Project Rules (.claude/rules/*.md)

La capa mas poderosa y menos conocida. Archivos markdown en .claude/rules/ que se activan condicionalmente:

---
globs: src/components/**/*.tsx
alwaysApply: false
---

Todos los componentes React deben usar named exports.
Usar `cn()` para la fusion de clases Tailwind.

La regla solo se activa cuando Claude Code trabaja en un archivo que coincide con el glob. Esto permite tener instrucciones especificas sin contaminar el CLAUDE.md principal.

Capa 4: User Memory (~/.claude/CLAUDE.md)

Tu archivo de preferencias personales, almacenado en tu directorio home. Se aplica a todos tus proyectos:

• Tu editor preferido
• Tus convenciones de estilo globales
• Tus preferencias de comunicacion con Claude

Capa 5: Imports

Archivos externos cargados al vuelo en el contexto. Util para inyectar documentacion, specs o referencias sin ponerlas en CLAUDE.md.

Capa 6: Auto Memory

La novedad. Claude Code escribe sus propias notas en ~/.claude/projects/<proyecto>/memory/:

~/.claude/projects/<proyecto>/memory/
├── MEMORY.md          <- Indice (primeras 200 lineas cargadas auto)
├── debugging.md       <- Notas de depuracion
├── api-conventions.md <- Decisiones aprendidas
└── ...

Cuando corriges a Claude Code ("no, usa pnpm no npm"), toma nota. Cuando resuelve un bug complejo, registra la solucion. Tambien puedes decirle "remember that..." y escribe en sus archivos.

El comando /memory te permite ver todas las capas a la vez y editarlas.

Memory vs Auto Memory vs Agent Memory

Esta es la confusion mas comun:

Agent Memory es el mas avanzado: cuando Claude Code genera sub-agentes, cada uno mantiene su propia memoria independiente que persiste entre sesiones.

La configuracion en 5 minutos

1. Crea tu CLAUDE.md en la raiz del proyecto con tus convenciones y comandos
2. Agrega rules en .claude/rules/ para reglas condicionales
3. Configura tu User Memory en ~/.claude/CLAUDE.md para preferencias globales
4. Activa Auto Memory usando Claude Code normalmente -- escribe solo
5. Verifica con /memory para ver el estado completo

Conclusion

El sistema de memoria de Claude Code es mucho mas que un simple archivo CLAUDE.md. Es una arquitectura de 6 capas que, una vez bien configurada, transforma a Claude Code en un verdadero colaborador que te conoce, conoce tu proyecto y aprende de sus errores.

Ver el video completo