Агентный вайбкодинг — это работа, в которой вы описываете цель словами, а ИИ-ассистент сам читает файлы проекта, правит код и запускает команды, пока не решит, что задача выполнена. «Вайбкодингом» такой стиль называют, когда результат принимают, не читая код. В этом курсе мы берём ту же технику, но добавляем то, что делает результат пригодным для продукта: проверяемую цель, ограниченные права и просмотр изменений.
После урока вы сможете
- Объяснить, чем агентный инструмент отличается от чата и автодополнения
- Назвать, что в работе с агентом делает человек, а что агент
- Решить, подходит ли конкретная задача для агента, и записать границы
Содержание
Чем агент отличается от чата и автодополнения
Чат отвечает текстом: вы копируете ответ в проект сами и сами запускаете проверку. Автодополнение предлагает следующую строку в редакторе. Агентный инструмент действует сам. Документация Claude Code описывает его работу как цикл из трёх фаз: собрать контекст, выполнить действие, проверить результат. Фазы перемешиваются: агент ищет файлы, правит их, запускает тесты, читает ошибку и правит снова.
Для этого у агента есть инструменты. По документации Claude Code, они делятся на категории: работа с файлами, поиск, выполнение команд (сборка, тесты, git), доступ в сеть и подсказки по коду. Работая в папке проекта, агент видит файлы, терминал, состояние git и файл правил проекта, о котором мы поговорим в уроке 4.
Что делает
- Чат
- Отвечает текстом
- Автодополнение
- Предлагает строку
- Агент (Claude Code, Codex)
- Читает, правит, запускает
Кто применяет результат
- Чат
- Вы, вручную
- Автодополнение
- Вы, строка за строкой
- Агент (Claude Code, Codex)
- Агент, в рамках разрешений
Кто запускает проверку
- Чат
- Вы
- Автодополнение
- Вы
- Агент (Claude Code, Codex)
- Агент, если вы дали команду
Цена ошибки
- Чат
- Низкая
- Автодополнение
- Низкая
- Агент (Claude Code, Codex)
- Выше: затронуть могут десятки файлов
Оба инструмента существуют в нескольких вариантах. Claude Code работает в терминале, расширениях для IDE, десктопном приложении и браузере. Codex — это десктопное приложение ChatGPT, веб-версия, консольный клиент (CLI), расширение для IDE и облачные задачи. Курс опирается на терминальные версии: они работают одинаково на любой системе, и именно в них видно, что агент делает.
Что делает человек
Вы остаётесь частью цикла. Документация Claude Code прямо пишет: вы можете прервать агента в любой момент, дать контекст или попросить сменить подход. Ваши обязанности:
- Поставить цель. Не «улучши форму», а «после отправки пустой формы показывать ошибку под полем телефона».
- Назвать проверку. Тест, команду сборки, ожидаемый ответ. Документация Claude Code формулирует это так: агент останавливается, когда работа «выглядит готовой», и без проверки, которую он может запустить сам, проверяющим становитесь вы.
- Ограничить права. Что агенту читать, что менять, что запускать (урок 6).
- Прочитать дифф. Дифф — список изменений в файлах. Отчёт агента описывает намерение, дифф показывает результат.
- Принять или отклонить. Решение остаётся за вами.
Документация Codex про постановку задач говорит то же другими словами: цель, контекст, ограничения и проверка — четыре части хорошего запроса.
Границы ответственности
За код отвечает тот, кто его принял, а не тот, кто его написал. Агент не ответит перед клиентом за утечку данных и не знает договорённостей, которых нет в репозитории.
Черновик кода, поиск по проекту, объяснение незнакомого файла
- Кто отвечает
- Агент
Выбор архитектуры, модель данных, права доступа, платежи
- Кто отвечает
- Человек (агент — помощник и разведчик)
Запуск тестов и сборки
- Кто отвечает
- Агент по вашей команде
Решение «можно выпускать»
- Кто отвечает
- Человек
Хранение ключей и паролей
- Кто отвечает
- Человек: агенту их не передают
Подробный разбор ревью мы не дублируем — он есть в уроках библиотеки: Ревью кода, написанного ИИ и AI-Assisted Coding.
Когда агент подходит, а когда нет
Подходит, когда результат можно проверить автоматически или быстро глазами:
- небольшая функция или экран с понятным поведением;
- тесты для уже написанного кода;
- перенос однотипных правок на много файлов;
- разбор незнакомого репозитория: «где обрабатывается вход пользователя?»;
- черновик скрипта, документации, конфигурации.
Не подходит или требует человека рядом, когда:
- нет способа проверить результат (нет тестов, непонятно, как должно быть);
- задача затрагивает деньги, права доступа, персональные данные — агента можно подключить, но ревью делает специалист;
- вы сами не понимаете, что хотите получить: сначала сформулируйте цель, потом давайте её агенту;
- нужны действия в боевых системах (деплой, миграции на проде, рассылки);
- проект слишком мал для оправдания затрат: правка в одну строку быстрее вручную.
Маршрут курса
Дальше мы по шагам собираем рабочий процесс: установка двух инструментов (уроки 2–3), файл правил (4), цикл «план → правки → проверка» (5), разрешения и безопасность (6), тесты и git как страховка (7), подключения через MCP (8), стоимость и итоговое задание (9). Каждый урок кончается действием, которое можно проверить.
Что дальше
Следующий урок — Claude Code: установка и первая сессия. Если вы собираете продукт и хотите, чтобы специалист посмотрел его границы и план работ, посмотрите услугу разработки MVP.