SSD Nodes Learn Hosting plans →
Руководства Matt ConnorАвтор: Matt Connor · Обновлено 2026-10-26

Почему AI-агенты игнорируют инструкции в промптах

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

Почему агенты для написания кода игнорируют ваши инструкции

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

У каждой причины есть свое решение, поэтому первая задача — научиться их различать. Заглавные буквы и слово IMPORTANT не являются диагностикой. Механизмы, описанные ниже, рассматриваются на примере Claude Code, поскольку его поведение при загрузке и сжатии данных подробно задокументировано по состоянию на октябрь 2026 года. Другие инструменты отличаются в деталях, но в общих чертах ведут себя так же.

Сначала определим два термина. Контекстное окно — это блок текста, который модель видит на конкретном шаге: системный промпт, файлы с вашими инструкциями, история диалога и каждый файл, который агент прочитал. Обвязка (harness) — это программа вокруг модели, которая считывает файлы с диска и формирует этот блок. Почти любая жалоба в этом тексте на самом деле является жалобой на обвязку, а не на модель.

Файл инструкций — это сообщение, а не настройка

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

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

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

Какие файлы инструкций загружаются и когда

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

Файлы в поддиректориях ниже вашей рабочей директории ведут себя иначе. Они не загружаются при запуске. Они загружаются, когда агент считывает файл в этой директории. То же самое касается правил с ограничением по пути в .claude/rules/, которые содержат поле paths: в заголовке: они попадают в контекст при чтении соответствующего файла, а не на каждом этапе работы. Начиная с версии v2.1.309, для файлов, загружаемых таким образом, действует ограничение размера (40,000 символов при окне контекста 200K), и агент получает только начало длинного файла, поэтому правила в конце большого вложенного файла могут никогда не попасть в контекст.

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

Еще одна ловушка при загрузке затрагивает репозитории, стандартизированные на AGENTS.md. Начиная с версии v2.1.277, Claude Code по умолчанию считывает AGENTS.md как инструкции вашего проекта, но только если в вашей рабочей директории или любой директории выше нее нет файлов CLAUDE.md, .claude/CLAUDE.md или CLAUDE.local.md (ваш личный ~/.claude/CLAUDE.md не учитывается). Добавьте любой из них, даже CLAUDE.local.md для личных заметок, и Claude Code начнет считывать ваши файлы CLAUDE.md, полностью игнорируя AGENTS.md. Чтобы загрузить оба варианта, установите для параметра Project instructions значение claude-md-and-agents-md в /config. В версиях до v2.1.277 или если вы хотите сохранить CLAUDE.md, связующим звеном служит CLAUDE.md, первой строкой которого является @AGENTS.md. Это импортирует файл при запуске, позволяя добавить любые специфические для Claude заметки ниже. Символическая ссылка также подойдет, если вам не нужно добавлять ничего дополнительного. Вопрос о том, что именно должно находиться в этом файле, рассматривается отдельно в разделе отделение инструкций для агента от документации для людей.

Подтверждение загрузки файла перед его перезаписью

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

Выполните /context внутри сессии. Команда выведет текущее окно, разбитое по категориям, а список Memory files содержит названия всех файлов инструкций, загруженных при запуске. Если файла нет в этом списке, значит, он не был загружен при старте, и любые изменения в нем не возымеют эффекта, пока что-то его не загрузит. Вложенный файл в поддиректории не отображается в этом списке, так как загружается по требованию; когда это происходит, в терминале появляется строка Loaded с путем к файлу. /memory выводит список путей к файлам и открывает их для редактирования, включая те, которые еще не существуют.

Для более точной проверки отслеживайте загрузки. Событие-хук InstructionsLoaded срабатывает каждый раз, когда файл CLAUDE.md или файл правил попадает в контекст, а его сопоставитель (matcher) указывает причину загрузки: session_start, nested_traversal, path_glob_match, include или compact. Добавьте это в .claude/settings.json:

{
  "hooks": {
    "InstructionsLoaded": [
      {
        "matcher": "nested_traversal",
        "hooks": [
          {
            "type": "command",
            "command": "cat >> /tmp/instructions-loaded.log"
          }
        ]
      }
    ]
  }
}

Хук получает полезную нагрузку в формате JSON через стандартный поток ввода, поэтому cat записывает всю запись целиком. Наблюдайте за ней с помощью tail -f /tmp/instructions-loaded.log во время работы. Код завершения этого события игнорируется, поэтому хук может только наблюдать, но не блокировать выполнение. Если ваш вложенный файл не появляется в этом логе в течение сессии, когда вы ожидали его загрузки, прекратите редактирование. Проблема заключается в размещении файла. Исключение: файл AGENTS.md, который Claude Code считывает напрямую, не вызывает это событие, поэтому ищите путь к нему в /memory. Файл AGENTS.md, импортированный из CLAUDE.md, вызывает событие в обычном режиме.

Как длительная сессия влияет на ваши правила

Здесь действуют два отдельных эффекта, требующих разных подходов.

Дистанция. До тех пор, пока не выполнена компактизация, правило, заданное на 1-м ходу, остается в окне контекста на 90-м ходу, конкурируя с 90 ходами текста, который является более свежим и специфичным для текущих задач. После выполнения компактизации правило, введенное только в чате, может вообще исчезнуть из окна. Документация Claude Code предупреждает, что инструкции из начала диалога могут быть потеряны — это второй эффект, описанный ниже. Вы не можете настроить дистанцию, но можете её измерить. Запустите ту же задачу в новой сессии. Если правило работает там, но перестает действовать в глубине длинной сессии, значит, причина в дистанции или компактизации.

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

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

Поэтому, если инструкция должна действовать на протяжении всей сессии, она должна находиться в корневом файле проекта без метаданных paths:. Все остальное — это компромисс, на который вы должны идти осознанно. Управление содержимым окна контекста описывает /compact с аргументом focus и /clear между несвязанными задачами; оба этих метода меняют частоту, с которой алгоритм суммирования принимает решение о том, какими были ваши правила.

Почему окружающий код важнее правила

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

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

Поэтому запишите это в правило. Правила, которые сами указывают на противоречащие им примеры, выживают при работе с реальным репозиторием. Правила, которые просто декларируют предпочтение, — нет.

Новый доступ к базе данных должен проходить через app/repositories/. Файлы в app/legacy/ по-прежнему вызывают ORM напрямую. Это старый код, а не паттерн. Не копируйте его.

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

Нечеткое правило невозможно проверить, а значит, его нельзя соблюсти

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

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

  • Непроверяемое: «Делайте функции короткими». Проверяемое: «Функция длиннее 60 строк должна содержать комментарий с объяснением причин».
  • Непроверяемое: «Тестируйте изменения». Проверяемое: «Запустите npm test и вставьте количество ошибок перед тем, как пометить задачу выполненной».
  • Непроверяемое: «Держите файлы в порядке». Проверяемое: «HTTP-обработчики должны находиться в src/api/handlers/. Никакие другие файлы не должны там размещаться».
  • Непроверяемое: «Форматируйте код правильно». Проверяемое: «Используйте отступ в 2 пробела в файлах .ts».

Правило «Не усложняйте» — это то, от чего люди отказываются в первую очередь, потому что решение заключается не в сокращении предложения, а в его расширении: подробное описание того, что на самом деле означает минимально необходимое изменение, дает агенту критерии, по которым он может оценить свой собственный diff.

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

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

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

  1. Убедитесь, что файл загружен. Выполните /context и изучите список файлов Memory, либо, если речь о вложенном файле, найдите строку Loaded в терминале. Если файла нет в списке, исправьте путь и остановитесь. Остальные пункты этого списка пока не имеют значения.
  2. Воспроизведите проблему в новой сессии. Запустите новую сессию и выполните минимальную задачу, которая должна активировать правило. Если проблема возникает в долгой сессии, но не здесь, значит, дело в контекстном расстоянии или сжатии данных. Если проблема воспроизводится и здесь, значит, ошибка в самом правиле.
  3. Устраните конкуренцию. Попробуйте применить то же изменение в директории, где существующий код уже соответствует правилу. Если соответствие восстановилось, значит, окружающий код перевешивал вашу инструкцию.
  4. Найдите конфликт. Если два файла содержат разные указания для одного и того же поведения — это задокументированная ошибка: модель может выбрать любое из них произвольно и не сообщит вам об этом.
  5. Сделайте правило проверяемым и повторите тест. Перепишите правило, добавив конкретный путь и условие. Значительный рост соответствия правилу будет означать, что причиной была формулировка.

Шаг 4 выполняется одной командой. Используйте grep для поиска темы во всех источниках инструкций, а не только в том файле, который вы редактировали:

grep -rni "migration" --include="CLAUDE.md" --include="CLAUDE.local.md" --include="AGENTS.md" .
grep -rni "migration" .claude/rules/ ~/.claude/CLAUDE.md ~/.claude/rules/ 2>/dev/null

Нахождение двух файлов с противоречивыми указаниями — это и есть ваша ошибка. Удалите один из них. Не пытайтесь расставить приоритеты с помощью более строгих формулировок, так как механизма ранжирования инструкций не существует. В Claude Code версии 2.1.283 и выше команда /doctor prompt-audit выполняет расширенный поиск по вашим файлам инструкций, правилам и навыкам, сообщая о противоречиях с предлагаемыми правками, не внося никаких изменений до вашего подтверждения.

Способы исправления: от простых к сложным

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

  1. Сделайте правило конкретным. Укажите путь, команду или условие. Добавьте контрпримеры, которые агент может обнаружить в репозитории, как было показано ранее. Это не требует затрат и исправляет значительную часть ошибок.
  2. Разместите правило ближе к объекту управления. Используйте вложенный CLAUDE.md, правило с ограничением по пути в .claude/rules/ или комментарий в начале самого файла. Правило будет прочитано одновременно с кодом, к которому оно относится. Учитывайте компромисс: данные, загруженные таким образом, удаляются при следующей компактизации и возвращаются при следующем чтении.
  3. Перенесите принудительное исполнение в хук. Текст просит, хук решает. Хуки выполняются как код в заданные моменты жизненного цикла и работают независимо от выводов модели.
  4. Передайте правило детерминированному инструменту и удалите текстовое описание. Это касается форматирования, порядка импортов, длины строк, запрещенных импортов и структуры сообщений коммитов. Используйте ruff format, prettier --write, eslint или хук pre-commit. Форматировщик всегда прав и не тратит токены. Текстовое правило работает не всегда и потребляет токены при каждом обращении.

Подробности шага 3. Допустим, агент не должен редактировать файлы миграций. Добавьте это в .claude/settings.json:

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "${CLAUDE_PROJECT_DIR}/.claude/hooks/guard-migrations.sh"
          }
        ]
      }
    ]
  }
}

И это в .claude/hooks/guard-migrations.sh:

#!/usr/bin/env bash
set -euo pipefail

path=$(jq -r '.tool_input.file_path // empty')

case "$path" in
  */migrations/*)
    echo "Files under migrations/ are written by hand. Stop and ask first." >&2
    exit 2
    ;;
esac

exit 0

Запустите chmod +x .claude/hooks/guard-migrations.sh, затем начните новую сессию и попросите агента отредактировать файл в migrations/. Редактирование будет отклонено, а ваше сообщение вернется в качестве причины. Код завершения 2 в PreToolUse блокирует вызов инструмента до его выполнения, а текст из stderr передается модели как сообщение о блокировке. ${CLAUDE_PROJECT_DIR} указывает на корень проекта, поэтому хук работает из любого каталога, в котором находится агент. Агенту не нужно соглашаться с правилом, помнить его или удерживать в контексте. Редактирование не произойдет.

Для простого запрета без логики используйте permissions.deny в настройках: это выполняет ту же задачу без необходимости поддерживать скрипты, а права доступа определяют, что будет запущено без дополнительного подтверждения. Если инструкцию необходимо разместить на уровне системного промпта, а не в сообщении пользователя, используйте --append-system-prompt. Это флаг запуска, который нужно передавать при каждой новой сессии, поэтому он лучше подходит для скриптов, чем для интерактивной работы.

Чего нельзя добиться инструкциями

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

Согласие не означает выполнение. Агент подтвердит правило, правильно повторит его вам и нарушит через два вызова инструментов. Подтверждение ничего не стоит и ничего не гарантирует. Не воспринимайте его как исправление и не считайте его проверкой.

Некоторые привычки устойчивы. Добавление комментариев, защитная обработка ошибок, написание итогового резюме, выполнение очевидной следующей команды. Они возвращаются даже при наличии запрещающего правила, пусть и реже, но не исчезают полностью. Вы можете измерить частоту нарушений самостоятельно: выполните одну и ту же задачу десять раз в новых сессиях и посчитайте количество нарушений. Если число должно быть равно нулю, правило нужно убрать из промпта. Завершение задачи, когда часть работы еще не выполнена, — это привычка того же типа, и исправление здесь структурное, а не словесное: навык борьбы с ленью заменяет фразу на дерево глубины (Depth Tree) и файлы-шлюзы, которые агент обязан закрыть, прежде чем сможет заявить о завершении.

Ваша собственная сессия становится примером. Если агент нарушил правило на шаге 12, а вы пропустили это, нарушение остается в контексте как демонстрация, и оно гораздо свежее, чем само правило. Исправляйте нарушение в тот же момент, когда его заметили. Неисправленное нарушение учит модель на протяжении всей оставшейся сессии.

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

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

FAQ

Почему Claude Code игнорирует мой CLAUDE.md?

Убедитесь, что файл был загружен, прежде чем делать вывод, что он игнорируется. Выполните /context и изучите список Memory files; файл, который там не указан, не был загружен при запуске. Файлы с инструкциями передаются как сообщение пользователя после системного промпта и рассматриваются как контекст, а не как принудительная конфигурация, поэтому строгая гарантия выполнения отсутствует. В большинстве случаев причина кроется в одном из четырех факторов: файл находится в поддиректории, которую агент не читал; два файла противоречат друг другу, и модель выбрала один из них произвольно; правило слишком расплывчато, чтобы проверить по нему действие; или окружающий код демонстрирует обратное тому, что сказано в правиле.

Изменяет ли что-то редактирование файла инструкций во время сессии?

Нет, для копии, которая уже находится в диалоге. Файлы выше вашей рабочей директории загружаются целиком при запуске, поэтому модель оперирует текстом, который был актуален в момент старта. Чтобы применить правки, начните новую сессию или попросите агента прочитать файл с помощью стандартных инструментов работы с файлами — это добавит текущую версию в диалог как новое сообщение. После сжатия (compaction) файл из корня проекта считывается с диска заново, поэтому новая версия появится в этот момент.

Какой файл имеет приоритет, если CLAUDE.md в корне и вложенный файл противоречат друг другу?

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

Сохраняются ли мои инструкции после /compact?

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

Когда правило стоит превратить в хук, а не оставлять в виде текста?

Когда проверка детерминирована, а цена ошибки выше, чем затраты на написание небольшого скрипта. Сюда относятся ограничения на пути к файлам, обязательные команды перед коммитом и запрещенные вызовы инструментов. Хук PreToolUse, который завершается со статусом 2, полностью блокирует вызов инструмента и возвращает ваш текст из stderr модели в качестве причины, поэтому правило будет работать независимо от того, находится ли оно в контексте. Все, что может решить форматер или линтер, должно быть передано этим инструментам и полностью удалено из файла инструкций.

Была ли эта статья полезной?