Как сохранить итоги работы в Claude Code: CLAUDE.md и session-wrap

Как связать итоги сессии с памятью проекта

Чтобы передать итоги работы следующей сессии Claude Code, подготовь инструкции проекта в CLAUDE.md, а многошаговую процедуру завершения вынеси в навык. Описанный в репозитории team-attention session-wrap запускает интерактивное подведение итогов командой /wrap.

Почему новый разговор требует контекста

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

Контекстом Anthropic называет набор токенов, включённых при генерации ответа языковой моделью. Для работы с проектом это полезное различие: значение имеет информация, которая передана модели к моменту ответа. Файл инструкций участвует в работе именно как часть такого контекста.

Чем автоматическая память отличается от инструкций

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

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

Где инструкции оказываются в разговоре

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

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

Подготовь CLAUDE.md и проверь его содержание

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

Как получить начальный черновик

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

1. Запусти /init для создания начального CLAUDE.md.
2. Проверь получившийся черновик.
3. Удали неточные сведения.
4. Закоммить проверенный файл.

Когда нужен интерактивный запуск

Для интерактивного многоэтапного варианта заранее задай переменной CLAUDE_CODE_NEW_INIT значение 1, затем запускай /init. Порядок здесь существенен: источник описывает настройку переменной до вызова команды. Сведения об этом варианте приведены на дату проверки, 10 октября 2026 года.

Почему рекомендации об автогенерации расходятся

HumanLayer рекомендует избегать автоматической генерации CLAUDE.md и тщательно продумывать его содержание. Это отличается от предложения документации начать с /init. При выборе подхода сохрани главное практическое требование официального руководства: сгенерированный черновик нужно просмотреть и очистить от неточностей.

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

Как выбрать механизм по задаче

Отбери инструкции, которые нужны проекту

По рекомендации документации на 10 октября 2026 года размер каждого CLAUDE.md должен быть менее 200 строк. Более длинные файлы расходуют больше контекста и ухудшают соблюдение инструкций. Это рекомендация по подготовке содержания, поэтому при редактировании оценивай и объём, и назначение записей.

Как формулировать требования понятнее

Anthropic рекомендует писать системные промпты предельно ясно, простым и прямым языком. В этой рекомендации важна сама форма требования: читателю инструкции должно быть понятно, какого поведения ожидают. Она относится к системным промптам; проектные файлы, как указано выше, передаются отдельно.

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

Что вынести из общего файла

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

• Перенеси многошаговую процедуру в навык либо правило с привязкой к пути.
• Храни инструкции для отдельных задач в отдельных Markdown-файлах с понятными названиями, как рекомендует HumanLayer.
• Используй ссылки вида file:line на первоисточник вместо копирования фрагментов кода, которые быстро устаревают.

Как не накопить противоречия

Если инструкции противоречат друг другу, Claude может выбрать одну произвольно. При добавлении итогов сессии проверь, согласуется ли новая формулировка с прежней. Обнаруженные файлы объединяются в контексте, поэтому рассчитывать на автоматическую замену прежнего требования новым файлом не стоит.

Для проверки и оформления кода HumanLayer рекомендует линтеры и форматтеры, при необходимости дополняя их хуками и командами. Это отдельная рекомендация о выборе инструмента: описание правил в памяти проекта не отменяет применение средств проверки и форматирования.

Раздели общие, личные и локальные правила

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

Куда записать личные предпочтения

Для личных настроек конкретного проекта, которые не должны попадать в систему контроля версий, документация предлагает CLAUDE.local.md в корне проекта. Добавление этого имени в.gitignore нужно, чтобы файл не попал в коммит. Здесь речь именно о личных предпочтениях проекта.

Как ограничить область действия правила

Правило можно привязать к конкретным файлам через поле paths в YAML-заголовке, то есть служебной части в начале файла. Если поля paths нет, правило загружается безусловно и применяется ко всем файлам. При разделении инструкций проверь наличие этого поля.

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

• Создай CLAUDE.local.md в корне проекта для личных настроек.
• Добавь CLAUDE.local.md в.gitignore.
• Укажи paths в YAML-заголовке правила, которое относится к конкретным файлам.

Почему дополнительный каталог не означает загрузку памяти

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

Подключи дополнительные файлы без ошибок импорта

CLAUDE.md поддерживает импорт дополнительных файлов через синтаксис @path/to/import. Импорт помогает организовать содержание, когда инструкции распределены по файлам. Однако это способ подключения материалов, а не сокращения объёма загружаемого контекста.

Откуда отсчитывается путь

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

1. Укажи импортируемый файл через @path/to/import.
2. Проверь относительный путь от файла с импортом.
3. Поставь обратную косую черту перед каждым пробелом в пути.

Какие ограничения действуют для записи пути

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

На дату проверки, 10 октября 2026 года, рекурсивный импорт ограничен глубиной в четыре перехода. Рекурсивность здесь означает, что импортированный файл может импортировать следующий. При организации цепочки подключений учитывай глубину, а не просто наличие нужного имени в одном из файлов.

Что меняют согласование и расход контекста

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

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

Подведи итоги через описанный session-wrap

В репозитории team-attention команда /wrap описана как интерактивное подведение итогов сессии и отмечена рекомендуемым вариантом. Ниже приведён порядок из этого описания. Он включает анализ, проверку, представление вариантов и выполнение выбранных действий.

Как выбрать форму команды

Для интерактивного завершения используй /wrap. У команды с сообщением другое заявленное назначение: /wrap [message] выполняет быстрый коммит с указанным сообщением. Выбирай форму по нужному результату: интерактивному подведению итогов либо быстрому коммиту.

Перед началом подведения итогов описание команды требует загрузить навык session-wrap с подробным процессом. Это подготовительное действие предшествует работе по процедуре. Само краткое описание команды отсылает к навыку за подробными указаниями.

В каком порядке проходит процедура

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

1. Проверь состояние git.
2. Запусти 4 аналитических агента параллельно на первой фазе.
3. Запусти агента проверки на второй фазе.
4. Объедини результаты после проверки.
5. Представь варианты действий.
6. Выполни выбранные действия.

Где результаты превращаются в действия

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

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

Выбери механизм под конкретную задачу

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

Когда нужен навык, а когда субагент

Навыки размещаются в.claude/skills/ как папки с инструкциями, скриптами и ресурсами. В каждом есть SKILL.md с названием, описанием и основным текстом. Это структура для оформления отдельной процедуры, которую Claude загружает динамически.

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

Субагент работает в собственном новом контекстном окне. В основную сессию возвращаются его финальное сообщение и метаданные. На дату проверки, 10 октября 2026 года, вложенность субагентов допускается до пяти уровней; это ограничение не определяет состав анализа в session-wrap.

При оценке результата субагента учитывай формат возврата: основная сессия получает итоговое сообщение и метаданные. Собственное контекстное окно субагента и сообщение, переданное обратно, выполняют разные роли. Это существенно для понимания процедуры, в которой после анализа результаты объединяются и проходят дальнейшую обработку.

Как технически запретить действие

Для блокировки независимо от решения Claude документация предлагает PreToolUse. Такой хук может проверить любой вызов инструмента и отклонить его кодом выхода 2. Если требуется именно отклонение вызова, ориентируйся на этот механизм, учитывая контекстный характер памяти.

• command входит в перечисленные типы хуков.
• HTTP входит в перечисленные типы хуков.
• mcp_tool входит в перечисленные типы хуков.
• prompt входит в перечисленные типы хуков.
• agent входит в перечисленные типы хуков.

Что меняют стиль вывода и дополнение промпта

Перечисленные хуки запускаются детерминированно, то есть их срабатывание задано механизмом запуска. Стили вывода решают другую задачу: файлы в.claude/output-styles/ добавляют инструкции в системный промпт. При выборе настройки различай запуск хука и изменение инструкций для ответа.

Изменение стиля вывода заменяет стандартный стиль, если в заголовке не указано keep-coding-instructions: true. Флаг дополнения системного промпта действует иначе: добавляет инструкции к исходному промпту и не меняет роль Claude. Учитывай это различие при настройке поведения.

Управляй контекстом во время длинной работы

Инженерия контекста, по Anthropic, представляет собой итеративный отбор информации: решать, что передать модели, приходится снова по ходу работы. Поэтому подготовка памяти проекта не заканчивается написанием исходного файла. Содержание нужно оценивать при дальнейшем выборе информации для модели.

Почему больше материалов не означает точнее

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

Исследование данных во время выполнения медленнее извлечения заранее подготовленных данных. Это различие помогает оценивать подготовку контекста: поиск в ходе задачи и обращение к подготовленным сведениям имеют разные затраты времени. Конкретные величины ускорения из этой рекомендации не следуют.

Что сохраняется при сжатии разговора

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

Для вызванных навыков действует другое условие: после сжатия они возвращаются в пределах общего бюджета. Если навыков было много, первыми исключаются самые старые. Учитывай это ограничение, когда длинная сессия включает последовательное обращение к разным процедурам.

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

Как подхватить правку памяти и сменить задачу

Если изменить CLAUDE.md посреди сессии, правка подхватывается после /compact, открытия через /memory либо в следующей сессии. Это даёт конкретные точки применения обновлений. При переходе к другой задаче руководство рекомендует /clear и новый разговор.

• Запусти /compact, чтобы подхватить изменение CLAUDE.md через сжатие.
• Открой файл через /memory как другой способ подхватить изменение.
• Запусти /clear при переходе к другой задаче.

Поставь следующую задачу с понятным результатом

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

Какие исходные данные передать

Если задача связана с ошибкой, руководство рекомендует вставить полный стек ошибки вместо пересказа. Для обращения к конкретному файлу используй @ перед путём, например @src/auth/login.ts. Это указание относится к ссылке на файл внутри запроса.

Критерии приёмки рекомендуется задавать заранее: по руководству, это эффективнее нескольких раундов исправлений. Сформулируй ожидаемые условия результата до выполнения задачи. Здесь важно отделить цель работы от того, по каким признакам ты будешь принимать получившееся изменение.

Как перейти от плана к выполнению

Для задач, затрагивающих больше пары файлов, предлагается перейти в режим планирования. На дату проверки, 10 октября 2026 года, описанный способ состоит в двойном нажатии Shift+Tab: первое нажатие включает acceptEdits, следующее переводит в планирование.

1. Нажми Shift+Tab дважды для перехода в режим планирования.
2. Просмотри предложенный план.
3. Скорректируй план в разговоре.
4. Переключи режим после проверки плана.
5. Попроси выполнить первый шаг.

Разберись, почему инструкции не сработали

Начни с проверки загрузки файла: запусти /context и посмотри список Memory files. Это подтверждает, что нужный файл попал в сессию. Затем отдельно оцени содержание, поскольку загруженные инструкции остаются контекстом, а не принудительно исполняемой конфигурацией.

Файл не виден или изменения не применились

Если проблема связана с дополнительным каталогом, вспомни ограничение --add-dir. Если с правкой посреди разговора, используй предусмотренные точки подхвата обновлений. Для импортов проверь отсчёт относительного пути и отсутствие кавычек: это отдельные причины несовпадения ожидаемого подключения с записью в файле.

Как найти устаревшие и спорные указания

Для поиска устаревших или противоречивых инструкций предусмотрена команда /doctor prompt-audit. На дату проверки, 10 октября 2026 года, для неё требуется Claude Code v2.1.283 или новее. Перед применением этого способа сопоставь требование с используемой версией.

Аудит выдаёт отчёт с предложенными правками. Файлы не меняются, пока пользователь не попросит применить изменения. Поэтому получение отчёта и исправление инструкций являются разными этапами: после чтения результатов можно отдельно запросить применение предложений.

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

1. Запусти /doctor prompt-audit в сессии.
2. Просмотри отчёт с предложенными правками.
3. Попроси применить нужные изменения.

Когда нужен другой механизм

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

Что сверить перед следующим завершением сессии

Версионные условия и ограничения в этом гайде приведены на 10 октября 2026 года. Перед применением аудита, рекурсивных импортов и вложенных субагентов сверь соответствующие разделы официальной документации Claude Code: здесь важны конкретная версия и пределы описанных механизмов.

Какие условия проверить по документации

Для session-wrap ориентируйся на описание команды в репозитории team-attention и подробный навык, который требуется загрузить перед процедурой. Различай интерактивный вызов и быстрый коммит с сообщением: у этих форм команды заявлены разные результаты.

• Проверь требование к версии для /doctor prompt-audit.
• Проверь ограничение глубины рекурсивных импортов.
• Проверь условия возврата вызванных навыков после сжатия.

Частые вопросы

Источники и проверка

• How Claude remembers your project - Claude Code Docs, code.claude.com (первоисточник). Прочитано 10 октября 2026.
• Steering Claude Code: when to use CLAUDE.md, skills, hooks, and subagents, claude.com (первоисточник). Прочитано 10 октября 2026.
• Effective context engineering for AI agents, anthropic.com (первоисточник). Прочитано 10 октября 2026.
• Give Claude context: CLAUDE.md and better prompts | Claude Help Center, support.claude.com (первоисточник). Прочитано 10 октября 2026.
• plugins-for-claude-natives/plugins/session-wrap/commands/wrap.md at main · team-attention/plugins-for-claude-natives, github.com (первоисточник). Прочитано 10 октября 2026.
• Writing a good CLAUDE.md, humanlayer.dev. Прочитано 10 октября 2026.

Подготовлено с помощью ИИ по первоисточникам и проверено автоматически: факты, числа и цитаты сверены с источниками. Человек статью перед выходом не читал. Если нашёл ошибку, напиши через контакты.