Memoria persistente con CLAUDE.md

Dale contexto permanente a Claude sobre tu proyecto

¿Por qué Claude "olvida" entre sesiones?

Cada conversación con Claude empieza desde cero. Sin contexto. Sin saber que trabajas en Next.js, que prefieres TypeScript estricto, que hay convenciones específicas en tu codebase. Tienes que re-explicarlo cada vez. CLAUDE.md soluciona esto.

¿Qué es CLAUDE.md?

Es un archivo Markdown que Claude Lee automáticamente al inicio de cada sesión. Le das contexto persistente sobre tu proyecto, tus preferencias y tus convenciones. Una vez configurado, Claude siempre sabe dónde está.

Los 3 niveles de memoria

~/.claude/CLAUDE.md — Personal: aplica a TODOS tus proyectos. Tus preferencias globales.
./CLAUDE.md — Proyecto: aplica a este repositorio. Convenciones, stack, contexto.
src/CLAUDE.md — Directorio: aplica solo a ese subdirectorio. Contexto granular.

TIP

Empieza con el CLAUDE.md de proyecto. Es el 80% del valor con el 20% del esfuerzo.

Qué poner en tu CLAUDE.md de proyecto

CLAUDE.md — Template de proyectomarkdown

# [Nombre del proyecto]

## Stack
- Framework: Next.js 15 App Router
- Lenguaje: TypeScript estricto (sin any)
- Estilos: Tailwind CSS
- DB: Neon Postgres + Prisma ORM
- Auth: Clerk

## Convenciones de código
- Componentes: PascalCase con tipos explícitos
- API routes: kebab-case
- Hooks: use[Feature] en /src/hooks/
- No comentarios obvios — solo el "por qué" no el "qué"

## Estructura de rutas
```
src/app/(marketing)/    → páginas públicas
src/app/(platform)/     → páginas autenticadas
src/app/api/           → API routes
```

## Lo que NO hacer
- No usar any en TypeScript
- No hardcodear API keys — siempre desde process.env
- No estilos inline — siempre Tailwind
- No añadir features no pedidas

## Variables de entorno
DATABASE_URL, CLERK_SECRET_KEY, ANTHROPIC_API_KEY

CLAUDE.md personal (~/.claude/CLAUDE.md)

~/.claude/CLAUDE.md — Template personalmarkdown

# Mis preferencias globales

## Idioma
Responde siempre en español salvo que el código lo requiera en inglés.

## Estilo de código
- TypeScript estricto siempre
- Funciones pequeñas y enfocadas (máx 30 líneas)
- Nombrado descriptivo > comentarios

## Cómo trabajo mejor con Claude
- Explica el razonamiento detrás de decisiones no obvias
- Si hay varias opciones, recomienda una con justificación
- Respuestas concisas — sin relleno ni disclaimers innecesarios

## Mis herramientas habituales
- Editor: VS Code / Cursor
- Terminal: zsh
- Gestor de paquetes: npm

ATENCIÓN

No pongas secrets ni API keys en CLAUDE.md — este archivo se commiteará al repo. Solo referencia variables de entorno.

ejercicio

Crea tu CLAUDE.md de proyecto

Crea el archivo CLAUDE.md en la raíz de tu proyecto actual. Adapta el template con tu stack real y commitéalo.

prompt

# Mi proyecto

## Stack
- [Framework que usas]
- [Lenguaje]
- [Estilos]
- [DB si aplica]

## Convenciones de código
- [Naming conventions]
- [Estructura de carpetas]
- [Patrones que prefieres]

## Lo que NO hacer
- [Anti-patrones de tu proyecto]
- [Restricciones importantes]

## Contexto del negocio
[2-3 líneas de qué hace tu proyecto y para quién]

Next lesson

Previous lesson