Es el archivo que le dice a Claude quién eres, a qué te dedicas y cómo quieres que trabaje. Se configura una vez y no se lo vuelves a explicar nunca más.
El error que comete todo el mundo al empezar con Claude es ponerse a hablar antes de configurarlo. Cada conversación arranca de cero, le cuentas otra vez lo mismo, y pagas tokens por repetirte.
Es lo que más resultado da por minuto invertido de todo lo que puedo darte. Tardas 25 minutos.
Dónde va
En ~/.claude/CLAUDE.md, la carpeta oculta .claude de tu home. Si no existe, la creas.
Es global: se lee antes de cualquier conversación, en todos tus proyectos.
Si no ves la carpeta en el Finder, pulsa Cmd + Shift + Punto (en Mac) y aparecen las ocultas. En Windows, Ctrl + Shift + Punto.
La forma rápida: que te entreviste Claude
Abre Claude Code en tu home y pega esto:
Entrevístame con 10 preguntas sobre mí, mis empresas y mi forma de trabajar.
Si no tengo empresa, pregúntame sobre mi rol y mi trabajo directamente.
Luego crea o actualiza mi CLAUDE.md en esta carpeta.Contesta por voz si puedes. Vas mucho más rápido y das más contexto que escribiendo, y el contexto es justo lo que hace que esto funcione.
Puedes pedirle más preguntas (20, 30) si quieres un perfil más afinado desde el principio.
Cómo sabes que está bien montado
Cierra la sesión, ábrela otra vez y pregúntale algo de tu trabajo.
Si responde sin que tengas que volver a explicarle nada, está bien. Si te vuelve a preguntar quién eres, le falta contexto.
La forma manual
Si prefieres pensarlo tú, rellena la plantilla a mano (20-30 minutos) y luego pídele a Claude: "lee mi CLAUDE.md y dime qué falta o qué está poco claro". Te lo afina.
Son siete secciones: quién eres, tus empresas, cómo trabajas, tu stack, lo que ya tienes automatizado, git y convenciones de formato.
# CLAUDE.md global
> Este archivo aplica a TODAS las sesiones de Claude Code.
> Vive fuera de cualquier proyecto, por encima de la carpeta de proyectos.
> Se lee siempre, antes que cualquier CLAUDE.md de proyecto.
---
## 1. Quién soy
<!-- Quién eres tú como persona. Nombre, edad si quieres, dónde vives, rol principal, mentalidad de trabajo. Es lo primero que lee Claude para saber con quién está hablando. -->
- **Nombre**: [rellenar: tu nombre completo y cómo te llaman]
- **Ubicación**: [rellenar: ciudad o país]
- **Rol principal**: [rellenar: founder, director, freelance, empleado, consultor]
- **Mentalidad**: [rellenar: cómo trabajas, qué priorizas, qué no haces]
---
## 2. Mis empresas
<!-- Empresas o proyectos en los que estás metido. Si no tienes empresa, pon tu trabajo y para quién trabajas. Una sección corta por cada una con qué hace, equipo, herramientas, objetivo. -->
### [rellenar: nombre empresa 1]
- **Qué es**: [rellenar: una frase, qué hace la empresa]
- **Equipo**: [rellenar: quién trabaja contigo]
- **Stack**: [rellenar: herramientas principales]
- **Objetivo actual**: [rellenar: a qué estás apuntando este año]
### [rellenar: nombre empresa 2 o proyecto]
- **Qué es**: [rellenar]
- **Equipo**: [rellenar]
- **Stack**: [rellenar]
- **Objetivo actual**: [rellenar]
---
## 3. Forma de trabajar
<!-- Cómo quieres que Claude te hable. Idioma, tono, longitud de las respuestas, herramientas favoritas, reglas que nunca rompe. Esta sección es la que más cambia la calidad de cada respuesta. -->
- **Idioma de comunicación**: [rellenar: español, inglés, mezcla]
- **Idioma para código y nombres técnicos**: [rellenar]
- **Tono de respuesta**: [rellenar: breve y directo, con detalle, conversacional]
- **Longitud preferida**: [rellenar: respuestas cortas, sin teoría innecesaria, con ejemplos]
- **Herramienta favorita de automatización**: [rellenar: n8n, Make, Zapier, otra]
- **Herramienta principal de desarrollo**: [rellenar: Claude Code, otra]
- **Filosofía**: [rellenar: cómo abordas el trabajo, qué automatizas, qué delegas]
---
## 4. Stack técnico
<!-- Lista de herramientas que usas a diario. Claude las va a referenciar cuando proponga soluciones, así evita sugerirte software que no usas. -->
| Herramienta | Uso |
|-------------|-----|
| [rellenar: herramienta] | [rellenar: para qué la usas] |
| [rellenar] | [rellenar] |
| [rellenar] | [rellenar] |
---
## 5. Automatizaciones completadas
<!-- Lo que ya tienes funcionando. Sirve para que Claude no te proponga construir cosas que ya existen, y para que sepa con qué piezas puede conectar lo nuevo. -->
### [rellenar: empresa 1]
- [rellenar: nombre del flujo o automatización] · [rellenar: qué hace en una línea]
- [rellenar]
### [rellenar: empresa 2]
- [rellenar]
- [rellenar]
---
## 6. Git workflow
<!-- Reglas para que Claude guarde versiones de lo que hace. Cada vez que termine algo que funciona, lo commitea, así puedes volver atrás si algo se rompe. Aquí también van las reglas que nunca se rompen: no comitear secretos, credenciales fuera del repo, etc. -->
- **Auto-commit**: [rellenar: tras cada unidad de trabajo que funcione, commit automático con mensaje descriptivo]
- **Nunca comitear**: [rellenar: secretos, .env, credentials.md, archivos sensibles]
- **Credenciales**: [rellenar: dónde viven, cómo se referencian]
- **Reglas que nunca se rompen**:
- [rellenar: regla 1]
- [rellenar: regla 2]
- [rellenar: regla 3]
---
## 7. Convenciones de formato
<!-- Cómo quieres que Claude formatee lo que te devuelve. Números, fechas, monedas, tablas, idioma de los headers, sentence case o title case. Detalles pequeños que cuando los ajustas dejas de corregirlos cada vez. -->
- **Formato de números**: [rellenar: separador de miles, decimales]
- **Formato de fechas**: [rellenar: DD/MM/YYYY, YYYY-MM-DD]
- **Moneda**: [rellenar: EUR, USD, símbolo o código]
- **Tablas**: [rellenar: preferencia de columnas, alineación]
- **Headers**: [rellenar: sentence case, title case]
- **Otras convenciones**: [rellenar]El otro CLAUDE.md: el de proyecto
Además del global hay uno por proyecto, que vive dentro de la carpeta de ese proyecto y solo se activa cuando estás dentro.
Funcionan en cascada: primero se lee el global, después el del proyecto. Y por eso el de proyecto nunca repite lo que ya dice el global, solo lo extiende con lo que es propio de ese trabajo.
Y aquí va el consejo que menos se espera la gente: no lo crees al principio.
Cuando abres un proyecto nuevo todavía no sabes qué reglas necesita, así que lo que escribas será inventado. Trabaja entre 30 y 60 minutos dentro, deja que aparezcan las fricciones reales, y entonces escríbelo. Sale en cinco minutos y sale bien.
Cómo mantenerlo vivo
Esta es la parte que separa a quien lo usa de verdad de quien lo montó una vez.
Al final de cada sesión importante, pregúntale:
¿Hay algo de lo que hemos aprendido hoy que merezca actualizar el CLAUDE.md?Cada vez que resuelves algo raro, que corriges un error suyo o que le explicas una preferencia tuya, eso es una regla que no deberías tener que volver a explicar. Ahí es donde el archivo pasa de ser una ficha de presentación a ser memoria.
Esto sale de la clase 3 de la academia de Digital Brain.
Cuando lo tengas montado, cuéntame qué has puesto en la sección de forma de trabajar. Es la que más cambia el resultado y la que peor rellena todo el mundo.
