Самая частая ошибка с агентом — отпустить его в код, пока он не понял задачу. План-режим заставляет Claude сначала показать план и ничего не трогать, пока ты его не утвердишь. Разберём, как включать и когда это окупается.
Большие задачи ломаются не на коде, а на непонимании. Ты просишь «перенеси авторизацию на новый способ», агент сразу лезет править десять файлов — и оказывается, что половину он понял не так. Откатывать дольше, чем делать заново. План-режим (plan mode) убирает эту яму: Claude сначала исследует код и показывает план словами, ничего не меняя, а ты ловишь недопонимание до того, как оно превратилось в испорченные файлы.
Что узнаешь из гайда
Часть 1 · Понятие
Главное
План-режим — состояние, в котором агент исследует код и составляет план, но не пишет в файлы. Сначала план на согласование, потом — выполнение.
В обычном режиме Claude Code действует сразу: читает, правит, запускает. В план-режиме его «руки на запись» отключены. Он может смотреть код, искать по проекту, рассуждать — но создать или изменить файл, выполнить команду на запись не может. Результат его работы в этом режиме — текст: разбор задачи и пошаговый план, что и где он собирается сделать.
Это принципиально иначе, чем просто написать в промте «сначала подумай». Просьба подумать — это вежливость, которой модель может не последовать: увлёкся и начал править. План-режим — это гарантия на уровне инструмента: пока ты в нём, ни один файл не изменится, что бы агент ни решил. Контроль не на доверии, а на запрете.
Дешевле поправить план словами, чем откатывать десять испорченных файлов.
Часть 2 · Вход
Главное
Два способа: Shift+Tab дважды прямо в чате или запуск сессии сразу в плане флагом claude --permission-mode plan.
Shift+Tab — это переключатель режимов работы агента в интерактивном чате. Нажатия по кругу меняют режим: обычный, авто-приём правок, план. Чтобы попасть в план, жми Shift+Tab дважды — индикатор режима внизу экрана покажет, что ты в плане.
# Shift+Tab по кругу переключает режим агента.
# Дважды — попадаешь в план-режим (plan mode).
# Внизу появится метка режима: пока она активна,
# агент ничего не пишет в файлы — только планирует.Если задача заведомо крупная и ты сразу хочешь начать с плана — запускай Claude Code в этом режиме с самого старта:
# Сессия откроется уже в план-режиме:
# агент сначала исследует и планирует, потом ждёт твоего «ок».
claude --permission-mode planВажно
План-режим — это часть общей системы режимов и прав агента. Тот же Shift+Tab переключает и на «авто-приём правок», где агент, наоборот, не спрашивает разрешений. Не перепутай: для крупной задачи нужен план (тормоз), а не авто-приём (газ). Метка режима внизу всегда показывает, где ты сейчас.
Часть 3 · Правка
Главное
План — это черновик на согласование. Читаешь, видишь где агент понял не так, и правишь словами прямо в чате. Цикл повторяется, пока план не станет верным.
Когда агент показал план, твоя работа — не пролистать, а прочитать. Именно здесь ловятся дорогие ошибки: агент собрался трогать не тот файл, понял задачу шире или уже нужного, выбрал не тот подход. Всё это видно в плане текстом, и поправить это — одна фраза:
# Агент показал план. Ты не согласен с парой шагов — говоришь прямо:
Шаг 3 не нужен, эту таблицу не трогаем.
В шаге 5 используй существующий хелпер formatPrice, не пиши новый.
Остальное ок — после правок плана покажи финальную версию.Агент перестроит план с учётом замечаний и покажет снова. Это можно повторять сколько нужно — всё ещё бесплатно с точки зрения кода: файлы не тронуты. Хорошая постановка задачи с самого начала сокращает число таких итераций — про это есть отдельный гайд про промтинг для Claude Code.
Часть 4 · Запуск
Главное
Когда план верный — выходишь из режима и разрешаешь выполнение. Агент начинает делать ровно то, что вы согласовали, шаг за шагом.
После того как план тебя устраивает, ты выходишь из план-режима и даёшь добро на выполнение. С этого момента «руки на запись» включены: агент идёт по согласованным шагам, правит файлы, запускает команды. Но теперь он делает это не по своему первому впечатлению, а по плану, который ты прочитал и утвердил.
Сильная связка — план-режим плюс работа через гит. Сначала согласовал план, потом дал выполнить на отдельной ветке, проверил результат — и если что-то не так, откат стоит одну команду. Про безопасный гит-воркфлоу с агентом есть гайд про Claude Code и Git.
Коротко
Shift+Tab дважды или claude --permission-mode plan.Часть 5 · Границы
План-режим — это инвестиция времени до кода. Она окупается, когда ошибка дорогая, и не окупается, когда задача мелкая. Простое правило: чем больше файлов и неочевиднее задача — тем нужнее план.
Пример
Просишь «добавь экспорт отчётов в PDF». В плане агент пишет: создам кнопку, новый эндпоинт, подключу библиотеку X. Ты замечаешь, что в проекте уже есть генератор PDF для счетов — говоришь «переиспользуй его». Одна фраза в плане сэкономила лишнюю зависимость и день правок.
Когда план не нужен
Не включай план на мелочи: поменять текст кнопки, поправить отступ, переименовать переменную, исправить опечатку. Тут план — лишний шаг, который раздражает и тратит время. Дай агенту сделать сразу. План — для задач, где ты сам не до конца уверен, что получится правильно с первого раза.
Коротко
Shift+Tab дважды или флаг запуска, правка плана — словами.Вопросы
План-режим — это состояние Claude Code, в котором агент анализирует задачу и код, составляет план действий, но не трогает файлы и не выполняет команды на запись. Сначала он показывает, что собирается сделать, ты читаешь план, правишь его словами и только потом разрешаешь выполнять. Это защита от того, чтобы агент сразу влез в код с неверным пониманием задачи.
План-режим включается двойным нажатием Shift+Tab в интерактивном чате Claude Code — это переключатель режимов работы агента. Также можно запустить сессию сразу в плане флагом claude --permission-mode plan. После того как план готов и тебя устраивает, выходишь из режима и агент начинает выполнять согласованные шаги.
План-режим нужен для больших и неочевидных задач: рефакторинг, новая фича в несколько файлов, изменение, которое затрагивает много мест. Для мелких правок — поменять текст, поправить отступ, переименовать переменную — план только тормозит, проще дать сделать сразу. Правило простое: чем дороже ошибка агента, тем нужнее сначала увидеть план.
В план-режиме агенту технически запрещено писать в файлы и выполнять команды на изменение, пока ты не утвердишь план. Обычная просьба «сначала подумай» опирается на послушание модели — она может всё равно сразу начать править. Plan mode даёт гарантию на уровне инструмента: пока ты в плане, ничего не меняется, только исследование кода и составление плана.
Читать дальше
Прикладной материал, разборы и рабочие приёмы — то, чем пользуюсь сам, без воды. Залетай, там самое полезное.
Зайти в Telegram