Claude Code для 1С: настройка агента для работы с конфигурацией

Claude Code для 1С работает так же, как для любого проекта: он читает и правит текстовые файлы. Поэтому первый шаг не установка агента, а получение исходников конфигурации в виде файлов. Дальше нужны правила проекта (CLAUDE.md), способ проверки правок и аккуратность: агент не должен трогать рабочую базу. Ниже настройка по шагам, формулировки для CLAUDE.md и расчёт стоимости. Описание функций платформы 1С дано в общем виде, названия пунктов меню и ключи командной строки сверяйте с документацией вашей версии платформы.

Шаг 1. Получите исходники в файлах

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

• Выгрузка из Конфигуратора. В Конфигураторе есть выгрузка конфигурации в файлы (пункт меню в разделе «Конфигурация»), а в пакетном режиме есть соответствующая команда DESIGNER с параметром выгрузки. В выгрузке модули лежат в .bsl-файлах в каталогах объектов, например модуль общего модуля обычно в CommonModules/<Имя>/Ext/Module.bsl.
• Проект в 1C:EDT. Если вы работаете в среде разработки 1C:Enterprise Development Tools, исходники и так лежат файлами в проекте.

Возьмите конфигурацию для разработки, а не рабочую базу. Сразу положите каталог под git: коммит перед каждой задачей агента даёт возможность откатить любые правки. Загрузка изменённых файлов обратно в базу выполняется вашими обычными средствами (Конфигуратор или EDT), а не агентом.

Шаг 2. Подключите Claude Code к ключу

Установка и переменные описаны в документации Claude Code↗. Коротко:

export ANTHROPIC_BASE_URL=https://api.zukko.pro
export ANTHROPIC_AUTH_TOKEN=fetch_ваш_ключ
export ANTHROPIC_MODEL=claude-sonnet-5-5

Адрес без /v1, ключ в ANTHROPIC_AUTH_TOKEN. Запустите claude в корне каталога с выгрузкой. На Windows Claude Code работает нативно или через WSL; варианты установки смотрите в документации Claude Code.

Шаг 3. CLAUDE.md с правилами BSL

Файл CLAUDE.md в корне проекта Claude Code читает в начале сессии. Здесь вы объясняете агенту то, что разработчик 1С знает сам: язык, структуру и ваши соглашения. Общие принципы в статье как написать CLAUDE.md↗. Пример для 1С:

## Проект: конфигурация 1С (выгрузка в файлы)

### Что это
Выгрузка конфигурации в каталог. Правим только файлы `.bsl`. Не редактируй
XML-описания объектов метаданных и формы (`Form.xml`, `*.mdo`): их структура
хрупкая. Если для задачи нужны новые реквизиты или формы, опиши, что создать
в Конфигураторе, и не создавай их сам.

### Язык и стиль
- Язык: встроенный язык 1С (BSL). Ключевые слова и имена на русском, как в соседнем коде.
- Кодировка и переводы строк: сохраняй как в исходном файле, не перекодируй
  и не меняй окончания строк.
- Структура модуля: области `#Область ... #КонецОбласти`. Новые процедуры клади
  в подходящую область, не создавай новую без необходимости.

Адаптируйте под себя: список правил должен быть коротким и проверяемым. Правила из стандартов разработки вашей организации можно добавить отдельными пунктами. Запись про команду анализа замените реальной или удалите.

Шаг 4. Проверки

Агент ошибается, особенно с методами платформы, которые редко встречаются в открытом коде. Три уровня проверки:

1. Статический анализ. Для BSL существуют сторонние анализаторы (BSL Language Server, плагин SonarQube для BSL). Запустите один из них командой из его документации и впишите эту команду в CLAUDE.md, тогда Claude Code будет запускать её сам и исправлять замечания. Автоматизировать запуск после каждой правки можно хуками (хуки Claude Code↗).
2. Загрузка и проверка в Конфигураторе. Синтаксический контроль модулей платформа выполняет сама. Это обязательный шаг перед тем, как идти дальше.
3. Тест на копии базы. Результат проверяйте человеком на тестовой базе, а не на рабочей.

Пример простой задачи, после которой стоит открыть diff:

Функция ПолучитьОстатки(Склад) Экспорт
	Запрос = Новый Запрос;
	Запрос.Текст =
		"ВЫБРАТЬ
		|	Остатки.Номенклатура КАК Номенклатура,
		|	Остатки.КоличествоОстаток КАК Количество
		|ИЗ
		|	РегистрНакопления.ТоварыНаСкладах.Остатки(, Склад = &Склад) КАК Остатки";
	Запрос.УстановитьПараметр("Склад", Склад);
	Возврат Запрос.Выполнить().Выгрузить();
КонецФункции

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

Какую модель выбрать

Для BSL мы не утверждаем, какая модель пишет лучше: на этом языке мало открытого кода, и результат зависит от задачи. Практичная схема: основная модель claude-sonnet-5-5, для сложных правок переключайтесь на claude-opus-5-5 командой /model и сравнивайте результаты на двух-трёх своих задачах. Индекс силы в каталоге: у Opus 5.5 58, у Sonnet 5.5 48. Окно контекста у обеих 1M токенов, чего хватает на крупные модули.

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

Допустим (условный пример), сессия на нескольких правках расходует 2M входных токенов, из них 1,7M читаются из кэша, 0,1M записываются в кэш, 0,2M свежие; выход 0,08M. Claude Code работает в Anthropic-формате, поэтому шлюз видит чтение и запись кэша. Цены Zukko на 18 октября 2026, $ за 1M токенов. Формула: свежий вход × цена входа + чтение × цена чтения + запись × цена записи + выход × цена выхода.

• claude-sonnet-5-5 (вход 0.4, чтение 0.05, запись 0.5, выход 2): 0,2 × 0,4 + 1,7 × 0,05 + 0,1 × 0,5 + 0,08 × 2 = 0,08 + 0,085 + 0,05 + 0,16 = $0.375.
• claude-opus-5-5 (вход 0.8, чтение 0.08, запись 1, выход 4): 0,2 × 0,8 + 1,7 × 0,08 + 0,1 × 1 + 0,08 × 4 = 0,16 + 0,136 + 0,1 + 0,32 = $0.716.

Разбиение токенов условное: своё смотрите в разделе «Использование» кабинета. Большие модули и «прочитай всю конфигурацию» расходуют больше, поэтому ограничивайте задачу конкретными модулями. Создайте отдельный ключ для проекта с дневным лимитом, например $5.

Вайб-кодинг и Codex для 1С

«Вайб-кодинг» в 1С возможен, но дороже по последствиям, чем в веб-проекте: ошибка в проведении документа или обработке регистров исказит учётные данные. Поэтому работайте маленькими задачами, коммитьте до и после и не передавайте агенту рабочие базы и пароли. Похожая схема есть у Codex: вместо CLAUDE.md он читает AGENTS.md. Если вам нужна интеграция 1С с моделью по API из самой конфигурации, это другая тема: интеграция нейросети в 1С↗.

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

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

Может ли Claude Code работать с 1С напрямую в базе?

Нет, он работает с файлами. Конфигурацию нужно выгрузить в каталог, а правки загрузить обратно средствами платформы.

Знает ли модель язык 1С?

Базовый синтаксис BSL модели обычно знают, но с редкими методами платформы и вашими объектами ошибаются. Поэтому нужны CLAUDE.md с правилами, статический анализ и проверка на тестовой базе.

Нужна ли подписка?

Нет. Ключ Zukko подключается к Claude Code через переменные окружения, оплата за использованные токены. Из России оплата доступна через СБП (комиссия платёжной страницы 8,5% сверху), карту MasterCard или криптовалюту.

Можно ли использовать дешёвую модель?

Можно попробовать, например glm-5.3-flash или deepseek-v4.1-flash, но проверьте результат на своих задачах: у GLM окно 128K, а на длинных модулях оно кончится раньше.

Чтобы начать, создайте ключ в кабинете Zukko↗, выгрузите тестовую конфигурацию в каталог и запустите claude в нём.