Plan mode в Claude Code: сначала план, потом правки в коде

Самая дорогая ошибка в работе с кодовым агентом — когда он уверенно переписал не то. Вы получили сотню изменённых строк, час на ревью и необходимость откатывать. Режим планирования в Claude Code нужен именно для этого: агент сначала читает код и показывает план, а править файлы начинает только после вашего согласия. Ниже — как включить claude code plan mode, как согласовывать план, как сочетать его с недорогой моделью для исполнения и во сколько это обходится в токенах. Описание построено на документации Claude Code (разделы про режимы разрешений и типовые сценарии) на октябрь 2026. Названия пунктов меню и версии могут меняться, сверяйтесь с документацией.

Как включить Claude Code plan mode

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

• нажать Shift+Tab в сессии, пока в строке состояния не появится ⏸ plan mode on (режимы переключаются по кругу, обычный режим, принятие правок и план идут друг за другом);
• поставить перед одним запросом /plan, тогда планирование применится только к нему;
• запустить сессию сразу в этом режиме:

claude --permission-mode plan

Повторное нажатие Shift+Tab выводит из режима планирования без одобрения плана. Чтобы режим включался по умолчанию в проекте, добавьте в .claude/settings.json в блок permissions значение defaultMode: "plan". В расширении для VS Code начальный режим задают отдельной настройкой claudeCode.initialPermissionMode: расширение не использует для этого проектный файл настроек.

Plan mode — функция самого клиента. Она одинаково работает, если Claude Code подключён к Zukko: настройки подключения те же, что в инструкции по Claude Code↗ (адрес https://api.zukko.pro без /v1, ключ в ANTHROPIC_AUTH_TOKEN, модель в ANTHROPIC_MODEL).

Как согласовать план

Когда план готов, Claude Code показывает его и спрашивает, что делать дальше. По документации, варианты такие:

• одобрить и продолжить в режиме с минимумом подтверждений (формулировка зависит от настроек и версии);
• одобрить и подтверждать каждую правку вручную;
• отказаться и продолжить планирование, сообщив агенту, что поправить.

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

Что проверять в плане

Не соглашайтесь на план, пока в нём нет четырёх вещей:

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

Хороший запрос для планирования:

Нужно перенести проверку прав из контроллеров в middleware.
Изучи, как сейчас устроена авторизация, и предложи план: какие файлы меняем,
в каком порядке, какие тесты добавить. Если чего-то не хватает для решения, задай вопросы.
Код пока не менять.

Если в плане видна неверная посылка, пишите об этом в ответ, а не отменяйте всё: «Нет, продолжай планировать» с уточнением дешевле, чем разбирать неудачную реализацию.

Сколько токенов уходит на план

Планирование не бесплатно, но дополнительные затраты невелики. Исследование кода (чтение файлов) агент делает в любом случае, с планом или без. Лишнее здесь — выходные токены самого плана и повторная отправка накопленного контекста при согласовании.

Пример с условными объёмами. Агент прочитал около 60 000 токенов кода и написал план на 4 000 токенов, планирование идёт на claude-opus-5-5 (вход 0.8, чтение кэша 0.08, выход 4, $ за 1M токенов, на 18 октября 2026):

• выход плана: 4 000 × 4 / 1 000 000 = $0.016;
• повторное чтение контекста из кэша при согласовании: 64 000 × 0.08 / 1 000 000 ≈ $0.005;
• итого дополнительные затраты на план: около $0.021.

Для сравнения, исполнение на claude-sonnet-5-5 (вход 0.4, выход 2) с 120 000 токенов входа и 15 000 токенов выхода за серию шагов стоит 0.12 × 0.4 + 0.015 × 2 = 0.048 + 0.030 = $0.078. Если агент пошёл не туда и всё нужно переделать, вы платите эту сумму ещё раз, не считая вашего времени на ревью. Значит, план окупается, если он предотвращает неверное направление хотя бы примерно в одном случае из четырёх (0.021 / 0.078 ≈ 0.27). Цифры условные и без учёта кэша на исполнении: подставьте свои объёмы из кабинета. Кэш для Claude виден шлюзу в Anthropic-формате, а именно им пользуется Claude Code; подробности — в справке по ключам и кэшу↗.

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

Планировать сильной моделью, исполнять дешёвой

В Claude Code есть режим модели opusplan: по документации, в режиме планирования он использует модель класса Opus, а при исполнении переключается на Sonnet. Какие именно модели стоят за псевдонимами, задают переменные окружения. Для шлюза укажите идентификаторы из списка Zukko:

export ANTHROPIC_BASE_URL=https://api.zukko.pro
export ANTHROPIC_AUTH_TOKEN=fetch_ваш_ключ
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5-5

claude --model opusplan

Цены и индекс силы: claude-opus-5-5 стоит 0.8 / 4, индекс 58; claude-sonnet-5-5 стоит 0.4 / 2, индекс 48 (цены в $ за 1M токенов, вход / выход). Считайте так: план на более дорогой модели обходится в два раза дороже на токен, чем тот же объём на Sonnet, зато исполнение идёт по сниженной цене. Хватит ли плана от одной модели и исполнения другой для вашего репозитория, заранее сказать нельзя: прогоните две-три реальные задачи и сравните результат и стоимость. Актуальный список моделей и цен — GET https://api.zukko.pro/v1/models и страница «Модели» в кабинете. Другие приёмы экономии собраны в статье «Claude Code: экономия токенов»↗.

Plan mode в рабочем цикле

Полезная последовательность для нетривиальной задачи:

1. Включите план (Shift+Tab) и опишите задачу вместе с ограничениями.
2. Прочитайте план, поправьте через Ctrl+G или текстом, потребуйте список проверок.
3. Одобрите план с подтверждением правок, если задача затрагивает критичный код, или без, если вы доверяете направлению.
4. После выполнения попросите агента запустить указанные в плане проверки.
5. Для следующей независимой задачи начните новый чат: так в контексте не будет лишнего.

Если вы только знакомитесь с агентом, начните с полной настройки Claude Code↗, а ключ создайте в кабинете Zukko. Оплата — от $1: СБП (платёжная страница берёт 8,5% сверху), криптовалюта или карты MasterCard.

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

Plan mode меняет файлы?

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

Можно ли использовать plan mode с любой моделью?

Режим реализован в клиенте, а модель вы выбираете сами. Как конкретная модель справится с планированием, проверьте на своих задачах.

Чем план отличается от вопроса «что ты собираешься делать»?

Обычный вопрос не блокирует правки: агент может начать работать сразу. В plan mode запрет на изменение кода обеспечивает сам клиент.

Как вернуться из плана к обычной работе без одобрения?

Нажмите Shift+Tab ещё раз. Режим переключится без одобрения плана.