Al terminar este módulo, vas a escribir la constitución de TU negocio para que Claude trabaje como TÚ trabajas, en cada sesión, sin repetírselo.
Ya viviste el problema aunque no lo hayas nombrado: en el módulo 1 tuviste que decirle "contéstame en español, sin tecnicismos" — y funcionó, pero solo para esa sesión. En el módulo 2 aprendiste por qué: cuando la mesa se limpia o cierras Claude Code, ese "empleado" brillante no se lleva a casa lo que aprendió de ti, a menos que quede escrito en algún lado. Hoy se acaba el repetirte.
¿Te acuerdas del empleado nuevo del módulo 0 — brillante, pero que no sabe nada de TU negocio hasta que se lo cuentas? Resulta que, sin ayuda, llega a la oficina así CADA VEZ. No porque sea despistado: así funciona un agente sin instrucciones guardadas — arranca de cero, sesión tras sesión.
La solución no es repetirte mejor. Es dejarle un documento que LEE SOLO, sin que se lo pidas, un segundo antes de contestarte el primer mensaje.
La constitución. CLAUDE.md es un documento que Claude lee al arrancar cada sesión, antes de que le digas una palabra: quién eres, cómo trabajas, tus líneas rojas. No es una lista de configuración técnica — es la constitución de tu negocio: así como la constitución de un país no cambia todos los días pero manda sobre todo lo demás, este archivo manda sobre cómo se comporta tu agente, siempre.
~/.claude: la oficina por dentroAntes de escribir la tuya, vale la pena ver dónde vive. ~/.claude (¿te acuerdas de los archivos ocultos, del módulo 1? el punto al inicio lo esconde por default) es el escritorio de tu empleado por dentro.
Los cajones de la oficina. Ese escritorio tiene, entre otras cosas, cuatro cajones: el contrato (settings.json — la configuración técnica del agente), la constitución (CLAUDE.md — de la que habla todo este módulo), la nómina (agents/ — donde vivirá la lista de otros empleados que vas a poder contratar, módulo 9) y el recetario (skills/ — tus chambas repetidas convertidas en receta, módulo 7). Hoy solo ubicamos los cajones; los dos últimos los abrimos más adelante.
Teclea (o pega) esto:
ls -a ~/.claudeVas a ver algo así:
. .. CLAUDE.md settings.json agents skills projectsQué significa: ahí está el escritorio completo. projects es la carpeta de transcripciones que ya conociste en el módulo 3; los demás son los cajones de arriba.
Si en vez de eso ves que faltan CLAUDE.md, agents o skills: normal si nunca los has usado — cada cajón aparece la primera vez que algo lo necesita. settings.json y projects sí deberían existir ya. Y si en vez de eso ves MUCHOS más nombres (settings.local.json, plugins, sessions, shell-snapshots, ide…): también normal — son más cajones internos que Claude Code se va abriendo solo conforme usas más funciones; no necesitas abrirlos, los cuatro de este módulo son los únicos que te tocan a ti.
[CAPTURA: m05-cajones — la terminal mostrando el listado de ~/.claude con sus cajones]
/initHay DOS lugares donde puede vivir tu constitución, y sirven para cosas distintas:
~/.claude/CLAUDE.md, en el cajón que acabas de ver): se lee en TODA sesión, sin importar en qué carpeta estés. Aquí van las reglas de CÓMO ERES TÚ trabajando, sin importar el proyecto — tu tono, tus manías, tus reglas de siempre.CLAUDE.md, suelto en la carpeta de un negocio o cliente específico): se lee SOLO cuando trabajas ahí. Aquí van las reglas de ESE proyecto en particular — sus carpetas, sus clientes, sus reglas propias.Las dos se leen juntas cuando aplica; si se topan (la global dice una cosa y la de proyecto otra más específica), gana la más específica — la de ESE proyecto, para ESE proyecto. Por eso no repites en cada CLAUDE.md de cliente lo que ya pusiste en el global: solo agregas lo que cambia. Esto se probó en vivo para este manual, con una regla puesta a propósito en la carpeta raíz y otra que la contradecía en una subcarpeta: ganó la de la subcarpeta, y Claude lo dijo con todas sus letras ("la regla de la carpeta raíz queda revocada aquí"). Un detalle honesto: esto no es un candado programado como los de permisos (módulo 10) — es texto que el propio Claude Code te acomoda en la conversación, y el modelo es el que decide darle prioridad a lo más específico. Casi siempre acierta; si algo tan importante no puede fallar NUNCA, ese candado va en permisos, no solo en CLAUDE.md.
Para arrancar el tuyo, no empieces en blanco:
Teclea (o pega) esto (parada en la carpeta de tu negocio o cliente):
/initVas a ver algo así:
Analyzing your project...
✔ Created CLAUDE.md with an initial summary of this folder.
Review it and add anything Claude couldn't infer.Qué significa: Claude se leyó tu carpeta y armó un primer borrador solo. NO lo sobreescribe si ya tenías uno.
Si en vez de eso ves que ya existía un CLAUDE.md y /init no hizo nada nuevo: correcto, así se comporta — edítalo directo, o bórralo primero si de verdad quieres empezar de cero.
Para retocarlo después sin reabrir ningún editor:
Teclea (o pega) esto:
/memoryVas a ver algo así:
Select a memory file to edit:
❯ Project (./CLAUDE.md)
User (~/.claude/CLAUDE.md)Qué significa: un editor rápido para tu constitución (y tu memoria — sección 5.5) sin salir de la conversación.
Si en vez de eso ves que abre directo un archivo en blanco: elige con las flechas cuál de los dos quieres editar antes de escribir.
Y para algo puntual, en media conversación, sin abrir ningún editor: empieza el mensaje con #. Por ejemplo, # este cliente SIEMPRE quiere el precio con IVA incluido — Claude lo guarda directo, en vez de contestarlo como pregunta. (¿Recuerdas el # del módulo 4? Es el mismo atajo — ahí lo usabas al vuelo; aquí es donde ese apunte de verdad vive.)
Síntoma: "Edité mi CLAUDE.md pero en OTRO proyecto no cambió nada."
Causa: editaste el de proyecto (ese cliente en particular), no el global — o al revés de lo que querías.
Salida: usa /memory y fíjate cuál de los dos eliges ANTES de escribir; si la regla aplica a TODOS tus proyectos, va en el global.
No toda regla escrita pesa igual. Compara:
El creador de Claude Code lo aplica en carne propia: "si hay algo que Claude se equivoca una y otra vez... ponlo en tu CLAUDE.md — yo le agrego al de mi equipo varias veces por semana." No es un documento que se escribe una vez y se olvida: es vivo, se poda tanto como se le agrega.
Y ahí está el otro extremo, el que nadie ve venir: el documento-basurero — un CLAUDE.md tan largo que tus reglas de verdad se pierden entre trivialidades, y Claude termina ignorando instrucciones que sí importaban. La documentación oficial lo advierte sin rodeos: "un CLAUDE.md inflado hace que Claude ignore tus instrucciones de verdad." El filtro de una línea: ¿si borro esta regla, Claude se va a equivocar en algo? Si la respuesta es no, sobra.
Qué SÍ va: tus carpetas importantes, tu tono con clientes, tus reglas de negocio, lo que Claude NO tiene forma de adivinar solo con mirar tus archivos. Qué NO va: lo obvio, lo que ya se ve con solo abrir la carpeta, la clase de "sé profesional" que no le dice nada a nadie. Una agencia que lo usa a diario lo resume así: escribir tu CLAUDE.md ANTES de tu primera chamba en serio — "15 minutos ahorran horas."
Síntoma: "Escribí mi CLAUDE.md pero Claude sigue sin hacerle caso a mi regla 3."
Causa: el documento quedó tan largo que esa regla se perdió entre trivialidades — o la escribiste vaga ("sé cuidadoso") en vez de concreta.
Salida: aplica el filtro de una línea de arriba, poda lo que sobra, y reescribe la regla con un verbo de acción y un número si aplica ("antes de mandar cualquier cotización, pregúntame").
Además de la constitución, Claude va guardando una memoria automática — hechos sueltos que aprende de ti con el tiempo (tu cliente frecuente, una fecha importante, una preferencia que mencionaste una vez).
La libreta. La memoria automática es una libreta de apuntes, no la constitución: se llena y se actualiza sola conforme trabajas, y tú la revisas y corriges con /memory cuando algo ya no aplica.
¿Y cómo sabes qué va en la constitución y qué en la libreta? La regla que vas a adoptar hoy: "la memoria guarda hechos que evolucionan; la constitución guarda quién soy." Que tu cliente favorito ahora se llama distinto porque cambió de razón social: memoria. Que TÚ jamás publicas nada sin revisarlo primero: constitución — no cambia con los hechos del día.
Y hay una tercera pieza que todavía no abrimos del todo: cuando la regla no es "quién eres" ni "un hecho que aprendiste", sino "los pasos exactos de una chamba que haces siempre igual" — esa es una receta (el cajón skills/ que viste arriba, y que abrimos en el módulo 7), no una regla de constitución. Por ahora, con saber que el cajón existe te basta: una regla, un solo lugar — no la dupliques en los tres.
El CLAUDE.md global de la casa lleva más de un año de guerra real, y no es una lista de preferencias: es la constitución de un socio de trabajo, con nombre, voz y reglas propias, organizada en 5 secciones — quién soy (identidad y voz), cómo trabajamos (las reglas de la relación), el orquestador (cómo despacha a otros agentes), los no negociables (líneas rojas) y lo que NO vive aquí (la frontera con la memoria, la misma que acabas de aprender en 5.5, tal cual, textual: "la memoria guarda hechos que evolucionan; esto guarda quién soy").
Dos reglas citables, de las que más pesan en el día a día: "Propongo, él aprueba" — dinero y publicación los decide el humano, siempre en dos tiempos. Y el "perito interno": "mi primera idea es candidata, no ganadora... intento tumbarla" — cada afirmación técnica lleva etiqueta, verificado (lo probé), inferido (se deduce de X) o hipótesis (suena bien, sin evidencia aún), y jamás se vende la tercera como la primera. Ese hábito de etiquetar en vez de prometer nace aquí, en una constitución real — y lo vas a volver a ver, formalizado, hasta el módulo 13.
Qué vas a lograr: un CLAUDE.md real de TU negocio, escrito hoy, y la prueba de que una sesión nueva lo respeta sin que se lo repitas.
Qué necesitas: la plantilla ejercicios/m05/plantilla-CLAUDE.md como guía de huecos a llenar (quién eres, cómo trabajas, tus 3 reglas duras) — úsala junto a lo que /init te proponga, no en lugar de eso.
Pasos:
~/Curso-Claude si sigues practicando) y corre /init (5.3)./clear — cierra la terminal) y ábrelo de nuevo en esa misma carpeta: sesión 100% nueva.¿LO LOGRASTE?
/init solo.[CAPTURA: m05-claude-md — un CLAUDE.md de negocio, ya lleno, abierto en pantalla]
CLAUDE.md — la constitución: reglas que Claude carga SIEMPRE, sin que se las repitas.
/init — el comando que arranca tu CLAUDE.md leyendo tu carpeta.
memoria (auto) — la libreta del agente: hechos que evolucionan, aparte de la constitución.
settings.json — el contrato: la configuración técnica del agente (lo abrimos a fondo en los módulos 8 y 10).
La demo de 5 minutos: abre TU CLAUDE.md real en pantalla (o el ejemplo de este módulo si prefieres no exponer el tuyo) y léelo en voz alta como lo que es: una constitución, no un archivo de configuración. Luego, en vivo, corre /init sobre una carpeta nueva del grupo y compara el borrador automático contra el tuyo, ya maduro — la diferencia ES la lección.
El error que el alumno VA a cometer: escribir un CLAUDE.md gigante el primer día, tratando de anticipar todo. Provócalo: pídeles escribir 15 reglas, luego aplica el filtro de una línea en voz alta ("¿si la quito, se equivoca?") y verán caer la mitad.
La pregunta de arranque: "¿Cuántas veces le has explicado LO MISMO a un empleado nuevo en tu negocio — y qué pasaría si lo escribieras UNA sola vez, bien, para siempre?"
Verificado contra documentación oficial el 2026-07-12.