Что мы оцениваем в репозитории
- есть ли уже CLAUDE.md и что в нём: насколько он короткий, актуальный и не противоречит сам себе
- как запускаются тесты, сборка и линт и знает ли о них агент
- структура репозитория, в том числе монорепозиторий и части, которым нужны свои правила
- где помогут правила, привязанные к путям, а где хватит общих
- какие AI-инструменты команда уже использует и как они настроены
Слой инструкций
Основной файл — CLAUDE.md в корне репозитория или в .claude/; личные заметки идут в CLAUDE.local.md, отдельно бывают пользовательский и управляемый организацией файлы. Файл загружается как контекст, поэтому его стоит держать коротким (в документации рекомендуют укладываться примерно в 200 строк) и выносить детали в подключаемые через @-импорт файлы и в правила .claude/rules/*.md, которые при необходимости привязываются к путям.
Если в команде уже есть AGENTS.md, мы не заводим вторую версию правил: документированный способ — CLAUDE.md, который импортирует @AGENTS.md. Чтение AGENTS.md напрямую работает только в определённых случаях и зависит от версии, поэтому мы проверяем это при оценке.
Что реально ограничивает агента
Инструкция в CLAUDE.md — просьба, а не запрет. Принуждение обеспечивают другие механизмы, и у каждого свои пределы:
- Правила разрешений allow / ask / deny и режимы работы (в том числе режим планирования, где агент сначала предлагает план). Правила проверяются в порядке deny, ask, allow.
- Хуки жизненного цикла: например, хук перед вызовом инструмента может заблокировать действие. Это детерминированная проверка, в отличие от текста в инструкциях.
- Песочница на уровне ОС для команд Bash: ограничивает файловую систему и сеть. Она покрывает Bash, а не все инструменты, и доступна не на всех платформах.
- Правило deny для Bash сопоставляется с текстом команды, и то же действие можно записать иначе, поэтому его стоит сочетать с песочницей.
Изоляция задач и повторяемые процедуры
Для параллельной работы у Claude Code есть запуск в отдельной рабочей копии с собственной веткой (claude --worktree), а субагентов можно настроить с ограничением набора инструментов и изоляцией в отдельном worktree. Повторяющиеся процедуры — подготовка релиза, ревью изменений — оформляются как skills (Markdown-файлы с описанием процедуры), чтобы команда запускала их одинаково.
Общие настройки команды и организации
Настройки бывают общие для репозитория (.claude/settings.json), личные (settings.local.json), пользовательские и управляемые организацией — последние стоят выше остальных. Через них можно закрепить правила разрешений, песочницу, переменные окружения и списки разрешённых и запрещённых MCP-серверов. Что из этого доступно, зависит от вашего тарифа и способа входа, поэтому мы подтверждаем это на этапе оценки, а не обещаем заранее.
CI и ревью
Claude Code умеет работать в неинтерактивном режиме (claude -p), а также есть интеграции с GitHub Actions и GitLab CI/CD и возможности ревью кода. Мы подключаем их только там, где это уместно для вашего процесса, и не считаем автоматический запуск заменой человеческого одобрения — точки одобрения описываются письменно.
Секреты и граница деплоя
Согласуем письменно, что агенту читать нельзя, где хранятся секреты и какие переменные окружения ему доступны, а также что он может делать в деплое: как правило, готовить изменения, но не выпускать их в production без вашего явного решения. Для Claude Code мы не утверждаем наличия механизма, который сам убирал бы секреты из среды на определённой фазе, — граница строится из разрешений, песочницы и процесса.
Онбординг и передача
В конце вы получаете документацию по настройке и по рабочему процессу, а команда проходит короткий онбординг: как ставить задачи агенту, как проверять результат и где границы. Мы не превращаем это в обучающий курс — это передача конкретной настройки вашего репозитория.
Чего мы не обещаем
Не обещаем автономную разработку без разработчиков, отмену ревью, процентный прирост продуктивности или срок настройки до оценки. Не заявляем, что защитные механизмы абсолютны или что процесс подойдёт любому репозиторию. Доступность Claude Code, возможность создания аккаунта и условия вендора проверяются до оценки объёма. Мы независимы: не перепродаём подписки и не заявляем партнёрский статус с Anthropic или другим вендором инструментов.
Чем это отличается от соседних страниц
Общий процесс, не привязанный к инструменту, описан на странице внедрения AI в процесс разработки; паттерны из нашего собственного процесса — там же. Эта страница — про конкретные механизмы Claude Code; если команда работает с OpenAI Codex, у него есть своя страница: внедрение Codex в разработку. Внедрение Claude для бизнеса — про внедрение Claude у сотрудников, которые не пишут код; а настройка инфраструктуры разработки — про базовый слой репозиториев, CI и релизов.
Как это работает
- 1
Оценка репозитория и рабочего процесса
Смотрим репозиторий, ветки, проверки, процесс релиза и то, какие ИИ-инструменты уже используются. Сначала только чтение, ничего не меняется. Объём и график работ согласуются письменно до начала настройки.
- 2
Риски и полезные задачи для AI-агентов
Разбираем, что может пойти не так при работе агентов в вашем коде, и какие задачи им действительно стоит отдавать, а какие остаются за людьми.
- 3
Разрешения, изоляция задач и точки одобрения
Определяем, что агент вправе менять, как изолируются задачи и в каких местах обязательно решение человека.
- 4
Инструкции проекта и границы инструментов
Описываем правила работы в репозитории, границы инструментов, правила для секретов и переменных окружения. Всё в вашем репозитории и ваших аккаунтах.
- 5
Проверки: тесты, сборка, линт, CI
Встраиваем обязательные проверки перед мерджем и деплоем в ваш существующий процесс, а не рядом с ним.
- 6
Проверка на репрезентативных задачах
Прогоняем настроенный процесс на реальных задачах из вашего репозитория и поправляем то, что не сработало.
- 7
Документация и передача команде
Письменное описание порядка работы с названным владельцем, короткий онбординг для разработчиков и чёткое указание, что дальше остаётся на стороне команды.
Частые вопросы
Достаточно ли просто написать хороший CLAUDE.md?+
Это полезно, но недостаточно. CLAUDE.md — контекст, а не принудительное правило. Чтобы граница работала, нужны разрешения, хуки, песочница, проверки в CI и ревью.
Можно ли использовать общий AGENTS.md?+
Да, если он уже есть в репозитории: документированный способ — CLAUDE.md, который подключает @AGENTS.md. Как именно это работает в вашей версии, мы проверяем при оценке.
Безопасно ли давать агенту запускать команды?+
Это зависит от разрешений, песочницы и процесса вокруг. Песочница покрывает команды Bash, но не все инструменты, а правила deny можно обойти другой формой команды, поэтому мы описываем границы явно и не называем настройку абсолютно безопасной.
Какие настройки для всей организации нам доступны?+
Управляемые настройки могут закреплять разрешения, песочницу и списки MCP-серверов, но доступность зависит от вашего тарифа и способа входа. Это подтверждается на этапе оценки.
Будет ли документация?+
Да: описание настройки и рабочего процесса и короткий онбординг для команды.
Сколько времени это займёт?+
Объём определяется после оценки репозитория; срок зависит от сложности репозитория и существующего CI/CD, и мы не называем его заранее.
Сколько стоит настройка Claude Code?+
Фиксированной цены нет. Сначала мы изучаем репозиторий и процесс, затем определяем объём работ и называем условия; от чего он зависит, описано на странице про AI-разработку в репозитории.
Доступен ли Claude Code нашей компании?+
Доступность инструмента, возможность создания аккаунта и условия вендора проверяются до оценки объёма. Мы не предлагаем обходных путей для аккаунтов, оплаты или региональных ограничений.
Сайт и форма заявки — на русском, проект ведётся на английском. Русский как язык проекта мы не обещаем.