Режим планирования Claude Code: как проверить план до правок

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

Что умеет режим планирования Claude Code

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

В документации описано существенное исключение: в интерактивном сеансе терминала, где доступен обход разрешений, блокировки Plan Mode не действуют. Claude по-прежнему получает инструкцию составить план, но попытка внести правку может выполниться. Это относится и к запуску с --allow-dangerously-skip-permissions, даже если обход разрешений не выбран активным режимом. Если вы хотите, чтобы исходный код оставался неизменным до одобрения, запускайте сеанс без возможности обхода разрешений. Правила режимов разрешений Anthropic.

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

Как включить Plan Mode в Claude Code и выйти из него

Чтобы сразу начать работу в Plan Mode, выполните в терминале:

claude --permission-mode plan

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

Из auto переключение идёт в default (Manual, ручной режим), затем в acceptEdits, затем в plan. После них идут доступные дополнительные режимы: сначала обход разрешений, последним — auto. Для Windows Anthropic указывает альтернативное сочетание Alt+M на случай, если среда выполнения Node или Bun не включает режим ввода VT. Переключение режимов, справочник сочетаний клавиш, справочник команд.

Когда Claude предлагает готовый план, в запросе на одобрение можно выбрать:

• No, keep planning — продолжить планирование и дать конкретные замечания.
• Yes, manually approve edits — одобрить подход, но подтверждать правки по отдельности.
• Yes, and use auto mode — одобрить план и продолжить в режиме auto, если он доступен.

Если режим auto недоступен, вариант автоматического продолжения вместо него включает автоматическое принятие правок. Если сеанс запущен с возможностью обхода разрешений, этот вариант переключает на обход. Прежде чем выбирать, прочитайте, какой режим предлагается. Одобрение завершает Plan Mode и запускает реализацию с выбранными разрешениями. Переключение через Shift+Tab тоже завершает планирование, но не утверждает предложенный план. Что происходит при одобрении плана.

Работаете через интерфейс редактора? В VS Code нажмите индикатор режима под полем ввода и выберите Plan. На вкладке Code приложения Desktop используйте переключатель режима рядом с Send. В JetBrains действуют команды и сочетания клавиш CLI во встроенном терминале. Кроме того, в журнале изменений указана поддержка ввода /plan в VS Code начиная с v2.1.280. Управление в разных интерфейсах, официальный журнал изменений.

Настройка Plan Mode: что стоит знать

Чтобы сеансы терминала в проекте начинались в Plan Mode, добавьте эти параметры в .claude/settings.json, сохранив остальные настройки:

{
  "permissions": {
    "defaultMode": "plan"
  }
}

Для настройки по умолчанию во всех своих сеансах терминала используйте ~/.claude/settings.json. Флаг запуска имеет приоритет над настройками, а настройки проекта или централизованно управляемые настройки могут переопределить пользовательское значение. У VS Code отдельный параметр начального режима: добавьте "claudeCode.initialPermissionMode": "plan" в пользовательские настройки VS Code. Расширение не берёт начальный режим разрешений из настроек проекта. Настройка начального режима.

Следующие параметры размещаются на верхнем уровне настроек Claude Code, за пределами permissions:

Это независимые настройки: где хранится план, как проверяются команды во время планирования и будет ли среди вариантов одобрения очистка разговора. Справочник настроек, хранение планов, очистка контекста.

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

Как Plan Mode работает вместе с режимом auto

Plan Mode оставляет решение о реализации на ваше рассмотрение. Режим auto сокращает число обычных запросов на разрешение: действия оценивает отдельная модель-классификатор. Она проверяет действие с точки зрения разрешений, а вы при просмотре плана оцениваете, решает ли предложенная архитектура нужную задачу.

Когда режим auto доступен и useAutoModeDuringPlan включён, этот классификатор также проверяет команды оболочки во время планирования. Одобренные команды выполняются, отклонённые блокируются. Если auto недоступен или настройка отключена, команды за пределами встроенного набора только для чтения требуют подтверждения. Удаление критически важных путей обрабатывается отдельно, а исключение с обходом разрешений в интерактивном терминале имеет приоритет. Планирование не означает, что любая команда оболочки выполняет только чтение. Команды во время планирования.

При реализации default означает ручную проверку (Manual), acceptEdits автоматически разрешает правки в пределах своей области действия и обычные команды файловой системы с оговорёнными в документации исключениями, а auto добавляет фоновую проверку действий. Ни один из этих режимов не оценивает, удачна ли сама архитектура. Подробнее о выборе разрешений — в нашем руководстве по Claude Code Auto Mode.

Согласно актуальной документации, начиная с v2.1.283 встроенным начальным режимом для интерактивных сеансов терминала и VS Code стал auto — с учётом настроек, правил организации и доступности. Поэтому явно задавать Plan Mode при запуске по-прежнему имеет смысл. Действующие правила выбора начального режима.

Старые инструкции могут не учитывать существенные изменения. В журнале Anthropic отмечены аргумент с описанием задачи для /plan в v2.1.72, скрытие варианта очистки контекста по умолчанию в v2.1.81 и проверка классификатором Bash-команд, для которых нельзя уверенно установить режим только для чтения, при планировании с auto в v2.1.218. Официальный журнал изменений.

Пример: вынести общую логику цен и сохранить суммы списаний

Разберём конкретный рефакторинг: приложение рассчитывает цену покупки в API, а стоимость продления — в фоновом обработчике. Нужно выделить общие правила расчёта, сохранив действующие правила округления и применения скидок в каждом месте вызова. Это иллюстративный план, а не отчёт о проверке реального репозитория и не гарантированный результат работы Claude.

Включите Plan Mode и сформулируйте главное ограничение:

Допустим, в проекте есть следующие файлы, относящиеся к задаче:

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

Исправьте план до одобрения. При его просмотре нажмите Ctrl+G и замените преждевременное удаление следующим уточнением:

Сохраните план и вернитесь к работе. Если он всё ещё требует доработки, выберите продолжение планирования и попросите Claude привести весь план в соответствие с уточнением. Нужно убрать противоречащий ему шаг удаления, а не просто дописать под ним предупреждение. И прямое редактирование, и продолжение планирования предусмотрены в документированном процессе работы. Рекомендации Anthropic: исследование, план и код.

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

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

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

Экономический выигрыш здесь вполне конкретен: изменение поведения обнаруживается до переписывания обоих мест вызова и их тестов. Приписывать этому предположительный процент экономии токенов незачем.

Для каких задач планирование особенно полезно

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

Это предлагаемые способы работы, а не измеренные результаты. Они следуют рекомендации Anthropic планировать, когда подход неясен, изменение затрагивает несколько файлов или код незнаком. Если нужно исправить опечатку, добавить заранее определённое сообщение в лог или выполнить переименование с чёткими границами, просите сразу внести правку. Когда Anthropic рекомендует планирование.

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

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

Какой продукт можно построить вокруг планирования?

Наиболее перспективная идея — комплект материалов для проверки рефакторинга в команде: превратить предложение об изменении в готовые для ревью карту файлов, список сохраняемых контрактов, критерии приёмки и инструкции по откату. Руководитель разработки мог бы платить за единый стандарт работы разработчиков, особенно при работе с общей бизнес-логикой.

По оценкам DataForSEO для США, полученным 12 октября 2026 года, запрос «code refactoring tools» собирает 170 поисков в месяц. Это умеренный сигнал интереса к задаче, а не доказательство того, что эти пользователи купят продукт для проверки планов. Минимально полезная версия могла бы принимать экспортированный план и карту файлов репозитория, находить пропущенные места вызова или необоснованные предположения и формировать описание для пул-реквеста. Сложность в том, что обычное составление планов уже есть в Claude Code. Чтобы продукт был нужен, он должен учитывать правила конкретной команды и выдавать полезные материалы для ревью.

Более узкая идея — комплект подготовки к миграции для агентств: до оценки стоимости обновления составлять перечень затронутых компонентов, чек-лист поэтапного развёртывания и список нерешённых вопросов. В той же проверке DataForSEO запрос «code migration tools» получил оценку 20 поисков в месяц в США. Небольшая частотность этого коммерческого запроса — повод проверить спрос у действующих клиентов, прежде чем строить универсальный продукт.

Минимальная версия могла бы охватывать один тип миграций и требовать ссылку на соответствующую документацию поставщика рядом с каждым изменением. Главная сложность — поддержка актуальности: правила миграции для конкретных версий быстро устаревают. Plan Mode помогает исследовать задачу, но не предоставляет проверенный свод правил миграции. Это продуктовые гипотезы, опирающиеся на поисковый спрос, а не прогнозы выручки.

Ultraplan больше недоступен

Anthropic закрыла экспериментальную версию Ultraplan, убрав /ultraplan, запуск по ключевому слову и вариант доработки плана через Ultraplan в веб-интерфейсе при одобрении. На странице сервиса поясняется, что исследовательские предварительные версии носят экспериментальный характер и могут меняться или исчезать с учётом отзывов. Для планирования читателям предлагают локальный Plan Mode и облачные сеансы Claude Code. Текущая страница Ultraplan у Anthropic.

Частые вопросы перед началом работы

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

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