Работу с ИИ-агентом, который меняет файлы и код проекта, начинайте с проверяемого результата: что должно измениться и как вы это увидите. Затем определите разрешённые действия, согласуйте подход для сложной задачи и проверьте изменения на собственном примере.
Агент может читать файлы, менять код и запускать инструменты, если это допускает среда. По документации Claude Code это основные возможности продукта. Но отчёт об исполнении не заменяет проверку: задача завершена, когда изменилось нужное поведение.
Поставьте задачу через наблюдаемое поведение
Вместо «почини фильтр» напишите, какие данные вы ввели, что получили и чего ожидали. Приложите минимальный пример без рабочих секретов. Сразу назовите ограничения: не менять оформление, не подключать платные сервисы, не публиковать результат.
В списке заявок фильтр «готово» оставляет строки со статусом «новая». Сначала найди причину и предложи план, не меняя файлы. После моего согласования исправь фильтр без изменения дизайна. Проверь набор из одной новой и двух готовых заявок: в выбранном режиме должны остаться только две готовые. Проверь также пустой список.
Подготовьте проект и разрешения
Начните с копии или отдельной ветки проекта. Сохраните исходное состояние в Git, если он используется. Перед запуском уберите из рабочей копии ключи, файлы .env и клиентские данные или замените их учебными значениями. Проверьте доступные агенту каталоги: он может читать не только текст, вставленный в чат. Разрешите только необходимые действия и узнайте, как приложение запрашивает подтверждение команд.
Просьба в тексте не заменяет настройки среды. Если требуется сначала обсудить изменения, включите режим плана или чтения, если среда его поддерживает; иначе ограничьте права и работайте в отдельной копии. Не исходите из того, что одинаковые названия режимов означают одинаковые права в разных приложениях.
Перед согласованием плана проверьте основание предполагаемой причины, список затрагиваемых файлов, команды и способ проверки результата. Уточните, какие выводы пока не подтверждены.
Двигайтесь небольшими изменениями
Для задачи с фильтром сначала добейтесь правильного отбора строк. Затем отдельно решайте, нужен ли счётчик результатов или новое сообщение при пустом списке. Такое разделение помогает понять, какая правка повлияла на поведение.
Если агент несколько раз повторяет одну ошибку, остановите цикл. Попросите показать наблюдения, которые подтверждают предполагаемую причину. Продолжать случайные изменения без новой информации обычно менее полезно, чем уточнить исходные условия.
Проверьте результат и сохраните доказательства
- Просмотрите список изменённых файлов и саму разницу с исходной версией.
- Повторите сценарий ошибки и контрольный случай, который работал раньше.
- Запустите подходящие существующие проверки проекта.
- Уточните, какие проверки не удалось выполнить и почему.
- Сохраните принятую версию и короткую инструкцию повторного запуска.
Для фильтра доказательством будет правильный набор строк на известном примере. Для формы — доставка тестового обращения и понятная обработка ошибки. Для расчёта — совпадение с заранее известным результатом. Выбирайте проверку по риску изменения, а не по длине отчёта агента.
Отделите принятие от публикации
Работающая локальная версия ещё требует подготовки размещения: настроек окружения, прав доступа, резервной копии и проверки по публичному адресу. Согласуйте этот шаг отдельно в задаче. После выпуска повторите ключевой путь пользователя уже на сервере.