Как использовать Claude Code для 1С

Чем Claude Code отличается от чатов с ИИ

Claude Code по сути превращает ИИ в полнофункционального ассистента, умеющего автономно работать с проектом, а не просто отвечать на вопросы. Как отмечается в официальной документации, в отличие от чат-бота, который лишь отвечает на запрос и ждёт нового указания, Claude Code может «читать ваши файлы, выполнять команды, вносить изменения и автономно работать над задачами, пока вы наблюдаете или делегируете». То есть вы описываете, что должно получиться, а Claude самостоятельно изучает кодовую базу, составляет план и реализует решение. Например, он может открыть исходный код объектов 1С, сгенерировать новый модуль формы, запустить компиляцию или прогон тестов – всё это без вашего непосредственного вмешательства. Благодаря такой «интеграции в кодовую базу» Claude Code ускоряет разработку: вместо того чтобы вручную пробрасывать исправления через конфигуратор и проверять их, вы сразу видите результат в чате.

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

Таким образом, Claude Code – это не просто чат, куда копируете код, а полноценный AI-ассистент в вашей IDE/терминале, знающий структуру проекта и умеющий выполнять шаги разработки самостоятельно.

Какие задачи решает Claude Code и где требуется MCP-сервер

Claude Code отлично подходит для генерации и доработки кода 1С, создания новых обработок, форм, отчётов и других объектов конфигурации. Например, агент может с нуля создать модуль справочника, формы и отчёта, прописать бизнес-логику на BSL, сгенерировать код обмена данными или заполнить стандартные процедуры. Он также умеет проводить рефакторинг (поиск и замена, оптимизация запросов), помогать писать обработки по описанному сценарию и отлаживать алгоритмы. Во многих рутинных задачах Claude Code практически заменяет человеческую рутину.

Однако ряд задач в 1С-среде требуются внешние сервисы (MCP-серверы), чтобы ИИ видел реальный контекст. MCP-серверы (Model Context Protocol) предоставляют Claude доступ к базе данных и метаданным 1С. Без MCP Claude «работает вслепую»: он не знает актуального синтаксиса платформы, структуры базы и не может выполнить SQL-запросы. Например, без MCP Claude не может проверить корректность запроса к регистру или увидеть, где лежат данные в базе. С подключённым MCP-сервером же агент может прямо запускать запросы в базе, выполнять произвольный BSL-код внутри 1С и проверять структуру конфигурации, быстро находя причины ошибок.

Ниже таблица иллюстрирует типовые сценарии:

Как видно, широкий спектр задач Claude Code решает самостоятельно, но когда дело доходит до реальной базы 1С, важно иметь MCP-сервер (особенно «1C-MCP» и «XML-MCP»): без него ИИ не «видит» данные и часто выдумывает несуществующий код. Соблюдение правила «MCP-First» (сначала пытаться использовать MCP-инструменты) резко снижает количество ошибок при использовании Claude Code.

Какой принцип работы Claude через агентов

За кулисами Claude Code работает по агентному принципу: он сам планирует шаги задачи и вызывает инструменты по мере необходимости. При запуске команды Claude читает ваш запрос вместе с системными инструкциями и контекстом проекта. Затем он оценивает состояние и решает, что делать дальше. Если требуется выполнить действие, Claude вызывает один или несколько инструментов (встроенные плагины или команды терминала), получает их результаты и на их основе принимает следующее решение.

Цикл работы агента можно описать так:

1. Получение запроса. Claude получает от вас сообщение и системный контекст (CLAUDE.md, история сессии).
2. Оценка и ответ. Модель решает, достаточно ли информации или нужно действовать. Она может сразу дать текстовый ответ либо запросить выполнение инструментов (например, «запусти сборку через команду Bash»).
3. Выполнение инструментов. SDK автоматически запускает запрошенные инструменты (например, читать/редактировать файлы, выполнять shell-команду, делать HTTP-запрос). Результаты этих действий возвращаются обратно моделью в цикл.
4. Повтор. Шаги 2–3 повторяются до тех пор, пока Claude не вернёт итоговый ответ без новых запросов к инструментам.

Иллюстрация из документации Anthropic: сначала агент может вызвать Bash для запуска тестов, затем анализирует ошибки, правит код и снова перезапускает тесты. В одном примере Claude в первом «ходе» запустил npm test (получил 3 сбоя), во втором — прочитал файлы, в третьем — внёс правки и снова запустил тесты, после чего все тесты прошли. Аналогично в 1С вы можете попросить Claude сгенерировать код, затем автоматически вызвать команду 1cv8.exe для запуска тестов, получить вывод и при необходимости скорректировать код.

Claude Code также может создавать дочерние агенты (subagents) для решения подзадач. То есть одна большая задача может разбиваться на несколько потоков: например, subagent для планирования, для поиска по метаданным, для генерации кода, а затем вновь объединяться в итоговый результат. Все эти агенты работают согласованно, передавая друг другу контекст задачи.

Таким образом, Claude Code реализует цикл «запрос – инструмент – ответ», где вместо простого ответа он может несколько раз вызывать утилиты (чтение/запись файлов, командная строка, внешние API) и последовательно уточнять решение.

Файл с правилами Claude для работы с 1С – как его создать и настроить

Для корректной работы Claude Code проект должен содержать файл правил CLAUDE.md (обычно в корне репозитория или в папке .claude). Это специальный текстовый файл, который Claude читает в начале каждой сессии. В нём задаются глобальные инструкции: команды запуска, стиль кода, договорённости по ветвлению, правила рабочего процесса и иные контексты, которые модель не может вывести из кода сама.

• Создание файла: в корне проекта откройте терминал и выполните команду /init (в Claude Code CLI). Это автоматически сгенерирует стартовый файл CLAUDE.md на основе структуры вашего проекта. Например:

  claude code session /init

  После этого в текущем каталоге появится CLAUDE.md.
• Содержимое и настройка: откройте CLAUDE.md в редакторе. Добавьте в него общие правила для вашего проекта: какие скрипты компилировать и запускать (например, сборку платформы 1С, выполнение тестов), какую модель использовать, общие соглашения по стилю BSL-кода и форматам файлов, основные контексты (версии платформы, названия общих модулей и т.п.). Укажите, например, команды командной строки для запуска компиляции или тестирования 1С, необходимые параметры запуска (1cv8.exe с определёнными ключами) и любые регулярные задачи. Claude будет читать эти инструкции при каждой сессии, что даст ему «постоянный контекст», недоступный из кода.
• Тон и объём: файл CLAUDE.md должен быть кратким и понятным. В документации советуют включать только широко применимые правила, избегая излишних деталей, чтобы не «зашумлять» модель. Используйте лаконичные формулировки (императивы вроде «всегда запускай», «никаких комментариев» и т.д.), которые Claude легко воспримет. Например, вы можете написать:

  - Запускать сборку конфигурации командой: 1cv8.exe ENTERPRISE /F ./Base /DumpCF ./output.cf
  - После каждой правки кода запускать встроенный синтакс-проверщик BSL и исправлять найденные ошибки.
  - Использовать модель Sonnet для задач генерации, Opus – только для архитектурных решений и безопасности.
  - Не коммитить конфиденциальные данные, выполнять команды в защищенной среде.

• Размещение и коммит: файл CLAUDE.md обычно хранится в корне проекта и подлежит коммиту в систему версий, чтобы вся команда могла совместно его редактировать. Дополнительно вы можете разделить настройки: глобальные правила поместить в ~/.claude/CLAUDE.md (действуют на все проекты), а проектно-специфичные – в каталоге проекта.

Таким образом, хорошо настроенный CLAUDE.md подскажет Claude особенности разработки на 1С именно в вашем проекте. Он станет «памятью» для агента: он будет знать, какие команды выполнять, какие правила следовать, и, например, автоматически вызывать синтакс-проверку BSL или запускать конфигуратор по нужному сценарию.

Тестирование после правок Claude Code – как создать тесты и автоматизировать

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

• Юнит-тесты в 1С: начиная с версии 8.3.16 в 1С:Предприятие есть встроенный фреймворк модульных тестов. Вы можете попросить Claude сгенерировать шаблон такой обработки тестов (BSL-код, проверяющий функцию). Например, создать внешний модуль Tests/ModuleTest с процедурами AssertEqual(...). Затем тесты запускаются из конфигуратора или через командную строку (например, 1cv8.exe ENTERPRISE /F ./Base /ExecuteModule Tests/RunAllTests – примерный формат команды). Такой цикл можно запустить прямо в терминале: Claude вызывает Bash-команду и анализирует результат.
• Автоматическое регрессионное тестирование: можно организовать сценарии тестирования через веб-клиент 1С. Например, используя возможности Playwright или других инструментов, Claude может эмулировать действия пользователя: открывать браузер, входить в веб-интерфейс 1С, заполнять формы и проверять результаты. В сообществе есть готовые навыки /web-test, /web-test-regression, которые автоматически прогоняют регрессию после изменений. Таким образом, после правок Claude запустит эмуляцию действий в веб-клиенте и сверит фактический результат с ожидаемым.
• Контейнерные/CI-тесты: настройте непрерывную интеграцию. Например, при пуше в репозиторий GitLab/GitHub автоматически запускать скрипт, который открывает тестовую ИБ (сценарий: копирует конфигурацию, запускает методы проверки). Это может быть обычный bat-файл или PowerShell, который вызывает 1cv8.exe для запуска линтинга и тестов, а затем логирует ошибки. Claude Code может сам написать такой скрипт или инструкцию.
• Пример использования Claude для тестов: в документации приведён пример: агент вызывает Bash-команду npm test, получает ошибки, правит код и снова перезапускает тесты. Аналогично, вы можете попросить Claude в 1С вызвать 1cv8.exe с командой запуска тестов и проанализировать вывод. Это автоматически завершит цикл проверки: Claude исправит код до тех пор, пока тесты не пройдут без ошибок.

Важно: интегрировать тестирование в workflow. После внесения изменений Claude должен «увидеть» зачёты/провалы тестов. Без этого агент «подумал, что всё хорошо», даже если появились скрытые ошибки. Поэтому перед закрытием задачи давайте Claude возможность запустить полный цикл тестов и учесть их вывод в своём ответе.

Рекомендации и особенности работы Claude Code для 1С

При работе с Claude Code в 1С-экосистеме учтите следующие моменты:

1. Приоритет MCP-серверов. Как уже отмечалось, для 1С наибольший прирост дают MCP-серверы. Обычно рекомендуют первым делом настроить 1c-mcp (для запуска запросов и получения метаданных) и XML-MCP (для безопасного создания/валидации XML-файлов конфигурации). В документации к проектам 1С нередко прописывают «MCP-First Rule» – сначала пробуем решить задачу через MCP-инструмент. Это снижает вероятность «галлюцинаций» ИИ (когда он придумывает несуществующие методы) и даёт модели реальный контекст данных.
2. Управление контекстом. Claude Code имеет ограниченное окно контекста. Старайтесь давать конкретные запросы и держать CLAUDE.md компактным, чтобы важные инструкции не «исчезали» в тексте. Часто советуют разбивать большие задачи на подзадачи (отдельные /task), чтобы каждый агент работал с меньшим объёмом информации. Также можно использовать подсказки («hooks»), например, сохранять результаты чтения файлов или автоматически отмечать изменённые файлы.
3. Модель Claude. Для 1С обычно рекомендуют модель Sonnet для решения большинства задач (синтеза кода, простых алгоритмов) и использовать Opus только для критических областей (архитектура, безопасность). Sonnet быстрее справляется с рутинными запросами и стоит дешевле по токенам.
4. Скорость разработки. Учтите, что загрузка конфигурации 1С и тестирование занимает значительное время. Например, в одном отчёте указано, что на написание кода агент тратит 10–15 минут, а на загрузку/отладку — ~30 минут, причём большая часть времени уходит на конфигуратор. Параллельность (запуск нескольких CLI-задач сразу) помогает незначительно: узким местом всё равно остаётся сервер 1С. Планируйте задачи с учётом этих задержек. Например, давайте Claude небольшие «порции» работы, чтобы он мог быстро вернуться к вам с результатом.
5. Проверка и ревью. Никогда полностью не доверяйте изменённому коду без проверки. Используйте встроенные линтеры и анализаторы (BSL-syntax, RSLint), которые можно запускать из CLI. Claude может сам подключить такой линтер через mcp-1c-syntax-check или аналогичные утилиты, и исправить очевидные ошибки. Сам пользователь должен тщательно пересматривать каждую сгенерированную проверку и тест.
6. Документация и правила. Поддерживайте в актуальном состоянии файл CLAUDE.md (и другие правила агента). Не секрет, что ИИ «запоминает» контекст из таких файлов: при росте проекта правила необходимо периодически пересматривать и корректировать. В крупных проектах часто заводят несколько файлов правил или подключают шаблоны (через @include). Это позволит Claude лучше ориентироваться в 1С-специфике вашего кода.

В целом, лучший результат даёт сочетание: Claude Code для автоматизации рутины и генерации кода, вместе с надёжной инфраструктурой MCP-серверов для проверки и контекста. Грамотное распределение задач (части делегируем ИИ, части – оставляем под контролем через тесты) позволит сильно ускорить разработку без потери качества.

Заключение

Claude Code может существенно облегчить жизнь 1С-разработчика, превращая ИИ из простого чат-ассистента в полноценного напарника по коду. Наиболее эффективный подход – это комбинировать возможности Claude с 1С-MCP-серверами и автоматическим тестированием. Создайте в проекте файл CLAUDE.md с инструкциями (команды запуска, правила кодирования, ссылки на тесты), подключите нужные MCP-сервисы и настройте CI для прогонки тестов. Тогда Claude будет автономно генерировать модули, формы и отчёты, а вы легко проверите результат по сигналам тестов и мониторингу.

Если эта статья была полезна, подпишитесь на блог MoscowSoft и рассылку новостей по 1С и ИИ. Также смотрите другие материалы на нашем сайте и задавайте вопросы команде – мы будем рады помочь в автоматизации разработки на 1С с помощью новейших технологий!