Sistema de Memoria Basado en Archivos de Claude Code: Una Alternativa Pragmática a las Bases de Datos Vectoriales

Claude Code utiliza un enfoque basado en archivos para la memoria del agente que reemplaza la configuración típica de base de datos vectorial y embeddings. En lugar de RAG completo, almacena recuerdos como archivos .md con pequeñas secciones de frontmatter que contienen información de nombre, descripción y tipo, además de un archivo MEMORY.md que actúa como índice.

Cómo funciona el sistema

En tiempo de ejecución, el sistema no embebe ni busca todo. Sigue este proceso:

• Escanea archivos de memoria (limitado a aproximadamente 200, los más nuevos primero)
• Lee solo las primeras ~30 líneas (principalmente metadatos)
• Construye un manifiesto ligero
• Usa un modelo pequeño para seleccionar los ~5 recuerdos más relevantes
• Carga solo esos recuerdos seleccionados en el contexto (con límites de tamaño)

Ventajas clave

El diseño ofrece varios beneficios prácticos:

• Rentable: Archivos limitados, tokens limitados, costos predecibles
• Rápido: Sin operaciones de embedding o búsqueda de similitud
• Controlado: Solo inyecta algunos recuerdos con límites estrictos en todas partes
• Legible para humanos: Todo se almacena como archivos markdown
• Menos basura: Evita explícitamente almacenar información que ya se puede derivar del repositorio

El sistema trata la memoria como "posiblemente desactualizada" en lugar de verdad absoluta, lo que proporciona un enfoque refrescante para la gestión de memoria del agente. Este diseño es particularmente pragmático para agentes de codificación y depuración donde la mayoría de la "memoria" consiste en preferencias, contexto o referencias externas en lugar de grandes bases de conocimiento.

Aunque este enfoque no reemplaza a RAG para todos los casos de uso, representa un buen equilibrio para agentes de desarrollo donde la simplicidad y la previsibilidad importan más que la recuperación integral de conocimiento.