CLAUDE.md: la memoria de tu proyecto
Un archivo de texto que Claude Code lee siempre al arrancar. Qué poner, qué no, y cómo hacer que mejore con el uso.
Qué es
Cada sesión de Claude Code arranca de cero: no se acuerda de lo que hablaron ayer. El archivo CLAUDE.md en tu carpeta es su «cuaderno»: lo lee al empezar cada sesión. Lo que escribas ahí, lo sabe siempre.
Paso a paso
-
Crealo con
/init. Escribí/initen Claude Code: mira tu carpeta y arma un primer CLAUDE.md. Es un borrador; lo vas a mejorar. - Agregá lo que solo vos sabés. Quién sos, para qué es la carpeta, cómo te gusta que te hable, qué no tiene que hacer nunca, dónde está cada cosa.
- Sumá reglas cuando se equivoca. Cada vez que corregís lo mismo dos veces, pedile: «agregá esto al CLAUDE.md para que no vuelva a pasar». Así mejora con el uso.
-
Mantenelo corto. Lo lee entero cada vez. Si crece a páginas y páginas, ocupa lugar y las reglas importantes se diluyen. Revisalo cada tanto y sacá lo viejo. Con
/memorylo abrís para editarlo.
Qué poner (y qué no)
Contexto del negocio. Reglas («nunca borres originales», «preguntame antes de mandar mails»). Dónde está cada cosa. Tu forma de trabajar. Errores que ya pasaron.
Contraseñas o claves (nunca). Historias largas. Cosas que cambian todos los días. Instrucciones vagas tipo «hacelo bien».
Dato PRO
Hay un CLAUDE.md general (en tu usuario) que aplica a todas tus carpetas, y uno por carpeta. Lo personal (cómo te gusta que te hablen) va en el general; lo del negocio, en el de cada carpeta.