CLAUDE.md (Claude Code): dónde se encuentra y cómo lo leen las herramientas

CLAUDE.md es el archivo de memoria que Claude Code carga al iniciarse desde el directorio de inicio, el proyecto y cada directorio superior. Las reglas con ámbito de ruta de .claude/rules/ añaden indicaciones que solo se cargan al leer archivos que coinciden.

Dónde se encuentra

• Proyecto: ./CLAUDE.md o ./.claude/CLAUDE.md, incluido en el repositorio y compartido con el equipo.
• Local: ./CLAUDE.local.md, para notas personales que no se incluyen en git.
• Usuario: ~/.claude/CLAUDE.md, aplicado a todos los proyectos.
• Reglas: ./.claude/rules/**/*.md y ~/.claude/rules/**/*.md, con ámbito opcional mediante frontmatter paths.
• Política gestionada: /Library/Application Support/ClaudeCode/CLAUDE.md en macOS, C:\Program Files\ClaudeCode\CLAUDE.md en Windows o la clave claudeMd de managed-settings.json.

Formato

Markdown. Los archivos de .claude/rules/ pueden empezar con YAML frontmatter cuya clave paths contiene una lista de patrones glob. Incluye otros archivos con @path/to/file, hasta 4 niveles de profundidad; no hay un límite de tamaño documentado, pero Anthropic recomienda que cada archivo tenga menos de 200 líneas.

Claves del frontmatter: paths

@AGENTS.md

# Claude Code notes

- Run `pnpm test` after every change under src/.
- Use the `gh` CLI for issues and pull requests.
- Ask before adding a dependency.

## API

- Error format is described in @docs/api-errors.md.
- One handler file per route in src/api/.

Precedencia y combinación

No se sobrescribe ningún archivo: todos los archivos encontrados se concatenan. La política gestionada se carga primero y, después, se cargan los archivos desde la raíz del sistema de archivos hasta el directorio desde el que se inicia Claude Code, por lo que los archivos más cercanos se leen al final; dentro de un mismo directorio, CLAUDE.local.md se carga después de CLAUDE.md. Los archivos de los subdirectorios se cargan bajo demanda cuando Claude lee archivos en ellos, y no se puede excluir la política gestionada con claudeMdExcludes.

Herramientas que lo leen

Consejos

• Si mantienes un CLAUDE.md, empieza con @AGENTS.md; de lo contrario, Claude Code ignora AGENTS.md con la configuración predeterminada.
• Traslada las indicaciones específicas de cada área a .claude/rules/ y añade frontmatter paths para que solo se carguen al trabajar con esos archivos.
• Las importaciones ayudan a organizar el archivo, pero también consumen contexto, porque el texto importado se carga igualmente.
• Ejecuta /doctor para revisar de una vez CLAUDE.md, CLAUDE.local.md, AGENTS.md, las reglas y las skills.

Otros archivos de instrucciones