CLAUDE.md (Claude Code): расположение и чтение инструментами

CLAUDE.md — это файл памяти, который Claude Code загружает при запуске из домашнего каталога, проекта и всех родительских каталогов. Правила с ограниченной областью действия в .claude/rules/ добавляют инструкции, загружаемые только при чтении файлов, соответствующих заданным условиям.

Расположение

• Проект: ./CLAUDE.md или ./.claude/CLAUDE.md — добавьте в коммит и поделитесь с командой.
• Локально: ./CLAUDE.local.md — для личных заметок, которые не нужно добавлять в git.
• Пользовательский: ~/.claude/CLAUDE.md — применяется ко всем проектам.
• Правила: ./.claude/rules/**/*.md и ~/.claude/rules/**/*.md; при необходимости задайте область действия с помощью frontmatter paths.
• Управляемая политика: /Library/Application Support/ClaudeCode/CLAUDE.md в macOS, C:\\Program Files\\ClaudeCode\\CLAUDE.md в Windows или ключ claudeMd в managed-settings.json.

Формат

Markdown. Файлы в .claude/rules/ могут начинаться с YAML frontmatter, где ключ paths содержит список glob-шаблонов. Подключайте другие файлы с помощью @path/to/file — максимум на 4 уровня вглубь. Жёсткое ограничение на размер не задокументировано, но Anthropic рекомендует не превышать 200 строк в одном файле.

Ключи 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/.

Приоритет и объединение

Ничто не переопределяется: все найденные файлы объединяются. Сначала загружается управляемая политика, затем файлы от корня файловой системы до каталога запуска — поэтому файлы в более близких каталогах читаются последними. В одном каталоге CLAUDE.local.md загружается после CLAUDE.md. Файлы во вложенных каталогах загружаются по мере необходимости, когда Claude читает файлы в этих каталогах. Исключить управляемую политику с помощью claudeMdExcludes нельзя.

Инструменты, которые его читают

Советы

• Если используете CLAUDE.md, добавьте в его начало @AGENTS.md; иначе Claude Code при настройках по умолчанию не учитывает AGENTS.md.
• Перенесите инструкции для отдельных областей в .claude/rules/ и добавьте frontmatter с paths, чтобы они загружались только для соответствующих файлов.
• Импорты помогают упорядочить файл, но всё равно занимают контекст: импортированный текст тоже загружается.
• Запустите /doctor, чтобы за один проход проверить CLAUDE.md, CLAUDE.local.md, AGENTS.md, rules и skills.

Другие файлы с инструкциями