CLAUDE.md
Un archivo Markdown en la raíz del proyecto con las instrucciones permanentes para Claude: qué es el proyecto, cómo trabajar en él y qué reglas seguir. Claude Code lo lee al empezar cada sesión.
✦Apagada: responde bien la pregunta del final para encenderla
También lo verás como: CLAUDE.md · archivo de contexto · memoria del proyecto · instrucciones del proyecto
Analogía
El manual de bienvenida que le das a alguien nuevo en el equipo: "esto es lo que hacemos, así trabajamos aquí, esto no se toca".
Qué suele llevar
- Quién eres y tu nivel (para que ajuste las explicaciones)
- Qué es el proyecto y con qué tecnologías está hecho
- Cómo se arranca y cómo se prueba
- Convenciones (nombres, estilo, idioma)
- Reglas: lo que no debe hacer sin preguntarte
Ejemplo mínimo
# Contexto
Soy principiante, aprendiendo desarrollo web. Este repositorio es mi taller de prácticas.
# Cómo trabajar
- Responde en español.
- Antes de cambiar nada, dime qué vas a hacer y por qué.
- Explica en una línea cada comando que propongas.
- No hagas commits ni push: los hago yo.
- No uses sudo ni borres archivos sin preguntarme.
Por qué importa
Sin él repites lo mismo en cada conversación. Con él, la IA trabaja con tus reglas por defecto. Es la primera herramienta de algo que la Fase 2 llama contexto, y que la Fase 13 convierte en un sistema.
Detalles
- Se crea a mano o con
/init, y se versiona con el resto del proyecto. - Existe también uno personal, en
~/.claude/CLAUDE.md, que se aplica a todos tus proyectos.
No confundir con
Un paso más: qué va y qué no va
Sirve una prueba sencilla para cada línea: ¿esto vale para todas las tareas de este proyecto? Si sí, va en CLAUDE.md. Si solo vale para la tarea de hoy, va en el prompt.
| Va en CLAUDE.md | No va |
|---|---|
| "Responde en español" | "Hoy arregla el pie de página" |
| "No añadas dependencias sin preguntar" | el contenido de la carta (eso es CONTENIDO.md) |
| "No inventes datos del negocio" | una explicación larga de cómo funciona HTML |
Cuanto más largo, peor se sigue: cada línea compite por atención con las demás. Corto, concreto y en imperativo. Y es un archivo vivo: cuando Claude repite un error, la solución duradera es añadir una regla, no corregirle otra vez a mano.