CLAUDE.md: que Claude conozca tu negocio

Qué consigues

Que Claude Code no empiece cada sesión de cero. Un archivo CLAUDE.md en la carpeta de tu negocio con lo que le repetirías una y otra vez: horarios, zonas de reparto, tono, precios. El ejemplo: una pizzería de Sevilla con reparto propio (tres repartidores en moto, radio de 4 km, pedido mínimo de 15 €) que usa Claude para escribir avisos, revisar la carta y preparar los mensajes de pedido.

Lo que necesitas

Claude Code instalado (plan Pro o superior).
Una carpeta para el negocio, por ejemplo pizzeria, con lo que ya tengas: carta, precios, textos de la web.
20 minutos para escribir la primera versión. Luego se mejora sola con el uso.

Pasos

1. Entiende dónde se guarda cada cosa

Claude Code lee varios CLAUDE.md al arrancar y los junta todos. Según dónde esté el archivo, vale para una cosa u otra:

Nivel	Dónde está	Para qué
Tuyo, para todo	`~/.claude/CLAUDE.md`	Tus preferencias en cualquier carpeta: idioma, tono, cómo te gusta que te conteste
Del proyecto	`CLAUDE.md` (o `.claude/CLAUDE.md`) en la carpeta	Lo del negocio. Si trabajas con alguien, lo compartís
Local	`CLAUDE.local.md` en la carpeta	Notas solo tuyas de ese proyecto, que no compartes
De empresa	Ruta del sistema que gestiona informática	Normas de toda la organización

Si hay varios, los lee todos, y el más cercano a la carpeta donde abres Claude se lee el último. Además, Claude Code tiene una memoria automática: apunta él solo lo que aprende de tus correcciones.

2. Genera un primer borrador con /init

Abre Claude en la carpeta del negocio:

cd ~/pizzeria
claude

Y escribe:

/init

Claude revisa la carpeta y crea un CLAUDE.md con lo que encuentra. Si ya tenías uno, te propone mejoras en vez de machacarlo. Al acabar verás el archivo nuevo en la carpeta.

3. Rellénalo con lo que solo sabes tú

/init descubre lo que hay en los archivos, pero no sabe que los lunes cerráis ni que el repartidor no sube a Bellavista. Esta plantilla está pensada para la pizzería del ejemplo; cambia los datos por los tuyos:

# Pizzería (Triana, Sevilla)

## El negocio
- Pizzería de barrio con sala de 30 cubiertos y reparto propio.
- Horario: martes a domingo, 13:00-16:00 y 20:00-23:30. Lunes cerrado.
- Reparto: 3 repartidores en moto, radio de 4 km desde el local.
- Pedido mínimo a domicilio: 15 €. Envío gratis desde 25 €; si no, 2 €.
- Tiempo de entrega que prometemos: 35-45 minutos. Viernes y sábado noche: 50-60.

## Carta y precios
- La carta vigente está en @carta.md. No inventes platos ni precios que no estén ahí.
- Las zonas y calles de reparto están en @zonas-reparto.md.

## Cómo escribimos
- Español de España, tuteo, frases cortas. Nada de emojis en avisos oficiales.
- Precios siempre con coma y símbolo detrás: 9,50 €.
- Si un cliente pregunta por alérgenos, remite a la ficha de alérgenos y al personal. Nunca afirmes que algo es apto sin que lo diga la ficha.

## Reglas
- Antes de cambiar precios en cualquier archivo, enséñame la lista de cambios y espera mi visto bueno.
- No guardes nombres, teléfonos ni direcciones de clientes en esta carpeta.
- Cuando acabes una tarea, dime en una línea qué archivos has tocado.

Guárdalo. Lo que lleva @ delante son importaciones: Claude carga también esos archivos al arrancar. Escribe tú carta.md y zonas-reparto.md en la misma carpeta.

4. Comprueba que lo está leyendo

Cierra y vuelve a abrir Claude en la carpeta. Escribe:

/context

En la lista de archivos de memoria (Memory files) tiene que aparecer tu CLAUDE.md. Para probarlo de verdad, pregúntale algo que solo esté ahí:

Un cliente de Los Remedios pide dos pizzas por 22 €. ¿Cuánto le cobramos de envío y cuánto tardamos un sábado a las 21:30?

Debería responder 2 € de envío y 50-60 minutos, siempre que Los Remedios esté en tu archivo de zonas.

5. Edítalo y mantenlo corto

Para abrirlo desde la sesión, usa /memory. Ahí también ves y desactivas la memoria automática.
Si le dices «recuerda que…», Claude lo guarda en su memoria automática. Si quieres que vaya al CLAUDE.md, díselo así: «añade esto al CLAUDE.md».
La documentación recomienda menos de 200 líneas por archivo. Cuanto más largo, peor lo sigue. Las importaciones con @ no ahorran espacio: se cargan enteras.
Escribe reglas que se puedan comprobar. «Precios con coma y símbolo detrás» funciona; «escribe bien» no.
Añade una regla cada vez que tengas que corregirle lo mismo por segunda vez.

Errores típicos

Tratarlo como una norma que se cumple siempre. Claude lo lee como contexto y suele seguirlo, pero no hay garantía. Para cosas que no pueden fallar, revisa tú o pide confirmación antes de actuar.
Reglas que se contradicen. Si un archivo dice «envío gratis desde 25 €» y otro «desde 20 €», Claude escoge uno. Repásalos de vez en cuando; /doctor prompt-audit busca contradicciones por ti.
Meterle datos de clientes. No hace falta y te complica el RGPD. Deja los datos personales en tu programa de pedidos.
Abrir Claude en otra carpeta. El CLAUDE.md del proyecto se carga al arrancar si abres Claude en esa carpeta o en una subcarpeta suya. Desde otro sitio no lo tendrá presente desde el principio.
Copiar el CLAUDE.md de otro sin adaptarlo. Las reglas genéricas sobran. Pon lo que es distinto en tu negocio.

Siguiente paso

Con el negocio explicado, apréndete los comandos de Claude Code que usarás cada día. Cuando tengas un proceso que repites, como el aviso semanal de la pizza del mes, conviértelo en tu primera skill.