CLAUDE.md es el archivo de memoria de proyecto de Claude Code. Al iniciar una sesión, su
contenido se inyecta en la ventana de contexto, de modo
que las instrucciones y el contexto del proyecto siempre están presentes sin que los
repitas. Es la solución práctica al problema de que el modelo no
recuerda entre sesiones.
Va lo que quieres que Claude sepa siempre en este repo:
No va documentación extensa ni cosas que solo importan una vez: cada línea ocupa
contexto en todas las llamadas. CLAUDE.md gordo =
más tokens por turno y más ruido. Sé conciso.
CLAUDE.md en el repo): compartido con el equipo vía Git.~/.claude): tus preferencias personales, en todos tus repos.Se combinan: lo global y lo de proyecto se suman en la sesión.
[!TIP] Trátalo como código: revísalo, recórtalo y actualízalo. Un
CLAUDE.mddesactualizado enseña a Claude cosas falsas del proyecto con total seguridad.
CLAUDE.md es exactamente context engineering aplicado:
decides qué información merece estar en la ventana en cada llamada, a cambio de su coste en
tokens. La disciplina de mantenerlo pequeño y relevante es la misma que gestiona cualquier
memoria de agente.
Resuelve la ventana de contexto y la
memoria del proyecto; sus equivalentes en otras herramientas son
AGENTS.md de Codex y las
rules de Cursor.