Вайб-кодинг для 1С с Claude Code: подготовка
Вайб-кодинг в 1С начинается не с промпта, а с представления конфигурации в файлах и понятной проверки в Конфигураторе. Агент видит текст, но не понимает вашу учётную логику без описания. Поэтому первая задача здесь простая: собрать безопасную копию, объяснить назначение модулей и выбрать изменение, которое можно проверить без боевых данных.
Коротко
Агенту нужен файловый контекст, а не снимок экрана Конфигуратора.
Выгрузка, ветка и проверка в Конфигураторе образуют минимальную страховку.
Инструкция проекта должна описывать объекты, правила и запреты, а не список команд без контекста.
Проводки, права и обновление конфигурации требуют отдельного ручного прохода.
Почему 1С нельзя отдавать агенту целиком
Конфигурация живёт в бизнес-правилах, именах объектов, расширениях и привычках команды. Два модуля с похожими названиями могут менять разные участки учёта. Агент быстро найдёт текст процедуры, но не узнает автоматически, какой документ нельзя перепроводить, где считается итог и какие регистры нельзя трогать без проверки.
Поэтому запрос «исправь расчёт» слишком широк. Сначала назовите документ, сценарий, роль пользователя и наблюдаемую ошибку. Затем перечислите, какие объекты агенту запрещено менять. Если работа касается движения по регистрам или прав доступа, добавьте отдельный шаг проверки в копии базы.
Самое полезное умение здесь не писать длинный промпт. Полезно сузить задачу до одного наблюдаемого эффекта и заранее решить, кто будет проверять конфигурацию после изменения.
Подготовьте файловую копию
Для агентной работы подготовьте файловый контекст, который можно хранить в git и сравнивать по диффу. Режим подготовки выбирайте по официальной документации 1С для своей версии платформы и по процессу команды. Не берите чужой шаблон за рабочую процедуру.
После выгрузки проверьте три вещи. В репозитории нет пользовательских данных, паролей и файлов подключения. Открываются нужные общие модули, формы и объекты метаданных. Наконец, изменения можно вернуть обычным коммитом, не собирая конфигурацию из случайной папки.
Не добавляйте в контекст резервную копию рабочей базы. Для разбора ошибки обычно хватает минимального примера: модуль, текст сообщения, обезличенные входные данные и ожидаемый результат. Чем меньше лишнего, тем проще увидеть, что агент сделал.
Напишите правила проекта для агента
Файл инструкций полезен, когда в нём есть решение для реальной неоднозначности. Опишите доменные термины, слои конфигурации, формат имён и тестовые сценарии. Отдельно перечислите запреты: не менять проведение без явной задачи, не трогать права, не добавлять внешние обработки и не хранить ключи в исходниках.
Добавьте практический порядок работы. Сначала агент читает модуль и связанный объект, затем предлагает план, после согласования меняет один участок, показывает дифф и список затронутых объектов. Такая последовательность снимает часть сюрпризов, когда модель видит знакомое слово и начинает чинить не тот расчёт.
Подробный формат таких файлов разобран в материале про инструкции для агента. Не копируйте чужой файл вслепую: в нём должны быть именно ваши правила проведения, расширений и сборки.
Процесс одной безопасной правки
Изменение конфигурации с агентом
- Повторите ошибку в копии
Подготовьте документы и условия, которые дают наблюдаемое расхождение. Запишите ожидаемый итог в словах, не ограничиваясь снимком экрана. Это станет критерием проверки.
- Покажите агенту узкую область
Назовите объект, модуль, форму и связанный тестовый сценарий. Попросите сначала объяснить текущий путь выполнения и назвать места, в которых он не уверен.
- Согласуйте план
План должен содержать перечень файлов и проверок. Если агент предлагает менять метаданные или регистры, остановитесь и решите отдельно, входит ли это в задачу.
- Прочитайте дифф
Смотрите на условия, обработку ошибок, запросы и вызовы записи. Случайная смена режима проведения или обход проверки доступа может не броситься в глаза на одном демонстрационном документе.
- Проверьте в Конфигураторе
Загрузите изменение в копию, обновите конфигурацию базы по правилам команды и повторите исходный сценарий. Затем проверьте соседний случай, где новое условие не должно срабатывать.
- Зафиксируйте итог
Коммитите только результат, который прошёл проверку. Если теста нет, оставьте в задаче конкретный ручной сценарий и причину, почему автоматизировать его пока нельзя.
Что проверять особенно внимательно
Проведение документа часто меняет данные не в одном месте. Даже маленькая правка может задеть движения, итоги, печатные формы или обмен. После агента проверьте исходный документ, отмену проведения, повторное проведение и сценарий пользователя с ограниченными правами, если он относится к задаче.
Расширения тоже требуют внимания. Агент может увидеть общий модуль и не заметить, что активное правило живёт в расширении. В инструкции полезно явно отметить, где искать переопределения. Иначе дифф окажется аккуратным, но не изменит рабочий путь.
Не просите агент «почистить все ошибки» в конфигурации. Такой запрос создаёт длинный список догадок и делает ревью почти невозможным. Разбирайте одну ошибку, один объект и одну проверку за раз.
Как подключить Claude Code к Relay
Для Claude Code нужна модель, доступная по протоколу Anthropic Messages. В инструкции Relay указан отдельный базовый адрес без /v1, переменная для токена и настройка модели из каталога. Секрет храните в окружении, не в файле выгрузки и не в модуле 1С.
Перед работой в конфигурации выполните маленькую проверку из страницы подключения Claude Code. Она показывает, что адрес, ключ и модель согласованы. После этого дайте агенту только каталог выгрузки, а не весь домашний диск.
Как читать план агента по конфигурации
План полезен, когда в нём есть не имена общих модулей, а путь данных. Попросите указать, где начинается сценарий, какая процедура получает входные значения, где выполняется запись и какие объекты могут изменить результат. Затем сравните этот путь с Конфигуратором и названием бизнес-правила.
Если агент видит несколько вариантов, пусть не угадывает. Хороший ответ перечисляет развилки: расширение или основная конфигурация, проведение или форма, общий модуль или подписка на событие. Вы выбираете путь, который соответствует вашему окружению, и только после этого разрешаете правку.
После изменения попросите составить обратный маршрут проверки. Какие документы создать, какой пользователь нужен, где увидеть итог и какой случай должен остаться прежним? Эта часть часто ценнее самого кода, потому что превращает догадку в проверяемую гипотезу.
Вопросы о 1С и агенте
Можно ли поручить агенту обновление рабочей конфигурации?
Нет без отдельного контролируемого процесса. Агент может подготовить изменение и подсказать, что проверить, но обновление рабочей базы связано с блокировками, совместимостью и бизнес-рисками. Решение о нём принимает ответственный за конфигурацию.
Что положить в первый промпт?
Укажите цель, объект, исходный сценарий, ожидаемый результат, запрещённые области и способ проверки. Добавьте, что агент должен показать план до правок. Этого достаточно, чтобы первая сессия не превратилась в обход всей конфигурации.
Нужен ли агенту доступ к данным из базы?
Обычно нет. Для анализа кода достаточно выгрузки и обезличенного примера. Если без данных нельзя воспроизвести проблему, подготовьте минимальный набор в копии базы и не передавайте персональные или финансовые записи. Зафиксируйте, кто подготовил копию и когда её можно удалить.
Сначала соберите безопасную выгрузку и завершите настройку по указанной выше инструкции. Общий порядок постановки задачи описан в статье про вайб-кодинг, а быстрый запрос к API есть в первом запуске.