Для старта нужны установленная платформа 1С:Предприятие, доступ к своей информационной базе и настольное приложение ChatGPT с разделом Codex. Остальную подготовку — Git, Python, Node.js, структуру каталога и настройки навыков — можно поручить Codex. Ниже есть и ручной способ установки плагинов.
1. Установите настольное приложение ChatGPT
На обычном Windows скачайте приложение с официальной страницы ChatGPT, установите и войдите в свою учётную запись. В приложении выберите Codex и откройте папку проекта 1С. Это локальная работа с файлами на вашем компьютере.
Для Windows Server с графической оболочкой, если обычный установщик или Microsoft Store недоступны, OpenAI публикует подписанный MSIX-пакет. В PowerShell под пользователем, который будет запускать приложение:
$package = Join-Path $env:TEMP 'ChatGPT-x64.msix'
Invoke-WebRequest 'https://persistent.oaistatic.com/codex-app-prod/ChatGPT-x64.msix' -OutFile $package
Add-AppxPackage -Path $package
Этот пример для x64; для Arm64 ссылка есть в официальной инструкции. Команда Add-AppxPackage устанавливает MSIX в учётную запись пользователя; поддержка MSIX на Windows Server зависит от версии и состава системы. На Server Core настольный интерфейс не предполагается — используйте Codex CLI на подходящем рабочем компьютере или сервер с графической оболочкой. При ошибке установки проверьте системные требования и зависимости MSIX, а не скачивайте неофициальные сборки.
2. Зачем нужны два проекта
Unica — плагин для Codex и Claude Code с навыками и MCP-сервером. Он помогает искать и анализировать BSL-код, работать с метаданными, формами, ролями, СКД и выполнять проверки. Его runtime-возможности связаны с конкретной версией платформы: в README Unica сейчас указана поддержка 1С 8.3.27.x.
cc-1c-skills — набор навыков для полного цикла работы с исходниками 1С: XML-выгрузка конфигурации, расширения, внешние обработки и отчёты, загрузка изменений в базу, запуск и тестирование через веб-клиент. Для Windows в проекте есть вариант на PowerShell, для других случаев — на Python. Для операций с базой используется локальный файл .v8-project.json; его формат описан в руководстве.
Оба проекта можно установить вместе. Если их возможности пересекаются, в задаче указывайте, каким плагином выполнять конкретную операцию. Например: «проанализируй BSL через Unica, выгрузи базу через cc-1c-skills». Базу и исходники сначала нужно сопоставить: нельзя считать, что версия в Git автоматически совпадает с конфигурацией в информационной базе.
3. Подключите плагины
Вручную
Для точной установки из репозиториев используйте Codex CLI. Если команды codex нет, установите CLI в PowerShell официальной командой:
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
codex --version
Установите Unica по её README:
codex plugin marketplace add IngvarConsulting/unica-marketplace --ref main
codex plugin add unica@unica
Добавьте marketplace второго проекта:
codex plugin marketplace add Nikolay-Shirokov/cc-1c-skills
codex
В открывшемся Codex введите /plugins, выберите 1c-skills (PowerShell) и нажмите Install. Если предпочитаете Python-вариант, выберите 1c-skills-py. Это способ из README cc-1c-skills. После установки откройте новую задачу в настольном приложении: новый сеанс подхватит навыки и инструменты плагинов. Доступные установки можно проверить командой codex plugin list.
Поручить настройку Codex
Откройте в настольном приложении папку вашего проекта 1С и отправьте этот запрос. Замените текст в квадратных скобках своими путями и сведениями о базе:
Подготовь эту папку как локальный проект 1С для работы в Codex.
Изучи актуальные README:
https://github.com/IngvarConsulting/unica
https://github.com/Nikolay-Shirokov/cc-1c-skills
1. Проверь, какие компоненты уже установлены: Git, Codex CLI, Python,
Node.js и платформа 1С. Установи недостающие Git, Python и Node.js,
если они нужны выбранным навыкам; используй официальные источники
или системный пакетный менеджер. Платформа 1С установлена здесь:
[путь к каталогу bin 1С].
2. Подключи плагины Unica и cc-1c-skills к Codex по актуальным
инструкциям авторов. Для Windows выбери PowerShell-вариант cc-1c-skills,
если нет причины выбрать Python.
3. Проверь содержимое этой папки. Если это существующий проект, сохрани
принятую структуру. Если проект пустой, подготовь Git и каталоги
src/cf, src/cfe, src/epf, src/erf. Создай короткий AGENTS.md
с правилами этого проекта.
4. Настрой локальное подключение к базе разработки [тип, путь или сервер
и имя базы] для cc-1c-skills. Не добавляй пароли и локальные файлы
настроек в Git. Укажи, какие сведения о базе ещё нужны.
5. Определи, где актуальная конфигурация — в базе или в исходниках Git.
Пока не загружай конфигурацию в базу и не перезаписывай исходники.
6. Проверь, что плагины доступны в новой задаче. Покажи, что установлено,
какие файлы созданы и каким будет первый безопасный шаг работы с 1С.
Codex может скачать и настроить обычные инструменты, если у него есть права на их установку и доступ в сеть. Он не сможет сам получить вашу лицензию 1С, узнать пароль базы или выбрать актуальную версию конфигурации без исходных данных. Плагины, установленные в ходе текущей задачи, используйте после открытия новой задачи.
Когда окружение готово, первый рабочий запрос может быть таким:
Изучи
AGENTS.md, исходники и состояние Git. Найди нужный модуль через Unica, предложи минимальную правку, выполни её и покажи diff и результаты проверок. В базу разработки загружай изменения только после того, как назовёшь её и покажешь состав загрузки.
Дальнейшие детали — в руководстве по проекту cc-1c-skills и операциям с базой.