Pregunta respondida en el curso · 3 min · del curso de 4 h

¿Qué es CLAUDE.md y para qué sirve?

Se responde en el curso gratis de Claude Code del canal de Adrián Sáenz, impartido por Agustín Medina, a partir del minuto 41:10.

El vídeo empieza en el minuto en que se responde y sigue con el resto del curso. Ver el curso completo con su índice · Ver en YouTube

En resumen

CLAUDE.md es un archivo de texto con instrucciones y reglas de tu proyecto que Claude Code carga antes de cada conversación, para que tome mejores decisiones desde el primer mensaje. En el curso de Claude Code, publicado en abril de 2026, Agustín Medina lo compara con el plano de obra que se entrega a los constructores antes de empezar.

El problema que resuelve

Agustín parte de la ventana de contexto: cuanta más información acumula una conversación, más cara es cada respuesta y más se equivoca la IA. Si cada vez tienes que explicar de nuevo cómo es tu proyecto, gastas tokens y obtienes resultados irregulares. El archivo CLAUDE.md da a Claude esas indicaciones fijas de una vez.

Ver la respuesta en el vídeo · 38:11

El plano de obra de tu proyecto

Su ejemplo son las pirámides: 300 constructores sin planos pueden acertar con la primera capa, pero la obra acabará mal. CLAUDE.md es ese plano. Se carga antes del historial de la conversación y le dice al modelo cómo tiene que hacer las cosas en ese proyecto: estructura, estilo, herramientas y reglas. La extensión .md significa que está escrito en Markdown, un formato de texto sencillo.

Ver la respuesta en el vídeo · 42:24

Cómo conseguir uno sin saber programar

No hace falta escribirlo desde cero. Según el curso, puedes encontrar modelos en internet o pedirle a la propia IA que lo genere a partir de tu proyecto. Justo después, Agustín usa uno para crear una landing page con un formulario.

Ver la respuesta en el vídeo · 43:56

Preguntas frecuentes

Dudas sobre esta pregunta

¿CLAUDE.md gasta tokens?

Sí. Como se carga al principio de cada sesión, ocupa espacio en la ventana de contexto. Por eso, en la parte de ahorro del curso, Agustín recomienda mantenerlo corto y con lo esencial: las herramientas del proyecto, las convenciones de código y las reglas básicas.

Ver la respuesta en el vídeo · 03:43:16

¿Qué pasa si no uso un archivo CLAUDE.md?

Claude Code funciona igual, pero cada vez que limpias la conversación se pierde lo que le habías explicado: tendrás que darle el contexto de nuevo y es más fácil que tome decisiones distintas cada vez. Agustín lo compara con perder los planos de una obra a medias. Para pruebas pequeñas puede no hacer falta.

Ver la respuesta en el vídeo · 43:17