К содержимому
Блог

Вайб-кодинг для 1С с Claude Code: подготовка

Вайб-кодинг для 1С с Claude Code: подготовка

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

Коротко

  • Агенту нужен файловый контекст, а не снимок экрана Конфигуратора.

  • Выгрузка, ветка и проверка в Конфигураторе образуют минимальную страховку.

  • Инструкция проекта должна описывать объекты, правила и запреты, а не список команд без контекста.

  • Проводки, права и обновление конфигурации требуют отдельного ручного прохода.

Почему 1С нельзя отдавать агенту целиком

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

Поэтому запрос «исправь расчёт» слишком широк. Сначала назовите документ, сценарий, роль пользователя и наблюдаемую ошибку. Затем перечислите, какие объекты агенту запрещено менять. Если работа касается движения по регистрам или прав доступа, добавьте отдельный шаг проверки в копии базы.

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

Подготовьте файловую копию

Для агентной работы подготовьте файловый контекст, который можно хранить в git и сравнивать по диффу. Режим подготовки выбирайте по официальной документации 1С для своей версии платформы и по процессу команды. Не берите чужой шаблон за рабочую процедуру.

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

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

Напишите правила проекта для агента

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

Добавьте практический порядок работы. Сначала агент читает модуль и связанный объект, затем предлагает план, после согласования меняет один участок, показывает дифф и список затронутых объектов. Такая последовательность снимает часть сюрпризов, когда модель видит знакомое слово и начинает чинить не тот расчёт.

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

Процесс одной безопасной правки

Изменение конфигурации с агентом

  1. Повторите ошибку в копии

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

  2. Покажите агенту узкую область

    Назовите объект, модуль, форму и связанный тестовый сценарий. Попросите сначала объяснить текущий путь выполнения и назвать места, в которых он не уверен.

  3. Согласуйте план

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

  4. Прочитайте дифф

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

  5. Проверьте в Конфигураторе

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

  6. Зафиксируйте итог

    Коммитите только результат, который прошёл проверку. Если теста нет, оставьте в задаче конкретный ручной сценарий и причину, почему автоматизировать его пока нельзя.

Что проверять особенно внимательно

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

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

Не просите агент «почистить все ошибки» в конфигурации. Такой запрос создаёт длинный список догадок и делает ревью почти невозможным. Разбирайте одну ошибку, один объект и одну проверку за раз.

Как подключить Claude Code к Relay

Для Claude Code нужна модель, доступная по протоколу Anthropic Messages. В инструкции Relay указан отдельный базовый адрес без /v1, переменная для токена и настройка модели из каталога. Секрет храните в окружении, не в файле выгрузки и не в модуле 1С.

Перед работой в конфигурации выполните маленькую проверку из страницы подключения Claude Code. Она показывает, что адрес, ключ и модель согласованы. После этого дайте агенту только каталог выгрузки, а не весь домашний диск.

Как читать план агента по конфигурации

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

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

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

Вопросы о 1С и агенте

Можно ли поручить агенту обновление рабочей конфигурации?

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

Что положить в первый промпт?

Укажите цель, объект, исходный сценарий, ожидаемый результат, запрещённые области и способ проверки. Добавьте, что агент должен показать план до правок. Этого достаточно, чтобы первая сессия не превратилась в обход всей конфигурации.

Нужен ли агенту доступ к данным из базы?

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

Сначала соберите безопасную выгрузку и завершите настройку по указанной выше инструкции. Общий порядок постановки задачи описан в статье про вайб-кодинг, а быстрый запрос к API есть в первом запуске.

Создать аккаунт

Готовы подключиться?Войдите в консоль, пополните баланс и создайте API-ключ.