Plan mode в Claude Code - это режим, в котором агент сначала изучает задачу и показывает план, а файлы проекта не правит, пока ты план не одобришь. Включается он клавишами Shift+Tab или командой /plan перед запросом. В Codex по его документации есть такой же режим с той же командой. Дальше важно прочитать план так, чтобы поймать ошибку до того, как она станет кодом.
Коротко
Что такое plan mode в Claude Code?
Документация Claude Code описывает режим одной фразой: он говорит Claude исследовать и предложить изменения, не делая их. Агент читает файлы, запускает команды для разведки и пишет план, но исходники не трогает. Правки остаются заблокированы, пока ты не одобришь план.
Разберём простым языком. Обычно ИИ-агент получает задачу и сразу начинает работать: создаёт файлы, правит код, ставит библиотеки. Это быстро, пока он понял тебя правильно. Если не понял, ты узнаёшь об этом по готовому результату, и откатывать приходится всё сразу.
В режиме плана порядок другой. Сначала агент рассказывает, что собирается сделать, и ждёт. На занятиях я объясняю это так: сначала агент пишет план, ты утверждаешь, потом код. Цикл, который я даю ученикам, звучит целиком так: отправил запрос, агент предложил план, ты план проверяешь, потом проверяешь результат и в конце сохраняешь версию.
Как включить режим планирования
| Где работаешь | Как включить | Как выйти |
|---|---|---|
| Claude Code в терминале | Shift+Tab или /plan перед запросом | Shift+Tab ещё раз или одобрить план |
| Приложение Claude, вкладка Code | переключатель режима под полем ввода, режим Plan | выбрать другой режим |
| Codex (приложение, CLI) | /plan или Shift+Tab | так же |
| Запуск сразу в режиме плана | claude --permission-mode plan | одобрить план |
Если хочешь, чтобы проект всегда стартовал с плана, документация Claude Code предлагает прописать defaultMode: plan в файле .claude/settings.json проекта. Для расширения VS Code есть своя настройка, claudeCode.initialPermissionMode.
В Codex, по справке OpenAI, /plan можно дать сразу с текстом задачи, и Codex начнёт планировать именно её. Пока Codex работает, команда временно недоступна.
Что режим запрещает, а что нет
В нескольких русских разборах написано, что в режиме плана агент «физически может только читать». По текущей документации это не так. Агент запускает команды, чтобы изучить проект. Если в сессии доступен автоматический режим, эти команды проверяет фоновый классификатор: одобренные выполняются, отклонённые блокируются. Если нет, команды вне встроенного набора команд только для чтения спрашивают у тебя разрешение. Так что «ничего не трогать» здесь значит «не править файлы проекта», а не «ничего не запускать».
Самое важное место - кнопка одобрения. Когда план готов, Claude Code предлагает выбрать:
- Yes, and use auto mode - одобрить и дальше работать в автоматическом режиме, без рутинных вопросов. Если этот режим недоступен, вариант называется «Yes, auto-accept edits».
- Yes, manually approve edits - одобрить и подтверждать каждую правку отдельно.
- No, keep planning - остаться в режиме плана и сказать, что поменять.
Одобрение выводит сессию из режима плана, и агент сразу начинает править. Если ты только учишься читать планы, выбирай ручное подтверждение: увидишь каждое изменение до того, как оно случится. Есть ещё Ctrl+G - открыть план в текстовом редакторе и поправить его прямо руками, до старта.
С Codex осторожнее. Справка OpenAI говорит, что режим плана собирает контекст, задаёт уточняющие вопросы и строит план до реализации. Отдельного обещания «только чтение» на этой странице нет. Поэтому в Codex я бы добавлял словами: «пока ничего не меняй, только план».
Как читать план, если ты не программист?
План агента часто выглядит как список технических шагов с названиями файлов. Читать его как код незачем. Я читаю его как подрядчика, который принёс смету: что сделает, чем это проверит, где подвох.
Цель одной фразой
В начале плана должно быть, что будет работать после него и как ты это поймёшь. «Улучшить форму» - не цель. «Форма отправляет заявку и показывает подтверждение» - цель.
Что изменится
Какие файлы, таблицы и настройки агент тронет. Если в списке есть то, о чём ты не просил, например рабочая база или чужая папка, спроси зачем.
Чего не будет
Хороший план говорит, что в этой работе НЕ делаем. Если такого раздела нет, попроси: «Допиши, что мы сознательно не делаем».
Как проверим
У каждого шага должен быть способ убедиться, что он готов: открыть страницу, загрузить тестовый файл, увидеть результат. «Проверить, что работает» без способа - не проверка.
Риски и вопросы ко мне
Что может сломаться и какие решения агент ждёт от тебя. Пустой раздел рисков в большой задаче - повод насторожиться.
Одна оговорка из моих правил. План - источник замысла, а не доказательство того, как система работает. Если план утверждает что-то про уже существующее поведение («выгрузка уже показывает X»), это проверяется по коду или на живом примере, прежде чем на этом строить.
Если формулировки плана непонятны, так и пиши агенту: «Объясни этот план без терминов, как руководителю: что изменится для пользователя». Вопросы, которые агент задаёт тебе до плана, - отдельный полезный приём, разобран в статье пусть агент задаёт вопросы.
Когда план обязателен, а когда лишний?
В моём рабочем пространстве граница записана правилом: если задача больше часа работы, у неё есть план. Микрофича меньше часа, в одном файле и с понятным путём, идёт без плана. Справка Codex проводит похожую границу: план до кода, если задача сложная, неясная или её трудно хорошо описать.
Вторая граница - цена ошибки. Чертёж проекта до кода, как я говорю на занятиях, нужен проектам с персональными данными, деньгами и оплатами и всему, что будет жить дольше месяца. Разовому скрипту он не нужен.
| Задача | План |
|---|---|
| Поправить текст кнопки, переименовать файл | не нужен |
| Разовый скрипт: свести выгрузку в таблицу | обычно не нужен |
| Новая функция в своём инструменте | нужен |
| Всё, что трогает деньги, персональные данные, рабочую базу | обязателен |
| Задача, которую ты не можешь толком описать | нужен, и с вопросами агента |
Лишний план тоже стоит денег, и это видно, когда планы живут в файлах. В моих проектах больше 500 файлов планов, и каждый следующий чат читает папку планов как список того, что взято в работу. Однажды на побочную идею, брошенную между делом, агент сразу написал план на 150 строк и шесть фаз. Ответ был «запиши в бэклог». План пришлось разбирать: любой новый чат увидел бы невыполненные фазы и решил, что их надо доделывать. С тех пор правило такое: сначала понять, берём ли задачу в работу, потом писать план.
План в файле: когда одного чата мало
Для короткой задачи плана в чате хватает: одобрил и поехали. Для работы на несколько дней я прошу агента сохранить план файлом в папку plans/ проекта. В файле - цель, фазы со статусами (не начато, в работе, готово), у каждой фазы результат и критерий «сделано», риски и итог в конце.
Зачем файл, если план уже в чате? Чат кончается: контекст заполняется, ты открываешь новое окно, и план остаётся в старом. Почему окна приходится закрывать, разобрано в статье гигиена контекстного окна. Файл читает любой следующий чат, а агент отмечает в нём, что сделано.
В Codex для длинной работы справка OpenAI предлагает похожий путь: настроить агента работать по шаблону плана выполнения, файлу PLANS.md.
Критика плана свежими глазами
Один чат пишет план и сам же в него вкладывается, поэтому дыр не видит. Для больших задач я разношу работу по трём окнам: первое пишет план, второе раскладывает его на фазы глазами человека, который его не писал, третье ищет дыры. Подробно эта схема разобрана в статье мультиагентные системы, здесь - одна деталь, которую легко упустить.
Критику надо просить отчётом, а не правкой. В моём промпте для третьего окна так и написано: не правь файл плана сам, покажи отчёт, я скажу, какие правки принять. Иначе критик перепишет план под себя, и ты снова не увидишь, что изменилось.
Ученику индивидуального трека я давал на домашку два правила к той же теме. Премортем, то есть «представь, что через год проект провалился, назови причины», запускать в новом окне. И не соглашаться на всё: читать, что агент пишет, и переспрашивать. Последний пункт моего чеклиста «план готов к коду» - согласие человека, а не «вроде нормально».
Если хочешь пройти этот цикл на своей задаче, на обучении работе с ИИ-агентами он стоит в центре занятия про первый код: агент предлагает план, ты критикуешь, он пишет, проверяем, доводим.
Частые вопросы
Частые вопросы
Главный вывод
Режим включается одной клавишей. Ошибку ловишь ты, когда читаешь план: цель, что изменится, чего не будет, как проверим, какие риски.
Практический шаг на сегодня: возьми задачу, которую собирался отдать агенту, включи Shift+Tab и прочитай план по этим пяти вопросам. На первый пустой ответ напиши правку, а при одобрении выбери ручное подтверждение правок.
Какой вопрос из пяти твой агент чаще всего оставляет без ответа?
Источники
- Choose a permission mode - режим плана, что агент делает при планировании, варианты одобрения и Ctrl+G, документация Claude Code
- Desktop application - режимы разрешений в приложении и совет начинать сложные задачи в Plan, документация Claude Code
- Model configuration - настройка opusplan, документация Claude Code
- Best practices, ChatGPT Learn - Codex: план до кода, режим Plan, интервью и PLANS.md
- Slash commands, ChatGPT Learn - команда /plan в приложении Codex
