El archivo CLAUDE.md

El problema que resuelve

Cuando abres Claude Code sin un archivo CLAUDE.md, comienza desde cero cada vez. Tiene que volver a explorar tu base de código, averiguar qué dependencias se necesitan y entender qué funciones ya están implementadas. A veces hace suposiciones, lo que dificulta guiar a Claude en la dirección correcta.

CLAUDE.md resuelve esto. Es un archivo Markdown que agregas a la raíz de tu proyecto, y Claude Code lo lee automáticamente cada vez que inicias una sesión. Piensa en él como un script de incorporación para tu base de código. El contenido del archivo CLAUDE.md se añade a tu prompt.

Un ejemplo

Así es como se ve un archivo CLAUDE.md típico:

# Project

This is a Next.js 15 app using the App Router, Tailwind, and Drizzle ORM.

# Commands
- Dev server: `pnpm dev`
- Run tests: `pnpm test`
- Lint: `pnpm lint`

# Code Style
- Use 2-space indentation
- Prefer named exports
- All API routes go in app/api/
- Use server actions instead of API routes where possible

Es sencillo. Ahora, si le pides a Claude Code que cree un componente de React, ya sabe que debe usar Tailwind para los estilos y seguir tus convenciones de código.



CLAUDE.md es para equipos

Puedes (y deberías) confirmar tu CLAUDE.md en el control de versiones para que tu equipo se beneficie de él. De hecho, existe una jerarquía de archivos de memoria según a quién estén destinados:

• CLAUDE.md a nivel de proyecto vive en el directorio raíz de tu proyecto. Se comparte con el equipo.

• CLAUDE.md a nivel de usuario vive en tu carpeta de configuración. Este es solo para ti y se aplica en todos tus proyectos. Coloca aquí tus preferencias personales.

Consejos

Guarda las correcciones en la memoria. Si te encuentras corrigiendo a Claude repetidamente —como decirle que siempre use server actions en lugar de rutas de API— pídele explícitamente a Claude que guarde esa regla en la memoria. La próxima vez que abras el proyecto, la sabrá.



Haz referencia a la documentación del proyecto. Si tienes documentación en tu proyecto a la que quieres que Claude haga referencia, usa el símbolo @ con la ruta del archivo:

## README.md

Please read if you need more info: @README.md

Empieza sin uno. Recomendamos comenzar un proyecto sin un archivo CLAUDE.md para que puedas ver dónde constantemente tienes que corregir el rumbo del modelo. Esto mantiene tu CLAUDE.md compacto y enfocado solo en la información necesaria. Cuando estés listo, ejecuta /init para que Claude genere uno por ti.

Resumen

La diferencia entre una sesión de Claude Code frustrante y una productiva a menudo se reduce al contexto, y el archivo CLAUDE.md es la forma en que proporcionas ese contexto. Comienza con tu stack, tus preferencias y tus comandos, y luego continúa construyendo a partir de ahí.