⌘ Claude Code Memoria (CLAUDE.md)
0 / 78

Mantener la memoria liviana

📚 Lección opcional. Si recién empezás, podés saltearla y volver más adelante.


El problema: la memoria que engorda

Con el tiempo, tus archivos se llenan. Reglas de estilo, contexto, decisiones, la lista del super… Y acá viene lo contraintuitivo:

Una memoria más grande hace a Claude peor, no mejor.

Hay estudios (y la propia documentación de Anthropic lo dice) que muestran que una memoria inflada baja la precisión en tareas reales. El motivo: todo lo del CLAUDE.md se carga en cada respuesta. Mientras más texto, más se diluye lo importante; tus reglas clave se ahogan en ruido.

Memoria inflada diluye tus reglas; memoria corta las mantiene claras


La dieta de 3 reglas

  1. Cada archivo, corto. El CLAUDE.md bajo 200 palabras. Si pasás, recortá.
  2. Hechos, no aspiraciones. “Escribo en frases cortas” queda. “Valoro la excelencia” se va.
  3. No repitas lo que el código ya dice. Nombres de carpetas, herramientas, convenciones: Claude las lee del proyecto.

⚠️ La trampa: escribís una regla clara, Claude igual la ignora, y tu instinto es agregar otra línea. Es al revés. Recortá lo de alrededor para que la regla que te importa sea una de las pocas cosas en la página.


El truco del índice (router, no bóveda)

Esto es exactamente lo que hiciste al conectar tus archivos: tu CLAUDE.md quedó como un índice que apunta a dónde está cada cosa, en vez de tener todo adentro.

Quién soy en detalle está en alma.md.
Cómo hablo está en voz.md.
A quién quiero llegar está en audiencia.md.

Así el CLAUDE.md queda corto (siempre cargado, barato), y Claude lee el archivo de detalle solo cuando lo necesita. La mayoría de las respuestas nunca tocan los archivos laterales, así que la mayoría son baratas.

El CLAUDE.md como índice que apunta a archivos de detalle, no una bóveda con todo adentro


Dos ideas para cuando crezcas

  • Limpieza periódica: cada tanto, pedile a Claude que revise tu memoria y consolide contradicciones o reglas viejas. Una vez por semana alcanza.
  • Notas en texto plano: para tu base de conocimiento personal no necesitás bases de datos sofisticadas. Una carpeta de archivos .md con buenos nombres y Claude leyéndolos por nombre alcanza para el 95% de los casos.