Un CLAUDE.md breve que funciona (y Markdown en 5 minutos)

Esta lección todavía está en pruebas: mejora con los comentarios de quienes la siguen. Si algo no está claro, hay que corregir la lección, no a ti.

Al final de esta lección, sabrás

leer y escribir un archivo Markdown, el formato de texto que Claude Code lee para sus instrucciones;
escribir un CLAUDE.md de una página que cambia de verdad la manera en que Claude Code trabaja contigo;
probarlo, y luego corregirlo cuando una instrucción no se sigue.

Por qué te interesa

Sin CLAUDE.md, repites las mismas instrucciones en cada sesión: «tutéame», «pregunta antes de modificar», «sé breve». Con él, las escribes una vez. Es el archivo que convierte a Claude Code de un asistente genérico en tu asistente.

Antes de empezar


Necesitas	Claude Code, tu carpeta mon-espace-ia en modo Manual, y la lección 1 de este módulo
Duración	40 minutos
Costo	Incluido en tu suscripción

Entenderlo en 3 minutos

Markdown, el formato de texto de tus instrucciones

Un archivo que termina en .md es un simple archivo de texto, legible tanto por ti como por la IA. Bastan unos pocos signos para darle formato:

Escribes	Obtienes
`# Título`	Un título grande
`## Parte`	Un título de sección
`- una idea`	Una línea de lista con viñetas
`1. un paso`	Una lista numerada
`importante`	Texto en negrita

Es todo lo que necesitas para CLAUDE.md. Puedes abrirlo con cualquier editor de texto (TextEdit en Mac, Bloc de notas en Windows), o directamente en la app Claude.

CLAUDE.md

Es un archivo llamado exactamente CLAUDE.md, colocado en la raíz de tu carpeta de trabajo. Claude Code lo relee al comienzo de cada sesión. Según la documentación (24/10/2026):

conviene apuntar a menos de 200 líneas: cuanto más largo es, peor se siguen sus instrucciones. Para empezar, basta con una página;
Claude lo lee como instrucciones, no como un candado: tus permisos en modo Manual siguen siendo tu protección;
el comando /init puede proponer uno automáticamente, pensado sobre todo para los proyectos de código. Para tu espacio de trabajo, la plantilla de esta lección es más adecuada.

Lo que se pone dentro

Sobre mí: 5 líneas como máximo, nada sensible.
Nuestra forma de trabajar: tus reglas (tuteo, un paso a la vez, preguntar antes de modificar).
Al empezar y al terminar una sesión: releer el diario, escribir la página del día.

Hagámoslo juntos

1Paso 1: Descargar la plantilla

Descarga la plantilla de CLAUDE.md (en los recursos más abajo) y léela: ocupa una página, con las tres partes.

2Paso 2: Hacer que Claude Code la instale

Atención: si instalaste el kit del módulo 4, mon-espace-ia ya contiene un CLAUDE.md, con tu parte «Sobre mí» y las reglas de seguridad del kit. No lo reemplaces sin compararlo.

En mon-espace-ia, en modo Manual, pega la plantilla en la conversación, precedida de:

Aquí tienes una plantilla de CLAUDE.md. Si ya existe un CLAUDE.md en la raíz de esta carpeta, compáralo con esta plantilla y proponme una versión que conserve mis líneas «Sobre mí», mi nivel de acompañamiento, mis reglas de seguridad y mis instrucciones para empezar y terminar una sesión; si no, crea el archivo con este contenido. Muéstrame el archivo completo antes de escribirlo.

Lee el archivo propuesto y la solicitud de permiso, y luego permítela.

3Paso 3: Completar «Sobre mí»

Si tu parte «Sobre mí» ya está completada, reléela y pasa al paso 4. Si no:

Hazme 3 preguntas, una por una, para completar la parte «Sobre mí» de CLAUDE.md en 5 líneas como máximo. Muéstrame las líneas antes de escribirlas.

4Paso 4: Probar

Abre una Nueva sesión en la misma carpeta y escribe simplemente: «Hola». Si sigue tu CLAUDE.md, te tutea, resume tu última sesión si existe un diario y te propone una sola cosa que hacer.

Ahora te toca a ti

Tu propia regla. Agrega a CLAUDE.md una regla que te importe, por ejemplo «Responde en 10 líneas como máximo», «Propón siempre dos opciones antes de elegir» o «Recuérdame comprobar las cifras». Abre una nueva sesión y comprueba que se sigue. Si no se sigue, hazla más precisa: «10 líneas como máximo» funciona mejor que «sé conciso».

Recursos para descargar

Plantilla de CLAUDE.md: una página, lista para adaptar.

Comprobar

Funcionó si:

CLAUDE.md existe en la raíz de mon-espace-ia, ocupa menos de una página y no contiene nada sensible;
en una nueva sesión, Claude Code aplica al menos dos de tus instrucciones sin que las repitas;
tu regla personal se sigue, después de una posible corrección.

Errores frecuentes:

un CLAUDE.md de tres páginas, con instrucciones que se contradicen: quédate con lo esencial;
instrucciones vagas («sé eficaz»): prefiere instrucciones comprobables («10 líneas como máximo»);
escribir en él información sensible: se relee y se transmite en cada sesión.

Guardar y retomar

Relee tu CLAUDE.md una vez al mes: elimina lo que ya no sirve, precisa lo que no se sigue.

Para ir más lejos

opcional

La documentación oficial, en inglés: code.claude.com/docs/en/memory (archivos CLAUDE.md personales para todos tus proyectos, importaciones, reglas por carpeta).

Palabras nuevas

4 palabras explicadas

Palabra	Lo que significa
Markdown	Una manera de escribir texto con unos pocos signos (#, -, **) para hacer títulos, listas y negritas
Archivo .md	Un archivo de texto escrito en Markdown
Raíz de la carpeta	El nivel principal de la carpeta, fuera de cualquier subcarpeta
/init	Un comando de Claude Code que propone un CLAUDE.md de partida, sobre todo para los proyectos de código

Puntos que quedan por verificar: la prueba completa con una persona principiante real, en Mac y en Windows.