# ¿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.

Fuente: https://skillsagentes.com/glosario/claude-md
Markdown: https://skillsagentes.com/glosario/claude-md.md

Área: Ejecución y control. Publicado el 2026-09-14. Última revisión: 2026-09-14. También: claude.md, Archivo de memoria del proyecto.

---

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.

## 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

- [AGENTS.md](https://skillsagentes.com/glosario/agents-md.md) — ¿Qué es el archivo AGENTS.md?
- [Prompt de sistema](https://skillsagentes.com/glosario/prompt-de-sistema.md) — ¿Qué es el prompt de sistema?
- [Skill](https://skillsagentes.com/glosario/skill.md) — ¿Qué es una skill de agente?
- [Hook](https://skillsagentes.com/glosario/hook.md) — ¿Qué es un hook en un agente?

## Fuentes

- [Manage Claude's memory](https://docs.claude.com/en/docs/claude-code/memory) — Anthropic. Comprobado el 2026-09-14.
- [Claude Code: Best practices for agentic coding](https://www.anthropic.com/engineering/claude-code-best-practices) — Anthropic Engineering. Comprobado el 2026-09-14.

---

[Glosario completo](https://skillsagentes.com/glosario.md) · [Guía de Claude Skills](https://skillsagentes.com/claude-skills.md) · [Todas las skills](https://skillsagentes.com/skills.md)

Skills Agentes · [Índice de páginas en markdown](https://skillsagentes.com/sitemap.md) · [Inicio](https://skillsagentes.com/index.md)