El archivo CLAUDE.md
Cada vez que abres Claude Code sin un archivo CLAUDE.md, empieza desde cero: tiene que explorar el código, entender las dependencias y descubrir qué ya está implementado. CLAUDE.md resuelve eso de raíz, dándole una memoria persistente de tu proyecto.
🌐 Este vídeo es el original de Anthropic, en inglés. Para seguirlo en español, dale al play al audio 🎬 «Sigue el vídeo en español» de aquí abajo — es la traducción exacta de lo que se dice.
Sigue el vídeo en español
Escucha la lección
¿Qué es CLAUDE.md?
Es un archivo Markdown que colocas en la raíz de tu proyecto. Claude Code lo lee automáticamente al inicio de cada sesión — como un guion de bienvenida para tu código. Su contenido se añade directamente al contexto de la sesión.
La diferencia entre una sesión frustrante y una productiva con Claude Code suele estar en el contexto. CLAUDE.md es la herramienta que lo proporciona.
Un ejemplo real
Así luce un CLAUDE.md típico para un proyecto Next.js: primero una descripción del proyecto (la tecnología que usa), luego los comandos principales (servidor de desarrollo, pruebas, lint) y por último el estilo de código (sangría, exportaciones, dónde van las rutas de API).
Con esto, si le pides a Claude Code que cree un componente React, ya sabe que debe usar tus convenciones y tu framework de estilo — sin que tengas que explicarlo cada vez.
CLAUDE.md es para equipos
Incluye tu CLAUDE.md en el control de versiones. Hay dos niveles:
CLAUDE.md de proyecto
En el directorio raíz del proyecto. Se comparte con todo el equipo y aplica a ese proyecto específico.
CLAUDE.md de usuario
En tu carpeta de configuración personal. Solo te aplica a ti y funciona en todos tus proyectos. Ideal para preferencias personales de estilo o flujo de trabajo.
Consejos para sacarle el máximo partido
Guarda las correcciones en memoria
Si te encuentras corrigiendo a Claude repetidamente — "usa server actions, no rutas de API" — pídele explícitamente que guarde esa regla en el CLAUDE.md. La próxima sesión ya lo sabrá sin que tengas que repetirlo.
Referencia documentación del proyecto
Si tienes documentos que quieres que Claude consulte, usa el símbolo @ con la ruta del archivo dentro del CLAUDE.md (por ejemplo, @README.md).
Empieza sin uno
Lo mejor es comenzar sin CLAUDE.md para ver dónde tienes que corregir al modelo una y otra vez. Eso te dice exactamente qué poner en él. Cuando estés listo, ejecuta /init y Claude generará uno basado en lo que ha aprendido de tu proyecto.
Empieza con lo básico: stack tecnológico, comandos principales y convenciones de código. A partir de ahí, añade lo que necesites según vayas trabajando.
Glosario
Markdown
Lenguaje de texto sencillo para dar formato (títulos, listas, negritas) con símbolos como # o *.
Una forma fácil de escribir texto con formato usando símbolos, sin un editor complicado.
CLAUDE.md
Archivo Markdown en la raíz del proyecto que Claude lee al iniciar cada sesión; le da memoria persistente.
La "ficha" del proyecto que Claude lee siempre al empezar, para no descubrirlo todo de cero.
Control de versiones
Sistema (como Git) que guarda el historial de cambios y permite volver atrás o colaborar en equipo.
Guardar todas las versiones del proyecto para poder volver atrás y trabajar en equipo.
Stack tecnológico
Conjunto de tecnologías que usa un proyecto: lenguaje, framework, base de datos, etc.
El conjunto de herramientas con las que está hecho tu proyecto.
/init
Comando que genera un CLAUDE.md inicial analizando tu proyecto.
Un atajo que crea la "ficha" del proyecto por ti, mirando tu código.
Lint
Herramienta que revisa el código en busca de errores y fallos de estilo de forma automática.
Un revisor automático que marca errores y descuidos en el código.
Fuentes oficiales de Anthropic