Claude Code: как ИИ-агент работает в реальном проекте

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

Чем агент отличается от подсказок в редакторе

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

Ключевое отличие в цикле. Агент не просто выдаёт текст, а действует и смотрит на результат: запустил, увидел ошибку, поправил, запустил снова. Именно это превращает его из справочника в исполнителя.

Что он реально закрывает

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

Пример из практики: переименование бренда

Задача звучит просто: заменить название компании во всём проекте. По факту это разметка, тексты, переводы на трёх языках, метатеги, шаблоны, файлы стилей и записи в базе данных.

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

Пример второй: правка вёрстки с проверкой глазами

Настоящая ценность появляется, когда агент умеет посмотреть на результат. Он открывает страницу в браузере, снимает скриншоты в нескольких разрешениях, читает вычисленные стили и находит то, что не видно в коде: элемент вылез за экран, картинка растянулась, текст перекрыт.

Это ломает старую схему, где разработчик говорит «у меня всё работает», а заказчик присылает скриншот с поехавшей вёрсткой. Агент проверяет сам и приносит доказательство.

Где агент ошибается

Первое: он уверенно делает не то, если задача поставлена размыто. Формулировка «сделай красиво» даёт результат, который придётся переделывать. Формулировка «фон должен закрывать всю секцию, кадр не подрезать, текст читается» даёт то, что нужно.

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

Третье: он не знает того, что знаете вы о проекте. Договорённости с клиентом, историю решений, причины костылей. Без этого контекста агент чинит то, что было сделано специально.

Внутрянка: как я строю работу с агентом

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

Второе: требовать проверку, а не обещание. Правило простое: изменение считается сделанным, когда есть доказательство. Скриншот, ответ сервера, замер веса файла. Слова «должно работать» не принимаются.

Третье: разделять задачи по риску. Массовые механические правки агент делает быстро и точно. Решения, влияющие на деньги и данные, остаются за человеком, а агент готовит варианты.

Четвёртое: беречь секреты. Доступы и ключи не должны попадать в открытые файлы и в переписку. Работа с продом идёт через отдельные ограниченные учётные записи, а одноразовые скрипты обновления удаляются сразу после запуска.

Сколько это экономит на самом деле

По моим проектам агент снимает от трети до половины времени на типовых задачах: контент, вёрстка, деплой, рутинные правки. На сложной архитектуре и продуктовых решениях выигрыш скромнее, потому что там основное время уходит на размышление, а не на набор кода.

Честная оценка: это не замена разработчика, а сильное ускорение того, кто понимает, что делает. Человеку без опыта агент так же уверенно поможет сломать проект.

С чего начать, если хотите попробовать

1. Возьмите скучную повторяющуюся задачу, где ошибку легко заметить.
2. Запишите правила проекта в один файл: стек, деплой, что нельзя трогать.
3. Требуйте план до изменений и доказательство после.
4. Не давайте доступ к боевой базе и платежам с первого дня.
5. Сравните время до и после на одной и той же задаче, а не по ощущениям.

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

Заменит ли агент разработчика? Нет, но заметно меняет состав работы: меньше набора кода, больше постановки задач и проверки.

Можно ли пускать его в рабочий проект? Да, с ограничениями по доступам и обязательными резервными копиями перед крупными правками.

Он пишет качественный код? На типовых задачах да, если в проекте есть примеры стиля. Без них получается технически верный, но чужеродный код.

Сколько это стоит? Подписка сопоставима с несколькими часами работы специалиста в месяц, поэтому окупается на первой же большой рутинной задаче.

Помогаю выстроить такую работу под проект: автоматизация процессов, аудит и ускорение сайта. Хотите обсудить, что в вашем проекте можно передать агенту - напишите.