Claude Code для 1С с нуля: что установить и как сделать первый проект

Шаг 1. Установите Claude Code

Claude Code запускается из терминала. Для Windows самый простой вариант — открыть PowerShell и выполнить:

irm https://claude.ai/install.ps1 | iex

После установки проверьте:

claude --version

Официальная инструкция Anthropic также предлагает установку через npm:

npm install -g @anthropic-ai/claude-code

но для первого знакомства проще использовать официальный установщик. Claude Code поддерживает Windows, macOS и Linux.

После этого перейдите в папку будущего проекта:

cd D:\Projects\My1CProject

и запустите:

claude

При первом запуске Claude предложит авторизоваться. Для подписки Pro или Max используется та же учетная запись Claude, что и в веб-интерфейсе.

Шаг 2. Как оплатить Claude Code из России

Здесь есть важный нюанс. Claude Pro официально доступен только в поддерживаемых регионах, а Anthropic прямо указывает, что платная подписка недоступна пользователям, находящимся за пределами таких регионов. Поэтому отдельной официальной инструкции «как оплатить Claude Pro из России» у Anthropic нет.

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

Для самой работы Claude Code можно использовать несколько моделей доступа — например, подписку Pro/Max либо корпоративные варианты Team/Enterprise. На момент подготовки статьи Pro стоит $20 в месяц в США, Max — от $100 в месяц.

Практический совет: сначала установите Claude Code и убедитесь, что он запускается. Покупать более дорогой тариф до того, как вы поняли свой реальный расход контекста, обычно нет необходимости.

Шаг 3. Подготовьте выгрузку конфигурации 1С в XML

Теперь понадобится проект, с которым будет работать Claude.

В обычной разработке 1С можно использовать выгрузку конфигурации в файлы. В Конфигураторе это команда:

Конфигурация → Выгрузить конфигурацию в файлы.

Укажите отдельный каталог, например:

D:\Projects\My1CProject\Configuration

В результате 1С создаст дерево файлов XML и модулей. Именно это дерево и становится рабочим пространством Claude Code.

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

Например, в проекте могут находиться:

• Configuration.xml
• Catalogs/
• Documents/
• CommonModules/
• InformationRegisters/
• DataProcessors/

а внутри объектов — XML-файлы метаданных и файлы с кодом BSL.

Это позволяет поставить Claude задачу вроде:

Найди все обращения к реквизиту X во всей конфигурации и составь список модулей, в которых он используется.

Для обычного чата пришлось бы самостоятельно искать и копировать код. Claude Code может выполнить поиск по всему дереву проекта.

Шаг 4. Не работайте непосредственно с единственной выгрузкой

Перед первым экспериментом сделайте копию проекта и желательно поместите его под Git.

Например:

D:\Projects\My1CProject\

После этого:

cd D:\Projects\My1CProject
git init
git add .
git commit -m "Начальная выгрузка конфигурации"

Теперь можно в любой момент увидеть, что именно изменил Claude:

git diff

А при неудачном эксперименте вернуть файлы к исходному состоянию.

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

Шаг 5. Создайте CLAUDE.md до первой серьезной задачи

В корне проекта создайте файл:

CLAUDE.md

Это обычный текстовый файл с правилами для Claude Code. Например:

# Правила проекта 1С

## Конфигурация
Версия платформы: 8.3.XX
Режим совместимости: 8.3.XX
Не изменять метаданные без явного указания пользователя.
Не изменять структуру XML и порядок элементов
без необходимости.
Не изменять эталонную выгрузку.

## Работа
Перед изменением сначала:
1. Изучить задачу.
2. Найти связанные объекты.
3. Составить план.
4. Показать план пользователю.
5. После согласования выполнить изменения.
Перед реализацией определить способ проверки результата.

## Безопасность
Не подключаться к боевой информационной базе.
Не выполнять операции удаления данных.
Не выполнять команды, назначение которых не понятно.

## Код
Комментарии в коде писать на русском языке.
После изменения запускать предусмотренные проектом проверки.

## Тестирование
Не считать задачу выполненной только потому,
что изменения внесены.
Результат считается подтвержденным только после
фактического выполнения проверки или теста.

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

Главная мысль: не надо каждый раз объяснять Claude одно и то же в промпте. Правила проекта должны быть записаны один раз.

Шаг 6. Первый запуск Claude Code

Теперь из каталога проекта выполните:

claude

Можно начать с совершенно безопасной команды:

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

После этого можно дать более содержательную задачу:

Найди все использования реквизита Номенклатура в документах и общих модулях. Ничего не изменяй. Составь список найденных мест.

На этом этапе ваша задача — не заставлять Claude сразу программировать, а убедиться, что он правильно понимает структуру выгрузки.

Шаг 7. Как автоматизировать выгрузку конфигурации

Ручная выгрузка через Конфигуратор подходит для первых экспериментов. Но если Claude Code используется постоянно, выгрузку желательно автоматизировать.

Есть два распространенных варианта.

Первый — использовать 1С:EDT. У EDT есть командная строка, позволяющая экспортировать проект в XML-файлы:

export --project D:\Projects\My1CProject ^
       --configuration-files D:\Projects\My1CProject\xml

Официальная документация 1С указывает, что команда export экспортирует проект EDT в XML-файлы конфигурации. Аналогично существует команда import для обратной загрузки XML в проект.

Второй — автоматизировать действия самого Конфигуратора. Это можно сделать с помощью командной строки 1С и скриптов, которые запускают нужные операции. Конкретный вариант зависит от версии платформы, типа конфигурации и используемого процесса разработки.

Для первого проекта я рекомендую не автоматизировать всё сразу. Сначала добейтесь следующей цепочки:

Конфигуратор
      ↓
Выгрузка в XML
      ↓
Git
      ↓
Claude Code
      ↓
Изменение файлов
      ↓
Проверка
      ↓
Git diff
      ↓
Загрузка в тестовую базу

Когда она начнет работать стабильно, автоматизируйте отдельные этапы.

Шаг 8. Как сделать так, чтобы Claude действительно проверял свои изменения

Это один из самых важных моментов.

Плохой вариант:

Исправь ошибку в этом модуле.

Claude изменит код и может ответить:

Готово. Ошибка исправлена.

Но это еще не доказательство, что исправление действительно работает.

Лучше сформулировать задачу так:

Сначала проанализируй проблему. Составь план. Предложи тест, который должен воспроизводить ошибочное поведение. Реализуй тест. Убедись, что тест сначала не проходит. Затем внеси исправление. Запусти тест повторно. Покажи фактический результат выполнения теста.

Получается цикл:

Ошибка
  ↓
Тест, воспроизводящий ошибку
  ↓
Тест НЕ проходит
  ↓
Исправление
  ↓
Тест проходит
  ↓
Регрессионные тесты

Это гораздо надежнее, чем доверять сообщению самого агента.

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

Шаг 9. Как написать первый тест

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

Для 1С это может быть, например:

1. Vanessa Automation;
2. 1С:Тестировщик;
3. собственные автоматизированные проверки;
4. внешние скрипты;
5. тестовая информационная база;
6. проверки компиляции и структуры выгрузки.

Поэтому сначала определите команду, которой можно проверить проект. Например, условно:

.\run-tests.ps1

Если команда возвращает код успешного выполнения, Claude может использовать её как один из критериев готовности.

В CLAUDE.md можно написать:

## Проверка
После изменения кода выполнить:
.\run-tests.ps1
Не считать задачу выполненной, если тесты
не были фактически запущены.
В итоговом отчете указать фактический результат
выполнения тестов.

После этого задача Claude становится значительно более определенной:

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

Так Claude превращается из «генератора кода» в участника инженерного процесса.

Шаг 10. Что автоматизировать в первую очередь

Не нужно пытаться построить полноценный CI/CD в первый день. Для начала достаточно автоматизировать четыре проверки:

После этого можно добавить автоматическую последовательность:

Claude Code
    ↓
Изменение
    ↓
XML-проверка
    ↓
Сборка
    ↓
Тесты
    ↓
Отчет

И только после успешного прохождения всех этапов считать задачу завершенной.

Шаг 11. Когда понадобится MCP

На первом этапе MCP вообще не нужен.

Если задача звучит так:

Найди все места использования регистра сведений X.

или:

Измени алгоритм в трех общих модулях.

Claude достаточно файлов выгрузки.

Но если задача звучит:

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

или:

Найди в базе контрагеров с определенным условием.

то одной выгрузки конфигурации недостаточно. Claude знает структуру программы, но не видит данные информационной базы.

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

Поэтому для новичка правильный порядок такой: сначала файлы → затем Claude Code → затем тесты → и только потом MCP.

Минимальный план внедрения Claude Code в разработку 1С

Если свести всё к одной последовательности, получится следующий план.

1. Шаг 1. Установить Claude Code и авторизоваться.
2. Шаг 2. Создать отдельную папку проекта.
3. Шаг 3. Выгрузить конфигурацию 1С в XML.
4. Шаг 4. Добавить проект в Git и сделать исходный коммит.
5. Шаг 5. Создать CLAUDE.md с правилами проекта.
6. Шаг 6. Запустить Claude и попросить его изучить структуру без изменений.
7. Шаг 7. Дать небольшую задачу, результат которой можно проверить через git diff.
8. Шаг 8. Подключить автоматическую проверку проекта.
9. Шаг 9. Добавить тесты и требовать от Claude фактического запуска тестов.
10. Шаг 10. Только после этого автоматизировать выгрузку/загрузку XML и подключать MCP.

Такой порядок важен. Если сразу дать агенту огромную конфигурацию, доступ к базе и право самостоятельно всё изменять, разобраться в результате будет гораздо сложнее.

Главная идея Claude Code для 1С — не передать разработку нейросети, а построить контролируемый процесс, в котором агент выполняет рутинную работу, а разработчик задает архитектуру, ограничения и критерии приемки. Именно такой подход позволяет использовать возможности агента, не теряя контроль над конфигурацией.