Mantén a Claude enfocado: el truco del CLAUDE.md

Cuando cambias entre sesiones de Claude Code, normalmente necesitas volver a explicar desde cero la estructura de tu proyecto, las convenciones de código y las decisiones de arquitectura. Esto hace perder tiempo y provoca resultados inconsistentes. El archivo CLAUDE.md lo soluciona actuando como la memoria persistente de Claude.

CLAUDE.md es un archivo markdown que se coloca en la raíz de tu proyecto (./CLAUDE.md). Claude Code lo lee automáticamente al inicio de cada sesión y lo integra en su ventana de contexto como instrucciones permanentes. Puedes incluir tu stack tecnológico, las convenciones de nomenclatura, los requisitos de pruebas, las políticas de seguridad y cualquier regla de arquitectura que siga tu equipo.

Para empezar, crea un archivo CLAUDE.md con la información básica: el nombre de tu proyecto, el stack tecnológico (React 18, Node.js, PostgreSQL), los directorios clave y cualquier convención innegociable («Usa siempre el modo estricto de TypeScript», «Escribe las pruebas antes del código»). Mantenlo entre 300 y 800 palabras. Para equipos más grandes, crea reglas específicas de cada proyecto en subdirectorios .claude/rules/ y mantén un archivo raíz más pequeño. Claude también carga un archivo global ~/.claude/CLAUDE.md con preferencias personales para todos los proyectos.

Ejemplo de flujo de trabajo: un equipo de procesamiento de pagos añade a su CLAUDE.md: «Backend: Node.js + Express. Base de datos: PostgreSQL con seguridad a nivel de fila. Seguridad: todos los campos de importe deben ser enteros (céntimos, no decimales). Todas las API requieren tokens de autenticación.» Ahora cada sesión con Claude Code conoce estas restricciones automáticamente. Cuando le pides a Claude que escriba un nuevo endpoint, genera código que respeta estas reglas sin que tengas que mencionarlas cada vez.