Режим планирования (plan mode) в Claude Code — самый простой способ не дать агенту умчаться не в ту сторону. Вместо того чтобы сразу править файлы, Claude изучает ваш код, задаёт нужные вопросы и пишет план. Вы его читаете, спорите, и только когда всё выглядит правильно, разрешаете приступать. В этом руководстве — как plan mode работает сейчас, как его включить, когда он оправдан и как сочетать его с сабагентами и CLAUDE.md.
Всё здесь сверено с документацией Anthropic о режимах разрешений и типовых сценариях работы в октябре 2026 года.
Что такое plan mode в Claude Code?
Plan mode — один из режимов разрешений Claude Code. В нём Claude может:
- читать файлы и искать по кодовой базе,
- запускать shell-команды для разведки, например выводить список файлов или читать историю git,
- задавать вам уточняющие вопросы,
- писать план.
Чего он не делает — не правит исходный код. План — это предложение, а не изменение. Пока plan mode включён, в строке состояния видно ⏸ plan mode on.
Смысл в том, чтобы отделить обдумывание от действий. В режиме по умолчанию Claude часто начинает править после беглого осмотра. На мелких задачах это именно то, что нужно. А на крупном изменении вы узнаёте о неверном допущении, когда уже затронуто десять файлов.
Как включить plan mode
Есть три способа, в зависимости от того, как долго вы хотите в нём оставаться.
Shift+Tab: переключить текущую сессию
Нажимайте Shift+Tab, чтобы перебирать режимы разрешений. Порядок такой:
- По умолчанию (Claude спрашивает перед правками и командами)
- Принятие правок (accept edits)
- Plan mode
- Обход разрешений — только если вы запустили сессию с ним
- Auto mode — только если он вам доступен
Затем всё снова начинается с режима по умолчанию. Остановитесь, когда в строке состояния появится plan mode. Чтобы выйти из plan mode, ничего не одобряя, нажмите Shift+Tab ещё раз.
/plan: спланировать один промпт
Напишите /plan перед промптом, чтобы спланировать только этот запрос:
/plan перенеси хранилище сессий с Redis на PostgresУдобно, если вы в основном работаете в режиме по умолчанию и хотите план лишь для редкой крупной задачи.
Запустить сессию в plan mode
claude --permission-mode planЕсли хотите, чтобы каждая сессия начиналась в plan mode, сделайте его режимом по умолчанию в .claude/settings.json:
{
"permissions": {
"defaultMode": "plan"
}
}В расширении для VS Code задайте claudeCode.initialPermissionMode значение "plan".
Plan mode в сравнении с другими режимами
| Режим | Читает и изучает | Правит файлы | Запускает команды |
|---|---|---|---|
| По умолчанию | Да | После вашего разрешения | После вашего разрешения |
| Принятие правок | Да | Без вопросов | После вашего разрешения |
| Plan mode | Да | Нет, только после одобрения плана | Для разведки; с проверкой или после вопроса |
| Auto mode | Да | Да, с проверками безопасности | Да, с проверками безопасности |
Plan mode — единственный режим, где правки ждут одобрения целого плана, а не отдельного изменения. О самом рискованном конце шкалы — в статье про обход разрешений в Claude Code.
Shift+Tab, режимы разрешений и остальные сочетания клавиш собраны в шпаргалке по командам Claude Code.
Что происходит, когда план готов
Закончив планирование, Claude показывает план и спрашивает, как действовать дальше. Варианты:
- Yes, and use auto mode: одобрить и дать Claude работать с проверками безопасности auto mode. Если auto mode недоступен, вместо этого будет «Yes, auto-accept edits».
- Yes, manually approve edits: одобрить, но проверять каждую правку по мере появления.
- No, keep planning: отправить замечания и получить исправленный план.
Если включить настройку showClearContextOnPlanAccept, первым появится ещё один вариант: одобрить план и очистить разговор о планировании. Тогда реализация начнётся с чистого контекста, в котором есть только план.
Одобрение завершает plan mode. Ещё несколько полезных деталей:
- Ctrl+G открывает план в вашем редакторе, чтобы поправить его прямо там перед одобрением.
- Планы сохраняются в файлы: по умолчанию в
~/.claude/plans/или в папку, заданную черезplansDirectory. - После принятия плана сессия получает сгенерированное название, и её проще найти потом.
Shell-команды во время планирования
Разведка часто означает запуск команд. Если вам доступен auto mode и включена настройка useAutoModeDuringPlan (по умолчанию она включена), эти команды проверяет классификатор, как в auto mode. В противном случае всё, что выходит за набор команд только для чтения, сначала требует вашего разрешения. В любом случае plan mode — не песочница для произвольных команд, а режим, в котором Claude не правит ваш код.
Когда использовать plan mode
Plan mode окупается там, где неверный первый шаг обходится дорого.
| Используйте plan mode | Обойдитесь без него |
|---|---|
| Изменения в нескольких файлах или модулях | Исправления в одну строку и опечатки |
| Кодовая база или её часть, которую вы плохо знаете | Код, который вы только что написали |
| Рефакторинги и миграции | Переименование переменной |
| Функции, где подход неочевиден | Задачи, где вы и так знаете каждый шаг |
| Всё, что касается данных, авторизации или биллинга | Форматирование и исправления линтера |
| Когда нужен план для ревью ещё до код-ревью | Быстрые эксперименты, которые вы выбросите |
Хорошее эмпирическое правило: если бы вы, делая изменение сами, сначала набросали его на бумаге, попросите Claude сначала о плане.
Plan mode помогает и при знакомстве с кодовой базой. Спросите в plan mode: «как проходит авторизация от формы входа до хранилища сессий?» — и Claude всё изучит и объяснит, ничего не рискуя задеть.
Схема «сначала план, потом реализация»
Цикл, который рекомендует сама Anthropic, состоит из четырёх шагов: изучить, спланировать, реализовать, закоммитить. На практике это выглядит так.
1. Изучите
Включите plan mode и направьте Claude в нужную часть кода:
Прочитай src/billing и тесты в tests/billing.
Объясни, как формируются счета и где применяются налоги.
Пока не предлагай изменений.Исправьте всё, что он понял неверно, прямо сейчас. На этом этапе недоразумения обходятся дешевле всего.
2. Спланируйте
Попросите план с важными ограничениями:
Спланируй добавление налоговых ставок по странам.
Публичный API не меняй, добавь миграцию и перечисли тесты, которые добавишь.Хороший план называет файлы, которые будут изменены, порядок, риски и способ проверить результат.
3. Возразите
Не одобряйте первый черновик на автомате. Выберите «No, keep planning» и скажите, что поменять: «Сделай миграцию отдельным шагом», «Не трогай генератор PDF». Или нажмите Ctrl+G и отредактируйте план сами.
4. Реализуйте
Одобрите. Если вы доверяете плану, «Yes, and use auto mode» позволит Claude пройти по нему, не останавливаясь на каждой правке. Если изменение рискованное, выберите ручное подтверждение.
5. Проверьте и закоммитьте
Попросите Claude запустить тесты, перечисленные в плане. Если что-то пошло не так, Escape останавливает Claude, а /rewind (или двойное нажатие Escape) возвращает к более раннему чекпоинту. Когда тесты прошли, коммитьте.
Для изменения покрупнее сохраните файл плана и начните реализацию в новой сессии. План станет промптом, и реализация начнётся с контекста, заполненного решениями, а не разведкой.
Планируйте более сильной моделью
Алиас модели opusplan использует Opus, пока вы в plan mode, и переключается на Sonnet для реализации. Решения принимаются с рассуждениями уровня Opus, а набор кода идёт по более низкой цене Sonnet. Включается командой /model opusplan. На подписке это заодно растягивает ваши лимиты использования.
Plan mode и сабагенты
Plan mode хорошо сочетается с сабагентами, и Claude Code уже использует их для этого.
- Встроенный сабагент Plan: в plan mode Claude может поручить исследование сабагенту Plan. У него инструменты только для чтения, та же модель, что и у основного разговора, а раскопки он ведёт в собственном контексте, так что в основной разговор попадают только выводы. Он стартует без вашего CLAUDE.md и без снимка git status и запускается один раз: продолжить его нельзя.
- Сабагент Explore: ещё один встроенный агент только для чтения, настроенный на быстрый поиск и чтение кода.
- Сабагенты остаются в plan mode: если основной разговор в plan mode, запущенные им сабагенты тоже остаются в plan mode. Неожиданной правки от помощника не будет.
Поскольку исследование идёт в отдельных контекстах, основной разговор остаётся компактным. План получается сфокусированным, а в контекстном окне остаётся больше места для реализации.
Параллельное исследование можно попросить и напрямую: «В plan mode с помощью сабагентов изучи отдельно слой API, слой базы данных и фронтенд, а потом дай мне один план». Одно предупреждение из документации Anthropic о расходах: команды агентов, участники которых работают в plan mode, расходуют примерно в семь раз больше токенов, чем обычная сессия, так что приберегите это для изменений, которые того стоят.
Plan mode и CLAUDE.md
Plan mode хорош ровно настолько, насколько хорош контекст, с которым стартует Claude. Здесь в дело вступает CLAUDE.md. Несколько строк в нём заметно улучшают планы:
## Планирование
- План перечисляет файлы для изменения по порядку и тесты, которые нужно добавить.
- Изменения базы данных всегда выносятся в отдельный шаг миграции.
- Сигнатуры публичного API не меняются без явного указания.
- Для проверки запускай `pnpm test` и `pnpm lint`.Держите в голове две детали:
- Встроенный сабагент Plan не видит CLAUDE.md. Пишите туда общие правила проекта для основного разговора, а всё критичное добавляйте и в промпт, когда просите об исследовании.
- Держите CLAUDE.md коротким. Он отправляется на каждом ходу, поэтому длинный файл расходует токены в любом режиме. Длинные процедуры выносите в skills.
Если ваша команда всегда сначала планирует, сделайте plan mode режимом по умолчанию в общем .claude/settings.json и опишите в CLAUDE.md, как выглядит хороший план. Все получат одинаковое поведение, и никому не придётся об этом помнить.
Частые ошибки
- Одобрять, не читая. Непрочитанный план — это просто более медленный режим по умолчанию.
- Планировать крошечные задачи. При исправлении опечатки plan mode лишь добавляет лишний круг.
- Слишком расплывчатые планы. «Отрефактори модуль auth» — не план. Просите файлы, порядок и шаги проверки.
- Не очищать контекст после планирования. Разведка заполняет контекст. Для крупных задач одобряйте с очисткой контекста или начинайте новую сессию с файла плана.
- Считать plan mode песочницей. Он запрещает правки исходников, но не превращает терминал в безопасную площадку. Проверяйте команды так же, как и везде.
Планирование в AgentVera
AgentVera — десктопное приложение для macOS, Windows и Linux, которое запускает Claude Code и другие CLI-агенты бок о бок, по проектам. Каждая панель — это настоящий терминал Claude Code, так что Shift+Tab, /plan и варианты одобрения плана работают так же, как и без него. AgentVera добавляет вокруг них структуру:
- Линия задач: задача проходит этапы Analysis, Plan, Build и Review. Каждый этап записывает результат в файл, например
02-plan.md, и следующий этап начинает с него, так что план путешествует вместе с задачей, а не живёт в одном разговоре. - Потоки: связывайте шаги вроде исследования, планирования и реализации в цепочку, чтобы один и тот же цикл «план, потом реализация» каждый раз проходил одинаково.
- Auto approval: после одобрения плана безопасные чтения и тесты проходят без запросов, а такие действия, как
git pushилиrm, по-прежнему требуют подтверждения. - Чекпоинты и повтор: хранятся последние 60 ходов на агента, так что можно вернуться назад, если реализация ушла от плана.
Чекпоинты есть на бесплатном тарифе. Линия задач и auto approval входят в Pro и Team. Если вы только начинаете запускать нескольких агентов, начните со статьи о том, как пользоваться Claude Code, и скачайте AgentVera.
Подведём итог
Plan mode заставляет Claude сначала изучить код и предложить план, а уже потом править. Включайте его через Shift+Tab, /plan или --permission-mode plan, по-настоящему читайте план, возражайте через «No, keep planning» или Ctrl+G и только потом одобряйте. Используйте его для изменений в нескольких файлах, незнакомого кода и всего рискованного; для мелких исправлений он не нужен. Добавьте короткий и конкретный CLAUDE.md, отдайте раскопки сабагентам только для чтения и попробуйте opusplan, чтобы планировать с Opus и реализовывать с Sonnet.