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 MemoriaUbicaciónPropósitoEjemplos de Casos de Uso
Memoria del proyecto./CLAUDE.mdInstrucciones compartidas por el equipo para el proyectoArquitectura del proyecto, estándares de codificación, flujos de trabajo comunes
Memoria del usuario~/.claude/CLAUDE.mdPreferencias personales para todos los proyectosPreferencias de estilo de código, atajos de herramientas personales
Memoria del proyecto (local)./CLAUDE.local.mdPreferencias 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:

Ver @README para la descripción general del proyecto y @package.json para los comandos npm disponibles para este proyecto.

# Instrucciones Adicionales
- flujo de trabajo git @docs/git-instructions.md

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.

# Preferencias Individuales
- @~/.claude/my-project-instructions.md

Para evitar posibles colisiones, las importaciones no se evalúan dentro de spans de código markdown y bloques de código.

Este span de código no será tratado como una importación: `@anthropic-ai/claude-code`

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 #:

# Siempre usar nombres de variables descriptivos

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:

> /init 

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.