Memoria y CLAUDE.md
Cada sesión de Claude Code empieza con un contexto limpio. Hay dos formas de llevar conocimiento entre sesiones: archivos CLAUDE.md y auto memoria.
Qué es CLAUDE.md
CLAUDE.md es un archivo markdown que Claude lee al inicio de cada sesión. Aquí pones las instrucciones que aplican siempre: comandos de build, estilo de código, convenciones del equipo, decisiones de arquitectura.
Tip rápido: Ejecuta /init para generar un CLAUDE.md inicial basado en tu proyecto. Claude analiza tu codebase y detecta frameworks, tests y patrones.
Ejemplo de CLAUDE.md
# Estilo de código
- Usar ES modules (import/export), no CommonJS (require)
- Desestructurar imports cuando sea posible
- Indentación con 2 espacios
# Workflow
- Hacer typecheck después de hacer cambios de código
- Preferir correr tests individuales, no la suite completa
- Usar pnpm, no npm
# Proyecto
- Frontend: Next.js 14 con App Router
- Backend: tRPC + Prisma + PostgreSQL
- Tests: Vitest para unit, Playwright para E2E
# Comandos
- Build: pnpm build
- Test: pnpm test
- Lint: pnpm lint
- Dev: pnpm devDónde poner CLAUDE.md
./CLAUDE.md Raíz del proyecto
Instrucciones del equipo. Se comparte via git con todos.
~/.claude/CLAUDE.md Tu carpeta personal
Preferencias personales que aplican a todos tus proyectos.
./.claude/CLAUDE.md Carpeta .claude del proyecto
Alternativa a la raíz. Mantiene la raíz del proyecto limpia.
Qué incluir y qué NO incluir
Incluir
- - Comandos de build/test/lint que Claude no puede adivinar
- - Reglas de estilo que difieren del default
- - Instrucciones de testing y runners preferidos
- - Convenciones de git (nombres de branches, PRs)
- - Decisiones arquitectónicas del proyecto
- - Variables de entorno requeridas
NO incluir
- - Cosas que Claude puede descubrir leyendo el código
- - Convenciones estandar del lenguaje
- - Documentación detallada de APIs (enlaza en su lugar)
- - Información que cambia seguido
- - Explicaciones largas o tutoriales
- - Cosas obvias como "escribe código limpio"
Mantenerlo corto: Apunta a menos de 200 líneas. Un CLAUDE.md demasiado largo hace que Claude ignore las instrucciones importantes. Si crece, mueve contenido a archivos separados con imports @docs/reglas.md.
Auto Memoria
Además del CLAUDE.md que escribes tú, Claude guarda notas automáticamente conforme trabaja: comandos de build, insights de debugging, patrones de código. Esto se llama auto memoria.
Se activa automáticamente
Claude decide qué vale la pena recordar basado en si la información sería útil en una conversación futura.
Se guarda localmente
En ~/.claude/projects/<proyecto>/memory/. Son archivos markdown que puedes leer y editar.
Puedes pedir que recuerde algo
"recuerda que siempre usamos pnpm" o "recuerda que los tests de API necesitan Redis local".
Usa /memory para ver todos los archivos de memoria cargados y editarlos directamente.
Reglas por tipo de archivo
Para proyectos grandes, puedes organizar instrucciones en .claude/rules/ y limitarlas a ciertos archivos:
---
paths:
- "src/api/**/*.ts"
---
# Convenciones de API
- Usar kebab-case en URLs
- Usar camelCase en propiedades JSON
- Siempre incluir paginación en list endpoints
- Versionar APIs en la URL (/v1/, /v2/)Estas reglas solo se cargan cuando Claude trabaja con archivos que coinciden con el patrón. Ahorra contexto y mantiene las instrucciones relevantes.
Resumen
- - Ejecuta /init para generar tu primer CLAUDE.md
- - Incluye solo lo que Claude no puede descubrir solo
- - Mantenlo corto (menos de 200 líneas)
- - La auto memoria guarda aprendizajes automáticamente
- - Usa .claude/rules/ para reglas por tipo de archivo
- - Usa /memory para ver y editar la memoria