С чего начать

Поставить, открыть проект, заполнить профиль — и дерево команд готово к работе.

Установка

Поиск по 1C: Platform Tools в панели расширений (Ctrl+Shift+X) или ссылкой:

Редактор	Откуда ставить
Visual Studio Code	VS Marketplace
Cursor, Windsurf, VSCodium	Open VSX
Без доступа к маркетплейсу	файл .vsix из релизов, Extensions: Install from VSIX…

В Cursor работают те же панели и команды. Подключение MCP — в разделе MCP-сервер.

Расширение активируется, когда в рабочей области есть проект: каталог с файлом packagedef. Панели 1С: Проекты и 1С: Администрирование работают и без открытого проекта: первая поможет найти и открыть нужный, вторая не привязана к рабочей области вовсе.

Что нужно для работы

• Платформа 1С:Предприятие 8 — клиент, конфигуратор, 1cestart, rac/ras, ibsrv, ibcmd.
• OneScript, OPM и vanessa-runner — из раздела Зависимости в дереве 1С: Инструменты.
• 1С:EDT — если исходный код ведётся в формате EDT, см. Формат EDT.
• MCP — расширение 1C: Platform Tools MCP, если команды вызывает агент, см. MCP-сервер.

Без локальной 1С команды можно выполнять в Docker — см. Docker и ibcmd.

Первые шаги

1. Откройте существующий проект 1С с файлом packagedef или выполните команду 1С: Зависимости: Инициализировать проект.

2. При необходимости выполните 1С: Зависимости: Инициализировать структуру проекта. Будут созданы каталоги по шаблону vanessa-bootstrap.

3. Настройте подключение к ИБ в основном профиле запуска. Формат файла зависит от установленного vanessa-runner (расширение определяет версию автоматически):

   // env.json — vanessa-runner 2
   { "default": { "--ibconnection": "/F./build/ib" } }
   
   // autumn-properties.json — vanessa-runner 3
   { "vrunner": { "ibconnection": "/F./build/ib" } }

   Профиль можно создать из дерева Служебные файлы (пункт «Осн. профиль запуска») или из статус-бара.

4. Установите зависимости через раздел Зависимости или команду 1С: Зависимости: Установить зависимости.

5. Откройте панель 1С: Инструменты и запускайте нужные команды из дерева.

Пошаговое знакомство со всеми панелями есть и внутри редактора — walkthrough Начало работы с 1C: Platform Tools (Help → Welcome или F1 → Welcome: Open Walkthrough).