¿Qué es el archivo CLAUDE.md?
CLAUDE.md es el archivo de contexto que Claude Code lee al arrancar en un repositorio. Contiene lo que hay que saber siempre de ese proyecto: comandos, convenciones, arquitectura y advertencias. Se versiona con el código, así que vale para todo el equipo.
- Última revisión
También: claude.md · Archivo de memoria del proyecto
En corto
- Se carga en cada sesión de ese proyecto, así que su coste en contexto es permanente.
- Sirve para lo estable: cómo se ejecutan las pruebas, qué no hay que tocar, qué comando construye.
- No es el sitio para un procedimiento puntual: eso es una skill o un comando slash.
Qué escribir y qué dejar fuera
Lo que ahorra una pregunta o evita un error: el comando exacto de pruebas, la advertencia de que un build tarda cuatro minutos, la convención de nombres que el repositorio ya sigue. Cuanto más concreto y más comprobable, mejor.
Lo que sobra: descripciones de la estructura de carpetas que el agente puede leer solo, historia del proyecto y reglas de estilo que ya están en la configuración del linter. Un archivo de contexto largo se paga en cada sesión y compite con el trabajo.
Términos relacionados
Fuentes
- Manage Claude's memory — Anthropic. Comprobado el .
- Claude Code: Best practices for agentic coding — Anthropic Engineering. Comprobado el .