Los archivos que lee Claude Code
| Archivo | Dónde | Para qué |
|---|---|---|
| Instrucciones de usuario | ~/.claude/CLAUDE.md | Tus preferencias, en todos los proyectos |
| Instrucciones del proyecto | ./CLAUDE.md o ./.claude/CLAUDE.md | Las reglas del equipo, compartidas mediante Git |
| Instrucciones locales | ./CLAUDE.local.md | Tus 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):
- Añade la carpeta de tu proyecto en Mis carpetas. Los archivos que escribe Claude Code, como planes, especificaciones e informes, aparecen marcados con N (nuevo) o U (actualizado). Una nota abierta se recarga cuando Claude Code u otra app la modifica.
- Resaltar cambios muestra lo que ha cambiado en un archivo que ya leíste: azul para lo añadido, naranja para lo eliminado o editado. Útil para un
MEMORY.mdo un plan que Claude va actualizando. - Comparar en paralelo muestra dos versiones. Con el historial de archivos activado, Archivo › Mostrar historial… te permite volver a una versión anterior.
~/.claudees una carpeta oculta. En el panel Abrir, pulsa ⌘⇧. (Comando-Mayúsculas-Punto) para mostrar las carpetas ocultas.- Sin conexión a internet; tus notas se quedan en tu Mac.
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)