1En una frase
Un pequeño archivo de texto llamado CLAUDE.md en la carpeta de tu proyecto le dice a Claude Code cómo te gusta que se hagan las cosas, y lo lee al principio de cada sesión.
2Palabras nuevas
- CLAUDE.md — un archivo de texto simple (el .md significa Markdown, texto con formato sencillo) con las reglas, convenciones y comandos útiles de tu proyecto. Piensa en él como las instrucciones de un Project (Capítulo 1.5), pero para Claude Code.
- Convención (Convention) — una costumbre que sigue tu proyecto: cómo se nombran los archivos, qué lenguaje se usa, cómo se ejecutan las pruebas.
- Alcance (Scope) — dónde se aplica una regla. Puede haber un CLAUDE.md para todo tu ordenador (tus costumbres personales), uno por proyecto (las reglas del proyecto) y uno para una empresa.
3Para qué te sirve
Sin él, cada sesión empieza con Claude adivinando tu estilo, y tú corriges las mismas cosas una y otra vez. Con él, Claude conoce el comando de pruebas, las reglas de nombres y las partes que no debe tocar antes de escribir una sola línea. Los equipos comparten un mismo archivo para que todos tengan el mismo Claude.
4Pruébalo ahora
(planes de pago)
- En la carpeta de tu proyecto, pídele a Claude Code: Crea un CLAUDE.md para este proyecto con: qué es el proyecto en dos líneas, cómo ejecutarlo, cómo probarlo, las reglas de nombres que usamos y tres cosas que nunca debes cambiar sin preguntar.
- Lee el archivo que escribe; corrige lo que esté mal.
- Empieza una sesión nueva y pide un cambio pequeño. Fíjate en que ejecuta las pruebas y sigue la regla de nombres sin que se lo digas.
5Lo que verás
[Imagen pendiente: un CLAUDE.md abierto en el editor y una sesión que lo sigue.] Un archivo corto, normalmente de menos de una página, que Claude menciona al empezar ("Siguiendo CLAUDE.md: ejecuto las pruebas después de los cambios"). Funciona junto con tus reglas globales; un archivo de proyecto se suma a ellas.
6Cuidado
- Mantenlo corto y al día. Un CLAUDE.md largo y desactualizado es peor que no tener ninguno; Claude seguirá fielmente reglas viejas.
- No pongas secretos (contraseñas, claves) ni cerca de él. Es un archivo de texto que se comparte.
7Ve más allá
Añade una línea como Si tienes dudas, pregunta antes de cambiar más de tres archivos. El Capítulo 6.3 convierte los trabajos repetidos en skills, que son reglas con pasos.