Incorpora las reglas del proyecto en archivos Claude.md

Deja de repetir los estándares de programación en cada sesión. Crea un archivo CLAUDE.md en la raíz de tu proyecto y Claude Code cargará automáticamente la arquitectura, los comandos de compilación y el estilo de programación de tu proyecto al iniciarse. Esta memoria persistente se mantiene a lo largo de todas las sesiones de los desarrolladores sin consumir tu ventana de tokens.

El sistema CLAUDE.md de Claude Code te permite integrar instrucciones específicas del proyecto directamente en tu repositorio. En lugar de poner a Claude al día sobre tu stack tecnológico, tus convenciones de nomenclatura y tus procedimientos de compilación cada vez que inicias una nueva sesión, creas un sencillo archivo markdown que Claude lee automáticamente.

Para empezar, ejecuta el comando /init en Claude Code. Este analiza tu base de código existente y genera un CLAUDE.md inicial con el contexto relevante. Después puedes editar este archivo para incluir: comandos de compilación y pruebas, estándares de programación, decisiones de arquitectura, estructura de carpetas y convenciones de nomenclatura. Guárdalo en la raíz como ./CLAUDE.md y súbelo al control de versiones: todo tu equipo se beneficia del mismo contexto.

El archivo reside en el repositorio y se sincroniza mediante git, de modo que cada desarrollador que trabaja en el proyecto (y el propio Claude Code) recibe las mismas instrucciones. Claude carga los archivos CLAUDE.md desde tu directorio de trabajo y todos los directorios superiores, concatenándolos en orden, por lo que puedes combinar reglas de todo el proyecto con reglas de todo el equipo y con preferencias personales.

Por ejemplo, si trabajas en un proyecto TypeScript/React, tu CLAUDE.md podría especificar: «Usa siempre el modo estricto de TypeScript, escribe pruebas unitarias con Vitest antes de la implementación, sigue la estructura de carpetas de ./docs/architecture.md y usa mensajes de commit convencionales». Una vez guardado, Claude Code lo carga en cada sesión sin repetir instrucciones.

Mantén el archivo por debajo de 300 líneas: Claude lo lee al inicio de cada sesión y los tokens importan. Céntrate en estándares de alto impacto en lugar de explicaciones extensas.