Archivo CLAUDE.md: qué es, dónde va y 3 plantillas

Un archivo CLAUDE.md es un archivo de texto en Markdown que Claude Code lee al inicio de cada sesión, para que escribas tus reglas, tu contexto y tus preferencias una sola vez en lugar de repetirlos en cada conversación. Ponlo en la carpeta principal de un proyecto para las reglas de ese proyecto, o en ~/.claude/CLAUDE.md para reglas que aplican a todo lo que haces. Claude lo toma como una guía y no como una configuración obligatoria, así que funcionan mejor las instrucciones cortas y concretas.

Markdown es simplemente texto con algunos símbolos para dar estructura: # empieza un título y - empieza una viñeta. No necesitas nada más para escribir un buen CLAUDE.md.

Cómo funciona CLAUDE.md

Cada sesión de Claude Code empieza con la memoria en blanco. Dos cosas llevan conocimiento de una sesión a la siguiente: los archivos CLAUDE.md que escribes tú y las notas de memoria automática que Claude escribe para sí mismo.

Las dos son contexto, no configuraciones obligatorias: Claude las lee e intenta seguirlas, como explica la documentación de memoria de Anthropic. Para bloquear algo pase lo que pase, usa una regla de permisos, que vemos más abajo.

Dónde van los archivos CLAUDE.md

~ significa tu carpeta de usuario (%USERPROFILE% en Windows), y ./ significa la carpeta principal de tu proyecto.

Claude Code carga el CLAUDE.md de la carpeta donde lo inicias y el de cada carpeta superior, y los archivos se suman en lugar de reemplazarse. Un CLAUDE.md dentro de una subcarpeta solo se carga cuando Claude empieza a trabajar con archivos de esa subcarpeta.

Como el archivo más específico se lee al final, una regla del proyecto queda más cerca del trabajo. Aun así, evita contradecir tu archivo personal, porque cuando dos reglas chocan Claude puede seguir cualquiera de las dos.

Cómo crear un archivo CLAUDE.md

1. Abre la carpeta de tu proyecto en Claude Code. En la terminal, entra en la carpeta y ejecuta claude; en la app de escritorio, usa la pestaña Code y Select folder.
2. Ejecuta /init. Claude recorre la carpeta y escribe un CLAUDE.md inicial. Si ya existe uno, propone mejoras en lugar de sobrescribirlo.
3. O deja que Claude te entreviste. Para una carpeta que todavía tiene poco, el prompt de abajo da mejores resultados que /init.
4. Edítalo. /memory enumera tus archivos CLAUDE.md y abre uno en tu editor, o simplemente puedes decir "agrega esta regla a CLAUDE.md".
5. Vuelve a cargarlo. El archivo se lee al inicio de la sesión, así que ejecuta /clear o empieza una sesión nueva después de editarlo; la página de prompt caching de Anthropic explica por qué los cambios a mitad de sesión esperan.
6. Comprueba que se cargó. Ejecuta /context y busca el archivo en Memory files.

Quiero un CLAUDE.md para esta carpeta. Hazme hasta 8 preguntas, una a la vez, sobre mi negocio, para quién es el trabajo, mi tono de voz, las reglas que siempre quiero que se cumplan y qué significa "terminado" para mí. Luego escribe un CLAUDE.md de menos de 60 líneas con títulos claros, y muéstramelo antes de guardarlo.

Qué poner y qué dejar fuera

Piensa en CLAUDE.md como el lugar para lo que de otro modo volverías a explicar. Una buena señal para agregar una línea es que Claude cometa el mismo error dos veces, o que escribas la misma corrección que escribiste la semana pasada.

Si tus reglas ya están en otro archivo, inclúyelo con una importación @, como @brand/voice.md, en lugar de copiarlo. Los archivos importados también se cargan al inicio, así que las importaciones ordenan las cosas pero no hacen el archivo más liviano.

Tres plantillas de CLAUDE.md listas para copiar

Reemplaza todo lo que está entre corchetes, borra lo que no aplique y mantén el resultado corto. Cada una es un punto de partida para recortar después de una semana de uso real.

Plantilla 1: dueño de negocio

Guárdala como ~/.claude/CLAUDE.md para que aplique en todas partes, o como CLAUDE.md en la carpeta que usas para tareas administrativas.

# Sobre mí y mi negocio
- Dirijo [NOMBRE DEL NEGOCIO], un [TIPO DE NEGOCIO] en [CIUDAD O MERCADO].
- Los clientes son [QUIÉNES SON]. Productos o servicios principales: [LISTA].
- No soy desarrollador. Explica cualquier cosa técnica en una frase simple.

# Cómo trabajar conmigo
- Hazme preguntas antes de empezar cualquier cosa que lleve más de unos pocos pasos.
- Muéstrame un plan corto antes de cambiar más de 3 archivos.
- Responde en [IDIOMA], en párrafos cortos, sin jerga.

# Reglas que siempre aplican
- Nunca envíes correos, mensajes ni pagos. Prepara borradores para que yo los envíe.
- Nunca borres archivos. Mueve lo que quieras quitar a una carpeta llamada _trash.
- Nunca inventes números, precios ni datos. Si falta algo, pregúntame.
- La moneda es [MONEDA]. Las fechas se escriben [FORMATO DE FECHA].

# Archivos y carpetas
- Los documentos que llegan están en /inbox. El trabajo terminado va en /output.
- Nombra los archivos como AAAA-MM-DD_tema.

# Cuando termines una tarea
- Enumera lo que cambiaste, lo que no pudiste hacer y todo lo que no tenías claro.

# Compact instructions
Al compactar, conserva la lista de archivos cambiados y las preguntas abiertas.

La última sección usa una función de la documentación de Anthropic: un título "Compact instructions" le dice a Claude qué conservar cuando resume una conversación larga.

Plantilla 2: marketer

Guárdala como CLAUDE.md en tu carpeta de marketing. Para flujos de marketing completos que la usan, mira Claude Code para marketing.

# Marca
- Marca: [NOMBRE DE LA MARCA]. Vendemos [OFERTA] a [AUDIENCIA].
- Voz: [TRES ADJETIVOS]. Sonamos como [EJEMPLO], nunca como [ANTIEJEMPLO].
- Palabras que nunca usamos: [LISTA].
- Ortografía: español [VARIANTE].

# Datos y afirmaciones
- Usa solo los datos de /brand/facts.md y de los archivos que te doy.
- Cada estadística necesita un enlace a la fuente. Si no encuentras uno, deja fuera el número.
- No nombres a competidores salvo que te lo pida.

# Canales y formatos
- LinkedIn: menos de [NÚMERO] palabras, una idea por publicación.
- Correo: asunto de menos de [NÚMERO] caracteres, una llamada a la acción.
- Textos de Instagram: el gancho va en la primera línea, menos de [NÚMERO] palabras en total.

# Archivos
- Los briefs están en /briefs. Los borradores van en /drafts, un archivo por pieza, nombrado canal_tema_fecha.

# Antes de decir que terminaste
- Compara cada afirmación con los archivos fuente y enumera todo lo que no tenga respaldo.

Plantilla 3: proyecto de sitio web

Guárdala como CLAUDE.md en la carpeta principal del sitio. La guía para crear un sitio web con IA recorre un proyecto completo que combina bien con ella.

# Proyecto
- Sitio web para [NOMBRE DEL NEGOCIO]: [PARA QUÉ ES EL SITIO].
- La única acción que queremos de los visitantes: [POR EJEMPLO, AGENDAR UNA LLAMADA].
- Hecho con [TECNOLOGÍA, POR EJEMPLO HTML Y CSS SIMPLES]. Alojado en [HOSTING].

# Comandos
- Vista previa local: [COMANDO]
- Revisión antes de publicar: [COMANDO]

# Reglas de diseño
- Colores: [CÓDIGOS HEX]. Fuentes: [FUENTES]. Deja mucho espacio en blanco.
- Primero móvil: revisa cada cambio en ancho de teléfono antes de decir que está listo.
- Cada imagen necesita texto alternativo. Los botones dicen qué pasa después ("Agendar una llamada", no "Enviar").

# Reglas de contenido
- Usa solo los textos de /content y los datos que yo confirme. Nada de reseñas, números ni logos inventados.
- Cada página necesita su propio título y su meta descripción.

# No
- No agregues bibliotecas, plugins ni servicios nuevos sin preguntarme.
- No cambies la configuración del dominio, el DNS ni el hosting.

# Terminado significa
- El comando de revisión pasa, la página funciona en ancho de teléfono y enumeras lo que cambiaste.

Cuando CLAUDE.md no alcanza

La guía para crear una skill de Claude muestra cómo convertir un procedimiento en una skill. Para las reglas de denegación, la guía de permisos de Anthropic tiene la sintaxis, y nuestra chuleta de Claude Code incluye un archivo de configuración inicial.

Mantener CLAUDE.md liviano también ahorra uso, porque se carga en cada sesión. La guía de límites de uso de Claude Code explica cuánto importa el tamaño de tu contexto.

Cuando Claude ignora tu CLAUDE.md

• Nunca se cargó. Ejecuta /context y búscalo en Memory files; si no está, está en la carpeta equivocada.
• Lo editaste a mitad de sesión. Ejecuta /clear o empieza una sesión nueva para que se cargue la versión nueva.
• Es demasiado largo o demasiado vago. Quita todo lo que Claude ya hace solo, y reescribe las reglas difusas como reglas comprobables.
• Dos reglas chocan. Revisa tu archivo personal, el archivo del proyecto y los de las subcarpetas, y borra una de las dos.
• Tiene que ser una regla estricta. Pásala a una regla de permisos o a un hook.

Qué hacer ahora

Abre la carpeta de proyecto que más usas, ejecuta /init o el prompt de entrevista, y mantén el resultado por debajo de 60 líneas durante la primera semana. Cada vez que corrijas a Claude, pregúntate si esa corrección va en el archivo, y quita todo lo que Claude ya hace solo. El tutorial para principiantes muestra CLAUDE.md funcionando dentro de un proyecto real, y el curso de Claude Code tiene una lección dedicada al archivo CLAUDE.md, seguida de skills y MCP.