Чертёж

Чертёж — это режим плана (plan mode): агент исследует код и предлагает изменения, но не трогает исходники. Правки остаются заблокированными, пока вы не одобрите план.

Зачем отдельный режим

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

Рабочий цикл из четырёх фаз:

1. Разведка — «прочитай <каталог> и объясни, как устроено <механизм>». Агент читает и отвечает, ничего не меняя.
2. План — «какие файлы нужно изменить, какой поток данных, составь план».
3. Исполнение — план одобрен, режим сменился, агент пишет код, сверяясь с планом.
4. Коммит — «сделай коммит с осмысленным сообщением и открой PR».

Как войти и выйти

Расширение VS Code проектные настройки для стартового режима не читает — там за это отвечает claudeCode.initialPermissionMode.

Что разрешено внутри плана

Чтение — всегда. С командами оболочки сложнее, и это то место, где ошибаются чаще всего.

Если авторежим доступен и настройка useAutoModeDuringPlan включена (а она включена по умолчанию), команды во время планирования проверяет классификатор: одобренные выполняются, отклонённые блокируются. Если авторежима нет — всё, что выходит за встроенный набор безопасных команд чтения, спрашивает разрешение, включая случай, когда включён авторазрешающий режим песочницы: в режиме плана песочница не расширяет одобрения. Подробнее про слои — Круг дозволенного.

Что вы выбираете при одобрении

Когда план готов, агент показывает его и предлагает три варианта:

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

Одобрение плана переключает режим разрешений и сразу запускает работу. Чтобы спланировать заново, вернитесь в режим через Shift+Tab или начните следующий промпт с /plan. Побочный эффект: при одобрении плана сессия получает сгенерированное имя по этому плану, если вы её ещё не назвали — см. Долгая сессия и точки возврата.

План переживает сжатие

Полезный и малоизвестный факт: план, написанный в режиме плана, при компакции контекста перечитывается с диска заново, как и корневой CLAUDE.md. То есть после сжатия агент не теряет договорённость о том, что он строит, — в отличие от инструкций, сказанных только в разговоре. Это ещё один аргумент фиксировать замысел планом, а не репликой в ленте.

Когда план — лишняя трата

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

И обратное: план не заменяет критерия готовности. План отвечает на вопрос «что будем делать», критерий — на вопрос «как поймём, что сделано». Второе живёт в Первый свиток.