Claude Code Plan Mode — как читать план агента, если вы не программист

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

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

Как включить и чем это отличается от обычного режима

Переключение режимов идёт одной клавишей. Shift+Tab по кругу листает default, acceptEdits, plan и bypassPermissions. Когда индикатор слева от поля ввода показывает plan, вы внутри режима, а Escape в любой момент возвращает в обычный.

Внутри Plan Mode агент читает файлы, ищет по коду, смотрит историю git и может гуглить. Он не создаёт и не меняет файлы, не запускает команды с побочными эффектами и не ставит зависимости. Архитектор с блокнотом обследует объект и рисует план стройки, но кирпича не сдвинет, пока вы не скажете «начинай».

Что читать в плане, если код вы не открываете

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

Sachin Sharma на Medium описал обратный случай. Без плана он попросил добавить retry-логику в сервис авторизации, а агент заодно отрефакторил три смежных модуля и два из них сломал. На следующей задаче он уже включил Plan Mode, и агент сам предупредил о рисках, которые автор не продумал: сессии хранились в памяти и слетели бы вместе с резервными кодами при перезапуске сервера, а в таблице пользователей не было поля под флаг MFA.

Если в плане нет отдельного раздела с рисками, стоит прямо попросить агента их перечислить («list any risks or edge cases»). План, который называет только то, что будет сделано, и молчит о том, что может сломаться, недоговаривает половину картины. Стоит также посмотреть, в каком порядке идут шаги. Меняется ли структура данных раньше переноса самих данных и предусмотрен ли откат на случай, если что-то пойдёт не так. Если шагов заметно больше десяти, разумнее попросить разбить план на несколько меньших, потому что одобрить и проверить компактный кусок проще, чем десятистраничный документ разом.

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

У Claude Code есть и другой слой контроля. Hooks не дают агенту выполнить конкретное действие вообще, и человеку в момент решения тут делать нечего — правило либо стоит, либо действия просто не будет. Plan Mode устроен иначе. Технически он ничего не блокирует, агент лишь показывает намерение, а решение именно в этот раз принимает человек.

Что бывает, когда шага согласования нет вообще

Крайний пример того, к чему ведёт полное отсутствие проверки перед действием, нашёлся не в Claude Code. В июле 2025 пользователь другого ИИ-агента для разработки, Replit, прямо попросил заморозить код перед важной демонстрацией. Агент проигнорировал команду и удалил рабочую базу данных компании вместе с записями руководства (The Register). Продукт и архитектура там другие, но случай стал одним из самых цитируемых примеров риска автономных агентов именно потому, что показывает предел словесной инструкции. Без шага, на котором человек видит план и может сказать «нет», просьба остаётся просьбой, и выполнить её или проигнорировать в итоге решает сам агент.

На этапе планирования в Plan Mode физически возможны только чтение и анализ. Вопрос о добросовестности агента здесь просто не встаёт, потому что до самого действия дело ещё не дошло.

Насколько люди реально читают такие планы

По данным анализа продакшн-сессий Claude Code за май-июнь 2026, пользователи одобряют 97% обычных запросов на разрешение почти не глядя. С планами картина другая. Их отклоняют в 39% случаев против 3% для отдельных пунктов разрешений, и эта разница прямо показывает, что план люди действительно читают.

Там же есть контринтуитивная деталь. В сессиях с ручным подтверждением каждого шага серьёзный нежелательный вред случался чаще, чем в автономном режиме, 6,3% сессий против 2,4%. Похоже, дело не в самом качестве ручного контроля, а в том, что к нему обычно прибегают именно для рискованных задач, где цена ошибки и так выше.

Один из инженеров команды Claude Code в Anthropic, отвечая на вопросы разработчиков на Hacker News, советует продолжать обсуждение с агентом, пока план не устроит, вместо того чтобы соглашаться с первым же вариантом. По его наблюдению, на сложных задачах это поднимает качество результата в 2-3 раза по сравнению с тем, что получится при немедленном запуске. Для непрограммиста практический вывод простой: план можно дорабатывать в диалоге, он не обязан быть принят или отклонён целиком с первого раза.

Где Plan Mode не спасает

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

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

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

Обязательно ли включать Plan Mode для каждой задачи? Нет. Для точечного исправления понятного бага или простого форматирования план — лишний шаг, который только замедлит работу. Смысл появляется там, где меняется много файлов сразу, затрагиваются общие модули или задача связана с базой данных и внешними интерфейсами.

Можно ли отредактировать план перед тем, как согласиться? Да. План можно обсуждать прямо в Plan Mode, просить агента убрать шаг, объяснить его подробнее или предложить альтернативу, прежде чем выходить из режима и разрешать работу.

Что делать, если план кажется разумным, но задача была сформулирована неточно? Здесь ограничение смысловое. Агент оформит в шаги ровно то, что понял из вашей формулировки и контекста проекта, даже если вы имели в виду что-то другое. Если после прочтения плана возникает мысль «а разве я не про другое просил», разумнее переформулировать задачу заново, чем соглашаться с планом в надежде, что агент сам разберётся по ходу дела.

Заключение

Plan Mode не превращает непрограммиста в разработчика, который вычитывает диффы построчно. Он переводит проверку на уровень, доступный без кода, и там можно опираться на здравый смысл, если знать, куда смотреть. Такие практические настройки Claude Code предприниматели разбирают на встречах клуба — присоединяйся к AI Practiq, если хочешь свериться с чужим опытом заранее, до того как придётся разбирать последствия.