Как Claude запоминает ваш проект

Дайте Claude постоянные инструкции с помощью файлов CLAUDE.md и позвольте Claude автоматически накапливать знания с помощью auto memory.

Каждый сеанс Claude Code начинается со свежего context window. Два механизма переносят знания между сеансами:

Файлы CLAUDE.md: инструкции, которые вы пишете, чтобы дать Claude постоянный контекст
Auto memory: заметки, которые Claude пишет сам на основе ваших исправлений и предпочтений

На этой странице рассматривается, как:

Писать и организовывать файлы CLAUDE.md
Ограничивать правила определёнными типами файлов с помощью .claude/rules/
Настраивать auto memory так, чтобы Claude автоматически делал заметки
Устранять неполадки когда инструкции не соблюдаются

CLAUDE.md и auto memory

Claude Code имеет две дополняющие друг друга системы памяти. Обе загружаются в начале каждого разговора. Claude рассматривает их как контекст, а не как принудительную конфигурацию. Чтобы заблокировать действие независимо от того, что решит Claude, используйте PreToolUse hook вместо этого. Чем более конкретны и лаконичны ваши инструкции, тем последовательнее Claude их соблюдает.

	Файлы CLAUDE.md	Auto memory
Кто это пишет	Вы	Claude
Что это содержит	Инструкции и правила	Знания и закономерности
Область действия	Проект, пользователь или организация	Отдельно для каждого репозитория, общая для всех его worktrees
Загружается в	Каждый сеанс	Каждый сеанс (первые 200 строк или 25KB)
Используется для	Стандарты кодирования, рабочие процессы, архитектура проекта	Ваши предпочтения, исправления, которые вы даёте Claude, контекст проекта, который Claude не может вывести из кода

Используйте файлы CLAUDE.md, когда вы хотите направить поведение Claude. Auto memory позволяет Claude учиться на ваших исправлениях без ручных усилий.

Subagents также могут поддерживать собственную auto memory. Подробнее см. в разделе конфигурация subagent.

Файлы CLAUDE.md

Файлы CLAUDE.md — это файлы markdown, которые дают Claude постоянные инструкции для проекта, вашего личного рабочего процесса или всей организации. Вы пишете эти файлы в виде простого текста; Claude читает их в начале каждого сеанса.

Когда добавлять в CLAUDE.md

Рассматривайте CLAUDE.md как место, где вы записываете то, что иначе пришлось бы переобъяснять. Добавляйте в него, когда:

Claude делает одну и ту же ошибку во второй раз
Проверка кода обнаруживает что-то, что Claude должен был знать об этой кодовой базе
Вы вводите одно и то же исправление или уточнение в чат, которое вводили в прошлом сеансе
Новому члену команды потребуется тот же контекст для продуктивности

Ограничивайте это фактами, которые Claude должен помнить в каждом сеансе: команды сборки, соглашения, макет проекта, правила "всегда делай X". Если запись — это многошаговая процедура или имеет значение только для одной части кодовой базы, переместите её в skill или правило с ограничением по пути вместо этого. Обзор расширений охватывает, когда использовать каждый механизм.

Выберите, где разместить файлы CLAUDE.md

Файлы CLAUDE.md могут находиться в нескольких местах, каждое с разной областью действия. Таблица ниже перечисляет их в порядке загрузки, от самой широкой области действия к наиболее специфичной, поэтому инструкция проекта появляется в контексте после инструкции пользователя.

Область действия	Местоположение	Назначение	Примеры использования	Общий доступ с
Управляемая политика	• macOS: `/Library/Application Support/ClaudeCode/CLAUDE.md` • Linux и WSL: `/etc/claude-code/CLAUDE.md` • Windows: `C:\Program Files\ClaudeCode\CLAUDE.md`	Инструкции на уровне организации, управляемые IT/DevOps	Стандарты кодирования компании, политики безопасности, требования соответствия	Все пользователи в организации
Инструкции пользователя	`~/.claude/CLAUDE.md`	Личные предпочтения для всех проектов	Предпочтения стиля кода, личные ярлыки инструментов	Только вы (все проекты)
Инструкции проекта	`./CLAUDE.md` или `./.claude/CLAUDE.md`	Инструкции, общие для команды проекта	Архитектура проекта, стандарты кодирования, общие рабочие процессы	Члены команды через систему контроля версий
Локальные инструкции	`./CLAUDE.local.md`	Личные предпочтения, специфичные для проекта; добавьте в `.gitignore`	Ваши URL-адреса sandbox, предпочтительные тестовые данные	Только вы (текущий проект)

Файлы CLAUDE.md и CLAUDE.local.md в иерархии каталогов выше рабочего каталога загружаются полностью при запуске. Файлы в подкаталогах загружаются по требованию, когда Claude читает файлы в этих каталогах. Полный порядок разрешения см. в разделе Как загружаются файлы CLAUDE.md.

Для больших проектов вы можете разбить инструкции на файлы, специфичные для темы, используя правила проекта. Правила позволяют ограничить инструкции определёнными типами файлов или подкаталогами.

Установите CLAUDE.md проекта

CLAUDE.md проекта может быть сохранён либо в ./CLAUDE.md, либо в ./.claude/CLAUDE.md. Создайте этот файл и добавьте инструкции, которые применяются к любому, кто работает над проектом: команды сборки и тестирования, стандарты кодирования, архитектурные решения, соглашения об именовании и общие рабочие процессы. Эти инструкции общие для вашей команды через систему контроля версий, поэтому сосредоточьтесь на стандартах уровня проекта, а не на личных предпочтениях. Чтобы подтвердить загрузку файла, запустите /context в сеансе и проверьте список в разделе Memory files.

Tip

Запустите /init для автоматического создания начального CLAUDE.md. Claude анализирует вашу кодовую базу и создаёт файл с командами сборки, инструкциями тестирования и соглашениями проекта, которые он обнаруживает. Если CLAUDE.md уже существует, /init предлагает улучшения вместо перезаписи. Уточните оттуда с помощью инструкций, которые Claude не смог бы обнаружить самостоятельно.

Установите CLAUDE_CODE_NEW_INIT=1 для включения интерактивного многофазного потока. /init спрашивает, какие артефакты настроить: файлы CLAUDE.md, skills и hooks. Затем он исследует вашу кодовую базу с помощью subagent, заполняет пробелы через дополнительные вопросы и представляет проверяемое предложение перед написанием каких-либо файлов.

Пишите эффективные инструкции

Файлы CLAUDE.md загружаются в context window в начале каждого сеанса, потребляя токены наряду с вашим разговором. Визуализация context window показывает, где загружается CLAUDE.md относительно остального контекста при запуске. Поскольку это контекст, а не принудительная конфигурация, то, как вы пишете инструкции, влияет на то, насколько надёжно Claude их соблюдает. Лучше всего работают конкретные, лаконичные, хорошо структурированные инструкции.

Размер: целевой показатель менее 200 строк на файл CLAUDE.md. Более длинные файлы потребляют больше контекста и снижают соблюдение. Если ваши инструкции становятся большими, используйте правила с ограничением по пути, чтобы инструкции загружались только когда Claude работает с соответствующими файлами. Вы также можете разделить содержимое на импорты для организации, хотя импортированные файлы всё равно загружаются и входят в context window при запуске.

Структура: используйте заголовки markdown и маркеры для группировки связанных инструкций. Claude сканирует структуру так же, как читатели: организованные разделы легче следовать, чем плотные абзацы.

Конкретность: пишите инструкции, которые достаточно конкретны для проверки. Например:

"Используйте отступ из 2 пробелов" вместо "Правильно форматируйте код"
"Запустите npm test перед фиксацией" вместо "Протестируйте ваши изменения"
"Обработчики API находятся в src/api/handlers/" вместо "Держите файлы организованными"

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

Импортируйте дополнительные файлы

Файлы CLAUDE.md могут импортировать дополнительные файлы, используя синтаксис @path/to/import. Импортированные файлы расширяются и загружаются в контекст при запуске вместе с CLAUDE.md, который их ссылается.

Допускаются как относительные, так и абсолютные пути. Относительные пути разрешаются относительно файла, содержащего импорт, а не рабочего каталога. Импортированные файлы могут рекурсивно импортировать другие файлы с максимальной глубиной четыре перехода.

Анализ импорта пропускает диапазоны кода Markdown и блоки кода с ограждением. Чтобы упомянуть путь в вашем CLAUDE.md без его импорта, оберните его в обратные кавычки: написание `@README` сохраняет текст буквальным, в то время как @README вне обратных кавычек импортирует файл.

Чтобы подтянуть README, package.json и руководство рабочего процесса, ссылайтесь на них с помощью синтаксиса @ в любом месте вашего CLAUDE.md:

Смотрите @README для обзора проекта и @package.json для доступных команд npm для этого проекта.

# Дополнительные инструкции
- git workflow @docs/git-instructions.md

Для личных предпочтений проекта, которые не должны попадать в систему контроля версий, создайте CLAUDE.local.md в корне проекта. Он загружается вместе с CLAUDE.md и рассматривается так же. Добавьте CLAUDE.local.md в ваш .gitignore, чтобы он не был зафиксирован. С установленным CLAUDE_CODE_NEW_INIT=1 запуск /init и выбор личного варианта делает это за вас.

Если вы работаете в нескольких git worktrees одного репозитория, игнорируемый git CLAUDE.local.md существует только в worktree, где вы его создали. Чтобы поделиться личными инструкциями между worktrees, импортируйте файл из вашего домашнего каталога вместо этого:

# Личные предпочтения
- @~/.claude/my-project-instructions.md

Warning

Импорт в файл памяти на уровне проекта является внешним, когда его путь разрешается вне вашего рабочего каталога, как импорт домашнего каталога выше. В первый раз, когда Claude Code встречает внешние импорты в проекте, он показывает диалог одобрения со списком файлов. Если вы отклоните, импорты остаются отключёнными и диалог больше не появляется.

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

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

AGENTS.md

Claude Code читает CLAUDE.md, не AGENTS.md. Если ваш репозиторий уже использует AGENTS.md для других кодирующих агентов, создайте CLAUDE.md, который импортирует его, чтобы оба инструмента читали одни и те же инструкции без их дублирования. Вы также можете добавить инструкции, специфичные для Claude, ниже импорта. Claude загружает импортированный файл при запуске сеанса, затем добавляет остальное:

@AGENTS.md

## Claude Code

Используйте plan mode для изменений в `src/billing/`.

Symlink также работает, если вам не нужно добавлять содержимое, специфичное для Claude:

ln -s AGENTS.md CLAUDE.md

Команда не выводит никакого вывода при успехе. В вашем следующем сеансе запустите /context и подтвердите, что CLAUDE.md появляется в разделе Memory files.

На Windows создание symlink требует привилегий администратора или режима разработчика, поэтому используйте импорт @AGENTS.md вместо этого.

Запуск /init читает правила Cursor в .cursor/rules/ или .cursorrules, и правила Copilot в .github/copilot-instructions.md, и включает соответствующие части в созданный CLAUDE.md. С установленным CLAUDE_CODE_NEW_INIT=1 /init также читает AGENTS.md, .devin/rules/, .windsurf/rules/ или .windsurfrules, и .clinerules.

Вы также можете запустить /import для переноса конфигурации поддерживаемого кодирующего агента в Claude Code, который добавляет одноразовую копию файлов инструкций, таких как AGENTS.md, к соответствующему CLAUDE.md и переносит MCP серверы, команды, subagents и skills. Требует Claude Code v2.1.213 или позже.

Как загружаются файлы CLAUDE.md

Claude Code загружает CLAUDE.md и CLAUDE.local.md из вашего текущего рабочего каталога и каждого каталога выше него. Запустите Claude Code в foo/bar/ и он загружает инструкции из foo/bar/CLAUDE.md, foo/CLAUDE.md и любых файлов CLAUDE.local.md рядом с ними.

Все обнаруженные файлы объединяются в контекст, а не переопределяют друг друга. Во всём дереве каталогов содержимое упорядочивается от корня файловой системы вниз к вашему рабочему каталогу. Для примера foo/bar/ foo/CLAUDE.md появляется в контексте перед foo/bar/CLAUDE.md, поэтому инструкции ближе к месту запуска Claude читаются последними. В каждом каталоге CLAUDE.local.md добавляется после CLAUDE.md, поэтому ваши личные заметки — это последнее, что Claude читает на этом уровне.

Claude также обнаруживает файлы CLAUDE.md и CLAUDE.local.md в подкаталогах под вашим текущим рабочим каталогом. Вместо загрузки при запуске они включаются, когда Claude читает файлы в этих подкаталогах.

Если вы работаете в большом монорепозитории, где подбираются файлы CLAUDE.md других команд, используйте claudeMdExcludes для их пропуска. Для полного макета корневых и каталог-специфичных файлов CLAUDE.md и правил см. Монорепозитории и большие репозитории.

Блочные HTML-комментарии () в файлах CLAUDE.md удаляются перед внедрением содержимого в контекст Claude. Используйте их для оставления заметок для человеческих разработчиков без траты токенов контекста на них. Комментарии внутри блоков кода сохраняются. Когда вы открываете файл CLAUDE.md напрямую с помощью инструмента Read, комментарии остаются видимыми.

Загрузка из дополнительных каталогов

Флаг --add-dir дает Claude доступ к дополнительным каталогам вне вашего основного рабочего каталога. По умолчанию файлы CLAUDE.md из этих каталогов не загружаются.

Чтобы также загружать файлы памяти из дополнительных каталогов, установите переменную окружения CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD:

CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1 claude --add-dir ../shared-config

Это загружает CLAUDE.md, .claude/CLAUDE.md, .claude/rules/*.md и CLAUDE.local.md из дополнительного каталога. CLAUDE.local.md пропускается, если вы исключите local из --setting-sources.

Организуйте правила с помощью `.claude/rules/`

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

Установите правила

Поместите файлы markdown в каталог .claude/rules/ вашего проекта. Каждый файл должен охватывать одну тему с описательным именем файла, например testing.md или api-design.md. Все файлы .md обнаруживаются рекурсивно, поэтому вы можете организовать правила в подкаталоги, такие как frontend/ или backend/:

your-project/
├── .claude/
│   ├── CLAUDE.md           # Основные инструкции проекта
│   └── rules/
│       ├── code-style.md   # Рекомендации по стилю кода
│       ├── testing.md      # Соглашения тестирования
│       └── security.md     # Требования безопасности

Правила без frontmatter paths загружаются при запуске с тем же приоритетом, что и .claude/CLAUDE.md.

Правила проекта пропускаются, если вы исключите project из --setting-sources. До версии 2.1.211 правила, которые загружаются по требованию, включая правила с ограничением по пути и правила в вложенных каталогах .claude/rules/, загружались даже когда project был исключён.

Правила, специфичные для пути

Правила могут быть ограничены определёнными файлами с помощью YAML frontmatter с полем paths. Эти условные правила применяются только когда Claude работает с файлами, соответствующими указанным шаблонам.

---
paths:
  - "src/api/**/*.ts"
---

# Правила разработки API

- Все конечные точки API должны включать проверку входных данных
- Используйте стандартный формат ответа об ошибке
- Включите комментарии документации OpenAPI

Правила без поля paths загружаются безусловно и применяются ко всем файлам. Правила с ограничением по пути срабатывают, когда Claude читает файлы, соответствующие шаблону, а не при каждом использовании инструмента. Начиная с версии 2.1.198, сопоставление также работает, когда Claude достигает файла через символическую ссылку на каталог проекта, например в символически связанном checkout.

Используйте glob-шаблоны в поле paths для сопоставления файлов по расширению, каталогу или любой комбинации:

Шаблон	Соответствует
`*/.ts`	Все файлы TypeScript в любом каталоге
`src/*/`	Все файлы в каталоге `src/`
`*.md`	Файлы Markdown в корне проекта
`src/components/*.tsx`	Компоненты React в определённом каталоге

Вы можете указать несколько шаблонов и использовать расширение скобок для сопоставления нескольких расширений в одном шаблоне:

---
paths:
  - "src/**/*.{ts,tsx}"
  - "lib/**/*.ts"
  - "tests/**/*.test.ts"
---

Каждая группа скобок умножает количество развёрнутых шаблонов: src/*.{ts,tsx} развёртывается в два шаблона, а {a,b}/{c,d}/*.{ts,tsx} в восемь. Чтобы сохранить расширение ограниченным, весь список paths правила использует один бюджет из 1000 развёрнутых шаблонов и 4 МиБ, и шаблоны без скобок не учитываются в нём.

Claude Code использует любой шаблон, который превысит бюджет без развёртывания, и его буквальные скобки не соответствуют никаким файлам. До версии 2.1.217 значение paths со многими группами скобок зависало или вызывало сбой CLI при запуске.

Синтаксис Glob рассматривает [ как начало выражения в скобках, такого как [abc]. Шаблон с [, который не может быть прочитан как выражение в скобках, такой как photos [2024/**, является недействительным: он ничему не соответствует, и другие шаблоны правила продолжают работать. Чтобы сопоставить буквальный [ в имени файла, экранируйте его как photos \[2024/**. До версии 2.1.207 один недействительный шаблон приводил к сбою инструмента Read для каждого файла, для которого оценивалось правило, вместо того чтобы ничему не соответствовать.

Каталог .claude/rules/ поддерживает symlinks, поэтому вы можете поддерживать общий набор правил и связывать их с несколькими проектами. Symlinks разрешаются и загружаются нормально, а циклические symlinks обнаруживаются и обрабатываются корректно.

Этот пример связывает как общий каталог, так и отдельный файл:

ln -s ~/shared-claude-rules .claude/rules/shared
ln -s ~/company-standards/security.md .claude/rules/security.md

Правила на уровне пользователя

Личные правила в ~/.claude/rules/ применяются к каждому проекту на вашей машине. Используйте их для предпочтений, которые не зависят от проекта:

~/.claude/rules/
├── preferences.md    # Ваши личные предпочтения кодирования
└── workflows.md      # Ваши предпочтительные рабочие процессы

Правила на уровне пользователя загружаются перед правилами проекта, что даёт правилам проекта более высокий приоритет.

Управляйте CLAUDE.md для больших команд

Для организаций, развёртывающих Claude Code в командах, вы можете централизовать инструкции и контролировать, какие файлы CLAUDE.md загружаются.

Развёртывание CLAUDE.md на уровне организации

Организации могут развернуть централизованно управляемый CLAUDE.md, который применяется ко всем пользователям на машине. Этот файл не может быть исключён индивидуальными настройками.

Создайте файл в местоположении управляемой политики

macOS: /Library/Application Support/ClaudeCode/CLAUDE.md
Linux и WSL: /etc/claude-code/CLAUDE.md
Windows: C:\Program Files\ClaudeCode\CLAUDE.md

Развёртывание с помощью вашей системы управления конфигурацией

Используйте MDM, Group Policy, Ansible или аналогичные инструменты для распределения файла на машины разработчиков. Подробнее см. в разделе управляемые настройки для других параметров конфигурации на уровне организации.

Ключ claudeMd позволяет вам поместить содержимое управляемого CLAUDE.md непосредственно внутри managed-settings.json вместо развёртывания отдельного файла.

Область действия: каждый сеанс Claude Code на машине, в каждом репозитории. Для руководства, специфичного для репозитория, вместо этого зафиксируйте CLAUDE.md проекта.

Приоритет: такой же, как у файла управляемого CLAUDE.md. Загружается перед пользовательским и проектным CLAUDE.md.

Где это соблюдается: только управляемые и политические настройки. Установка claudeMd в пользовательских, проектных или локальных настройках не имеет эффекта.

Пример ниже добавляет поведенческие инструкции непосредственно в файл управляемых настроек:

{
  "claudeMd": "Always run `make lint` before committing.\nNever push directly to main."
}

Управляемый CLAUDE.md и управляемые настройки служат разным целям. Используйте настройки для технического принуждения и CLAUDE.md для поведенческого руководства:

Проблема	Настроить в
Блокировать определённые инструменты, команды или пути файлов	Управляемые настройки: `permissions.deny`
Принудительная изоляция sandbox	Управляемые настройки: `sandbox.enabled`
Переменные окружения и маршрутизация поставщика API	Управляемые настройки: `env`
Метод аутентификации и блокировка организации	Управляемые настройки: `forceLoginMethod`, `forceLoginOrgUUID`
Рекомендации по стилю кода и качеству	Управляемый CLAUDE.md
Напоминания об обработке данных и соответствии	Управляемый CLAUDE.md
Поведенческие инструкции для Claude	Управляемый CLAUDE.md

Правила настроек принудительно применяются клиентом независимо от того, что решит делать Claude. Инструкции CLAUDE.md формируют поведение Claude, но не являются жёстким уровнем принуждения.

Исключите определённые файлы CLAUDE.md

В больших монорепозиториях файлы CLAUDE.md предков могут содержать инструкции, которые не имеют отношения к вашей работе. Параметр claudeMdExcludes позволяет пропустить определённые файлы по пути или glob-шаблону.

Этот пример исключает CLAUDE.md верхнего уровня и каталог правил из родительской папки. Добавьте его в .claude/settings.local.json, чтобы исключение оставалось локальным для вашей машины:

{
  "claudeMdExcludes": [
    "**/monorepo/CLAUDE.md",
    "/home/user/monorepo/other-team/.claude/rules/**"
  ]
}

Шаблоны сопоставляются с абсолютными путями файлов с использованием синтаксиса glob. Вы можете настроить claudeMdExcludes на любом уровне настроек: пользователь, проект, локальный или управляемая политика. Массивы объединяются между уровнями.

Чтобы исключить файл правила, который вы достигаете через symlink, будь то файл или его каталог является ссылкой, напишите шаблон для любого пути: пути файла в .claude/rules/ или его цели ссылки. Шаблон, который соответствует любому пути, исключает файл. До версии 2.1.239 только шаблон, который соответствовал цели ссылки, исключал файл.

Файлы CLAUDE.md управляемой политики не могут быть исключены. Это гарантирует, что инструкции на уровне организации всегда применяются независимо от индивидуальных настроек.

Auto memory

Auto memory позволяет Claude накапливать знания между сеансами без вашего участия. По мере работы Claude сохраняет четыре вида заметок для себя. Claude записывает вид как поле type в frontmatter файла памяти:

user: ваша роль, опыт и предпочтения в работе
feedback: исправления, которые вы даёте Claude, и подходы, которые вы подтверждаете
project: текущая работа, сроки и решения, которые Claude не может вывести из кода или истории git
reference: где найти информацию вне проекта, например трекер проблем или панель управления

Claude пропускает всё, что он может вывести из кодовой базы, такое как архитектура, пути файлов или исправления отладки. Он также пропускает всё, что уже говорят ваши файлы CLAUDE.md.

Claude не сохраняет что-то каждый сеанс. Он решает, что стоит помнить, на основе того, будет ли информация полезна в будущем разговоре.

Включите или отключите auto memory

Auto memory включена по умолчанию. Чтобы переключить её, откройте /memory в сеансе и используйте переключатель auto memory, который сохраняет autoMemoryEnabled в ваши пользовательские настройки в ~/.claude/settings.json. Чтобы отключить её для одного проекта, установите autoMemoryEnabled в настройках этого проекта:

{
  "autoMemoryEnabled": false
}

Чтобы отключить auto memory через переменную окружения, установите CLAUDE_CODE_DISABLE_AUTO_MEMORY=1.

Местоположение хранилища

Каждый проект получает свой собственный каталог памяти в ~/.claude/projects/<project>/memory/. Путь <project> получается из репозитория git, поэтому все worktrees и подкаталоги в одном репозитории используют один каталог auto memory. Вне репозитория git вместо этого используется корень проекта.

Если вы установите CLAUDE_CODE_PROJECT_DIR_NAME рядом с CLAUDE_CONFIG_DIR, Claude Code использует это имя как каталог <project> под <config dir>/projects/ независимо от того, в каком репозитории вы его запустите, поэтому проекты, запущенные с этим каталогом конфигурации, используют один каталог auto memory. Требуется Claude Code v2.1.234 или позже.

Чтобы сохранить auto memory в другом местоположении, установите autoMemoryDirectory в вашем settings.json. Он читается из любой области настроек: пользователя, проекта, локальной, политики или --settings.

{
  "autoMemoryDirectory": "~/my-custom-memory-dir"
}

Значение должно быть абсолютным путём или начинаться с ~/. Когда вы установите его в .claude/settings.json или .claude/settings.local.json проекта, Claude Code соблюдает его в соответствии с тем же правилом доверия рабочей области, что и hooks в файлах настроек.

Каталог содержит индекс MEMORY.md и один файл по теме на память:

~/.claude/projects/<project>/memory/
├── MEMORY.md           # Индекс, одна строка на память, загружается в каждый сеанс
├── user_role.md        # Одна память
├── feedback_testing.md # Одна память
└── ...                 # Любые другие файлы по темам, которые создаёт Claude

MEMORY.md служит индексом каталога памяти. Claude читает и пишет файлы в этом каталоге на протяжении вашего сеанса, используя MEMORY.md для отслеживания того, что хранится где.

Auto memory зависит от машины. Все worktrees и подкаталоги в одном репозитории git используют один каталог auto memory. Файлы не общие между машинами или облачными окружениями.

Claude Code удаляет старые стенограммы сеансов после периода хранения cleanupPeriodDays, но исключает файлы памяти в каталоге памяти из этого периода хранения. MEMORY.md и файлы по темам остаются до тех пор, пока вы или Claude не отредактируете или не удалите их.

Как это работает

Первые 200 строк MEMORY.md, или первые 25KB, в зависимости от того, что наступит раньше, загружаются в начале каждого разговора. Содержимое после этого порога не загружается при запуске сеанса. Claude держит MEMORY.md лаконичным, перемещая подробные заметки в отдельные файлы по темам.

После того как Claude пишет в MEMORY.md, Claude Code измеряет файл в соответствии с ограничениями чтения в 200 строк и 25KB. Если файл близок к ограничению, Claude Code напоминает Claude сократить его: оставить одну строку на запись, переместить детали в файлы по темам и объединить или удалить устаревшие записи. Если файл превышает ограничение, запись всё ещё успешна, но Claude Code возвращает ошибку, указывающую Claude переписать индекс, потому что всё после ограничения отбрасывается при следующей загрузке.

Это ограничение применяется только к MEMORY.md. Claude Code загружает файл CLAUDE.md размером до 4 MiB полностью и пропускает больший файл. Более короткие файлы дают лучшее соблюдение.

Claude Code не загружает файлы по темам, такие как user_role.md или feedback_testing.md, при запуске. Claude читает их по требованию, используя свои стандартные инструменты файлов, когда ему нужна информация.

Память auto memory основного разговора не загружается в подагентов; исключением является fork, который наследует родительский разговор и системный prompt. Собственная auto memory подагента, включённая с полем memory подагента, — это отдельный каталог.

Claude читает и пишет файлы памяти во время вашего сеанса. Когда вы видите сообщения вроде "Saved 2 memories" или "Recalled 2 memories" в интерфейсе Claude Code, Claude активно обновляет или читает из ~/.claude/projects/<project>/memory/.

Когда Claude пишет файл памяти, который начинается с YAML frontmatter, Claude Code записывает время записи в поле modified frontmatter как временную метку ISO 8601. Временная метка показывает, насколько актуален факт, как для вас, так и для Claude, когда он читает память обратно. Любой файл, который имеет frontmatter, получает это поле при следующей записи Claude, включая файлы, созданные в более ранних версиях; Claude Code никогда не добавляет frontmatter к файлу, который его не имеет. Поле modified требует Claude Code v2.1.214 или позже.

Проверьте и отредактируйте вашу память

Файлы auto memory — это простой markdown, который вы можете редактировать или удалять в любое время. Запустите /memory для просмотра и открытия файлов памяти из сеанса.

Просмотр и редактирование с помощью `/memory`

Команда /memory перечисляет ваши файлы CLAUDE.md, CLAUDE.local.md и другие файлы памяти в разных областях пользователя и проекта, включая записи CLAUDE.md пользователя и проекта для файлов, которые еще не существуют. Она также позволяет переключать auto memory включена или отключена и предоставляет опцию для открытия папки auto memory. Выберите любой файл для открытия его в вашем редакторе; выбор файла, который еще не существует, сначала создает его. Чтобы проверить, какие файлы фактически загружены в текущий сеанс, запустите /context.

Графические редакторы, такие как VS Code, открывают файл в отдельном окне, и вы можете продолжать использовать сеанс, пока он открыт. До версии 2.1.216 /memory ждал, пока вы закроете файл, прежде чем ответить. Редакторы терминала, такие как Vim, захватывают терминал, пока вы не выйдете.

Когда вы просите Claude что-то запомнить, например "всегда используйте pnpm, а не npm" или "помните, что тесты API требуют локального экземпляра Redis", Claude сохраняет это в auto memory. Чтобы добавить инструкции в CLAUDE.md, попросите Claude напрямую, например "добавьте это в CLAUDE.md", или отредактируйте файл самостоятельно через /memory.

Устранение неполадок с памятью

Это наиболее распространённые проблемы с CLAUDE.md и auto memory, а также шаги для их отладки.

Claude не следует моему CLAUDE.md

Содержимое CLAUDE.md доставляется как пользовательское сообщение после системного запроса, а не как часть самого системного запроса. Claude читает его и пытается следовать ему, но нет гарантии строгого соответствия, особенно для расплывчатых или конфликтующих инструкций.

Для отладки:

Запустите /context и проверьте список под Memory files, чтобы убедиться, что ваши файлы CLAUDE.md и CLAUDE.local.md загружены. Если файл отсутствует там, Claude не может его видеть. Используйте /memory для открытия и редактирования файлов.
Проверьте, что соответствующий CLAUDE.md находится в местоположении, которое загружается для вашего сеанса (см. Выберите, где разместить файлы CLAUDE.md).
Сделайте инструкции более конкретными. "Используйте отступ из 2 пробелов" работает лучше, чем "красиво форматируйте код".
Ищите конфликтующие инструкции в файлах CLAUDE.md. Если два файла дают разные рекомендации для одного поведения, Claude может выбрать одну произвольно.

Если инструкция — это что-то, что должно выполняться в определённый момент, например перед каждым коммитом или после каждого редактирования файла, напишите её как hook. Hooks выполняются как команды shell в фиксированных событиях жизненного цикла и применяются независимо от того, что решит сделать Claude.

Для инструкций, которые вы хотите на уровне системного запроса, используйте --append-system-prompt. Вы передаёте это при запуске, поэтому оно лучше подходит для скриптов и автоматизации, чем для интерактивного использования. О том, как оно ведёт себя при возобновлении разговора, см. System prompt flags in resumed conversations.

Я не знаю, что сохранила auto memory

Запустите /memory и выберите папку auto memory для просмотра того, что Claude сохранил. Всё это простой markdown, который вы можете читать, редактировать или удалять.

Мой CLAUDE.md слишком большой

Файлы более 200 строк потребляют больше контекста и могут снизить соблюдение. Claude Code пропускает файл размером более 4 MiB. Используйте path-scoped rules для загрузки инструкций только когда Claude работает с соответствующими файлами, или сократите содержимое, которое не требуется в каждом сеансе. Разделение на @path imports помогает организации, но не снижает контекст, так как импортированные файлы загружаются при запуске.

Проверка /doctor предлагает сокращения для проверенного CLAUDE.md: она удаляет содержимое, которое Claude может вывести из кодовой базы, такое как макеты каталогов, списки зависимостей и обзоры архитектуры, и сохраняет подводные камни, обоснование и соглашения, которые отличаются от стандартных инструментов. Проверка сокращения требует Claude Code v2.1.206 или более поздней версии.

Инструкции кажутся потерянными после `/compact`

CLAUDE.md в корне проекта выживает при сжатии: после /compact Claude повторно читает его с диска и повторно вводит его в сеанс. Вложенные файлы CLAUDE.md в подкаталогах и правила с paths: frontmatter перезагружаются по мере того, как Claude читает файлы, к которым они применяются.

Если инструкция исчезла после сжатия, она была дана только в разговоре, находится в вложенном CLAUDE.md, который ещё не перезагрузился, или является правилом с областью действия пути, которое не совпадало с файлом с момента сжатия. Добавьте инструкции только для разговора в CLAUDE.md, чтобы они сохранялись. Полный список см. в разделе What survives compaction.

Подробнее см. в разделе Write effective instructions для рекомендаций по размеру, структуре и конкретности.

Отладка вашей конфигурации: диагностируйте, почему CLAUDE.md или настройки не вступают в силу
Skills: упакуйте повторяемые рабочие процессы, которые загружаются по требованию
Settings: настройте поведение Claude Code с помощью файлов настроек
Subagent memory: позвольте subagents поддерживать собственную auto memory

memory.md +65 −30

25Claude Code имеет две дополняющие друг друга системы памяти. Обе загружаются в начале каждого разговора. Claude рассматривает их как контекст, а не как принудительную конфигурацию. Чтобы заблокировать действие независимо от того, что решит Claude, используйте [PreToolUse hook](/docs/ru/hooks-guide) вместо этого. Чем более конкретны и лаконичны ваши инструкции, тем последовательнее Claude их соблюдает.25Claude Code имеет две дополняющие друг друга системы памяти. Обе загружаются в начале каждого разговора. Claude рассматривает их как контекст, а не как принудительную конфигурацию. Чтобы заблокировать действие независимо от того, что решит Claude, используйте [PreToolUse hook](/docs/ru/hooks-guide) вместо этого. Чем более конкретны и лаконичны ваши инструкции, тем последовательнее Claude их соблюдает.

26 26

27| | Файлы CLAUDE.md | Auto memory |27| | Файлы CLAUDE.md | Auto memory |

~~28| :------------------- | :----------------------------------------------------------- | :---------------------------------------------------------------- |~~28| :------------------- | :----------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------- |

29| **Кто это пишет** | Вы | Claude |29| **Кто это пишет** | Вы | Claude |

34 34

35Используйте файлы CLAUDE.md, когда вы хотите направить поведение Claude. Auto memory позволяет Claude учиться на ваших исправлениях без ручных усилий.35Используйте файлы CLAUDE.md, когда вы хотите направить поведение Claude. Auto memory позволяет Claude учиться на ваших исправлениях без ручных усилий.

36 36

76 Установите CLAUDE.md проекта76 Установите CLAUDE.md проекта

77</h3>77</h3>

78 78

79CLAUDE.md проекта может быть сохранён либо в `./CLAUDE.md`, либо в `./.claude/CLAUDE.md`. Создайте этот файл и добавьте инструкции, которые применяются к любому, кто работает над проектом: команды сборки и тестирования, стандарты кодирования, архитектурные решения, соглашения об именовании и общие рабочие процессы. Эти инструкции общие для вашей команды через систему контроля версий, поэтому сосредоточьтесь на стандартах уровня проекта, а не на личных предпочтениях.79CLAUDE.md проекта может быть сохранён либо в `./CLAUDE.md`, либо в `./.claude/CLAUDE.md`. Создайте этот файл и добавьте инструкции, которые применяются к любому, кто работает над проектом: команды сборки и тестирования, стандарты кодирования, архитектурные решения, соглашения об именовании и общие рабочие процессы. Эти инструкции общие для вашей команды через систему контроля версий, поэтому сосредоточьтесь на стандартах уровня проекта, а не на личных предпочтениях. Чтобы подтвердить загрузку файла, запустите `/context` в сеансе и проверьте список в разделе **Memory files**.

80 80

81<Tip>81<Tip>

82 Запустите `/init` для автоматического создания начального CLAUDE.md. Claude анализирует вашу кодовую базу и создаёт файл с командами сборки, инструкциями тестирования и соглашениями проекта, которые он обнаруживает. Если CLAUDE.md уже существует, `/init` предлагает улучшения вместо перезаписи. Уточните оттуда с помощью инструкций, которые Claude не смог бы обнаружить самостоятельно.82 Запустите `/init` для автоматического создания начального CLAUDE.md. Claude анализирует вашу кодовую базу и создаёт файл с командами сборки, инструкциями тестирования и соглашениями проекта, которые он обнаруживает. Если CLAUDE.md уже существует, `/init` предлагает улучшения вместо перезаписи. Уточните оттуда с помощью инструкций, которые Claude не смог бы обнаружить самостоятельно.

121- git workflow @docs/git-instructions.md121- git workflow @docs/git-instructions.md

122```122```

123 123

124Для личных предпочтений, которые не должны быть проверены в систему контроля версий, создайте `CLAUDE.local.md` в корне проекта. Он загружается вместе с `CLAUDE.md` и рассматривается так же. Добавьте `CLAUDE.local.md` в ваш `.gitignore`, чтобы он не был зафиксирован; запуск `/init` и выбор личного варианта делает это за вас.124Для личных предпочтений проекта, которые не должны попадать в систему контроля версий, создайте `CLAUDE.local.md` в корне проекта. Он загружается вместе с `CLAUDE.md` и рассматривается так же. Добавьте `CLAUDE.local.md` в ваш `.gitignore`, чтобы он не был зафиксирован. С установленным `CLAUDE_CODE_NEW_INIT=1` запуск `/init` и выбор личного варианта делает это за вас.

125 125

126Если вы работаете в нескольких git worktrees одного репозитория, игнорируемый git `CLAUDE.local.md` существует только в worktree, где вы его создали. Чтобы поделиться личными инструкциями между worktrees, импортируйте файл из вашего домашнего каталога вместо этого:126Если вы работаете в нескольких git worktrees одного репозитория, игнорируемый git `CLAUDE.local.md` существует только в worktree, где вы его создали. Чтобы поделиться личными инструкциями между worktrees, импортируйте файл из вашего домашнего каталога вместо этого:

127 127

131```131```

132 132

133<Warning>133<Warning>

134 В первый раз, когда Claude Code встречает внешние импорты в проекте, он показывает диалог одобрения со списком файлов. Если вы отклоните, импорты остаются отключёнными и диалог больше не появляется.134 Импорт в файл памяти на уровне проекта является внешним, когда его путь разрешается вне вашего рабочего каталога, как импорт домашнего каталога выше. В первый раз, когда Claude Code встречает внешние импорты в проекте, он показывает диалог одобрения со списком файлов. Если вы отклоните, импорты остаются отключёнными и диалог больше не появляется.

135</Warning>135

136 Claude Code показывает диалог для защиты вас от файлов, которые другие люди фиксируют в общем проекте. Файлы памяти на уровне пользователя, такие как `~/.claude/CLAUDE.md` и `~/.claude/rules/`, — это файлы, которые вы написали сами. За исключением сеансов [Cowork](https://claude.com/product/cowork) на вашем рабочем столе, Claude Code загружает их импорты без диалога и доверяет им как остальной вашей личной конфигурации.

136 137

137Для более структурированного подхода к организации инструкций см. [`.claude/rules/`](#organize-rules-with-claude/rules/).138 В сеансах Cowork на вашем рабочем столе Claude Code пропускает любой импорт в файле на уровне пользователя, который разрешается к пути вне рабочего каталога сеанса, и загружает остальную часть файла. В этих сеансах он также пропускает `~/.claude/CLAUDE.md`, который сам является символической ссылкой или жёсткой ссылкой, и символически связанный каталог `~/.claude/rules/` или файл правила, который указывает вне рабочего каталога.

139</Warning>

138 140

139<h3 id="agents-md">141<h3 id="agents-md">

140 AGENTS.md142 AGENTS.md

156ln -s AGENTS.md CLAUDE.md158ln -s AGENTS.md CLAUDE.md

157```159```

158 160

161Команда не выводит никакого вывода при успехе. В вашем следующем сеансе запустите `/context` и подтвердите, что `CLAUDE.md` появляется в разделе **Memory files**.

162

159На Windows создание symlink требует привилегий администратора или режима разработчика, поэтому используйте импорт `@AGENTS.md` вместо этого.163На Windows создание symlink требует привилегий администратора или режима разработчика, поэтому используйте импорт `@AGENTS.md` вместо этого.

160 164

161Запуск [`/init`](/docs/ru/commands) в репозитории, который уже имеет `AGENTS.md`, читает его и включает соответствующие части в созданный `CLAUDE.md`. Он также читает другие конфигурации инструментов, такие как `.cursorrules`, `.devin/rules/` и `.windsurfrules`.165Запуск [`/init`](/docs/ru/commands) читает правила Cursor в `.cursor/rules/` или `.cursorrules`, и правила Copilot в `.github/copilot-instructions.md`, и включает соответствующие части в созданный `CLAUDE.md`. С установленным `CLAUDE_CODE_NEW_INIT=1` `/init` также читает `AGENTS.md`, `.devin/rules/`, `.windsurf/rules/` или `.windsurfrules`, и `.clinerules`.

166

167Вы также можете запустить [`/import`](/docs/ru/commands) для переноса конфигурации поддерживаемого кодирующего агента в Claude Code, который добавляет одноразовую копию файлов инструкций, таких как `AGENTS.md`, к соответствующему `CLAUDE.md` и переносит MCP серверы, команды, subagents и skills. Требует Claude Code v2.1.213 или позже.

162 168

163<h3 id="how-claude-md-files-load">169<h3 id="how-claude-md-files-load">

164 Как загружаются файлы CLAUDE.md170 Как загружаются файлы CLAUDE.md

165</h3>171</h3>

166 172

167Claude Code читает файлы CLAUDE.md, проходя вверх по дереву каталогов из вашего текущего рабочего каталога, проверяя каждый каталог на пути для файлов `CLAUDE.md` и `CLAUDE.local.md`. Это означает, что если вы запустите Claude Code в `foo/bar/`, он загружает инструкции из `foo/bar/CLAUDE.md`, `foo/CLAUDE.md` и любых файлов `CLAUDE.local.md` рядом с ними.173Claude Code загружает `CLAUDE.md` и `CLAUDE.local.md` из вашего текущего рабочего каталога и каждого каталога выше него. Запустите Claude Code в `foo/bar/` и он загружает инструкции из `foo/bar/CLAUDE.md`, `foo/CLAUDE.md` и любых файлов `CLAUDE.local.md` рядом с ними.

168 174

169Все обнаруженные файлы объединяются в контекст, а не переопределяют друг друга. Во всём дереве каталогов содержимое упорядочивается от корня файловой системы вниз к вашему рабочему каталогу. Для примера `foo/bar/` `foo/CLAUDE.md` появляется в контексте перед `foo/bar/CLAUDE.md`, поэтому инструкции ближе к месту запуска Claude читаются последними. В каждом каталоге `CLAUDE.local.md` добавляется после `CLAUDE.md`, поэтому ваши личные заметки — это последнее, что Claude читает на этом уровне.175Все обнаруженные файлы объединяются в контекст, а не переопределяют друг друга. Во всём дереве каталогов содержимое упорядочивается от корня файловой системы вниз к вашему рабочему каталогу. Для примера `foo/bar/` `foo/CLAUDE.md` появляется в контексте перед `foo/bar/CLAUDE.md`, поэтому инструкции ближе к месту запуска Claude читаются последними. В каждом каталоге `CLAUDE.local.md` добавляется после `CLAUDE.md`, поэтому ваши личные заметки — это последнее, что Claude читает на этом уровне.

170 176

216 222

217Правила без [frontmatter `paths`](#path-specific-rules) загружаются при запуске с тем же приоритетом, что и `.claude/CLAUDE.md`.223Правила без [frontmatter `paths`](#path-specific-rules) загружаются при запуске с тем же приоритетом, что и `.claude/CLAUDE.md`.

218 224

225Правила проекта пропускаются, если вы исключите `project` из [`--setting-sources`](/docs/ru/cli-reference). До версии 2.1.211 правила, которые загружаются по требованию, включая правила с ограничением по пути и правила в вложенных каталогах `.claude/rules/`, загружались даже когда `project` был исключён.

226

219<h4 id="path-specific-rules">227<h4 id="path-specific-rules">

220 Правила, специфичные для пути228 Правила, специфичные для пути

221</h4>229</h4>

257---265---

258```266```

259 267

268Каждая группа скобок умножает количество развёрнутых шаблонов: `src/*.{ts,tsx}` развёртывается в два шаблона, а `{a,b}/{c,d}/*.{ts,tsx}` в восемь. Чтобы сохранить расширение ограниченным, весь список `paths` правила использует один бюджет из 1000 развёрнутых шаблонов и 4 МиБ, и шаблоны без скобок не учитываются в нём.

269

270Claude Code использует любой шаблон, который превысит бюджет без развёртывания, и его буквальные скобки не соответствуют никаким файлам. До версии 2.1.217 значение `paths` со многими группами скобок зависало или вызывало сбой CLI при запуске.

271

260Синтаксис Glob рассматривает `[` как начало выражения в скобках, такого как `[abc]`. Шаблон с `[`, который не может быть прочитан как выражение в скобках, такой как `photos [2024/**`, является недействительным: он ничему не соответствует, и другие шаблоны правила продолжают работать. Чтобы сопоставить буквальный `[` в имени файла, экранируйте его как `photos \[2024/**`. До версии 2.1.207 один недействительный шаблон приводил к сбою инструмента Read для каждого файла, для которого оценивалось правило, вместо того чтобы ничему не соответствовать.272Синтаксис Glob рассматривает `[` как начало выражения в скобках, такого как `[abc]`. Шаблон с `[`, который не может быть прочитан как выражение в скобках, такой как `photos [2024/**`, является недействительным: он ничему не соответствует, и другие шаблоны правила продолжают работать. Чтобы сопоставить буквальный `[` в имени файла, экранируйте его как `photos \[2024/**`. До версии 2.1.207 один недействительный шаблон приводил к сбою инструмента Read для каждого файла, для которого оценивалось правило, вместо того чтобы ничему не соответствовать.

261 273

262<h4 id="share-rules-across-projects-with-symlinks">274<h4 id="share-rules-across-projects-with-symlinks">

306 </Step>318 </Step>

307 319

308 <Step title="Развёртывание с помощью вашей системы управления конфигурацией">320 <Step title="Развёртывание с помощью вашей системы управления конфигурацией">

309 Используйте MDM, Group Policy, Ansible или аналогичные инструменты для распределения файла на машины разработчиков. Подробнее см. в разделе [управляемые настройки](/docs/ru/permissions#managed-settings) для других параметров конфигурации на уровне организации.321 Используйте MDM, Group Policy, Ansible или аналогичные инструменты для распределения файла на машины разработчиков. Подробнее см. в разделе [управляемые настройки](/docs/ru/managed-settings) для других параметров конфигурации на уровне организации.

310 </Step>322 </Step>

311</Steps>323</Steps>

312 324

326}338}

327```339```

328 340

329Управляемый CLAUDE.md и [управляемые настройки](/docs/ru/settings#settings-files) служат разным целям. Используйте настройки для технического принуждения и CLAUDE.md для поведенческого руководства:341Управляемый CLAUDE.md и [управляемые настройки](/docs/ru/managed-settings) служат разным целям. Используйте настройки для технического принуждения и CLAUDE.md для поведенческого руководства:

330 342

331| Проблема | Настроить в |343| Проблема | Настроить в |

332| :------------------------------------------------------------ | :------------------------------------------------------------- |344| :------------------------------------------------------------ | :------------------------------------------------------------- |

357}369}

358```370```

359 371

360Шаблоны сопоставляются с абсолютными путями файлов с использованием синтаксиса glob. Вы можете настроить `claudeMdExcludes` на любом [уровне настроек](/docs/ru/settings#settings-files): пользователь, проект, локальный или управляемая политика. Массивы объединяются между уровнями.372Шаблоны сопоставляются с абсолютными путями файлов с использованием синтаксиса glob. Вы можете настроить `claudeMdExcludes` на любом [уровне настроек](/docs/ru/settings#where-settings-live): пользователь, проект, локальный или управляемая политика. Массивы объединяются между уровнями.

373

374Чтобы исключить файл правила, который вы достигаете через [symlink](#share-rules-across-projects-with-symlinks), будь то файл или его каталог является ссылкой, напишите шаблон для любого пути: пути файла в `.claude/rules/` или его цели ссылки. Шаблон, который соответствует любому пути, исключает файл. До версии 2.1.239 только шаблон, который соответствовал цели ссылки, исключал файл.

361 375

362Файлы CLAUDE.md управляемой политики не могут быть исключены. Это гарантирует, что инструкции на уровне организации всегда применяются независимо от индивидуальных настроек.376Файлы CLAUDE.md управляемой политики не могут быть исключены. Это гарантирует, что инструкции на уровне организации всегда применяются независимо от индивидуальных настроек.

363 377

365 Auto memory379 Auto memory

366</h2>380</h2>

367 381

368Auto memory позволяет Claude накапливать знания между сеансами без вашего участия. Claude сохраняет заметки для себя по мере работы: команды сборки, инсайты отладки, заметки об архитектуре, предпочтения стиля кода и привычки рабочего процесса. Claude не сохраняет что-то каждый сеанс. Он решает, что стоит помнить, на основе того, будет ли информация полезна в будущем разговоре.382Auto memory позволяет Claude накапливать знания между сеансами без вашего участия. По мере работы Claude сохраняет четыре вида заметок для себя. Claude записывает вид как поле `type` в frontmatter файла памяти:

383

384* `user`: ваша роль, опыт и предпочтения в работе

385* `feedback`: исправления, которые вы даёте Claude, и подходы, которые вы подтверждаете

386* `project`: текущая работа, сроки и решения, которые Claude не может вывести из кода или истории git

387* `reference`: где найти информацию вне проекта, например трекер проблем или панель управления

388

389Claude пропускает всё, что он может вывести из кодовой базы, такое как архитектура, пути файлов или исправления отладки. Он также пропускает всё, что уже говорят ваши файлы CLAUDE.md.

390

391Claude не сохраняет что-то каждый сеанс. Он решает, что стоит помнить, на основе того, будет ли информация полезна в будущем разговоре.

369 392

370<h3 id="enable-or-disable-auto-memory">393<h3 id="enable-or-disable-auto-memory">

371 Включите или отключите auto memory394 Включите или отключите auto memory

372</h3>395</h3>

373 396

374Auto memory включена по умолчанию. Чтобы переключить её, откройте `/memory` в сеансе и используйте переключатель auto memory, или установите `autoMemoryEnabled` в настройках вашего проекта:397Auto memory включена по умолчанию. Чтобы переключить её, откройте `/memory` в сеансе и используйте переключатель auto memory, который сохраняет `autoMemoryEnabled` в ваши пользовательские настройки в `~/.claude/settings.json`. Чтобы отключить её для одного проекта, установите `autoMemoryEnabled` в настройках этого проекта:

375 398

376```json theme={null}399```json theme={null}

377{400{

387 410

388Каждый проект получает свой собственный каталог памяти в `~/.claude/projects/<project>/memory/`. Путь `<project>` получается из репозитория git, поэтому все worktrees и подкаталоги в одном репозитории используют один каталог auto memory. Вне репозитория git вместо этого используется корень проекта.411Каждый проект получает свой собственный каталог памяти в `~/.claude/projects/<project>/memory/`. Путь `<project>` получается из репозитория git, поэтому все worktrees и подкаталоги в одном репозитории используют один каталог auto memory. Вне репозитория git вместо этого используется корень проекта.

389 412

413Если вы установите [`CLAUDE_CODE_PROJECT_DIR_NAME`](/docs/ru/sessions#name-the-project-directory-yourself) рядом с `CLAUDE_CONFIG_DIR`, Claude Code использует это имя как каталог `<project>` под `<config dir>/projects/` независимо от того, в каком репозитории вы его запустите, поэтому проекты, запущенные с этим каталогом конфигурации, используют один каталог auto memory. Требуется Claude Code v2.1.234 или позже.

414

390Чтобы сохранить auto memory в другом местоположении, установите `autoMemoryDirectory` в вашем `settings.json`. Он читается из любой [области настроек](/docs/ru/settings#settings-precedence): пользователя, проекта, локальной, политики или `--settings`.415Чтобы сохранить auto memory в другом местоположении, установите `autoMemoryDirectory` в вашем `settings.json`. Он читается из любой [области настроек](/docs/ru/settings#settings-precedence): пользователя, проекта, локальной, политики или `--settings`.

391 416

392```json theme={null}417```json theme={null}

395}420}

396```421```

397 422

398Значение должно быть абсолютным путём или начинаться с `~/`. Когда установлено в `.claude/settings.json` или `.claude/settings.local.json` проекта, значение учитывается только после того, как вы примете диалог доверия рабочей области для этой папки, то же самое ограничение, которое управляет hooks.423Значение должно быть абсолютным путём или начинаться с `~/`. Когда вы установите его в `.claude/settings.json` или `.claude/settings.local.json` проекта, Claude Code соблюдает его в соответствии с тем же [правилом доверия рабочей области, что и hooks в файлах настроек](/docs/ru/permissions#what-runs-before-you-trust-a-folder).

399 424

400Каталог содержит точку входа `MEMORY.md` и дополнительные файлы по темам:425Каталог содержит индекс `MEMORY.md` и один файл по теме на память:

401 426

402```text theme={null}427```text theme={null}

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

404├── MEMORY.md # Краткий индекс, загружается в каждый сеанс429├── MEMORY.md # Индекс, одна строка на память, загружается в каждый сеанс

405├── debugging.md # Подробные заметки о шаблонах отладки430├── user_role.md # Одна память

406├── api-conventions.md # Решения по проектированию API431├── feedback_testing.md # Одна память

407└── ... # Любые другие файлы по темам, которые создаёт Claude432└── ... # Любые другие файлы по темам, которые создаёт Claude

408```433```

409 434

411 436

412Auto memory зависит от машины. Все worktrees и подкаталоги в одном репозитории git используют один каталог auto memory. Файлы не общие между машинами или облачными окружениями.437Auto memory зависит от машины. Все worktrees и подкаталоги в одном репозитории git используют один каталог auto memory. Файлы не общие между машинами или облачными окружениями.

413 438

439Claude Code удаляет старые стенограммы сеансов после периода хранения [`cleanupPeriodDays`](/docs/ru/settings-reference#cleanupperioddays), но исключает файлы памяти в каталоге памяти из этого [периода хранения](/docs/ru/claude-directory#cleaned-up-automatically). `MEMORY.md` и файлы по темам остаются до тех пор, пока вы или Claude не отредактируете или не удалите их.

440

414<h3 id="how-it-works">441<h3 id="how-it-works">

415 Как это работает442 Как это работает

416</h3>443</h3>

417 444

418Первые 200 строк `MEMORY.md`, или первые 25KB, в зависимости от того, что наступит раньше, загружаются в начале каждого разговора. Содержимое после этого порога не загружается при запуске сеанса. Claude держит `MEMORY.md` лаконичным, перемещая подробные заметки в отдельные файлы по темам.445Первые 200 строк `MEMORY.md`, или первые 25KB, в зависимости от того, что наступит раньше, загружаются в начале каждого разговора. Содержимое после этого порога не загружается при запуске сеанса. Claude держит `MEMORY.md` лаконичным, перемещая подробные заметки в отдельные файлы по темам.

419 446

420Это ограничение применяется только к `MEMORY.md`. Файлы CLAUDE.md загружаются полностью независимо от длины, хотя более короткие файлы дают лучшее соблюдение.447После того как Claude пишет в `MEMORY.md`, Claude Code измеряет файл в соответствии с ограничениями чтения в 200 строк и 25KB. Если файл близок к ограничению, Claude Code напоминает Claude сократить его: оставить одну строку на запись, переместить детали в файлы по темам и объединить или удалить устаревшие записи. Если файл превышает ограничение, запись всё ещё успешна, но Claude Code возвращает [ошибку, указывающую Claude переписать индекс](/docs/ru/errors#memory-index-is-over-its-read-limit), потому что всё после ограничения отбрасывается при следующей загрузке.

421 448

422Файлы по темам, такие как `debugging.md` или `patterns.md`, не загружаются при запуске. Claude читает их по требованию, используя свои стандартные инструменты файлов, когда ему нужна информация.449Это ограничение применяется только к `MEMORY.md`. Claude Code загружает файл CLAUDE.md размером до 4 MiB полностью и пропускает больший файл. Более короткие файлы дают лучшее соблюдение.

423 450

424Claude читает и пишет файлы памяти во время вашего сеанса. Когда вы видите "Writing memory" или "Recalled memory" в интерфейсе Claude Code, Claude активно обновляет или читает из `~/.claude/projects/<project>/memory/`.451Claude Code не загружает файлы по темам, такие как `user_role.md` или `feedback_testing.md`, при запуске. Claude читает их по требованию, используя свои стандартные инструменты файлов, когда ему нужна информация.

452

453Память auto memory основного разговора не загружается в [подагентов](/docs/ru/sub-agents#what-loads-at-startup); исключением является [fork](/docs/ru/sub-agents#fork-the-current-conversation), который наследует родительский разговор и системный prompt. Собственная auto memory подагента, включённая с полем `memory` подагента, — это отдельный каталог.

454

455Claude читает и пишет файлы памяти во время вашего сеанса. Когда вы видите сообщения вроде "Saved 2 memories" или "Recalled 2 memories" в интерфейсе Claude Code, Claude активно обновляет или читает из `~/.claude/projects/<project>/memory/`.

456

457Когда Claude пишет файл памяти, который начинается с YAML frontmatter, Claude Code записывает время записи в поле `modified` frontmatter как временную метку ISO 8601. Временная метка показывает, насколько актуален факт, как для вас, так и для Claude, когда он читает память обратно. Любой файл, который имеет frontmatter, получает это поле при следующей записи Claude, включая файлы, созданные в более ранних версиях; Claude Code никогда не добавляет frontmatter к файлу, который его не имеет. Поле `modified` требует Claude Code v2.1.214 или позже.

425 458

426<h3 id="audit-and-edit-your-memory">459<h3 id="audit-and-edit-your-memory">

427 Проверьте и отредактируйте вашу память460 Проверьте и отредактируйте вашу память

433 Просмотр и редактирование с помощью `/memory`466 Просмотр и редактирование с помощью `/memory`

434</h2>467</h2>

435 468

436Команда `/memory` перечисляет все файлы CLAUDE.md, CLAUDE.local.md и правила, загруженные в вашем текущем сеансе, позволяет переключать auto memory включена или отключена, и предоставляет ссылку для открытия папки auto memory. Выберите любой файл для открытия его в вашем редакторе.469Команда `/memory` перечисляет ваши файлы CLAUDE.md, CLAUDE.local.md и другие файлы памяти в разных областях пользователя и проекта, включая записи CLAUDE.md пользователя и проекта для файлов, которые еще не существуют. Она также позволяет переключать auto memory включена или отключена и предоставляет опцию для открытия папки auto memory. Выберите любой файл для открытия его в вашем редакторе; выбор файла, который еще не существует, сначала создает его. Чтобы проверить, какие файлы фактически загружены в текущий сеанс, запустите `/context`.

470

471Графические редакторы, такие как VS Code, открывают файл в отдельном окне, и вы можете продолжать использовать сеанс, пока он открыт. До версии 2.1.216 `/memory` ждал, пока вы закроете файл, прежде чем ответить. Редакторы терминала, такие как Vim, захватывают терминал, пока вы не выйдете.

437 472

438Когда вы просите Claude что-то запомнить, например "всегда используйте pnpm, а не npm" или "помните, что тесты API требуют локального экземпляра Redis", Claude сохраняет это в auto memory. Чтобы добавить инструкции в CLAUDE.md, попросите Claude напрямую, например "добавьте это в CLAUDE.md", или отредактируйте файл самостоятельно через `/memory`.473Когда вы просите Claude что-то запомнить, например "всегда используйте pnpm, а не npm" или "помните, что тесты API требуют локального экземпляра Redis", Claude сохраняет это в auto memory. Чтобы добавить инструкции в CLAUDE.md, попросите Claude напрямую, например "добавьте это в CLAUDE.md", или отредактируйте файл самостоятельно через `/memory`.

439 474

451 486

452Для отладки:487Для отладки:

453 488

454* Запустите `/memory` для проверки загрузки ваших файлов CLAUDE.md и CLAUDE.local.md. Если файл не указан, Claude не может его видеть.489* Запустите `/context` и проверьте список под **Memory files**, чтобы убедиться, что ваши файлы CLAUDE.md и CLAUDE.local.md загружены. Если файл отсутствует там, Claude не может его видеть. Используйте `/memory` для открытия и редактирования файлов.

455* Проверьте, что соответствующий CLAUDE.md находится в местоположении, которое загружается для вашего сеанса (см. [Выберите, где разместить файлы CLAUDE.md](#choose-where-to-put-claude-md-files)).490* Проверьте, что соответствующий CLAUDE.md находится в местоположении, которое загружается для вашего сеанса (см. [Выберите, где разместить файлы CLAUDE.md](#choose-where-to-put-claude-md-files)).

456* Сделайте инструкции более конкретными. "Используйте отступ из 2 пробелов" работает лучше, чем "красиво форматируйте код".491* Сделайте инструкции более конкретными. "Используйте отступ из 2 пробелов" работает лучше, чем "красиво форматируйте код".

457* Ищите конфликтующие инструкции в файлах CLAUDE.md. Если два файла дают разные рекомендации для одного поведения, Claude может выбрать одну произвольно.492* Ищите конфликтующие инструкции в файлах CLAUDE.md. Если два файла дают разные рекомендации для одного поведения, Claude может выбрать одну произвольно.

458 493

459Если инструкция — это что-то, что должно выполняться в определённый момент, например перед каждым коммитом или после каждого редактирования файла, напишите её как [hook](/docs/ru/hooks-guide). Hooks выполняются как команды shell в фиксированных событиях жизненного цикла и применяются независимо от того, что решит сделать Claude.494Если инструкция — это что-то, что должно выполняться в определённый момент, например перед каждым коммитом или после каждого редактирования файла, напишите её как [hook](/docs/ru/hooks-guide). Hooks выполняются как команды shell в фиксированных событиях жизненного цикла и применяются независимо от того, что решит сделать Claude.

460 495

461Для инструкций, которые вы хотите на уровне системного запроса, используйте [`--append-system-prompt`](/docs/ru/cli-reference#system-prompt-flags). Это должно быть передано при каждом вызове, поэтому оно лучше подходит для скриптов и автоматизации, чем для интерактивного использования.496Для инструкций, которые вы хотите на уровне системного запроса, используйте [`--append-system-prompt`](/docs/ru/cli-reference#system-prompt-flags). Вы передаёте это при запуске, поэтому оно лучше подходит для скриптов и автоматизации, чем для интерактивного использования. О том, как оно ведёт себя при возобновлении разговора, см. [System prompt flags in resumed conversations](/docs/ru/cli-reference#system-prompt-flags-in-resumed-conversations).

462 497

463<Tip>498<Tip>

464 Используйте hook [`InstructionsLoaded`](/docs/ru/hooks#instructionsloaded) для логирования точно того, какие файлы инструкций загружены, когда они загружаются и почему. Это полезно для отладки правил, специфичных для пути, или ленивых загруженных файлов в подкаталогах.499 Используйте hook [`InstructionsLoaded`](/docs/ru/hooks#instructionsloaded) для логирования точно того, какие файлы инструкций загружены, когда они загружаются и почему. Это полезно для отладки правил, специфичных для пути, или ленивых загруженных файлов в подкаталогах.

474 Мой CLAUDE.md слишком большой509 Мой CLAUDE.md слишком большой

475</h3>510</h3>

476 511

477Файлы более 200 строк потребляют больше контекста и могут снизить соблюдение. Используйте [правила с областью действия пути](#path-specific-rules) для загрузки инструкций только когда Claude работает с соответствующими файлами, или сократите содержимое, которое не требуется в каждом сеансе. Разделение на [`@path` импорты](#import-additional-files) помогает организации, но не снижает контекст, так как импортированные файлы загружаются при запуске.512Файлы более 200 строк потребляют больше контекста и могут снизить соблюдение. Claude Code пропускает файл размером более 4 MiB. Используйте [path-scoped rules](#path-specific-rules) для загрузки инструкций только когда Claude работает с соответствующими файлами, или сократите содержимое, которое не требуется в каждом сеансе. Разделение на [`@path` imports](#import-additional-files) помогает организации, но не снижает контекст, так как импортированные файлы загружаются при запуске.

478 513

479Проверка [`/doctor`](/docs/ru/commands#all-commands) предлагает сокращения для проверенного CLAUDE.md: она удаляет содержимое, которое Claude может вывести из кодовой базы, такое как макеты каталогов, списки зависимостей и обзоры архитектуры, и сохраняет подводные камни, обоснование и соглашения, которые отличаются от стандартных инструментов. Проверка сокращения требует Claude Code v2.1.206 или более поздней версии.514Проверка [`/doctor`](/docs/ru/commands#all-commands) предлагает сокращения для проверенного CLAUDE.md: она удаляет содержимое, которое Claude может вывести из кодовой базы, такое как макеты каталогов, списки зависимостей и обзоры архитектуры, и сохраняет подводные камни, обоснование и соглашения, которые отличаются от стандартных инструментов. Проверка сокращения требует Claude Code v2.1.206 или более поздней версии.

480 515

482 Инструкции кажутся потерянными после `/compact`517 Инструкции кажутся потерянными после `/compact`

483</h3>518</h3>

484 519

485CLAUDE.md в корне проекта выживает при сжатии: после `/compact` Claude повторно читает его с диска и повторно вводит его в сеанс. Вложенные файлы CLAUDE.md в подкаталогах не повторно вводятся автоматически; они перезагружаются в следующий раз, когда Claude читает файл в этом подкаталоге.520CLAUDE.md в корне проекта выживает при сжатии: после `/compact` Claude повторно читает его с диска и повторно вводит его в сеанс. Вложенные файлы CLAUDE.md в подкаталогах и правила с [`paths:` frontmatter](#path-specific-rules) перезагружаются по мере того, как Claude читает файлы, к которым они применяются.

486 521

487Если инструкция исчезла после сжатия, она была дана только в разговоре или находится в вложенном CLAUDE.md, который ещё не перезагрузился. Добавьте инструкции только для разговора в CLAUDE.md, чтобы они сохранялись. Полный список см. в разделе [Что выживает при сжатии](/docs/ru/context-window#what-survives-compaction).522Если инструкция исчезла после сжатия, она была дана только в разговоре, находится в вложенном CLAUDE.md, который ещё не перезагрузился, или является правилом с областью действия пути, которое не совпадало с файлом с момента сжатия. Добавьте инструкции только для разговора в CLAUDE.md, чтобы они сохранялись. Полный список см. в разделе [What survives compaction](/docs/ru/context-window#what-survives-compaction).

488 523

489Подробнее см. в разделе [Пишите эффективные инструкции](#write-effective-instructions) для рекомендаций по размеру, структуре и конкретности.524Подробнее см. в разделе [Write effective instructions](#write-effective-instructions) для рекомендаций по размеру, структуре и конкретности.

490 525

491<h2 id="related-resources">526<h2 id="related-resources">

492 Связанные ресурсы527 Связанные ресурсы

memory.md 2026-09-09 22:58 UTC to 2026-09-10 23:00 UTC

Как Claude запоминает ваш проект

CLAUDE.md и auto memory

Файлы CLAUDE.md

Когда добавлять в CLAUDE.md

Выберите, где разместить файлы CLAUDE.md

Установите CLAUDE.md проекта

Пишите эффективные инструкции

Импортируйте дополнительные файлы

AGENTS.md

Как загружаются файлы CLAUDE.md

Загрузка из дополнительных каталогов

Организуйте правила с помощью `.claude/rules/`

Установите правила

Правила, специфичные для пути

Делитесь правилами между проектами с помощью symlinks

Правила на уровне пользователя

Управляйте CLAUDE.md для больших команд

Развёртывание CLAUDE.md на уровне организации

Создайте файл в местоположении управляемой политики

Развёртывание с помощью вашей системы управления конфигурацией

Исключите определённые файлы CLAUDE.md

Auto memory

Включите или отключите auto memory

Местоположение хранилища

Как это работает

Проверьте и отредактируйте вашу память

Просмотр и редактирование с помощью `/memory`

Устранение неполадок с памятью

Claude не следует моему CLAUDE.md

Я не знаю, что сохранила auto memory

Мой CLAUDE.md слишком большой

Инструкции кажутся потерянными после `/compact`

Связанные ресурсы