Cursor для 1С: как писать код на BSL с ИИ-агентом

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

Принципы запроса к модели (что передавать, как формулировать) разобраны в статье про интеграцию нейросети в 1С↗. Здесь речь именно о работе в редакторе с проектом.

Cursor AI для 1С, шаг 1: выгрузите конфигурацию в файлы

Агент работает с файлами проекта, поэтому конфигурацию нужно превратить в дерево каталогов. Есть два распространённых пути:

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

В выгрузке окажутся модули .bsl и XML-описания объектов метаданных: справочники, документы, регистры, формы. Именно XML даёт агенту реальные имена реквизитов и измерений, поэтому не исключайте их из индекса.

Проверьте две вещи сразу. Первая: кодировка. Модули 1С из выгрузки обычно хранятся в UTF-8 с BOM, и редактор или агент, который сохранит файл без него, может испортить файл для обратной загрузки. Проверьте, как ведёт себя ваша связка, на одном тестовом файле. Вторая: размер. Крупная типовая конфигурация может насчитывать десятки тысяч файлов. Откройте в Cursor не всё дерево, а нужный подсистемный срез либо исключите ненужное в .cursorignore (формат как у .gitignore).

Шаг 2. Напишите правила для BSL

Правила это файл, который Cursor подмешивает в контекст агента. Современный формат лежит в каталоге .cursor/rules, подробно он разобран в статье как писать правила Cursor↗. Пример для 1С:

---
description: Правила работы с кодом 1С (BSL)
globs: **/*.bsl
alwaysApply: false
---

- Язык: встроенный язык 1С:Предприятие, платформа 8.3.
- Перед написанием кода найди в проекте XML-описание объекта метаданных
  и используй только реально существующие реквизиты, измерения и ресурсы.
- Если реквизита нет в XML, не придумывай его: задай вопрос.
- Соблюдай директивы компиляции: &НаКлиенте, &НаСервере, &НаСервереБезКонтекста.
  Не вызывай серверные процедуры из клиентского кода без явной передачи данных.
- Запросы пиши на языке запросов 1С, с параметрами (&Параметр), без склейки строк.
- Не используй запрос в цикле. Собирай данные одним запросом.
- Стиль и именование копируй из соседних процедур того же модуля.
- Не трогай блоки с пометкой "Не изменять".

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

Шаг 3. Работа с агентом в проекте

Рабочий порядок, который снижает количество выдуманного кода:

1. Откройте нужный модуль и явно добавьте в контекст файл модуля и XML объекта через @ в чате Cursor. Не рассчитывайте, что агент найдёт всё сам.
2. Сформулируйте задачу с границами. Например: «в обработчике проведения документа РеализацияТоваров добавь проверку остатков по регистру ТоварыНаСкладах; ничего другого не меняй».
3. Попросите сначала план, потом код. План вы читаете за полминуты, и неверные допущения видны до правок.
4. Смотрите diff. Принимайте правки по одному фрагменту.
5. Не поручайте за один запрос несколько объектов. Разбивайте на задачи по модулю.

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

Шаг 4. Как проверять код 1С

Правдоподобный код на BSL не значит рабочий. Минимальная проверка:

• Синтаксический контроль платформой. Загрузите изменения в тестовую базу и выполните проверку конфигурации.
• Статический анализ. Для BSL существуют сторонние анализаторы, например BSL Language Server и плагины для SonarQube. Подключите их в CI или локально и дайте агенту результат анализатора на исправление. Настройку смотрите в документации этих проектов.
• Ручная проверка запросов. Выполните текст запроса в консоли запросов на тестовых данных.
• Тестовая база. Любые изменения сначала там, никогда сразу в рабочей базе.
• Ревью. Код от агента проходит то же ревью, что и ваш.

Типичные ошибки моделей в 1С: несуществующие методы платформы, перепутанные контексты клиент/сервер, запросы в цикле, обращение к реквизитам через точку в запросе без соединения. Их удобно вписывать в правила по мере встречи.

Шаг 5. Подключите свой ключ

Свой API-ключ в Cursor задаётся в настройках моделей. Порядок по документации Zukko: создайте ключ в кабинете Zukko↗, в настройках Cursor включите собственный OpenAI-ключ, вставьте fetch_..., включите подмену Base URL на https://api.zukko.pro/v1, добавьте имя модели, например cursor-sonnet-5 (второе имя claude-sonnet-5, потому что Cursor не принимает имена, которые уже знает; список вторых имён — в документации Zukko), и нажмите проверку. Какие именно пункты и тарифы доступны у вас, зависит от версии и плана Cursor, цены подписки смотрите на сайте сервиса. Пошаговая инструкция есть в документации по Cursor↗, а если редактор не видит модели, поможет статья Cursor не видит модели после смены base URL↗.

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

Формула: вход × цена входа + выход × цена выхода, цены Zukko на 18 октября 2026. Допущения: сессия из 30 запросов агента, в каждом около 40 000 токенов входа (правила, открытые файлы, история) и 1 500 токенов выхода. Cursor работает через OpenAI-формат, поэтому скидку за кэш Claude шлюз не видит, и весь вход считается по цене входа: это верхняя оценка.

Все значения делятся на 1 000 000. У glm-5.3-flash контекст 128K, для больших модулей и длинной истории может не хватить, у остальных строк таблицы 1M. Для GPT-моделей чтение кэша видно и в OpenAI-формате, так что реальная сумма может быть ниже. Какая модель лучше справляется с BSL, цифрами не скажешь: возьмите три типовые задачи и прогоните на каждой. Текущие цены смотрите в GET https://api.zukko.pro/v1/models.

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

Знает ли Cursor язык 1С?

Модели знают его неровно. Поэтому нужны метаданные в проекте, правила и проверка платформой.

Cursor AI и 1С: можно ли работать с конфигурацией прямо из базы?

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

Безопасно ли отдавать код конфигурации модели?

Код уходит провайдеру модели. Исключите из индекса секреты и данные клиентов (.cursorignore), согласуйте политику с владельцем кода и прочитайте условия поставщиков.

Можно ли использовать Cursor без подписки?

Возможности зависят от плана Cursor. Смотрите актуальные условия на сайте сервиса.