Для Claude 5 из промпта Claude Code вырезали больше 80%

В Anthropic читали расшифровки собственной работы с Claude Code и находили в одном запросе сразу «оставляй документацию, где уместно» и «НЕ добавляй комментарии», рассказывает Тарик Шихипар в блоге Claude. Команда разобрала такие конфликты и вырезала больше 80% системного промпта Claude Code для моделей вроде Claude Opus 5 и Claude Fable 5. На собственных тестах Anthropic по коду измеримых потерь не нашлось.

Коротко

• Anthropic пересобрала советы по контекст-инженерии для поколения Claude 5. Речь обо всём, что модель получает помимо вашей реплики: о системном промпте, навыках, файлах CLAUDE.md и памяти.
• Жёсткие запреты заменили суждением модели, примеры к инструментам заменили продуманными параметрами, а проверку, код-ревью и часть инструментов подгружают по требованию через навыки и ToolSearch.
• Какими именно тестами по коду проверяли сокращённый промпт, Anthropic не раскрывает. Ужать собственные навыки и CLAUDE.md она предлагает командой /doctor, но подробно её работу не описывает.

Если вы не следили, промпт Claude Code давно разбирают по версиям. С августа 2025 года этим занимается утилита cchistory Марио Цехнера, а один репозиторий на GitHub к версии v2.1.101 отследил 147 версий начиная с v2.0.14. По данным этого репозитория, промпт собран из 110 с лишним строк, и часть из них добавляется по условиям. Как писал Дрю Брёниг, ещё до Claude 5 там стояло правило по умолчанию не писать комментариев.

Три запрета про комментарии и документы заменили одной фразой

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

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

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

Вместо примеров к инструментам Anthropic советует продумывать их параметры

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

В качестве образца приводят инструмент задач Todo. У поля статуса три значения, pending, in_progress и completed, и уже по ним видно, как инструментом пользоваться. Отдельная инструкция держать в работе только один пункт задаёт нужное поведение.

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

Память Claude сохраняет сам, а спецификацией может стать HTML-макет или набор тестов

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

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

Ещё один вид ссылок называется рубриками. Это критерии вкуса в какой-то области, например хорошего дизайна API: по ним Claude поднимает агентов-проверяющих в динамических процессах. Файлы подключают через упоминание с @, и предпочтение советуют отдавать коду. HTML-макет дизайна обычно даёт результат лучше, чем описание или скриншот.

Основную часть токенов в CLAUDE.md Anthropic советует отдать подводным камням кода

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

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

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

Проверку и код-ревью вынесли в навыки, часть инструментов ищется через ToolSearch

На одном механизме держится большинство советов, и Anthropic называет его прогрессивным раскрытием: нужный контекст попадает к модели в нужный момент. Раньше в промпте Claude Code лежали подробные инструкции по код-ревью и проверке работы. Нужны они были не всегда, но в нужный момент без них было не обойтись. Их перенесли в отдельные навыки, которые Claude Code вызывает по необходимости.

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

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

Цифра в 80% опирается на собственные тесты Anthropic по коду. Какие это тесты, сколько в них задач и сколько токенов весил промпт до и после, в руководстве не сказано. На наш взгляд, переносить эти выводы на свои проекты стоит с осторожностью: потери измеряли только на задачах по коду, а советы про навыки и CLAUDE.md не подкреплены никакими цифрами.

Что /doctor сделает с вашими файлами

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