CLAUDE.md после Opus 5: почему длинные инструкции теперь мешают Claude

Опубликовано 26.07.202615 мин чтенияСредний
Светящийся мозг ИИ завален длинным кодом, но сосредоточен на кратких, ярких символах.
Что узнаешь
  • Почему с Opus 5 длинный CLAUDE.md начинает вредить
  • Что оставить в CLAUDE.md, а что выкинуть - по пунктам
  • Как вынести правила в скиллы, чтобы не жечь контекст
  • Что такое автопамять Claude и как её включить
  • Готовый промпт, чтобы почистить свой CLAUDE.md за вечер
Применить за 20 мин
Сэкономит 3 ч
Средний
5просмотров
Что понадобится

Каждый день в Telegram-канале - что нового в вайб-кодинге: инструменты, примеры, ошибки. Подпишись, чтобы быть в курсе.

Что изменилось в Claude после выхода Opus 5?

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

Инженер Anthropic Thariq Shihipar написал разбор, который за день собрал сотни комментариев на профильных площадках. Главная мысль звучит так:

Мы убрали больше 80% системного промпта Claude Code - и не увидели заметного падения качества на задачах по коду. Мы слишком сильно ограничивали Claude.

- Thariq Shihipar, Anthropic, https://claude.com/blog/the-new-rules-of-context-engineering-for-claude-5-generation-models

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

Что это значит для тебя на практике:

  • Твой CLAUDE.md - это тот же системный промпт, только для твоего проекта. Если Anthropic урезала свой на 80 процентов, значит и твой, скорее всего, раздут.
  • Длинные списки правил больше не гарантия послушания. Наоборот, чем больше строк, тем хуже модель за ними следит (про это ниже, с цифрами из документации).
  • Появились новые механизмы - автопамять и скиллы, - которые берут на себя часть работы, которую раньше приходилось вручную прописывать в CLAUDE.md.

Я на записи практикумов давно повторяю одну мысль: главная работа делается до промпта - в том, что ты положил модели в контекст ещё до первого запроса. Обновление Opus 5 - это, по сути, официальное подтверждение той же идеи от самой Anthropic. Только теперь у неё есть конкретные цифры и новые инструменты. Дальше разберу каждый по очереди.

Почему длинный CLAUDE.md теперь мешает?

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

Документация Claude Code говорит про это без обиняков:

Держи файл в пределах 200 строк. Более длинные файлы потребляют больше контекста и снижают следование инструкциям.

- Документация Claude Code, https://code.claude.com/docs/en/memory

Второе тут важнее первого: длинные файлы снижают следование инструкциям. Модель начинает хуже слушаться. Это ловушка, в которую попадает почти каждый новичок. Логика кажется железной: хочу, чтобы Claude меня слушался - напишу побольше правил. А на деле выходит наоборот. Чем длиннее список, тем размытее внимание модели, и тем чаще она правило пропускает.

Вот как менялся подход:

Раньше (модели послабее)Сейчас (Opus 5 и 5-е поколение)
ЛогикаБольше правил - надёжнее результатМеньше правил - выше послушание
CLAUDE.mdДлинный список на все случаиКороткий: только то, что модель не угадает сама
ИнструкцииЖёсткие команды «делай так»Опора на суждение модели
Повторы правилПовторить для надёжностиПовтор только сбивает

Есть и вторая проблема - противоречия. Когда файл разрастается, в нём почти неизбежно появляются правила, которые конфликтуют между собой. В одном месте написано «всегда пиши тесты», в другом - «не трогай папку с тестами». Документация предупреждает: если два правила противоречат друг другу, Claude может выбрать любое из них наугад. То есть раздутый файл делает поведение модели менее предсказуемым.

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

Хочешь не просто почистить CLAUDE.md, а собрать связку, при которой Claude реже галлюцинирует и дольше держит нить? CLAUDE.md - лишь один кирпичик контекст-инжиниринга. На практикуме показываю всю систему целиком: как контекст-инжиниринг собирается со Вторым мозгом (структура папки business/) и с ИИ-клоном (твой ai-clone/). Это три кита, без которых любая модель, хоть Opus 5, хоть Fable, разваливается на длинной сессии.

Практикум по вайб-кодингу
+Твой второй мозг
3 вечера - инструменты, метод, первый проект
Набор открыт
Записаться →

Что оставить в CLAUDE.md, а что выкинуть?

Документация даёт понятный критерий, когда правило заслуживает места в CLAUDE.md. Добавляй его, если:

  1. Claude совершил одну и ту же ошибку второй раз.
  2. Проверка кода поймала то, что модель должна была знать про этот проект.
  3. Ты второй раз печатаешь в чат ту же поправку, что и в прошлый раз.
  4. Новому человеку в команде понадобился бы тот же контекст, чтобы не сломать проект.

Общий принцип - оставляй грабли проекта и выкидывай очевидное. У Claude Code даже есть встроенная проверка claude doctor, которая предлагает почистить раздутый CLAUDE.md. Она вырезает то, что модель и так может вывести из кодовой базы - структуру папок, список зависимостей, обзор архитектуры, - и оставляет подводные камни, обоснования и договорённости, которые отличаются от стандартных настроек.

Второе важное правило - конкретность. Размытые формулировки не работают. Сравни:

Размыто (мимо)Конкретно (в цель)
Форматируй код правильноСтавь отступ в 2 пробела
Тестируй измененияЗапускай npm test перед коммитом
Держи файлы в порядкеОбработчики API лежат в src/api/handlers/
Пиши хорошие сообщения коммитовСообщение коммита начинай с типа: fix:, feat:

Разница простая. «Форматируй правильно» модель может понять как угодно. «Отступ в 2 пробела» проверяется однозначно. Каждое правило в CLAUDE.md должно быть таким, чтобы его можно было проверить и увидеть - выполнено или нет.

И третье - выкидывай очевидное. Если ты пишешь в CLAUDE.md «пиши чистый код» или «следуй лучшим практикам» - это шум. Модель это и так знает, а строка занимает место и размывает внимание. Anthropic прямо советует не тратить контекст на очевидные вещи.

Совет

Быстрый тест на каждую строку CLAUDE.md: «Claude угадает это сам, если просто посмотрит на мой код?». Если да - удаляй. Оставляй только то, что нельзя вывести из самого проекта.

Куда убрать правила, которые не влезли в CLAUDE.md?

Вот здесь появляется самый недооценённый инструмент. Если раньше все инструкции надо было держать в CLAUDE.md, то теперь у длинных процедур есть отдельный дом - скиллы. Как выбрать нужные и не наставить лишнего, я разбирал в инструкции «Как выбрать скиллы Claude Code».

Разница принципиальная. CLAUDE.md загружается целиком в начале каждой сессии. Скилл - нет. Документация формулирует это так:

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

- Документация Claude Code, https://code.claude.com/docs/en/skills

Это называется progressive disclosure - «подгрузка по мере надобности». Смысл: подавать модели контекст порциями, в нужный момент. Anthropic перенесла свои детальные инструкции - например, по проверке кода - в скиллы и убрала их из системного промпта.

Критерий, когда пора выносить в скилл, простой: раздел CLAUDE.md перерос из факта в процедуру. Одна строка «сборка идёт через npm run build» - это факт, ему место в CLAUDE.md. А десять шагов «как мы публикуем проект» - это уже процедура, ей место в скилле.

Я эту мысль повторяю на эфирах своими словами: что делаешь больше пары раз - отдай системе. Один раз объяснил Claude, как ты собираешь, например, еженедельный отчёт для клиента, - оформил это скиллом, и дальше не объясняешь заново. Скилл лежит и ждёт, контекст не занимает, вызывается по имени командой вида /otchet.

Что удобно выносить в скиллы:

  • Многошаговые процедуры (публикация, сборка отчёта, проверка перед релизом).
  • Длинные инструкции, которые нужны редко, но целиком.
  • Всё, что ты копируешь из чата в чат по второму-третьему разу.

Есть и промежуточный вариант - правила с привязкой к папкам. Если инструкция важна только для одной части проекта, её можно положить в .claude/rules/ и привязать к нужным файлам. Тогда она подгрузится, только когда Claude работает именно с ними, и не висит в контексте всё остальное время.

Что такое автопамять и зачем она в 2026?

Второй новый механизм, который снимает нагрузку с CLAUDE.md, - это автопамять. Идея в том, что теперь Claude помнит не только то, что написал ты, но и то, что заметил сам. Чем эта память по механике отличается от CLAUDE.md, я разбирал в инструкции «Память Claude против CLAUDE.md».

Разница между двумя видами памяти:

CLAUDE.mdАвтопамять
Кто пишетТыClaude сам
Что внутриИнструкции и правилаНаходки и закономерности
Пример«Отступ 2 пробела»«Сборка падает, если не запустить Redis»
Когда обновляетсяТы правишь рукамиClaude по ходу работы

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

Заметки лежат в отдельной папке, у каждого проекта своей, с файлом-оглавлением MEMORY.md. Посмотреть и поправить их можно командой /memory - это обычные текстовые файлы, ты в любой момент можешь их прочитать, отредактировать или удалить.

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

Заметка

Автопамять включена по умолчанию, но живёт на твоём компьютере и не уезжает в облако. Если хочешь посмотреть, что Claude уже про твой проект запомнил, набери /memory в сессии - откроется папка с заметками.

Почему Opus 5 спорит с твоими инструкциями?

У этой медали есть обратная сторона, о которой честно предупреждают первые обзоры. Дэн Шиппер из издания Every, протестировав Opus 5 неделю, описал ощущение так:

Opus 5 - модель, которую трудно полюбить сразу.

- Дэн Шиппер, Every, https://every.to/vibe-check/opus-5

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

Что это значит для тебя, если ты обновился на Opus 5 и что-то пошло не так:

  1. Перепроверь старые скиллы и плагины. Заготовки, собранные под прошлые модели, могут конфликтовать с новой логикой. То, что раньше работало как часы, теперь стоит прогнать заново.
  2. Убери самые жёсткие формулировки. Команды в духе «никогда не делай X, всегда делай только Y» модель пятого поколения воспринимает хуже, чем гибкую формулировку с объяснением почему.
  3. Смотри, где модель останавливается раньше времени. Иногда это сигнал, что инструкция противоречит сама себе или упирается в правило из раздутого CLAUDE.md.

Как переписать CLAUDE.md под Opus 5: пошагово

Вот порядок, по которому я бы прошёлся по любому CLAUDE.md, доставшемуся с прошлых моделей.

  1. Прогони встроенную проверку

    Набери claude doctor в проекте - она сама предложит, что вырезать из раздутого файла и что оставить.
  2. Выкинь очевидное

    Удали все строки, которые Claude угадает по коду сам: структуру папок, список библиотек, общие фразы вроде «пиши чистый код».
  3. Убери противоречия

    Пройди файл сверху вниз и найди правила, которые спорят друг с другом. Оставь одно, конфликтующее удали.
  4. Вынеси процедуры в скиллы

    Всё, что превратилось из факта в пошаговую инструкцию, перенеси в отдельный скилл. В CLAUDE.md оставь одну строку-ссылку.
  5. Сделай оставшееся конкретным

    Каждое правило переформулируй так, чтобы его можно было проверить: «форматируй правильно» превращается в «отступ 2 пробела».
  6. Включи автопамять и проверь размер

    Убедись, что автопамять работает (/memory), и что файл влез в 200 строк. Если нет - значит что-то ещё пора выносить.

Чтобы не делать первый проход руками, дай эту работу самому Claude. Вот промпт, который я использую как отправную точку - копируешь, вставляешь в сессию, открытую в твоём проекте:

ПромптПочистить раздутый CLAUDE.md
Прочитай мой CLAUDE.md и мой код. Твоя задача - сделать CLAUDE.md короче и полезнее для модели пятого поколения.

Пройди по файлу и раздели все правила на три группы:

ОСТАВИТЬ - грабли проекта и договорённости, которые ты не угадаешь из кода сам.

УДАЛИТЬ - очевидные вещи, которые ты и так знаешь, и всё, что выводится из кода.

ВЫНЕСТИ В СКИЛЛ - многошаговые процедуры, которые сейчас лежат текстом в CLAUDE.md.

Для группы 1 переформулируй размытые правила в конкретные и проверяемые.
Найди правила, которые противоречат друг другу, и покажи их отдельно.
Верни новый вариант CLAUDE.md короче 200 строк плюс список того, что предлагаешь вынести в скиллы.
Ничего не меняй в файлах, пока я не подтвержу.

Обрати внимание на последнюю строку - «ничего не меняй, пока я не подтвержу». С моделью, которая теперь пользуется суждением, это важно: пусть сначала покажет план, а решение оставь за собой.

Почему контекст важнее промпта?

Если убрать частности про Opus 5 и посмотреть шире, весь этот разбор - про одну идею, которую я повторяю с самого начала: контекст важнее промпта. Главная работа делается раньше запроса - в тот момент, когда ты собираешь окружение, в котором модель работает.

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

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

Обновление Opus 5 эту логику обострило. Anthropic своими руками показала: когда модель достаточно умная, лишние правила только вредят, а выигрывает тот, кто аккуратно собрал контекст. Это навык, который останется с тобой при любой следующей модели, хоть Opus 6, хоть какой угодно.

С чего начать прямо сейчас?

Не откладывай на «когда-нибудь потом». Самый простой первый шаг - открыть CLAUDE.md прямо сейчас и честно спросить себя по каждой строке: это грабли, которые Claude не угадает, или очевидная вещь, которую я вписал на всякий случай? Всё, что во второй группе, - кандидаты на удаление.

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

Если хочешь собрать всю связку по системе - на практикуме за три вечера мы делаем это с нуля: CLAUDE.md, второй мозг, скиллы под твои задачи. Всё на твоём реальном проекте, без общих слов.

Источники

Полная схема по вайб-кодингу за вечер: ИИ-клон + Второй мозг + Контекст-инжиниринг. Три кита, без которых ИИ галлюцинирует на длинной сессии.

Практикум по вайб-кодингу
+Твой второй мозг
3 вечера - инструменты, метод, первый проект
Набор открыт
Записаться →

Новые материалы - дайджестом, без спама

Гайды выходят регулярно. Подпишись, чтобы не пропускать: пришлю подборку в Telegram или на email. Раз в неделю или каждый день - выбираешь сам.

Была инструкция полезна?
Артемий Миллер
Автор
Артемий Миллер
Предприниматель и вайб-кодер

Артемий Миллер - предприниматель и вайб-кодер. Бывший программист, собирает продукты исключительно вместе с ИИ-агентами, без найма разработчиков.

Связанные концепты

Концепт

Вайб-кодинг

Способ строить продукты через диалог с ИИ-агентами: ты ставишь задачу словами, агент пишет код, ты проверяешь и итерируешь. Не «изучить программирование», а «получить результат руками агента».

Концепт

Второй мозг

Папка `business/` в проекте с базой знаний: аудитория, продукты, цели, экономика. Claude читает её перед каждой задачей и заземляет решения на реальный контекст бизнеса.

Концепт

Контекст-инжиниринг

Дисциплина подготовки контекста для ИИ-агента: что он уже знает к моменту твоего промпта. 5 слоёв: ИИ-клон, бизнес, проект, зона задачи, сама задача.

Концепт

CLAUDE.md

Файл-манифест проекта, который Claude читает первым: карта репо, правила, стек, ссылки на ИИ-клон и Второй мозг. Без него агент работает «в общем по индустрии», с ним - в правилах твоего проекта.

Концепт

Плагин Claude Code

Бандл из расширений Claude Code (skill, subagent, MCP-сервер, hook), который ставится одной командой `/plugin install` и работает в одном пакете. Заменяет ручную сборку CLAUDE.md, MCP-конфигов и хуков.