Claude Code для 1С: как настроить и где предел

Claude Code не знает про 1С ничего специального — и это нормально: он работает с текстовыми файлами, а конфигурация в формате EDT как раз ими и является. Ниже — как довести связку до рабочего состояния и где у неё жёсткий предел, о котором лучше знать заранее.

Что понадобится

• Конфигурация, выгруженная в файлы EDT. Обязательное условие. С бинарным .cf агенту работать нечем.
• Git над проектом. Не пожелание, а страховка: любую правку агента нужно уметь откатить одной командой.
• Установленный Claude Code и подписка либо ключ.
• Тестовая база с включённым OData — если хотите, чтобы агент сверял данные, а не выдумывал.

1. Открыть проект как обычный репозиторий

Никакой специальной настройки не нужно: перейти в каталог проекта EDT и запустить claude.

Первой командой — /init. Агент обойдёт файлы, поймёт структуру и создаст описание проекта. На конфигурации 1С это особенно полезно: раскладка каталогов EDT неочевидна, и без такого разбора агент будет каждый раз искать модули заново.

2. Записать правила проекта

Место, где выигрыш заметнее всего. Модель знает встроенный язык 1С, но не знает ваших соглашений — а в 1С их всегда много.

Что стоит внести в AGENTS.md или CLAUDE.md:

• какая конфигурация и на какой основе — типовая, доработанная, самописная;
• используется ли БСП и какие её механизмы трогать нельзя;
• соглашения по именованию: префиксы доработок, правила для общих модулей;
• что менять запрещено — типовые объекты, которые обновляются с релизами поставщика;
• как проверяется результат: кто и чем прогоняет.

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

3. Принять главное ограничение

Агент не запустит конфигуратор и не проверит своё творение в предприятии.

На обычных языках вайб-кодинг работает за счёт замкнутого цикла: агент пишет, запускает, видит ошибку, правит сам. В 1С этот цикл разомкнут — компиляция и запуск остаются за пределами его досягаемости.

Практический вывод: режим работы здесь «агент пишет, человек прогоняет». Это всё равно кратный выигрыш на рутине, но ожидать автономии не стоит. Развёрнуто — вайб-кодинг в 1С.

Частично цикл замыкают двумя способами: статической проверкой синтаксиса через bsl-language-server и плагином, который работает изнутри EDT, — про MCP и EDT.

4. Дать доступ к данным

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

Правила те же, что везде: отдельный технический пользователь, только чтение, никакой административной учётки. И работать с копией, а не с боевой базой — данные из неё уходят в модель.

5. Настроить русский язык

Мелочь, которая экономит раздражение. Агент понимает русский, но отвечать по умолчанию может по-английски. Закрепляется одной строкой в файле правил — как именно.

На 1С это заметнее, чем на других языках: и платформа русская, и код русский, и обсуждать его удобнее по-русски.

6. Начать с задач, где выигрыш очевиден

Порядок, который не разочаровывает:

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

Чего ждать не стоит

Гарантий по специфике платформы. Общие конструкции модели пишут уверенно, а регистры, обмены и механизмы БСП путают. Всё сложнее процедуры на экран проверяется.

Работы с .cf напрямую. Нет файлов — нет работы. Выгрузка в EDT — не опция, а вход.

Замены понимания платформы. Человек, который не отличает регистр накопления от регистра сведений, не сможет проверить ответ, — а проверять здесь обязательно.

Коротко о главном

• Специальной настройки не нужно: EDT-конфигурация — это обычные текстовые файлы, а /init разбирает их структуру.
• Соглашения проекта — в AGENTS.md. Отдельно перечислите, что менять нельзя.
• Цикл проверки разомкнут: конфигуратор агенту недоступен, прогоняет человек.
• Данные подключайте через OData к копии базы, только чтение, отдельный пользователь.
• Начинайте с разбора и поиска по коду, а не с разработки.
• Git обязателен: он превращает любую правку агента в обратимую.

Дальше: экосистема инструментов для 1С с проверенными цифрами, MCP для 1С, первый день в Claude Code.