El archivo CLAUDE.md: cómo explicarle tu negocio a Claude para que haga tu web

Cada vez que abres Claude Code, empieza sin memoria. No sabe qué vendes, a quién, cómo hablas ni qué páginas de tu web son intocables. Lo averigua mirando archivos, y lo que no está en los archivos lo inventa.

El archivo CLAUDE.md existe para eso. Es un texto que Claude lee al arrancar cada sesión, y es la parte de crear tu web con Claude Code que más resultado da por el esfuerzo que cuesta. Aquí va qué es, qué escribir y cuánto, con lo que dice la documentación oficial y lo que he medido en mi propio servidor.

Los datos técnicos salen de la guía de memoria de Claude Code, consultada el 14 de noviembre de 2026.

Qué es CLAUDE.md y dónde se guarda

Un archivo de texto en formato markdown. Hay tres sitios según a quién afecte:

Claude carga el de tu carpeta y los de las carpetas que están por encima. Los de subcarpetas entran cuando trabaja con archivos de ahí. Y no se pisan: se suman.

Hay un segundo mecanismo, la «memoria automática», donde Claude apunta por su cuenta lo que aprende de tus correcciones. Es útil, pero no sustituye al archivo que escribes tú. El que escribes tú es el que puedes revisar, corregir y entender.

Qué escribir en el CLAUDE.md de un negocio con web

Hay un criterio de la documentación que ahorra muchos errores: las instrucciones tienen que ser tan concretas que se puedan comprobar. «Usa sangría de dos espacios» sirve; «formatea bien el código», no. Aplicado a un negocio:

• Mal: «Escribe con un tono cercano.»
• Bien: «Tutea. Frases cortas. Nada de signos de exclamación. Palabras como “lo mejor del mercado” o “calidad premium” no se usan.»

Lo que debe llevar el archivo, en este orden:

1. Quién eres y qué vendes. Dos o tres líneas. Servicio, ciudad o zona, a quién va dirigido.
2. Estructura de la web. Qué páginas hay, qué hace cada una y cuáles no se tocan. Un listado de direcciones con una línea cada una.
3. Voz. Cómo hablas, con ejemplos de frases tuyas reales y una lista de palabras prohibidas.
4. Datos que no se inventan. Precios, plazos, garantías, nombre legal, teléfono. Escríbelos una vez y di que cualquier otro dato se pregunta.
5. Reglas de seguridad. Qué necesita tu aprobación: publicar, borrar, cambiar precios, gastar dinero.
6. Cómo se comprueba un trabajo. Qué miras tú antes de dar algo por bueno.

Lo que no debe llevar: historias largas del negocio, todo el manual de marca, instrucciones que solo valen para una tarea concreta. Eso último es una skill, no un CLAUDE.md. Lo expliqué en el artículo sobre skills de Claude para marketing.

Plantilla de CLAUDE.md para la web de un negocio

Cópiala y rellena los huecos. Mide unas 35 líneas, que es lo que debe medir al principio.

# Negocio y web

## Quién soy
- [Nombre del negocio]: [qué haces] en [zona]. Cliente típico: [quién].
- Web: [dirección]. Está hecha con [WordPress / Shopify / otra].

## Páginas
- / : portada, presenta [servicio principal]
- /servicios : lista de servicios con precio desde
- /contacto : formulario y teléfono
- No se tocan sin avisarme: /aviso-legal, /privacidad, /cookies

## Cómo escribo
- Tuteo. Frases cortas. Sin exclamaciones.
- Nunca uso: "lo mejor del mercado", "calidad premium", "servicio de primera".
- Ejemplo de frase mía: "[pega aquí una frase real tuya]"

## Datos fijos (no inventar nada más)
- Precio de [servicio]: [cifra]
- Horario: [horario]
- Si falta un dato, pregúntamelo

## Reglas
- Trabaja siempre en borrador. Nunca publiques.
- No borres ni cambies precios sin mi "sí".
- Prueba con cinco elementos antes de hacerlo con todos.
- Haz copia antes de editar.

## Cómo reviso
- Leo el texto en la web real, no solo en el archivo.
- Comprueba que los enlaces funcionan.

Cuánto debe medir un CLAUDE.md: lo que he medido en el mío

La recomendación oficial es no pasar de 200 líneas por archivo: más largo consume contexto y empeora que se sigan las instrucciones. Si algo solo importa en una parte de la web, se mueve a una carpeta de reglas con un alcance acotado, o a una skill.

Yo tengo 26 archivos CLAUDE.md repartidos por mis agentes y proyectos, contados el 14 de noviembre de 2026. La mitad no llega a 60 líneas. El de la raíz de mi espacio de trabajo tiene 138 y está dividido en once apartados con títulos que dicen de qué van. Y cinco pasan de 200 líneas; el mayor, con 559. Esos cinco son los candidatos a recortar o a trasladar parte a skills, porque están justo en el tramo que la documentación desaconseja.

No lo cuento como modelo, sino como aviso: es fácil que un CLAUDE.md engorde sin que nadie decida que engorde.

Cuándo partir el CLAUDE.md en varios archivos

Cuando el archivo crece, hay dos salidas. La primera son las importaciones: escribes @ruta/del/archivo dentro del CLAUDE.md y Claude carga también ese archivo. Sirven para ordenar, pero no ahorran contexto, porque lo importado entra junto con el archivo principal.

La segunda es la carpeta .claude/rules/, con un archivo por tema. Cada regla puede limitarse a ciertos archivos o carpetas, y solo se carga cuando Claude trabaja con ellos. Para una web con blog y tienda, tendría sentido una regla para las páginas de producto y otra para los artículos, y dejar en el CLAUDE.md solo lo común.

Lo que CLAUDE.md no garantiza

Claude lo trata como contexto, no como reglas que se ejecutan por obligación. Cuanto más concreta y corta es la instrucción, más se sigue; pero no hay garantía absoluta. Si una acción no debe ocurrir nunca, como borrar en bloque, no basta con escribirlo: la documentación indica usar permisos o un hook que lo bloquee. Por eso recomiendo que una regla como «nada se publica ni se borra sin tu sí» vaya en dos sitios: escrita en el archivo y controlada también por los permisos de Claude Code.

También conviene revisarlo de vez en cuando. Si dos instrucciones se contradicen, Claude puede elegir una al azar. El comando /doctor prompt-audit repasa tus archivos de instrucciones y señala lo desfasado o contradictorio, sin cambiar nada hasta que se lo pidas.

Cómo empezar con tu CLAUDE.md hoy

Abre Claude Code en la carpeta de tu proyecto y escribe /init. Genera un borrador. Bórrale todo lo que sea obvio, añade los seis puntos de arriba y pruébalo con una tarea pequeña, como corregir un texto de la portada. Si Claude se salta una regla, no la repitas en el chat: ponla en el archivo con más precisión.

Siguiente paso: lo que viene después de un buen CLAUDE.md es usarlo para construir y mejorar la web, que explico en crear tu web con Claude Code. Y si tu web ya está en WordPress, mira IA para WordPress.