← Volver a tutoriales

Tutoriales · Principiante

CLAUDE.md: enséñale a Claude a trabajar como tú quieres

Un archivo CLAUDE.md le da contexto y reglas a Claude Code en cada proyecto. Aprende qué poner, dónde va y por qué te ahorra repetir lo mismo una y otra vez.

  • Claude Code

CLAUDE.md es un archivo de texto donde le dejas a Claude Code las reglas e información de tu proyecto. Claude lo lee solo al empezar, así no tienes que repetir lo mismo en cada conversación. Toca cada bloque para abrirlo.

¿Para qué sirve?

Imagina contratar a alguien y tener que explicarle TODO cada mañana. Cansado, ¿no? CLAUDE.md es ese “manual” que Claude lee una vez y recuerda: cómo es tu proyecto, qué herramientas usas, tu estilo, y lo que NO debe hacer.

1 Créalo

La forma más fácil: en Claude Code escribe el comando /init y él crea un CLAUDE.md analizando tu proyecto. O créalo a mano: un archivo llamado CLAUDE.md en la carpeta principal del proyecto.

2 Qué poner adentro

Escríbelo en lenguaje normal, en puntos. Por ejemplo:

# Mi proyecto
- Es una página web personal hecha con Astro.
- Idioma del sitio: español primero, inglés después.

## Cómo trabajar
- Explícame los cambios en palabras simples antes de hacerlos.
- Haz commit y push cuando termine algo.

## Reglas
- No subas contraseñas ni llaves al repo.
- No instales librerías nuevas sin avisarme.
3 Manténlo vivo

Cuando notes que le repites algo a Claude (“acuérdate de…”), agrégalo al CLAUDE.md. Con el tiempo se vuelve la memoria de tu proyecto y Claude trabaja cada vez más a tu manera.

Consejos rápidos
  • Corto y claro gana a largo y vago.
  • Escribe reglas, no novelas: puntos cortos.
  • Súbelo a GitHub: así viaja con tu proyecto.
  • ¿Algo aplica a TODOS tus proyectos? Ponlo en el CLAUDE.md de tu carpeta personal (global).