Claude Code и 1С: агент пишет код и сверяет его с живой базой

Claude Code пишет доработку 1С и сам проверяет запрос на живой базе, с настоящими именами реквизитов. Как дать ему доступ без публикации базы и открытых портов.

Задача

Связка Claude Code и 1С обычно начинается с доработки: отчет по продажам с новой группировкой, обработка для массовой правки, выгрузка для смежной системы. Агент пишет быстро, но ему не хватает двух вещей. Первая - точные имена объектов и реквизитов именно этой конфигурации, с доработками и расширениями. Вторая - проверка на данных: запрос может быть синтаксически верным и при этом вернуть пустую таблицу или удвоенные суммы.

Без этого программист работает посредником: копирует текст агента в консоль запросов, запускает, несет ошибку обратно в терминал. Половина времени уходит на переключение окон.

Как это решают обычно

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

Скиллы для Claude и инструкции для Codex. Файлы с правилами: стандарты 1С, типовые ошибки, как писать запросы с виртуальными таблицами. Заметно повышают качество кода, особенно у новых проектов. Но скилл учит писать, а не проверять: правдоподобное имя реквизита, которого в вашей базе нет, он не поймает.

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

Все три способа полезны и хорошо сочетаются с тем, что описано ниже. Им не хватает одного шага: запуска на настоящей базе.

Как быстрее

В кабинете Жёлтого моста на карточке ключа есть промт для IDE-агентов: в нем адрес и авторизация, агент сам ходит в API командами curl. Второй вариант для Claude Code - подключить мост как MCP-сервер одной командой из кабинета. Тогда у агента появляются инструменты чтения и поиска по справке, а инструмент записи появится, когда на ключе включена запись в ИИ-чатах.

Дальше агент работает как программист за консолью. Отправляет текст модуля на проверку валидатором BSL Language Server и исправляет замечания уровня Error и Warning. Выполняет запрос в базе и получает строки или ошибку платформы с меткой места. Если к ключу приложена справка по структуре, смотрит в ней имена, а не угадывает.

Как это выглядит словами. Вы пишете: "Нужен отчет: выручка по менеджерам и номенклатурным группам за квартал, найди в базе, где это лежит, проверь запрос на данных и покажи первые строки". Агент ищет регистр в справке, пишет запрос, получает ошибку в имени ресурса, правит, запускает снова и показывает результат.

Подробнее о том, как шлюз стал средой разработки, в статье Разработка кода 1С с ИИ через Жёлтый мост.

Как это сделать

1. Создайте ключ на базу и запустите в ней обработку. По умолчанию ключ создается в режиме "чтение + запись". Если агенту нужно только читать, выберите при создании режим "только чтение".

2. На карточке ключа откройте промт "Для IDE-агентов" и вставьте его в Claude Code или Codex, в конце опишите задачу.

3. В Claude Code наберите /permissions и в разделе Allow добавьте правило Bash(curl:*): иначе агент будет спрашивать разрешение на каждый вызов. Либо подключите мост инструментами командой из кабинета и начните новый чат.

4. В Codex ослабьте режим одобрений для папки проекта, иначе он спрашивает подтверждение на каждую команду с выходом в сеть.

5. По промту "Для IDE-агентов" запись доступна сразу, если ключ в режиме "чтение + запись". Если мост подключен инструментами (MCP), для записи нужно еще включить на ключе переключатель записи "в т.ч. в ИИ чатах": первый раз его включает поддержка по вашему запросу. В обоих случаях каждый скрипт по умолчанию идет пробным прогоном: транзакция откатывается, а агент показывает, что изменилось бы. Настоящая запись будет, когда вы явно попросите сохранить.

Что знать заранее

• Ключ в промте равнозначен доступу к базе. Для внешнего исполнителя безопаснее временный ключ, а все обращения видны в журнале кабинета.
• Агент видит то же, что пользователь 1С, под которым открыта обработка. Персональные данные по умолчанию маскируются.
• Запросы к одной базе идут по очереди, ответ может прийти через 1-2 минуты. Для тяжелых проверок удобна копия базы с отдельным ключом, а как проверить чужой код до запуска, разобрано в практике Проверить чужой запрос 1С до запуска.
• Валидатор проверяет текст, а не смысл: итог все равно смотрит программист.
• Ключ стоит 81 рубль в сутки без лимита запросов, первые 3 дня бесплатно. Про подключение обычного чата Claude к 1С - в статье Как подключить чат ИИ к своей 1С.

Не уверены, как подключается именно ваша база - в 1С:Фреш, в аренде, своя серверная или файловая? Выберите свой случай на главной: покажем, что мешает и что меняет мост.