Claude Code GitHub — это интеграция, при которой упоминание @claude в задаче или комментарии к pull request запускает Claude Code внутри рабочего процесса вашего репозитория: он читает код, вносит правки в отдельной ветке и предлагает изменения на проверку. Работает схема там, где задачи уже оформлены в трекере репозитория и есть автоматические тесты, а решение о слиянии остаётся за человеком. Для репозитория без тестов и ревью такая автоматизация лишь ускорит накопление ошибок.
Контур работы
Claude Code в GitHub отвечает на упоминание @claude, вносит изменения в ветку и открывает запрос на слияние, а проверка тестами и ручной review остаются обязательными шагами контура.
По документации Claude Code, действие для GitHub запускает Claude Code в ваших рабочих процессах: на упоминание в задаче или в комментарии он анализирует код, реализует изменения и отправляет коммиты. Есть и режим автоматизации: если в рабочем процессе указан запрос, Claude выполняет его без упоминания по событию, например по расписанию.
Обзор возможностей инструмента остаётся за материалом Claude Code для команды. Здесь разбирается один маршрут: задача, ветка, проверка, review. Повторяемые шаги, например проверку по чек-листу, можно оформить навыком и вызывать по имени из запроса рабочего процесса: как это делается, описано в статье Skill Claude Code. Подключение репозитория к агенту через MCP описано в статье MCP GitHub: как подключить репозиторий к ИИ-агенту, а сравнение с другим редактором дано в материале Cursor или Claude Code.
- Вход: задача с понятным описанием, критериями готовности и ссылками на нужные файлы.
- Работа: чтение кода, правки в отдельной ветке, запуск тестов, описание изменений.
- Выход: запрос на слияние с пояснением, который просматривает человек.
- Контроль: автоматические проверки репозитория и ручной review перед слиянием.
Установка и секреты
Заранее выберите репозиторий для пилота: небольшой, с работающими тестами и активными ревьюерами, а критичный монолит оставьте на потом. Для настройки нужны права администратора репозитория. Быстрый путь — команда /install-github-app из самого Claude Code: она ставит приложение, добавляет секрет и готовит запрос на слияние с файлами рабочего процесса. Ручной путь — установка приложения, добавление секрета и копирование файла рабочего процесса. Команда работает только с репозиториями на github.com.
- Убедитесь, что репозиторий находится на github.com и у вас есть права администратора.
- Установите приложение Claude для GitHub в репозиторий или в организацию.
- Добавьте секрет с ключом доступа: либо ключ API, либо долгоживущий токен подписки.
- Скопируйте в каталог рабочих процессов файл с реакцией на упоминание и закоммитьте его.
- Создайте тестовую задачу и упомяните @claude в комментарии.
- Проверьте, что ответ пришёл, а изменения лежат в отдельной ветке.
После установки сделайте пробу на безобидной задаче вроде правки опечатки в документации: так вы проверите весь путь от упоминания до ветки без риска для рабочего кода. Секреты хранят только в защищённых настройках репозитория, а в файлы рабочих процессов их вписывать запрещено. Помните и про запуски по расписанию: GitHub выполняет такие рабочие процессы только из основной ветки, а в публичных репозиториях отключает расписание после 60 дней без активности, поэтому регулярные задачи проверяйте раз в месяц. Для организации приложение ставят один раз на уровне организации, а секрет делают общим; при общем секрете документация советует ключ API, потому что токен подписки привязан к человеку, который его выпустил.
В каком репозитории вы хотели бы отдать Claude первую задачу?
Ветка и тесты
Хорошая задача для агента читается как письмо коллеге: что нужно получить, где искать, какие тесты должны пройти и что трогать нельзя. Чем яснее описание, тем меньше круг правок и тем проще review. Главное правило контура: изменения агента попадают только в отдельную ветку, а основная остаётся защищённой. Настройте защиту основной ветки так, чтобы слияние требовало прохождения проверок и одобрения человека, и тогда ошибке агента до рабочего кода добраться заметно труднее.
- Защита основной ветки: прямые коммиты запрещены, слияние только через запрос.
- Обязательные проверки: сборка, тесты, линтеры запускаются на каждом запросе.
- Описание задачи содержит критерии готовности: какие тесты должны пройти, что нельзя менять.
- Файл правил проекта CLAUDE.md в корне репозитория задаёт стиль кода и принятые решения; агент читает его при каждом запуске.
- Ограничения на объём работы: число шагов и время выполнения задаются в настройках запуска.
Есть один технический нюанс. Коммиты, сделанные стандартным токеном рабочего процесса, по правилам GitHub остаются без автоматических проверок, поэтому доступ настраивают так, чтобы действие работало от имени приложения. Если проверки на ветке агента молчат, начните поиск причины именно здесь.
Ручной review
Договоритесь в команде, кто просматривает изменения агента и в какие сроки: запрос без ревьюера повисает, а повисшие запросы быстро теряют актуальность. Review — последняя линия защиты, и человек в ней незаменим: он знает, зачем задача поставлена, и видит последствия, которых нет в тестах. Для просмотра изменений агента нужен собственный чек-лист, составленный по реальным ошибкам: каждая найденная проблема превращается в строку, и список растёт вместе с опытом команды.
| Что смотрим | Тревожный признак | Что делаем |
|---|---|---|
| Соответствие задаче | Изменения шире описания или в посторонних файлах | Возвращаем с замечанием, сужаем задачу |
| Тесты | Новые тесты проверяют очевидное, существующие удалены или отключены | Просим добавить содержательные проверки |
| Безопасность | Новые зависимости, обращения к сети, работа с ключами | Проверка вручную, консультация безопасности |
| Стиль и архитектура | Дублирование кода, обход принятых решений | Правка по правилам проекта |
| Описание изменений | Общие слова без указания причин | Просим переписать понятно |
Отдельно проверяйте, оставил ли агент сами тесты нетронутыми, ведь подгонка тестов под результат остаётся известной уловкой автоматики. Просматривайте различия построчно для критичных частей и выборочно для остальных. Если запрос слишком большой, верните его с просьбой разделить: большие изменения читаются плохо, а ошибки в них прячутся.
Права и расход
Действию нужны три разрешения на чтение и запись: содержимое репозитория, задачи и запросы на слияние. Выдавайте приложение только тем репозиториям, где работа агента действительно нужна, и закройте доступ к секретам, которые агенту лишние.
Отдельно проверьте, кто в организации вправе запускать агента из комментариев: список таких людей лучше записать и пересматривать вместе с остальными правами. По документации, приложение запрашивает набор разрешений, общий для нескольких функций, и принять его можно только целиком. Если политика организации требует урезанных прав, создают собственное приложение с минимальным набором. Запускать действие могут только пользователи с правом записи в репозиторий, а боты по умолчанию отклоняются, чтобы исключить цепочки самозапуска.
Фиксируйте итоги пилота числами: сколько задач передано, сколько принято без правок, сколько возвращено и почему. Эти данные подскажут, какие задачи подходят агенту, а какие остаются за людьми. Расход складывается из минут рабочих процессов и обращений к модели. Снижают его так: пишут конкретные запросы, используют шаблоны задач, держат файл правил проекта коротким, ограничивают число шагов и время выполнения, задают лимит параллельных запусков. Планирование работы при лимитах разобрано в материале лимиты Claude Code: план работы и контроль расхода, а регламент подключения агента к репозиториям мы собираем в рамках разработки ИИ-агентов. Первый пилот ограничьте одним репозиторием, одной задачей и обязательным ручным review.