Claude Code и GitHub: подключение, pull request, GitHub Actions

В Claude Code есть средства, с помощью которых можно настроить взаимодействие с таким сервисом, как GitHub. Это один из основных сервисов для работы с Git-репозиториями: в нём можно разместить свой код в облаке. В этом уроке разберём возможности, которые дают Claude Code и GitHub при совместной работе, что можно получить и какой результат будет.

Зачем нужен GitHub

Прежде чем связывать два инструмента, посмотрим, зачем вообще нужен GitHub:

• копия кода в облаке: если сломался компьютер, проект скачивается с GitHub;
• работа с двух компьютеров без переноса файлов, а в команде - общая работа над проектом;
• история изменений: любую правку можно откатить, посмотреть, что и когда было сделано, и переключиться на другие версии проекта;
• автоматический деплой проекта на таких сервисах, как Vercel, Netlify, Cloudflare Pages и другие;
• портфолио проектов для заказчиков и работодателей.

Два способа связать Claude Code с GitHub

Связать GitHub с Claude Code можно двумя основными способами.

Первый - MCP-сервер. Claude Code установлен на вашем компьютере, он обращается к MCP-серверу GitHub, а тот уже взаимодействует с GitHub. Так можно давать команды commit, push, pull и другие, и всё это будет происходить через MCP-сервер. Важно иметь в виду, что Claude Code при этом работает локально, на вашем компьютере, а GitHub живёт сам по себе.

Второй способ предоставляет сам GitHub: установить Claude Code в репозиторий как приложение и связать его с GitHub Actions. GitHub Actions - это специальные службы, которые позволяют выполнять действия с вашим репозиторием. Claude Code, установленный как приложение, может анализировать код репозитория, исправлять его, оставлять комментарии, создавать pull request, запускать автотесты, делать деплой и так далее. Промежуточного звена в виде MCP-сервера здесь нет.

Главное отличие: в этом случае Claude Code работает не на вашем компьютере, а в облаке, на серверах GitHub. Вы даёте ему свои данные для входа: подписку или API-ключ. Поэтому это не бесплатно: работа идёт за счёт вашей подписки, тратятся ваши токены, а скрипты запускаются на удалённом сервере.

GitHub MCP-сервер

Есть официальный MCP-сервер от GitHub (github.com/github/github-mcp-server). Скачивать его не нужно: сервер работает на стороне GitHub, а команда его подключает. В навыках можно написать, что для взаимодействия с GitHub нужно пользоваться этим MCP-сервером, и тогда Claude Code сам будет предлагать делать коммиты и отправлять их в удалённый репозиторий, который вы ему укажете.

Единственное, что нужно сделать, - получить токен GitHub, чтобы Claude Code связался с вашим аккаунтом. Токен получают в разделе Settings, Developer settings, Personal access tokens. Лучше брать fine-grained токен и только на нужный репозиторий. Затем в терминале выполняется команда подключения MCP-сервера:

claude mcp add-json github '{"type":"http","url":"https://api.githubcopilot.com/mcp","headers":{"Authorization":"Bearer ТОКЕН_GITHUB"}}'

Установка Claude Code в репозиторий

MCP-сервер - это стандартная возможность, поэтому подробнее остановимся на установке Claude Code в репозиторий. Порядок такой:

• в системе должна быть установлена утилита gh, с её помощью вы входите в GitHub под своим аккаунтом (gh auth login); нужны права администратора репозитория;
• в папке репозитория запустите claude и выполните команду /install-github-app: она привязывает Claude Code к определённому репозиторию;
• на запросы команды укажите путь к репозиторию, к которому нужно открыть доступ (его можно скопировать из адресной строки браузера), и нажмите Install на GitHub;
• выберите, как будет работать приложение: по токену подписки или по API-ключу; данные сохраняются в секретах репозитория;
• выберите workflow, которые будут созданы автоматически.

Чтобы убедиться, что приложение установилось, зайдите в Settings проекта и откройте раздел GitHub Apps: там должно появиться приложение Claude, а в его настройках можно посмотреть параметры.

Как это работает: раннеры и workflow

В GitHub есть так называемые раннеры - серверы, на которых GitHub выполняет специальные скрипты в нужные моменты времени. Когда установлено приложение, эти скрипты могут взаимодействовать с Claude Code, который вы связали с GitHub, и выполнять действия. Когда вы пишете workflow для проекта, то есть описываете действия по автоматизации, к ним можно подключить агента Claude Code: он поправит что-то в репозитории, проверит данные и так далее.

Компьютер для этого не нужен. Так можно работать, если вы в командировке, работаете со слабого компьютера или у вас сейчас нет доступа к рабочему проекту: достаточно зайти в репозиторий через браузер (или через CLI-утилиту) и внести правки.

Команда @claude в Issue и pull request

После установки приложения появляется возможность вызывать агента командой @claude. Через пробел пишется задача, которую нужно выполнить, например:

@claude исправь ошибку авторизации пользователей

Это можно писать в Issue, в комментариях и в pull request - везде, где такая возможность есть в репозитории. Так можно анализировать кодовую базу проекта, вносить правки в файлы, делать коммиты, создавать pull request и так далее.

Например, в тестовом репозитории я открыл Issue с задачей создать тестовую страницу и написал: @claude создай тестовую страницу в корне проекта. Запустился бот Claude, выполнил правки и создал pull request, который я слил. Тестовая страница появилась в корне проекта - её создал Claude Code без участия моего компьютера. Если нужно что-то дополнить, можно снова написать @claude в комментариях, и агент запустится ещё раз. Всё это происходит на серверах GitHub и работает на вашей подписке.

Ревью каждого pull request

Ещё один сценарий - ревью каждого pull request. Если вы работаете в команде и хотите автоматизировать процесс, чтобы Claude Code проверял, безопасны ли изменения стороннего разработчика и не навредят ли они репозиторию, для этого создаётся workflow.

Workflow лежат в корне проекта, в папке .github/workflows, и именно там настраиваются рабочие процессы, которые выполняет GitHub. Файлов можно создавать много, на разные ситуации. Например, откроем процесс claude-code-review:

• событие, при котором он запускается, - pull request;
• задачи (jobs) и шаги внутри них;
• в шаге с ревью указано, что нужно использовать агента Anthropic (anthropics/claude-code-action);
• токен хранится в секретах репозитория: если вы правильно установили приложение и связали его с аккаунтом Claude, он появится там автоматически;
• можно подключить плагины и главное - написать промпт, то есть что именно агент делает (в нашем случае код-ревью проекта).

Каждую настройку можно разбирать долго, её лучше читать в документации. Здесь важно понять смысл: когда workflow запускается, он запускает агента Claude Code, который анализирует код и выдаёт ответ.

Запуск по расписанию

Очень интересная возможность - запуск действий по расписанию. Например, можно получать дневной отчёт. GitHub-репозиторий бесплатный, и получается своего рода cron-задание: Claude Code выполняет какие-то действия в репозитории или вообще не связанные с ним, например, парсит откуда-то данные. Компьютер при этом может быть выключен, и не нужен VPS-сервер.

Для этого в .github/workflows создаётся отдельный workflow на действия по расписанию с нужным промптом.

Что нужно учитывать

Работать это может либо по подписке, либо по API-ключу, точно так же, как при установке Claude Code на ваш компьютер. Нужно учитывать, что в обоих случаях тратятся ещё и минуты GitHub Actions. При активном использовании можно упереться в лимиты GitHub Actions, и тогда, возможно, потребуется платный аккаунт GitHub.

Вот такая возможность связки Claude Code и GitHub Actions. Имейте её в виду и знайте, куда смотреть подробнее для настройки таких сценариев. О том, как Claude Code работает с Git-репозиторием локально, рассказывает урок «Git-репозиторий в работе с Claude Code», а об MCP-серверах - урок «Что такое MCP сервер и зачем это нужно».