Агенту нужна выгрузка 1С в файлы: подключаем Claude Code и Codex через EDT и Git

Продолжим переход 1С-отдела на агентов на учебном пилоте: проверке заполнения поля в документе.

Claude Code и Codex работают с файлами проекта. Для первого чтения им хватит папки с исходниками; Git понадобится для контроля изменений.

Своего 1С-проекта у нас нет. Маршрут ниже собран по документации 1С. Наш опыт связан с правилами машины агентов, которая строит vibecoding.ru.

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

Выгрузка базы .dt переносит и данные учёта. Для чтения кода нужна другая операция: выгрузка конфигурации в файлы.

Пароли и реальные имена бывают и в модулях. Перед доступом агента проверьте содержимое папки исходников.

EDT не обязателен для агента. Конфигуратор тоже выгружает BSL и XML. Здесь разберём путь отдела, выбравшего EDT.

На базе для разработки сверьте версии платформы и EDT, режим совместимости и возможность менять конфигурацию.

Импорт не разрешает менять типовую на поддержке. Для пилота согласуйте доработку или выберите расширение.

EDT преобразует XML-выгрузку в своё представление. Проект EDT и выгрузка Конфигуратора не взаимозаменяемы.

Обновлять тестовую базу можно из EDT. Для возврата через Конфигуратор сначала экспортируйте из EDT в XML.

Проверка до агента: исходный проект собирается и запускается на тестовой базе. Это точка сравнения для правки.

В Большом опросе Инфостарта 2025 года 27,32 % ответивших на вопрос о контроле версий выбрали «Никакие не использовал(-а)».

Git покажет разницу до и после задачи. Слова «исправил только проверку поля» подтвердит список изменённых файлов.

В EDT у проекта выберите «Групповая разработка», «Общий проект…». Создайте репозиторий и сделайте первый коммит.

По руководству 1С, рабочая область EDT и репозиторий не вложены друг в друга. Агенту нужна папка проекта, не .metadata.

Первый коммит сохраняет исходную точку. Рядом запишите версии и способ проверки. Для задачи создайте ветку.

Запустите разрешённого в компании агента из каталога репозитория. Для чтения файлов ему не нужен плагин EDT.

Правила положите в AGENTS.md. Для Claude Code подключите этот файл строкой @AGENTS.md в CLAUDE.md.

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

Начните без правок: режим плана Claude Code или песочница read-only Codex. Инструменты доступа к базе пока не нужны.

Попросите найти процедуру и её вызовы. Проверьте пути и фрагменты кода в ответе по реальным исходникам.

Вся конфигурация не обязана помещаться в память модели. Задавайте конкретный объект и требуйте опору на код.

Агент может изменить файл, но не увидеть результат проведения документа. Правку нужно вернуть в тестовую базу.

В учебном пилоте проверяем поле документа. До правки опишите поведение при пустом и допустимом значении.

Сравните поведение до и после правки. Если агент сообщает об успехе, а сценарий никто не запускал, задача ещё не принята.

Правила не ограничивают права технически. Доступы настройте отдельно. .gitignore лишь управляет учётом файлов в Git.

MCP нужен под конкретную операцию, например диагностику EDT. Для чтения уже выгруженного BSL он не требуется.

Инженер ведёт нашу машину агентов через проверки. В открытом журнале работы видна история правок.

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

Если задача касается поля, а дифф затронул соседние объекты, остановите приёмку. Сначала выясните причину.

Ниже предлагаемый список проверок первой недели. Это возможные ошибки настройки, а не статистика внедрений в 1С-отделах.

На нашем сайте правила родились из поломок. В пилот 1С переносим порядок работы, а не готовые тесты сайта.

Вопросы для приёмки те же: что изменилось, чем проверено и останется ли проверка после закрытия задачи.

Причину ошибки верните в правила или тест. Если оставить её в переписке, новый агент повторит прежний путь.

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

В нашем курсе агентной разработки этому посвящены уроки «Файл правил целиком», «Одиннадцать шагов одной задачи» и «Руль, окно и сторож».

Курс построен на веб-проекте. Для 1С разработчик подбирает свои команды сборки и сценарии учёта.

Поручение отделу: «Подготовить файловый проект и проверить одну правку на тестовой базе».

В пилоте коллега должен повторить проверку поля и объяснить результат. Тогда подготовку можно принять.

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

1. Передайте агенту проверенные исходники. Копию базы с учётом храните отдельно.

2. Выберите формат и ответственного за его свежесть. EDT и выгрузку Конфигуратора не редактируйте как две равноправные версии.

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

4. Доведите правку до сценария на тестовой базе. Дифф и статическая проверка не заменяют результат в 1С.

5. Поручите коллеге повторить проверку. Каждый отказ приёмки превращайте в исправление правил или теста.