Si usas Claude Code y no tienes un CLAUDE.md, estás tirando tokens y dinero a la basura en cada conversación. Es el archivo más importante que vas a configurar, y casi nadie empieza por él.
Un CLAUDE.md es un archivo donde le cuentas a Claude quién eres, a qué te dedicas y cómo quieres que trabaje. Claude lo lee antes de cada conversación, así no tienes que explicarle tu contexto una y otra vez.
Te cuento qué es, cómo montarlo en 25 minutos y cómo lo tengo yo para mis dos empresas.
Qué es un CLAUDE.md
Es un archivo de texto plano que vive en tu ordenador y que Claude Code carga solo al arrancar. Dentro pones tu contexto: tu nombre, tus empresas, tu forma de trabajar, tu stack, tus reglas.
Sin él, cada conversación empieza de cero. Le explicas que trabajas en español, que usas tal herramienta, que no te suelte teoría. Y al día siguiente, otra vez lo mismo. Con CLAUDE.md eso se dice una vez y ya está.
El error número uno: ponerse a hablar antes de configurarlo
El fallo que comete casi todo el mundo al empezar con Claude es abrir la app y pedir cosas sin haberlo configurado. Es como contratar a alguien buenísimo y no contarle nada de tu empresa el primer día. Va a acertar a medias.
Configura el CLAUDE.md primero. Es lo primero de todo. Después ya hablas.
Lo que ganas desde el día uno
Tres cosas, y se notan desde la primera sesión:
- Ahorras 5 a 10 minutos por conversación, porque no repites tu contexto nunca más.
- Sube la calidad de cada respuesta, porque Claude responde sabiendo quién eres y qué necesitas, no a ciegas.
- Todo tu equipo trabaja igual: si compartes el CLAUDE.md, todos parten del mismo estilo y las mismas reglas.
La cascada: global y de proyecto
Hay dos niveles, y entenderlos te ahorra líos.
El CLAUDE.md global vive una vez, en la carpeta `.claude` de tu usuario, y rige todas tus conversaciones, estés en el proyecto que estés. Ahí va lo que no cambia: quién eres, tus empresas, tu forma de trabajar.
El CLAUDE.md de proyecto vive dentro de la carpeta de un proyecto concreto y solo se activa cuando estás dentro de ella. Ahí va lo específico de ese proyecto. Regla importante: el de proyecto nunca repite el global, solo lo extiende.
Las 7 secciones de mi CLAUDE.md
Mi CLAUDE.md global real, el que uso a diario para Barner y Digital Brain, tiene estas siete secciones. Úsalas de esqueleto:
1. Quién soy. Nombre, rol, mentalidad de trabajo. Lo primero que lee Claude. 2. Mis empresas. Una ficha corta por cada una: qué hace, equipo, stack, objetivo del año. 3. Forma de trabajar. Idioma (yo: español para comunicar, inglés para código), tono, longitud de las respuestas, herramientas favoritas. Esta es la sección que más sube la calidad. 4. Stack técnico. Las herramientas que uso a diario, para que no me proponga software que no toco. 5. Automatizaciones completadas. Lo que ya tengo funcionando, para que no me sugiera construir algo que ya existe. 6. Git workflow. Que guarde versiones de lo que hace y las reglas que nunca se rompen. La mía incluye "nunca commitear credenciales". 7. Convenciones de formato. Detalles pequeños que, cuando los ajustas, dejas de corregir cada vez: números con separador de miles, español para el texto.
Un ejemplo: cómo se ve un trozo del mío
Para que no quede en teoría, así arranca mi CLAUDE.md real, recortado:
Quién soy: Ramón (Ray), founder de Barner y Digital Brain. Mentalidad de arquitecto de sistemas que ejecuta con Claude de copiloto.
Forma de trabajar: español para comunicar, inglés para código. Respuestas breves y directas, sin teoría de relleno. Automatizo con n8n, desarrollo con Claude Code.
Git workflow: auto-commit tras cada unidad de trabajo que funcione. Nunca commitear credenciales, viven fuera del repo.
Convenciones de formato: números siempre con separador de miles.
Cuatro líneas por sección bastan. No hace falta una novela, hace falta que sea verdad y que Claude lo pueda usar.
Cómo montarlo en 25 minutos
No lo escribas a mano línea a línea. Deja que Claude te entreviste.
Abre Claude Code en la carpeta donde quieras el archivo (tu home, para el global) y pégale esto: "Entrevístame con 10 preguntas sobre mí, mis empresas y mi forma de trabajar. Luego crea mi CLAUDE.md en esta carpeta".
Responde por voz si puedes, vas mucho más rápido y das más contexto. Cuando termine, cierra la sesión, ábrela de nuevo y pregúntale algo de tu negocio. Si te responde sin que tengas que explicar nada, está bien montado.
Cuándo crear el de proyecto: nunca al principio
Este es el error de la segunda semana: crear el CLAUDE.md de proyecto nada más abrir la carpeta. No.
Trabaja primero 30 o 60 minutos dentro del proyecto. Cuando ya tienes claro de qué va y cómo lo quieres, entonces creas el de proyecto. Antes no sabes lo suficiente para que sirva de algo.
El ritual que separa al pro del aficionado
Al final de cada sesión importante, pregúntale a Claude: "¿Hay algo de lo que hemos aprendido hoy que merezca actualizar el CLAUDE.md?".
Eso hace que el archivo mejore solo con el tiempo. El aficionado lo escribe una vez y lo olvida. El que lo usa en serio lo va afilando cada semana.
Lo que esto me da en la práctica
Para que veas que no es teoría. Con un CLAUDE.md bien montado más Claude Code construí la B2B Platform de Barner en hora y media. Me ahorra 1.500 euros al mes porque sustituye a una herramienta de distribución para tiendas y agentes que reponen stock.
Otro: mi proyecto Couriers revisa facturas de DHL de 160 páginas con 1.500 envíos y detecta cuando me cobran 21 euros en vez de 18,90. Un amigo recuperó 5.000 euros así. Antes eso era humanamente imposible de revisar.
Nada de eso sale bien si Claude no tiene tu contexto. El CLAUDE.md es lo que se lo da.
Truco de Mac para encontrarlo: Comando + Shift + Punto te enseña las carpetas ocultas, incluida `.claude`.
Cada día resumo lo importante de la IA en la newsletter de Digital Brain, y los miércoles voy a fondo con un tema práctico: digitalbrain.email.
Relacionado
