Plantillas de CLAUDE.md para descargar
CLAUDE.md es el archivo que Claude Code lee al empezar cada sesión en una carpeta: ahí van tus reglas, la estructura de la carpeta y lo que no debe tocar. Tres plantillas listas según lo que tengas en la carpeta; descarga la tuya, guárdala en la raíz de la carpeta y edita lo que va entre corchetes.
Carpeta de trabajo (no técnica)
Para una carpeta con documentos, presupuestos, facturas o material de clientes. Le dice a Claude Code cómo nombrar archivos, qué no tocar y en qué idioma trabajar.
Ver la plantilla completa
# Carpeta de trabajo de [tu nombre o negocio]
## Qué hay aquí
- `clientes/`: una subcarpeta por cliente con presupuestos, contratos y entregas.
- `facturas/`: facturas emitidas y recibidas, por año y mes.
- `plantillas/`: documentos base que se copian, nunca se editan directamente.
- `borradores/`: trabajo en curso; aquí puedes crear y modificar libremente.
## Cómo quiero que trabajes
- Escribe siempre en español.
- Nombra los archivos nuevos así: `AAAA-MM-DD_cliente_tipo.ext` (por ejemplo, `2026-09-20_acme_presupuesto.docx`).
- Antes de crear un documento, pregúntame el cliente y la fecha si no te los he dado.
- Cuando muevas o renombres archivos, enséñame el plan completo antes de hacerlo.
- Si una tarea afecta a más de 10 archivos, hazla en dos pasos: primero 2 de prueba, luego el resto.
## Lo que no debes hacer
- No borres ni muevas nada dentro de `facturas/` sin preguntarme.
- No modifiques `plantillas/`: cópialas a `borradores/` y trabaja sobre la copia.
- No subas nada a Internet ni envíes correos.
## Cuando termines una tarea
- Resume en tres líneas qué has hecho y qué archivos has tocado.
- Si has tenido que suponer algo, dímelo.
Proyecto web (HTML, CSS y JavaScript)
Para una página o sitio web estático. Fija la estructura, el estilo de código, cómo previsualizar y qué comprobar antes de dar algo por terminado.
Ver la plantilla completa
# [Nombre del sitio]
## Qué es
Sitio web estático en HTML, CSS y JavaScript, sin frameworks. Se publica en [Cloudflare Pages / Netlify / hosting]. Público: [describe a quién va dirigido].
## Estructura
- `index.html`: portada.
- `css/styles.css`: único archivo de estilos; los colores y fuentes son variables al principio.
- `js/`: un archivo por función; sin librerías externas salvo que lo apruebe.
- `img/`: imágenes optimizadas (WebP o SVG, nunca más de 300 KB).
- Cada página vive en su carpeta con un `index.html` (`/contacto/index.html`), para que las URL sean limpias.
## Cómo trabajar
- Escribe el contenido en español y el código con nombres en inglés.
- Mantén el HTML semántico (`header`, `main`, `nav`, `article`) y accesible: textos alternativos en imágenes, contraste suficiente, botones con etiqueta.
- Todo debe funcionar en móvil (375 px de ancho) sin desplazamiento horizontal.
- No añadas dependencias ni cambies la paleta sin preguntar.
- Para previsualizar: `python -m http.server 8000` en la raíz y abrir http://localhost:8000.
## Antes de dar algo por terminado
- Comprueba que todos los enlaces internos existen.
- Abre la página en el navegador y revisa la consola: cero errores.
- Mira la página a 375 px y a 1280 px.
- Si has cambiado `styles.css`, revisa que no se ha roto ninguna otra página.
## Lo que no debes hacer
- No borres páginas existentes ni cambies URL publicadas: rompen enlaces externos.
- No incluyas claves, contraseñas ni identificadores de servicios en el código.
Automatizaciones y datos (scripts, n8n, CSV)
Para una carpeta con scripts, flujos de n8n exportados y archivos de datos. Establece cómo probar sin romper nada, cómo tratar los datos y cómo documentar.
Ver la plantilla completa
# Automatizaciones de [tu nombre o negocio]
## Qué hay aquí
- `flujos/`: flujos de n8n exportados en JSON. El nombre del archivo es el nombre del flujo.
- `scripts/`: scripts en Python o PowerShell. Cada uno con un comentario inicial que dice qué hace y cómo se ejecuta.
- `datos/`: archivos CSV y Excel de entrada. Son de solo lectura.
- `salidas/`: resultados generados. Se puede borrar y regenerar.
## Cómo quiero que trabajes
- Antes de escribir un script, dime en tres líneas qué va a hacer y qué archivos va a leer y escribir.
- Los scripts deben aceptar una opción de simulación (`--dry-run` o `-WhatIf`) que muestre lo que haría sin hacerlo, y ejecutarse primero así.
- Nunca modifiques los archivos de `datos/`; escribe siempre en `salidas/`.
- Los flujos de n8n no llevan credenciales dentro: usa las credenciales de n8n y marcadores como `ID_DE_TU_HOJA`.
- Cuando cambies un flujo, exporta el JSON nuevo y guarda el anterior como `nombre.v1.json`.
- Usa Python por defecto; PowerShell solo para tareas de Windows.
## Datos personales
- Los archivos de `datos/` pueden contener datos personales. No los copies a otros sitios, no los pegues en ejemplos y no los envíes a ningún servicio externo.
## Cuando termines
- Añade o actualiza el `README.md` de la carpeta con: qué hace cada script y flujo, cómo se ejecuta y qué necesita.
- Resume qué has cambiado y qué habría que probar a mano.
Dónde va el archivo y cómo se usa
- Guarda el archivo como
CLAUDE.md(así, en mayúsculas) en la carpeta raíz del proyecto o de trabajo. - Abre Claude Code en esa carpeta (o reinícialo si ya estaba abierto). No hace falta decirle nada: lo lee al empezar.
- Cuando quieras añadir una regla sin abrir el archivo, escribe un mensaje que empiece por
#: Claude lo guarda en el CLAUDE.md. - Para revisarlo o editarlo desde dentro, escribe
/memory.
Qué poner y qué no
- Sí: qué hay en la carpeta, cómo nombrar archivos, qué no tocar, en qué idioma escribir, qué comprobar antes de terminar, cómo se ejecuta o previsualiza el proyecto.
- Sí: las correcciones que te encuentras repitiendo. Si en tres sesiones has dicho «no uses emojis», eso es una regla del CLAUDE.md.
- No: contraseñas, claves ni datos personales. El archivo es texto plano y suele acabar compartido.
- No: instrucciones de una sola tarea. Para eso está la conversación.
- Corto: entre 20 y 60 líneas. Claude lo lee entero en cada sesión; cuanto más largo, menos caso hace a cada línea.
Puedes tener un CLAUDE.md general en tu carpeta de usuario (~/.claude/CLAUDE.md) con tus preferencias de siempre (idioma, tono) y otro en cada proyecto con lo específico. Claude combina los dos. Si trabajas con tareas que se repiten, el siguiente paso son las skills.
Preguntas frecuentes
¿Claude Code lee el CLAUDE.md siempre?
Sí, al iniciar cada sesión en esa carpeta, y también los que haya en subcarpetas cuando trabaja dentro de ellas. No hace falta mencionarlo.
¿Sirve para claude.ai?
No directamente, pero su contenido es exactamente lo que pondrías en las instrucciones de un Proyecto. Cópialo ahí.
¿Y si Claude no hace caso a una regla?
Acórtala y hazla más concreta («no borres archivos de /facturas» funciona mejor que «ten cuidado con las facturas»), muévela arriba del archivo y, si es crítica, pídele que la confirme al empezar la sesión.