DF-ИИ-034 · ИИ в работе команды
Настройка ИИ-помощника для кода: права и проверки до старта
- Какие файлы правил читает помощник и где их хранить
- Какие действия и внешние подключения требуют отдельного разрешения
- Как разложить настройки по уровням прав на учебном примере
- Какие проверки зафиксировать до включения помощника в работу
Помощник для кода удобно включать «как есть»: поставили расширение, открыли проект, попросили поправить функцию. Через неделю выясняется, что он уже запускал команды в терминале, читал внешние документы и открывал pull request — и никто заранее не решил, что из этого допустимо.
Настройка начинается не с промптов, а с прав. Сначала команда фиксирует, какие файлы правил помощник читает, какие действия ему разрешены и какие подключения к внешним источникам открыты. Потом — какие проверки проходят его изменения, прежде чем попасть в общую ветку.
Ниже — порядок действий по обзорной документации Claude Code и GitHub Copilot. Это редакционный чек-лист Deskforge, а не отчёт об испытании продукта и не клиентский кейс: шаги нужно адаптировать к вашему стеку и вашим правилам. Смежная тема — ИИ пишет код в команде: как сохранить качество и контекст, а варианты работ с ИИ собраны на странице автоматизации процессов.
Что помощник читает и где хранятся правила проекта
Claude Code читает файл CLAUDE.md в корне проекта в начале каждой сессии. Это точка, где команда задаёт свои правила один раз, а не повторяет их в каждом запросе. В файл кладут стандарты кодирования, архитектурные решения, предпочитаемые библиотеки и чек-листы ревью.
Важная оговорка: это перечень возможного содержимого, а не рекомендация вписать всё сразу. Длинный файл правил размывает приоритеты, и помощник начинает трактовать их вольно. Начните с того, что действительно нарушается в вашем проекте: стиль, запрещённые зависимости, порядок ревью.
Если в репозитории уже есть AGENTS.md для других кодирующих агентов, Claude Code может читать его вместо CLAUDE.md. Формулировка «can read» не гарантирует, что файл будет прочитан при любой конфигурации, и не описывает, при каких условиях это происходит. Поэтому команде стоит выбрать один файл правил как основной, а второй либо убрать, либо оставить с явной отсылкой к первому — и проверить на практике, какой файл реально читается.
Отдельно про поверхности: настройки, файлы CLAUDE.md и MCP-серверы репозитория работают на всех поверхностях Claude Code, потому что они подключаются к одному движку. Значит, правило, записанное один раз, действует и в терминале, и в редакторе, — но и ошибка в нём распространяется так же широко.
Какие действия помощника требуют отдельного разрешения
Хуки позволяют запускать shell-команды до или после действий Claude Code: например, автоформатирование после правки файла или линт перед коммитом. Это удобно, но именно здесь помощник получает доступ к выполнению команд — и это решение команда принимает осознанно, а не по умолчанию.
Claude Code работает с git: индексирует изменения, пишет сообщения коммитов, создаёт ветки и открывает pull request. В обзорной документации не сказано, какие ограничения прав или подтверждения действуют при этих операциях, — поэтому границы задаёт команда: например, коммиты и открытие pull request разрешены, а слияние в основную ветку остаётся за человеком.
У GitHub Copilot есть облачные песочницы — изолированные среды, которые хостит GitHub, где Copilot запускает облачные сессии, не используя машину пользователя. Уровень изоляции и политика доступа в обзорной документации не раскрыты, так что считать песочницу заменой проверкам не стоит.
Copilot также может взаимодействовать с настольными приложениями для задач, которые нельзя выполнить более прямым инструментом. Границы доступа и риски этой функции в обзорной документации не раскрыты — это ещё один пункт, который команда решает до запуска, а не после инцидента.
Внешние подключения и политики: что ограничить до запуска
Через MCP Claude Code может читать внешние источники данных: документы в облачном хранилище, тикеты в трекере, сообщения из корпоративного мессенджера или собственный инструментарий компании. Это описание возможностей, а не утверждение, что такие подключения безопасны или разрешены в вашей компании. Каждый источник — отдельное решение с понятным владельцем.
У Copilot политики определяют, включены или отключены по умолчанию неконфигурированные функции и модели. Обзорная документация не перечисляет конкретные политики и их значения, поэтому список придётся собрать самим: что включено сейчас, что должно быть выключено и кто отвечает за изменение.
Администраторы предприятия могут централизованно задавать политики плагинов для пользователей, обеспечивая единообразную доступность плагинов. Механизм применения политик в обзорной документации не описан — проверьте на пилотной группе, прежде чем раскатывать на всех.
Матрица доступа: как разложить настройки по уровням прав
Практичнее всего свести настройки в таблицу «настройка — разрешено или нет» и утвердить её до первого запуска. Ниже — учебный пример на синтетических данных, не клиентский кейс. Он проверяет логику разметки прав, но не подтверждает работу реального сервиса или экономию команды.
| Настройка | Разрешено |
|---|---|
| Чтение файлов проекта | да |
| Правка файлов проекта | нет |
| Запуск shell-команд | нет |
| Внешние MCP-источники | нет |
| Коммиты и pull request | да |
| Слияние в основную ветку | нет |
Логика набора такая: помощник читает проект и предлагает изменения текстом — в ответе или в описании pull request, — но не правит файлы в рабочей копии, не запускает команды и не ходит во внешние источники. Правку вносит человек по этому предложению, а коммит и pull request помощник оформляет уже после неё, когда изменения появились в рабочей копии. Слияние в основную ветку остаётся за человеком, поэтому код попадает туда только через ревью.
Дальше матрицу расширяют по мере доверия. Открывая правку файлов, команда одновременно решает, какие хуки при этом срабатывают и кто смотрит diff. Открывая MCP-источник, называет владельца данных и срок доступа. Матрица — живой документ, а не разовая формальность.
Проверки изменений до включения помощника в работу
Первая проверка — файл правил. Убедитесь, что CLAUDE.md или AGENTS.md действительно читается: попросите помощника назвать действующие правила и сравните с тем, что записано. Если он цитирует устаревшую версию или второй файл вместо выбранного основного, проблема в конфигурации, а не в модели.
Вторая — хуки. Прогоните типовой сценарий: правка файла, форматирование, линт перед коммитом. Проверьте, что команды срабатывают именно там, где задумано, и не запускаются на чужих ветках. Примеры в документации — иллюстрация, а не гарантия поведения в вашем проекте.
Третья — git-операции. Посмотрите, какие ветки помощник создаёт и какие сообщения коммитов пишет. Сверьтесь с матрицей: коммит и pull request разрешены, слияние в основную ветку — нет. Если помощник пытается слить изменения сам, значит, граница в настройках не задана.
Четвёртая — облачные сессии.
Если используете песочницы Copilot, проверьте, какие репозитории и данные в них попадают и что остаётся после завершения сессии. Уровень изоляции в обзорной документации не раскрыт, поэтому выводы делайте по своим наблюдениям.
Зафиксируйте результат проверок письменно: какие настройки включены, какие выключены, кто отвечает за изменение матрицы. Тогда следующий сотрудник, подключивший помощника, начнёт с готовых правил, а не с чистого листа.