Saltar al contenido principal

CLAUDE.md y archivos de memoria

Principiante

Si haces una sola cosa para mejorar Claude Code, que sea esta. CLAUDE.md es un archivo de texto plano que Claude lee al inicio de cada sesión — el briefing permanente de tu proyecto.

What you'll learn
  • Por qué CLAUDE.md es el único ajuste de Claude Code de mayor impacto
  • Cómo la jerarquía de memoria se combina desde lo global hasta lo específico del proyecto
  • Cómo generar un archivo inicial con /init y recortarlo
  • Qué pertenece a CLAUDE.md — y qué dejar fuera
  • Cómo los @imports te permiten referenciar documentos sin duplicarlos

Por qué es el ajuste de mayor impacto​

Sin él, vuelves a explicar tu proyecto en cada sesión ("usamos pnpm, los tests están en __tests__, no toques /generated…"). Con él, Claude ya lo sabe. Unas buenas instrucciones aquí mejoran cada interacción futura de golpe.

La jerarquía de memoria​

Claude Code lee la memoria de varios sitios y los combina, aproximadamente de lo más global a lo más específico:

  • Memoria de usuario — tus preferencias personales en todos los proyectos.
  • Memoria de proyecto (./CLAUDE.md, en el control de versiones) — cómo funciona este repo. Se comparte con tu equipo.
  • Anidada — coloca un CLAUDE.md en una subcarpeta para reglas que solo apliquen ahí.
Conoce tus capas de memoria
Pulsa Intro o Espacio para girar la tarjeta. Usa las flechas izquierda y derecha para moverte entre las tarjetas.Término mostrado.
1 / 4

Genera un punto de partida​

Guided walkthrough1 of 3
  1. Claude inspecciona el código y redacta un CLAUDE.md por ti automáticamente.

Genera un borrador de CLAUDE.md

/init

Toma una plantilla lista para usar en Plantillas de CLAUDE.md.

Qué poner en él​

  • Qué es el proyecto, en dos frases.
  • El stack tecnológico y cómo ejecutar / testear / hacer lint.
  • Convenciones que Claude no puede inferir (nomenclatura, estructura, estilo de commits).
  • Salvaguardas: "ejecuta los tests antes de declarar que está hecho", "nunca edites /vendor", "nunca hagas commit de secretos".

Qué NO poner en él​

Watch out
  • Claude sigue CLAUDE.md al pie de la letra — las instrucciones obsoletas, vagas o aspiracionales perjudican activamente.
  • Describe cómo funciona el proyecto realmente hoy; breve y veraz gana a largo y aspiracional.
  • Evita documentos enormes pegados (usa @imports en su lugar), secretos y reglas que en realidad no sigues.
  • Revísalo periódicamente para que se mantenga preciso a medida que el proyecto evoluciona.

Importaciones​

Trae documentos existentes en lugar de duplicarlos — p. ej. referencia tu guía de estilo con una importación @path/to/file para que haya una única fuente de verdad. Consulta la documentación oficial de memoria para la sintaxis exacta.

Pro tip
  • Una única fuente de verdad: referencia un archivo con @imports en lugar de pegar su contenido en CLAUDE.md.
  • Si un documento ya existe, enlázalo — no lo copies. Las copias se quedan obsoletas.

Compruébate​

Compruébate

0/3
  1. ¿Qué archivo lee Claude Code al inicio de cada sesión como el briefing permanente de tu proyecto?
  2. ¿Qué hace ejecutar /init en un proyecto?
  3. ¿Cuál es la forma recomendada de incluir un documento grande existente, como una guía de estilo?
Key takeaways
  • CLAUDE.md es el ajuste de mayor impacto: mejora cada sesión futura de golpe.
  • La memoria se combina de lo global a lo específico: política enterprise, luego archivos CLAUDE.md de usuario, de proyecto y anidados.
  • Empieza con /init, luego recorta el borrador a lo que es realmente cierto.
  • Incluye el resumen del proyecto, los comandos de ejecución/test/lint, las convenciones y las salvaguardas.
  • Mantenlo breve y veraz — usa @imports para documentos grandes y nunca hagas commit de secretos.

Siguiente​