Вайб кодинг в 1С: агент, выгрузка конфигурации и проверка результата

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

Схема целиком

1. Конфигурация выгружается в файлы (XML и модули .bsl) и кладётся в git.
2. Агент запускается в терминале в каталоге с выгрузкой и правит модули.
3. Метаданные и справочную информацию агент получает из файлов или через MCP-сервер.
4. Результат загружается обратно в тестовую базу и проверяется в конфигураторе. Только после этого он идёт в рабочую базу.

Главное правило: рабочая (боевая) база агенту не доступна никогда. Работаете в копии или в базе разработчика.

Шаг 1. Выгрузка в файлы

Есть три пути:

• Конфигуратор. В меню конфигурации есть выгрузка в файлы (пункт «Выгрузить конфигурацию в файлы», точное расположение зависит от версии платформы).
• Пакетный режим. У конфигуратора есть параметры командной строки для выгрузки и загрузки из файлов, например DumpConfigToFiles и LoadConfigFromFiles. Точный синтаксис и ключи сверяйте с документацией вашей версии платформы, мы их здесь не приводим, чтобы не ввести вас в заблуждение.
• EDT. Если вы уже работаете в 1C:Enterprise Development Tools, проект и так хранится файлами, и подготовительный шаг не нужен.

Выгрузку положите под git и сделайте первый коммит до любых правок агента. Это ваша страховка: любое изменение видно в git diff, откатывается одной командой.

Шаг 2. Агент в терминале

Для Claude Code нужны три переменные (подробнее в документации↗):

export ANTHROPIC_BASE_URL=https://api.zukko.pro
export ANTHROPIC_AUTH_TOKEN=fetch_ваш_ключ
export ANTHROPIC_MODEL=claude-sonnet-5-5

Обратите внимание: адрес без /v1, а переменная именно ANTHROPIC_AUTH_TOKEN. Затем в каталоге с выгрузкой запускаете claude.

Для сложного рефакторинга можно переключиться на claude-opus-5-5, для рутины хватит claude-sonnet-5-5. Это решение по цене и задаче: проверьте на своём коде.

Шаг 3. Правила для агента в CLAUDE.md

Агент не знает вашу конфигурацию и соглашения. Положите в корень выгрузки файл CLAUDE.md и опишите их. Пример (подставьте свои пункты):

## Правила проекта (1С)
- Язык кода: встроенный язык 1С (BSL). Директивы компиляции &НаСервере, &НаКлиенте указывай явно.
- Не изменять типовые модули и объекты на поддержке без прямого указания.
- Запросы пиши в виде текста запроса с параметрами, без склейки строк.
- Не используй запросы в цикле; сначала собери данные одним запросом.
- Имена процедур: русские, с префиксом нашего решения.
- После правок перечисли изменённые файлы и что проверить в конфигураторе.
- Не придумывай методы платформы. Если не уверен, что метод существует, скажи об этом.

Последний пункт особенно важен: модель может уверенно выдумать метод или свойство платформы. Подробнее про такие файлы в статье про CLAUDE.md↗.

Шаг 4. MCP для метаданных

MCP-сервер это программа, которая даёт агенту дополнительные инструменты. Для 1С возможны два варианта:

• Готовые серверы сообщества. Они существуют, но качество и безопасность у них разные. Прежде чем подключать, прочитайте код и права: сервер не должен писать в рабочую базу и отправлять данные наружу.
• Свой небольшой сервер. Он читает вашу выгрузку и отвечает на вопросы вроде «какие реквизиты у справочника», «где используется этот регистр», «какие процедуры вызывают эту функцию». Для этого достаточно разбора XML и текстового поиска.

Подключение MCP в Claude Code описано в статье про MCP-серверы↗. Начните без MCP: часто хватает самой выгрузки, потому что агент и так умеет искать по файлам.

Что проверять после агента

Рабочий цикл на одну задачу:

1. Просите агента изменить один модуль, а не «весь отчёт».
2. Смотрите git diff. Читайте каждую строку, как чужой пул-реквест.
3. Загружаете изменения в тестовую базу.
4. В конфигураторе запускаете синтаксический контроль и проверку конфигурации. Ошибки копируете агенту.
5. Запускаете сценарий руками: проведение документа, формирование отчёта, граничные данные.
6. Для статического анализа можно подключить сторонний линтер для BSL (например, BSL Language Server с открытым кодом), перед использованием прочитайте его документацию.

Где агент полезен, а где опасен

Полезен:

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

Опасен:

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

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

Сколько стоит сессия

Допущение для небольшой доработки: 30 вызовов в агентной сессии на claude-sonnet-5-5 (0.4 / 2, кэш чтения 0.05, запись 0.5), Anthropic-формат. Свежий вход 150 000 токенов, чтение кэша 600 000, запись в кэш 100 000, выход 30 000.

150 000 × 0.4 / 1 000 000 = $0.06 600 000 × 0.05 / 1 000 000 = $0.03 100 000 × 0.5 / 1 000 000 = $0.05 30 000 × 2 / 1 000 000 = $0.06 Итого $0.20.

Это порядок величины, реальную цену покажет «Использование» в кабинете. Цены на 18 октября 2026, актуальные: GET https://api.zukko.pro/v1/models. Ключ создаётся в кабинете↗. Если вам нужны не агенты, а интеграция 1С с нейросетью по HTTP, смотрите статью про интеграцию 1С с нейросетью↗.

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

Можно ли писать код 1С без выгрузки в файлы?

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

Модель знает встроенный язык 1С?

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

Нужен ли MCP?

Не сразу. Начните с файлов и CLAUDE.md. MCP стоит добавлять, когда агент регулярно промахивается в метаданных.

Безопасно ли давать агенту доступ к базе?

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