Contexto y memoria

Claude no recuerda nada entre sesiones por sí solo. Su memoria persistente vive en archivos CLAUDE.md, que se cargan automáticamente al iniciar cada sesión:

• CLAUDE.md en la raíz del proyecto: convenciones compartidas del repositorio (comandos de build y test, estilo de código, arquitectura, rutas clave).
• ~/.claude/CLAUDE.md: tus preferencias personales, aplicadas en todos tus proyectos.

Qué poner ahí: información corta y de alto valor que Claude necesita siempre — "usamos pnpm, no npm", "los tests corren con pnpm test", "el código de dominio vive en src/core/". Qué no poner: contenido largo o volátil, como archivos fuente pegados o historiales de conversación. Todo lo que está en CLAUDE.md ocupa contexto en cada sesión.

La ventana de contexto es el espacio de trabajo del modelo: contiene la conversación, los archivos leídos y los resultados de comandos. Es finita. Cuando se llena, Claude Code puede compactar la conversación (/compact), reemplazándola por un resumen. Con /clear la borrás por completo para empezar una tarea nueva.

Memorias rápidas: si empezás un mensaje con #, Claude lo guarda como memoria en el CLAUDE.md que elijas, sin que tengas que editar el archivo a mano.

Secretos fuera del contexto. Todo lo que entra a la conversación sale de tu máquina hacia el modelo y queda en el historial de la sesión. Por eso: nunca pegues API keys ni contraseñas en el chat, y no guardes secretos en CLAUDE.md ni en archivos que el agente vaya a leer. Referencia los secretos por su nombre de variable de entorno (API_KEY), no por su valor. Y el archivo .env va siempre en .gitignore, para que tampoco termine versionado.

La regla general: contexto liviano, memoria curada, secretos fuera del contexto.