Codex для 1с

Codex для 1с можно начать использовать с копии исходников: попроси разобрать BSL-модуль, объяснить логику и предложить проверяемую правку без доступа к рабочему учёту. Для предметных инструментов есть сторонний плагин Unica: в его README на 22 октября 2026 года поддерживаемой указана платформа 8.3.27.x. Установка плагина и изменение базы - разные этапы.

Проверено: 22 октября 2026 года по документации OpenAI и репозиториям IngvarConsulting. Команды ниже сверены с источниками; Unica и подключение к живой базе 1С в этом разборе не запускались.

Как выбрать Codex для 1с под свою задачу?

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

BSL - язык модулей 1С. Выгрузка конфигурации в файлы позволяет дать агенту текст этих модулей и описание объектов. По документации OpenAI Codex CLI умеет просматривать файлы проекта, редактировать их и запускать установленные инструменты. Из этого не следует, что он безошибочно понимает правила твоего учёта.

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

Последний сценарий разобран в статье как подключают MCP к 1С. Здесь другой маршрут: работа с кодом и контроль результата, без повторения настройки HTTP-сервиса базы.

Как подготовить исходники и проверить первый результат?

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

1. Сохрани исходную версию файлов отдельно или зафиксируй её в своей системе контроля версий. Убедись, что можешь вернуть именно тот файл, который собираешься менять.
2. Убери пароли, строки подключения с секретами и реальные данные клиентов. Локальный запуск агента сам по себе не означает локальную обработку моделью.
3. Открой папку этой копии в Codex. Укажи существующий модуль, который хочешь понять, и дай ограниченную задачу.

Замени поле в угловых скобках на существующий путь к своему модулю. Этот учебный запрос составлен для статьи; его выполнение здесь не тестировалось:

Прочитай только модуль BSL по пути: <вставь путь к файлу>.
Если путь не указан или файла нет, попроси его назвать.
Пока не меняй файлы, не запускай 1С и не подключайся к базам.
Найди, где формируется запрос к данным.
Покажи путь файла, имя процедуры и короткие фрагменты кода,
на которых основан вывод. Объясни входные параметры и результат.
Если нужной логики в модуле нет, так и напиши.
Отдельно перечисли, чего не хватает для вывода о правильности.

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

Текст правил полезен, но он не отнимает у программы права доступа. Для первого опыта не предоставляй рабочую базу и секреты, даже если в запросе написано «только чтение».

Как установить Unica в Codex?

Ставь Unica, если тебе нужны его предметные инструменты, а не только объяснение текста. Это плагин IngvarConsulting с навыками и MCP-сервером unica, не отдельная редакция Codex от OpenAI.

В README Unica указаны Codex CLI и Git. Платформа нужна для действий, которые запускают 1С. Установка обычного пакета не равна сборке проекта из исходников: инструкции разработчика с Rust и Cargo для неё не нужны. Если устройство скиллов и плагинов пока непонятно, начни с разбора скиллов Codex.

На дату чтения автор приводит такую совместимость платформенных операций:

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

Для новой установки выполни в терминале команды из README:

codex plugin marketplace add IngvarConsulting/unica-marketplace --ref main
codex plugin add unica@unica

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

codex plugin list

В строке unica@... смотри столбец VERSION. Если команда установки не распознана, не подбирай случайный пакет с похожим названием: сверь свою версию CLI и текущую инструкцию автора.

Как проверить, что Unica видит твой проект?

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

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

В новой задаче Codex открой /mcp и проверь активное подключение unica. Затем попроси:

Используй Unica только для чтения этой копии проекта.
Вызови unica.view с пустыми аргументами {}.
Покажи обнаруженные наборы исходников и их фактические адреса.
Не выполняй unica.apply и операции с информационной базой.
Если инструмент не отвечает, покажи ошибку, не составляй ответ за него.

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

Нужны две проверки: в истории виден вызов инструмента; возвращённый набор относится к твоей копии. Если наборов нет, открой инструкцию настройки рабочего пространства. По ней unica.view {} возвращает найденные sourceSets, конфигурацию и рекомендуемое содержимое v8project.yaml; unica.check {} показывает готовность и ошибки настройки. Попроси агента объяснить найденные ошибки и предложить настройку для твоей копии, пока без записи. Повтори проверку после согласованного исправления: ложный ready не означает готовность исходников. Не разрешай запись ради исчезновения ошибки.

Как проверить правку перед загрузкой в 1С?

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

В документации стабильного пакета v0.13.0 файловая правка модуля существующего объекта отделена от синхронизации с ИБ. Этот путь ограничен допустимыми исходниками формата платформы; переносить его на любой EDT-проект нельзя. EDT - среда разработки 1С со своим форматом проекта.

Для приёмки задай порядок:

1. До изменений агент показывает затронутую процедуру и объясняет, что именно поменяет. Имена объектов и требования подтверждаешь по своему проекту.
2. После изменения просматриваешь разницу исходного и нового файла. Посторонние изменения отклоняешь; сохранить копию нужно до этого шага.
3. Передаёшь специалисту 1С задание: проверить изменённый модуль на платформе, затем повторить затронутый сценарий на тестовой базе. Например, для правки запроса заранее выбери учебный документ и ожидаемый набор строк; сравни состав результата до и после. Это пример плана проверки, не выполненный тест. Если ожидаемый результат неизвестен, правку пока не принимай.
4. Решение о переносе в рабочую базу принимаешь отдельно, с резервной копией и порядком восстановления. Если не можешь проверить расчёт или проведение, передай результат специалисту 1С.

У Unica есть отдельные платформенные операции: например, push применяет конфигурацию к базе. pull может перезаписать исходники; документация предупреждает об удалении несохранённых в истории и неотслеживаемых файлов. Не добавляй force:true как универсальное решение ошибки. В этом руководстве эти операции выполнять не требуется.

Также сверяй возможности установленного пакета, а не только ветки разработки. При чтении каталог стабильной поставки указывал v0.13.0; документация main уже отличалась. Например, у стабильной поставки публичная сборка ограничена CF/CFE, обещать по ней сборку EPF/ERF нельзя.

Если работаешь на удалённом рабочем столе через RDP, проверь, где находятся CLI, исходники и нужная платформа: доступ к экрану сервера не равен доступу агента к его файлам. Если у тебя только браузерный вход в 1С:Фреш, эта инструкция не предоставляет права выгрузки или установки расширений. Сначала уточни разрешённый способ работы у администратора; отдельный сервер сам по себе не решает эти ограничения.

Перед первой правкой закрепи правила проекта и разрешения агента. Открой ClaudeBase и посмотри программу обучения выше блока подписки: для этого шага выбери урок «Рабочее окружение: правила проекта и разрешения». Программа открыта без оплаты; доступ к материалам ClaudeBase предоставляется по подписке, подписки Anthropic и OpenAI оплачиваются отдельно. Подписка продлевается автоматически, отключить продление можно в кабинете.

Что делать, если установка или проверка не прошла?

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

Для обновления существующей современной установки README приводит порядок ниже. Сначала сверь раздел миграции: для старых выпусков 0.3.0-0.7.4 у автора отдельный переход, эти команды не универсальны.

codex plugin marketplace upgrade unica
codex plugin remove unica@unica
codex plugin add unica@unica

После обновления нужна новая задача. Если плагин больше не нужен, README предлагает удалить его и источник командами codex plugin remove unica@unica и codex plugin marketplace remove unica. Это не откат уже изменённых файлов или базы: их восстанавливают из своих сохранённых версий.

Источники

Открыты 22 октября 2026 года. Текст основан на документации, без собственного теста установки или работы с информационной базой.

• OpenAI: возможности Codex CLI.
• IngvarConsulting: установка, обновление и требования Unica.
• Unica: чтение исходников через предметные инструменты.
• Каталог стабильной поставки Unica.
• Пакет Unica v0.13.0.
• Ограничения файловой правки v0.13.0.
• Платформенные операции и предупреждения v0.13.0.