Контекст-инжиниринг в Claude Code: настрой и проверь за вечер

Что такое контекст-инжиниринг простыми словами

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

По объяснению Anthropic (инженерный блог, проверен живым запросом 05.09.2026), это работа над тем, чтобы модель видела только нужные и полезные куски текста, а не всё подряд. Отличие от привычного промпт-инжиниринга простое: промпт-инжиниринг - это одна удачная формулировка для одной задачи, а контекст-инжиниринг - это то, что происходит на каждом шаге долгого разговора с агентом вроде Claude Code, снова и снова. Если тебе ближе именно формулировка отдельного запроса, а не вся система вокруг него - семь рабочих формул точного запроса разобраны в отдельном гайде про промпт-инженера, эта статья решает соседнюю задачу

Заводить Claude Code для того, чтобы вообще было с чем настраивать контекст, - отдельный шаг: если инструмент ещё не установлен на компьютере, порядок действий из России есть в гайде про установку Claude Code

Здесь же в документации прямо названа причина, почему это вообще важно: «каждая сессия Claude Code начинается с чистого контекстного окна» - и дальше перечислены штатные механизмы, которые переносят знание между сессиями. Дальше в статье разберу эти механизмы и остальные источники, которые дополняют их внутри одной сессии

Шесть слоёв, из которых Claude Code собирает контекст

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

Слой 1. Системные инструкции - то, что не редактируешь напрямую

Это базовый набор правил поведения самого Claude Code, встроенный в продукт: как модель работает с инструментами, как форматирует ответы, как решает, когда спросить тебя, а когда действовать самой. По документации Anthropic (claude.com/blog, проверено живым запросом 05.09.2026) для нового поколения моделей Claude 5 - Opus 5, Sonnet 5, Fable 5 - Anthropic удалили больше 80% прежнего системного промпта Claude Code без потери качества на тестах программирования

Причина такой правки объясняется в самой статье просто: старые модели нуждались в жёстких запретах вроде «никогда не пиши многострочные докстринги», а новые модели способны сами подобрать уместный стиль кода, если им не мешать избыточными правилами. Для тебя как для пользователя это означает одну практическую вещь: слепо копировать длинные наборы «железных законов» в свой CLAUDE.md для новых моделей часто не усиливает результат, а иногда мешает модели пользоваться собственным здравым смыслом. Короче обычно лучше - это ровно тот случай. Как переписать конкретный промпт под эти шесть правил «тогда → сейчас» шаг за шагом - у меня отдельно разобрано в гайде про новые правила контекста: та статья учит переписывать сам текст запроса, а здесь я показываю карту слоёв, из которых запрос вообще собирается

Слой 2. CLAUDE.md - твои правила, которые сохраняются между сессиями

CLAUDE.md - это простой текстовый файл, куда ты записываешь то, что иначе объяснял бы Claude заново каждый раз: какой командой запускать тесты, в какой папке лежит код, каких соглашений придерживаться в проекте. По документации Claude Code (code.claude.com/docs/en/memory) файл читается в начале каждой сессии и живёт на нескольких уровнях сразу - персональный (~/.claude/CLAUDE.md, только на твоём компьютере), проектный (./CLAUDE.md, общий для всей команды) и локальный, который остаётся только у тебя и не попадает в общую папку проекта, если команда работает вместе через Git

Отдельный разбор этой части лежит в гайде 5 уровней автоматизации на Claude: собери МАШИНУ, которая работает за тебя

Вот как выглядит рабочий файл правил - пять строк, больше и не нужно:

Документация прямо советует держать файл компактным - до 200 строк, потому что более длинный файл потребляет больше контекста и хуже соблюдается моделью. Проверить, что файл вообще загрузился, можно командой /context внутри сессии Claude Code - она показывает список «Memory files», и если твоего CLAUDE.md там нет, значит он лежит не в той папке или превысил лимит размера

Про сам файл CLAUDE.md - скелет из шести блоков, как его завести с нуля и когда переносить правило в замок настроек - у меня отдельно разобрано в гайде про памятку CLAUDE.md: здесь я показываю только МЕСТО этого файла среди остальных источников контекста, а не повторяю его устройство

Слой 3. Структура проекта - что модель видит на диске

Помимо файла CLAUDE.md, Claude Code ориентируется на саму структуру папок и файлов проекта: имена, вложенность, README на видном месте. Это отдельный слой контекста - модель делает выводы не только из того, что ты написал явно, но и из того, как физически разложены файлы. Неаккуратная или запутанная структура заставляет модель тратить часть контекстного окна на угадывание того, что можно было бы сразу увидеть по имени папки

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

Слой 4. Память (auto memory) - заметки, которые Claude пишет сам

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

Технически это отдельная папка на диске с файлом-индексом MEMORY.md (загружаются первые 200 строк или 25 килобайт, что наступит раньше) и отдельными тематическими файлами внутри. Разница с CLAUDE.md принципиальная:

Термин «память» в узком смысле и разница между этими двумя механизмами подробно разобраны в глоссарии термина «память» - здесь достаточно понимать, что это отдельный источник контекста, а не единственный

Слой 5. Скиллы - инструкции, которые подгружаются только когда нужны

Пятый слой - это скиллы, отдельные пакеты инструкций для конкретных задач, которые Claude Code не держит в контексте постоянно, а подгружает по необходимости. По документации Anthropic это называется прогрессивным раскрытием (progressive disclosure): вместо того чтобы с самого начала разговора нести в контексте инструкции для всех возможных задач, модель узнаёт про конкретный скилл только тогда, когда задача этого требует

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

Сюда же рядом со скиллами относятся MCP-серверы - способ дать Claude Code доступ к внешним инструментам и данным без раздувания основного контекста постоянными инструкциями. Что это такое простыми словами и какие серверы уже готовы к подключению - в отдельном гайде про MCP

Слой 6. История сессии и компакция - как разговор сжимается, когда он растёт

Шестой слой - это сама переписка внутри текущего разговора, и отдельно то, что происходит, когда она становится слишком длинной. Модели теряют фокус по мере роста контекста - это явление называется в документации Anthropic «context rot» (буквально «гниение контекста»): чем больше токенов накоплено, тем труднее модели удерживать внимание равномерно на всех частях разговора, особенно на середине

Подробности собраны в соседней статье: Claude Code удаляет историю через 30 дней

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

Это же объясняет знакомую многим ситуацию, когда агент посреди долгой задачи вдруг теряет нить и говорит «готово», хотя доделано не всё: часть контекста, которая держала полную картину задачи, уже вымылась компакцией или context rot. Что делать в этот момент и как довести агента до реального завершения - в отдельном гайде

Что меняется в подходе с приходом моделей Claude 5

Смена поколения моделей - не абстрактная новость, а прямая причина пересмотреть то, что уже настроено в CLAUDE.md и скиллах. По документации Anthropic вот что именно поменялось местами:

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

Что происходит, если контекст не настроен вообще

Без осознанной настройки Claude Code всё равно как-то работает - модель не откажется отвечать. Разница проявляется не сразу, а на длинной дистанции: без CLAUDE.md модель заново узнаёт одни и те же правила проекта каждую сессию, без структуры папок тратит часть ответа на угадывание расположения файлов, без auto memory забывает вчерашние поправки, а без разумных скиллов и MCP держит в контексте инструкции, которые в 9 разговорах из 10 не нужны

Итог одинаковый во всех случаях: часть контекстного окна съедена не задачей, а восстановлением того, что могло бы быть настроено один раз. На длинной сессии это тот самый context rot, который разобран в слое истории и компакции выше - просто он наступает быстрее, если остальные пять слоёв не помогают модели, а мешают

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

Отдельно каждый из шести слоёв настроить несложно: завёл CLAUDE.md, разложил папки по смыслу, дал скиллам появиться по необходимости. Сложность в другом - слои должны СОГЛАСОВЫВАТЬСЯ друг с другом, а не спорить

Практический порядок настройки на новом проекте:

1. Начни со структуры папок, а не с файла CLAUDE.md - модель и так поймёт часть контекста по разумной организации файлов, и в CLAUDE.md не придётся дублировать очевидное. Как разложить папки - в отдельном гайде
2. Заведи короткий CLAUDE.md только с тем, что модель не смогла бы вывести сама из структуры: команды запуска, соглашения именования, редкие исключения из правил. Полный скелет памятки на шесть блоков - в гайде про CLAUDE.md
3. Дай auto memory собирать наблюдения самому - не пытайся вручную предугадать все твои будущие поправки, эта работа для памяти, а не для CLAUDE.md. Разница механизмов - в глоссарии
4. Не тащи в контекст всё сразу - если задача узкая и редкая, ей место в отдельном скилле с прогрессивной загрузкой, а не строчкой в постоянно висящем CLAUDE.md
5. Проверяй командой /context, что реально загрузилось, вместо того чтобы гадать по ощущению - список «Memory files» показывает правду, а не намерение

Последний пункт стоит разобрать отдельно: это единственная проверка, которая показывает, сработала настройка или нет

Что нажать. Набери в окне Claude Code команду /context и нажми Enter Что увидишь. Разбивку загруженного: системные инструкции, файлы памяти списком с путями, подключённые скиллы и сколько всего занято от общего окна Что это даёт. Ты видишь факт вместо намерения: если твой CLAUDE.md в списке не появился, значит он лежит не там, где модель его ищет, и все правила в нём не работают

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

Если видишь, что нужного файла нет в списке вовсе - проверь имя и место: файл правил проекта читается из корня проекта, личный - из домашней папки, и это разные слои

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

Где новичок обычно теряется

Что почитать рядом на сайте

• CLAUDE.md: памятка для ИИ, 4 прогона и замок на важное - полный скелет файла из шести блоков и когда чистить, если разросся
• Структура проекта для Claude Code: папки и файл CLAUDE.md - как физически разложить папки, чтобы Claude Code ориентировался
• Как экономить токены в Claude: рабочие приёмы и настройки - конкретный инструмент для среза лишнего текста, если тема в цене
• Память (memory) в Claude Code - глоссарий - точное определение термина и что писать в память, а что нет
• Как писать промпты для Claude 5: 6 правил вместо старых - переписка конкретного запроса под новые правила, шаг за шагом
• Claude промпт инженер: 7 формул точного запроса без воды - если нужна не карта системы, а формулы самого запроса
• Как сделать свой Skill в Claude за 5 шагов - живой прогон сборки собственного пятого слоя
• MCP сервер простыми словами: 12 готовых серверов на выбор - расширение контекста внешними инструментами без раздувания CLAUDE.md
• Claude Code установка из России - с чего начать, если инструмента ещё нет на компьютере
• Агент говорит «готово»: 4 шага, чтобы доделать до конца - что делать, если контекст вымылся посреди задачи
• Тема: Claude Code, все разборы - полный список гайдов по настройке инструмента

Источники

Документация и инженерный блог открыты живым запросом 5 сентября 2026 года без VPN и без входа в аккаунт; факты о моделях Claude 5 и изменениях системного промпта сняты напрямую со страниц Anthropic, а не переписаны из чужих обзоров

• Официальная документация Claude Code: How Claude remembers your project - устройство CLAUDE.md, auto memory, команда /context
• Инженерный блог Anthropic: The new rules of context engineering for Claude 5 generation models - удаление 80% системного промпта, смена подхода с правил на суждение модели
• Инженерный блог Anthropic: Effective context engineering for AI agents - базовая методология, компакция, structured note-taking, субагенты
• Официальная документация Claude Code: Skills - устройство скиллов и прогрессивная загрузка
• Официальная документация Claude Code: контекстное окно - что переживает компакцию, а что нет

Памятка: контекст-инжиниринг за 5 минут

Шесть строк, которые закрывают карту слоёв

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