Global vs proyecto
Hay dos archivos de memoria, y la diferencia es simple:
Global = quién sos. Proyecto = en qué estás trabajando.
El CLAUDE.md global
- Dónde vive: en tu carpeta personal (
~/.claude/CLAUDE.md). - Para qué sirve: todas tus sesiones de Claude Code, en esta computadora.
- Qué va adentro: cosas tuyas que no cambian. Tu nombre, qué hacés, cómo te gusta que te hablen, qué considerás “listo”.
El CLAUDE.md de proyecto
- Dónde vive: en la raíz de la carpeta de un proyecto (
CLAUDE.md). - Para qué sirve: solo las sesiones dentro de ese proyecto.
- Qué va adentro: cosas del proyecto. Qué es, qué está en marcha, qué ya está hecho, qué no hay que tocar.
Cómo se combinan
Cuando existen los dos, Claude lee primero el global, después el de proyecto encima. Si hay un conflicto, gana el de proyecto (es más específico).
💡 Si recién empezás y todavía no tenés un proyecto, no te compliques: arrancá solo con el global. El de proyecto lo sumás cuando empieces a construir algo más grande.
La idea en una frase
Tenés que poder decir, sin pensarlo: el global es para quién soy, el de proyecto para en qué estoy trabajando. Si eso te queda claro, listo.