CLAUDE.md y los archivos de memoria de Claude Code, explicados

Claude Code usa archivos Markdown para sus instrucciones y su memoria. Tú le das instrucciones en CLAUDE.md. Él guarda sus propias notas en archivos de memoria. Y cuando se lo pides, escribe planes, especificaciones e informes como archivos .md en tu proyecto. Esta página muestra dónde está cada archivo y cómo leerlos con comodidad.

Los archivos que lee Claude Code

ArchivoDóndePara qué
Instrucciones de usuario~/.claude/CLAUDE.mdTus preferencias, en todos los proyectos
Instrucciones del proyecto./CLAUDE.md o ./.claude/CLAUDE.mdLas reglas del equipo, compartidas mediante Git
Instrucciones locales./CLAUDE.local.mdTus propias notas para un proyecto; añádelo a .gitignore
Reglas.claude/rules/*.md (un proyecto) o ~/.claude/rules/ (todos los proyectos)Un tema por archivo; se puede limitar a ciertas rutas

Cómo se cargan. Claude Code lee CLAUDE.md y CLAUDE.local.md en la carpeta donde lo inicias y en todas las carpetas superiores. Se combinan, no se sustituyen: desde la carpeta superior hacia abajo, de modo que el archivo de la carpeta en la que lo iniciaste se lee el último. Un CLAUDE.md en una subcarpeta se carga cuando Claude empieza a trabajar con archivos de ahí.

Importaciones. Una línea como @docs/style.md incorpora otro archivo a tu CLAUDE.md.

Que sea corto. La documentación sugiere menos de 200 líneas por CLAUDE.md. Pasa las reglas por tema a .claude/rules/.

AGENTS.md

Si un proyecto tiene un AGENTS.md (el archivo que leen Codex y otros agentes) y no tiene CLAUDE.md ni CLAUDE.local.md, Claude Code lee el AGENTS.md en su lugar. Si existen los dos, por defecto solo lee CLAUDE.md. Para usar un solo archivo para ambos, impórtalo: pon @AGENTS.md en tu CLAUDE.md. Más sobre AGENTS.md: página de Codex.

Memoria automática: las notas que escribe Claude por su cuenta

La memoria automática está activada por defecto. Mientras trabaja, Claude Code guarda notas sobre ti, tus comentarios, el proyecto y dónde encontrar las cosas. Se guardan en:

~/.claude/projects/<project>/memory/

MEMORY.md es ahí el índice; las primeras 200 líneas (o 25 KB) se cargan al principio de cada sesión. Puedes activar o desactivar la memoria automática con el comando /memory.

Son archivos Markdown normales que puedes leer y editar. Revísalos de vez en cuando: una nota equivocada afecta a todas las sesiones nuevas hasta que la corriges o la eliminas.

Cómo leer estos archivos en un Mac

En un Mac, PilcrowMD (gratis, beta):

PilcrowMD para Mac (beta) · Más sobre cómo leer archivos de agentes

Preguntas frecuentes

Claude ignora mi CLAUDE.md. ¿Por qué? Ejecuta /context en una sesión y comprueba que aparece en la lista de Memory files. Los archivos largos o contradictorios se siguen con menos fiabilidad.

¿Debe CLAUDE.local.md ir a Git? No, es para tus propias notas. Añádelo a .gitignore.

¿Puedo leer estos archivos en mi teléfono? Si la carpeta del proyecto se sincroniza con Google Drive, añádela en Mis carpetas en PilcrowMD para Android. Abre una nota para ver su última versión; en Android no hay recarga en directo.

También en Mac: PilcrowMD para Mac (beta)