Gestionar la memoria de Claude
Aprende cómo gestionar la memoria de Claude Code a través de sesiones con diferentes ubicaciones de memoria y mejores prácticas.
Claude Code puede recordar tus preferencias a través de sesiones, como pautas de estilo y comandos comunes en tu flujo de trabajo.
Determinar el tipo de memoria
Claude Code ofrece tres ubicaciones de memoria, cada una sirviendo un propósito diferente:
Tipo de Memoria | Ubicación | Propósito | Ejemplos de Casos de Uso |
---|---|---|---|
Memoria del proyecto | ./CLAUDE.md | Instrucciones compartidas por el equipo para el proyecto | Arquitectura del proyecto, estándares de codificación, flujos de trabajo comunes |
Memoria del usuario | ~/.claude/CLAUDE.md | Preferencias personales para todos los proyectos | Preferencias de estilo de código, atajos de herramientas personales |
Memoria del proyecto (local) | ./CLAUDE.local.md | Preferencias personales específicas del proyecto | (Obsoleto, ver abajo) Tus URLs de sandbox, datos de prueba preferidos |
Todos los archivos de memoria se cargan automáticamente en el contexto de Claude Code cuando se inicia.
Importaciones de CLAUDE.md
Los archivos CLAUDE.md pueden importar archivos adicionales usando la sintaxis @ruta/a/importar
. El siguiente ejemplo importa 3 archivos:
Se permiten tanto rutas relativas como absolutas. En particular, importar archivos en el directorio home del usuario es una forma conveniente para que los miembros de tu equipo proporcionen instrucciones individuales que no se registren en el repositorio. Anteriormente CLAUDE.local.md servía un propósito similar, pero ahora está obsoleto en favor de las importaciones ya que funcionan mejor a través de múltiples árboles de trabajo git.
Para evitar posibles colisiones, las importaciones no se evalúan dentro de spans de código markdown y bloques de código.
Los archivos importados pueden importar recursivamente archivos adicionales, con una profundidad máxima de 5 saltos. Puedes ver qué archivos de memoria están cargados ejecutando el comando /memory
.
Cómo Claude busca memorias
Claude Code lee memorias recursivamente: comenzando en el cwd, Claude Code recurre hacia arriba hasta / y lee cualquier archivo CLAUDE.md o CLAUDE.local.md que encuentre. Esto es especialmente conveniente cuando trabajas en repositorios grandes donde ejecutas Claude Code en foo/bar/, y tienes memorias tanto en foo/CLAUDE.md como en foo/bar/CLAUDE.md.
Claude también descubrirá CLAUDE.md anidados en subárboles bajo tu directorio de trabajo actual. En lugar de cargarlos al inicio, solo se incluyen cuando Claude lee archivos en esos subárboles.
Agregar memorias rápidamente con el atajo #
La forma más rápida de agregar una memoria es comenzar tu entrada con el carácter #
:
Se te pedirá que selecciones en qué archivo de memoria almacenar esto.
Editar memorias directamente con /memory
Usa el comando slash /memory
durante una sesión para abrir cualquier archivo de memoria en tu editor del sistema para adiciones más extensas u organización.
Configurar memoria del proyecto
Supongamos que quieres configurar un archivo CLAUDE.md para almacenar información importante del proyecto, convenciones y comandos frecuentemente usados.
Inicializa un CLAUDE.md para tu base de código con el siguiente comando:
Consejos:
- Incluye comandos frecuentemente usados (build, test, lint) para evitar búsquedas repetidas
- Documenta preferencias de estilo de código y convenciones de nomenclatura
- Agrega patrones arquitectónicos importantes específicos de tu proyecto
- Las memorias CLAUDE.md pueden usarse tanto para instrucciones compartidas con tu equipo como para tus preferencias individuales.
Mejores prácticas de memoria
- Sé específico: “Usar indentación de 2 espacios” es mejor que “Formatear código apropiadamente”.
- Usar estructura para organizar: Formatea cada memoria individual como un punto de viñeta y agrupa memorias relacionadas bajo encabezados markdown descriptivos.
- Revisar periódicamente: Actualiza las memorias a medida que tu proyecto evoluciona para asegurar que Claude siempre esté usando la información y contexto más actualizado.