Usa CLAUDE.md para mantener las convenciones del proyecto en las sesiones de Claude AI

Un usuario de Reddit informa que agregar un archivo CLAUDE.md a la raíz del proyecto es el cambio de mayor apalancamiento que ha hecho con Claude Code. Claude lee este archivo al inicio de cada sesión, por lo que nunca necesitas reexplicar convenciones como el uso de TypeScript, Tailwind vs. CSS modules, la estructura de carpetas de pruebas o las relaciones del modelo de datos.

Detalles clave

• Ubicación: Crea un archivo llamado CLAUDE.md en la raíz de tu directorio de proyecto.
• Qué incluir: Convenciones de codificación (ej., "Usamos TypeScript, siempre. Sin exportaciones por defecto. Tailwind, no CSS modules. Las pruebas van en carpetas tests."), además del contexto de la arquitectura del proyecto: cómo se conectan los módulos, los modelos de datos, y qué archivos son críticos vs. scaffolding.
• Comportamiento: El archivo se lee automáticamente al inicio de cada sesión de Claude. No se necesita invocación manual. Las convenciones se aplican sin que se las pidas.
• Resultado: El usuario notó que "las ediciones de Claude mejoraron notablemente una vez que tuvo ese contexto integrado desde el inicio de la sesión."

Ejemplo práctico

# CLAUDE.md

Convenciones

Lenguaje: TypeScript
Exportaciones: solo exportaciones nombradas (sin exportaciones por defecto)
Estilos: Tailwind CSS (sin CSS modules)
Pruebas: las pruebas van en carpetas tests/ dedicadas

Arquitectura

Frontend: React con React Router
Capa de API: rutas Express en /api
Modelos de datos: esquema Prisma en /prisma
Archivos críticos: /src/app.ts, /src/config.ts

Después de agregar este archivo, el usuario informa que nunca ha tenido que volver a escribir esas reglas por sesión.

Para quién es

Desarrolladores que usan Claude Code o cualquier agente de codificación impulsado por Claude que quieran un comportamiento consistente entre sesiones de chat sin repetir instrucciones.