Первый промпт: режимы подтверждения и план

Установка позади, пора работать. В этом уроке пройдём первую сессию от запуска до первой правки, научимся читать запросы на подтверждение и переключать режимы прав. Отдельно разберём режим планирования — самый полезный инструмент для тех, кто только начинает доверять агенту.

Запуск и приглашение

Перейдите в папку проекта и запустите claude. Над строкой ввода вы увидите версию, текущую модель и рабочую папку. Команда /help показывает список доступных команд, /resume — возвращает к прошлому разговору. Выйти можно командой /exit или дважды нажав Ctrl+D.

Три полезных префикса в строке ввода:

• / в начале — команда или навык. Наберите / и увидите меню с автодополнением.
• @ — упоминание файла или папки. Содержимое файла попадёт в контекст сразу, без ожидания, пока агент сам его прочитает: объясни логику в @src/utils/auth.ts.
• ! в начале — режим оболочки: команда выполняется напрямую, а её вывод добавляется в разговор.

Картинку можно вставить из буфера обмена (Ctrl+V, на Windows и WSL — Alt+V) или перетащить в окно терминала — удобно для скриншотов ошибок и макетов.

Первые вопросы

Документация советует начинать с понимания проекта, а не с правок. Хорошие первые запросы:

что делает этот проект?
какие технологии здесь используются?
где точка входа?
объясни структуру папок

Claude Code сам прочитает нужные файлы — вам не нужно добавлять контекст руками. Это хороший момент проверить, насколько он понял проект: если в ответе есть ошибки, скорее всего, в репозитории нет README или он устарел. Заодно можно спросить о самом инструменте: «что умеет Claude Code?», «как создать навык?» — у него есть доступ к собственной документации.

Первая правка

Простая задача для проверки: добавь в главный файл функцию hello world. Claude Code найдёт файл и покажет изменение. Если он спросит подтверждения, выберите «Yes». Дальше — по нарастающей: «добавь валидацию в форму регистрации», «есть баг: пользователь может отправить пустую форму, почини».

Формулировки решают многое. Документация приводит правило: вместо «почини баг» — «почини баг на логине, когда после неверного пароля пользователь видит пустой экран». Сложную задачу разбивайте на шаги в одном сообщении:

1. добавь таблицу user_profiles в схему
2. сделай эндпоинт GET/PUT /api/profile
3. сделай страницу, где пользователь видит и правит профиль

Ещё два совета из документации: дайте агенту сначала исследовать («проанализируй схему базы») и говорите с ним как с коллегой — описывайте, чего хотите достичь, а не какие файлы открыть.

Запрос на подтверждение

В ручном режиме перед правкой файла или запуском команды Claude Code остановится и покажет диалог: что именно он собирается сделать, и варианты ответа. Для правки файла — дифф, для команды — её текст. Обычно вариантов три: разрешить один раз, разрешить и больше не спрашивать, отклонить. При отклонении можно объяснить, что сделать вместо этого.

«Больше не спрашивать» для команд сохраняется навсегда для этого репозитория в .claude/settings.local.json. Для правок файлов разрешение действует до конца сессии. Пользуйтесь этим осознанно: разрешить npm test навсегда — разумно, разрешить произвольный curl — не очень.

Режимы прав

Режим задаёт, что агент делает без вопросов. Переключаются они клавишами Shift+Tab, текущий режим виден в строке состояния.

Цикл Shift+Tab идёт так: ручной → acceptEdits → plan → снова ручной; режим auto, если он доступен, встаёт после plan. На планах Pro, Max и Team сессия в терминале по умолчанию стартует в режиме auto; в нём классификатор блокирует рискованные действия — расширение области работы, незнакомую инфраструктуру, действия по указке из внешнего контента — а рутину пропускает. На Enterprise и при работе по ключу API стартовый режим — ручной. Первое нажатие Shift+Tab из auto переводит в ручной.

Есть ещё два режима вне цикла. dontAsk автоматически отклоняет всё, что не разрешено правилами, — для CI. bypassPermissions (флаг --dangerously-skip-permissions) пропускает все проверки; документация допускает его только в изолированных контейнерах и виртуальных машинах. Стартовый режим для одной сессии задаёт флаг --permission-mode, например claude --permission-mode plan.

Совет для начала: пока вы не научились читать действия агента, работайте в ручном режиме. Он утомителен, зато вы увидите каждую команду. Через неделю разрешите через /permissions то, что подтверждали чаще всего, и переходите в acceptEdits или auto.

Режим планирования

Это отдельная тема, потому что план — лучший способ убедиться, что агент понял задачу так же, как вы. В режиме plan Claude читает файлы, выполняет безопасные команды для исследования и пишет план изменений, но не редактирует исходники.

Войти в режим: Shift+Tab до ⏸ plan mode on, запуск с claude --permission-mode plan, либо префикс /plan перед одним конкретным промптом. Когда план готов, Claude Code предложит варианты:

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

Ctrl+G открывает план в вашем текстовом редакторе — можно поправить его руками до начала работы. В VS Code план открывается как документ Markdown с построчными комментариями.

Пример из практики. Задача для Flutter-приложения: «добавить офлайн-кэш для списка заказов». В режиме плана агент прочитал репозиторий с сетевым слоем, нашёл, что уже используется hive, и предложил план из четырёх шагов с указанием файлов. Разработчик увидел, что агент собирается кэшировать и ответы с ошибками, поправил план одной фразой и только после этого разрешил правки. Без плана эту ошибку поймали бы на ревью, а то и позже.

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

Остановить и откатить

Esc останавливает агента посреди действия, контекст сохраняется. Двойной Esc или /rewind открывают меню контрольных точек: восстановить разговор, код или и то и другое. Можно просто написать «отмени это» — агент вернёт свои правки. Если вы поправили агента дважды по одному и тому же поводу, документация советует не продолжать, а сделать /clear и написать новый, более точный промпт с учётом того, что вы узнали.