Hay una pregunta que separa a quien aprovecha Claude de quien pelea con él: ¿le explicas tu proyecto cada vez que abres una sesión? Si la respuesta es sí, estás dejando la mitad del valor sobre la mesa. El truco no es escribir mejores prompts. Es escribir un archivo, una sola vez, que Claude lea automáticamente cada vez que empieza: el CLAUDE.md.
Es el cambio más barato y más rentable que puedes hacer. Cuatro líneas bien puestas y dejas de repetirte para siempre. Esta guía va de qué meter ahí, qué dejar fuera y cómo estructurarlo para que de verdad funcione.
Nota
CLAUDE.md no es un prompt ni una documentación. Es contexto permanente: las reglas y datos que aplican a todas tus sesiones en ese proyecto. Claude lo carga solo al abrir la carpeta, sin que tengas que pegarlo en el chat.
Qué es CLAUDE.md y por qué multiplica a Claude
Es un archivo de texto en formato Markdown que pones en la carpeta de tu proyecto. Nada más: texto plano. Lo que lo hace especial es que Claude lo lee de forma automática al arrancar cada sesión y trata su contenido como instrucciones de cabecera.
La diferencia con un chat normal es brutal. Sin CLAUDE.md, cada conversación empieza de cero: Claude no sabe qué es tu proyecto, qué stack usas, cómo te gusta que escriba ni qué archivos son intocables. Tú rellenas ese hueco a mano, una y otra vez, gastando tu tiempo y su atención. Con CLAUDE.md, ese contexto ya está cargado antes de que escribas una palabra.
Por eso "multiplica": no hace a Claude más inteligente, lo hace más tuyo. Deja de adivinar y empieza alineado con cómo trabajas. La primera respuesta de cada sesión es ya la buena, no la tercera.
Qué poner (y qué dejar fuera)
Aquí está el error más común: tratar el CLAUDE.md como un cajón de sastre donde meter todo lo que sabes del proyecto. Mal. Todo lo que escribes ahí ocupa contexto en cada sesión y compite por la atención del modelo. Un archivo enorme diluye las instrucciones que de verdad importan.
La regla mental es sencilla: instrucciones operativas y estables, no documentación. Si algo es estable (aplica siempre) y operativo (cambia cómo trabaja Claude), entra. Si cambia cada semana o solo sirve para una tarea de hoy, va en el chat.
Lo que SÍ va dentro:
- Qué es el proyecto en una o dos frases. El para qué, no la historia.
- Cómo quieres que trabaje: tono, idioma, nivel de detalle, si debe pedir permiso antes de cambios grandes.
- Convenciones: stack y comandos (proyectos de código), estructura de carpetas, nomenclatura, formato de salida.
- Prohibiciones explícitas: qué archivos o áreas no debe tocar nunca. Esta es la sección que más errores evita y la que casi todos olvidan.
- Atajos: comandos o flujos que repites mucho ("para desplegar se usa X").
Lo que NO va dentro:
- El historial del proyecto o decisiones ya cerradas que no afectan al trabajo de hoy.
- Documentación larga que ya vive en otro sitio (mejor: enlázala o di dónde está).
- Instrucciones de una sola tarea ("hoy arregla este bug"): eso es un prompt.
- Secretos, claves o contraseñas. Nunca.
Atención
La sección de prohibiciones es la más importante y la más ignorada. "NO modifiques la carpeta de producción", "NUNCA borres datos sin enseñarme el plan antes", "no toques los archivos de configuración". Escribir lo que NO debe pasar evita el 90% de los sustos.
Una estructura recomendada
No hay un formato obligatorio, pero esta estructura funciona porque va de lo general a lo específico y pone las reglas duras donde Claude las ve. Cuatro bloques:
- Sobre el proyecto — qué es y para qué, en pocas frases.
- Cómo trabajar — tono, idioma, flujo de aprobación, nivel de detalle.
- Convenciones — stack, estructura, comandos, formato. Lo concreto.
- No tocar — las prohibiciones explícitas, bien visibles.
Mantén cada bloque corto y en listas. Claude lee mejor cinco viñetas claras que un párrafo denso. Y si tu proyecto crece, divide: un CLAUDE.md general con tus preferencias globales y uno por subproyecto con sus detalles. Los específicos se suman a los generales, así que no repitas: en el de marca pones el tono, en el de cada proyecto solo lo que cambia.
Plantilla copiable
Esta es la plantilla base. Cópiala, borra lo que no aplique y rellena los corchetes. En dos minutos tienes un CLAUDE.md mejor que el 95% de los que existen.
# [Nombre del proyecto]
## Sobre el proyecto
[Qué es, en 1-2 frases.] La uso para [objetivo principal].
Audiencia / contexto: [quién lo usa o para quién es].
## Cómo quiero que trabajes
- Háblame en español, directo y sin rodeos.
- Antes de cambios grandes o irreversibles, enséñame el plan y espera mi OK.
- Por defecto, tareas pequeñas y reversibles.
- Si algo no está claro, pregunta antes de asumir.
## Convenciones
- Stack / herramientas: [lenguaje, framework, apps].
- Estructura: [dónde vive cada cosa].
- Comandos clave: [build / test / deploy si aplica].
- Formato de salida: [cómo quieres las respuestas].
## NO tocar (importante)
- [archivos, carpetas o áreas intocables].
- Nunca borres ni sobrescribas [X] sin avisar primero.
- No incluyas secretos, claves ni datos sensibles.Tres ejemplos según tu caso
La plantilla es la misma; lo que cambia es el relleno. Tres casos reales.
Proyecto de código. Aquí el valor está en las convenciones técnicas. Stack y versiones, comando de build y de tests, estructura de carpetas, estilo de código ("usa TypeScript estricto, sin any"), y las prohibiciones críticas ("no toques migrations/, no hagas push directo a main"). Claude deja de inventarse comandos y respeta tu arquitectura desde el primer mensaje.
Marca o negocio. Aquí lo que importa es la voz. Tono ("directo, práctico, sin relleno, sin emojis"), qué palabras usar y cuáles evitar, formato de los textos, idioma, y reglas de estilo ("nunca prometas resultados garantizados"). Lo que en código son convenciones técnicas, en marca son convenciones de voz. El resultado: todo lo que escriba Claude suena a ti, no a IA genérica.
Uso no técnico. Organizar documentos, planificar, redactar correos. No hace falta saber programar. Pones cómo trabajas ("ordéname siempre por fecha", "los resúmenes en viñetas de máximo cinco puntos"), tus carpetas habituales y qué no tocar ("no muevas nada de la carpeta Importante sin enseñarme antes qué vas a hacer"). Mismo archivo, mismo efecto: dejas de explicar lo obvio cada sesión.
El error que arruina un buen CLAUDE.md
Escribirlo y olvidarlo. Un CLAUDE.md es un documento vivo: cuando notes que repites una instrucción en el chat dos o tres veces, esa instrucción pertenece al archivo. Añádela. Y al revés: si una regla ya no aplica, bórrala, porque la basura acumulada también pesa.
Trátalo como lo que es: el contrato de trabajo entre tú y Claude. Cuanto más claro y actualizado, mejor trabaja. La diferencia entre quien pelea con la herramienta y quien la aprovecha casi siempre se reduce a esto: el segundo escribió sus reglas una vez, en un archivo, y dejó de repetirlas para siempre.
Abre tu proyecto, crea un CLAUDE.md con la plantilla de arriba y rellena los cuatro bloques. Es lo más rentable que harás hoy con Claude.