Claude Code GitHub: подключение, проверка кода и правки

За запросом «claude code github» стоит сразу несколько связок, и Anthropic говорит об этом прямо: имя Claude Code носят несколько разных продуктов. Первый — рабочий процесс внутри репозитория, который отзывается на упоминание @claude. Второй — отдельная проверка запросов на слияние, которой файл рабочего процесса не нужен вовсе. Третий — сеанс Claude Code в браузере и на телефоне. Четвёртый — набор для разработчика, на котором построен первый. Ниже разведены все четыре, разобраны два пути подключения и названо то, что агент делает с обсуждениями и запросами на слияние, вместе с границами, которые Anthropic называет сам.

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

Четыре связки Claude Code с GitHub под одним именем

Разводит их сам Anthropic на странице про GitHub Actions. Там сказано прямо: «Several products share the Claude Code name» — имя Claude Code делят между собой несколько продуктов. Дальше он перечисляет их и за подробностями отсылает на разные страницы. Именно здесь чаще всего путаются чужие руководства: порядок подключения из одной связки переносят в описание другой.

Связка	Где работает	Что нужно настроить	Кому доступна
Рабочий процесс в репозитории	GitHub Actions вашего репозитория	приложение GitHub, секрет с учётными данными и файл рабочего процесса	любому, у кого есть права управляющего репозиторием
Отдельная проверка запросов на слияние	GitHub, без файла рабочего процесса	только установленное приложение	планам Team и Enterprise, в состоянии предварительного показа; при включённом отказе от хранения данных недоступна
Сеанс в браузере и на телефоне	браузер и телефон	доступ к репозиториям приложением либо своим ключом GitHub CLI	любому владельцу учётной записи Claude
Набор для разработчика Claude Agent SDK	ваша собственная программа, вне GitHub Actions	своя сборка	тому, кто пишет автоматику сам

Рабочий процесс (workflow) — это описанный файлом порядок действий, который GitHub выполняет сам, когда в репозитории что-то происходит. Запрос на слияние (pull request) — предложение перенести правки из одной ветки в другую, с обсуждением и проверками до слияния.

Разница между первой и второй строкой видна сразу. Рабочий процесс вы описываете сами и запускаете тем событием, каким захотите. Отдельная проверка включается на каждом запросе на слияние без единой строки настройки, но открыта не всем. На остальных планах вместо неё остаётся разбор изменений на своей машине командой /code-review. Четвёртая строка нужна тем, кому не хватает GitHub Actions: Anthropic пишет, что рабочий процесс построен как раз на этом наборе.

Что лежит в репозитории Claude Code на GitHub

Репозиторий anthropics/claude-code — первое место, куда попадает человек, который ищет Claude Code на GitHub. Его описание перечисляет четыре вещи: установку, набор дополнений к Claude Code, приём сообщений об ошибках командой /bug и правила сбора данных. Исходного кода самой программы в этом перечне нет, и тот, кто пришёл за ним, находит там другое. Само описание называет Claude Code инструментом, который живёт в терминале, разбирает вашу кодовую базу и работает обычными словами. Отдельной фразой оно называет третий способ работы: «tag @claude on Github» — упомянуть агента прямо на GitHub.

Исполняемый код связки находится в другом репозитории — anthropics/claude-code-action, под лицензией MIT. Это то, что запускается в ваших рабочих процессах. А сам Claude Code — программа командной строки, и её установка под каждую систему разобрана в статье как установить Claude Code.

Как подключить Claude Code к GitHub: два пути

Anthropic называет два пути и общее для них условие: для обоих нужны права управляющего репозиторием (admin access). Быстрый путь работает только с репозиториями на github.com — если ваш удалённый репозиторий на gitlab.com или bitbucket.org, команда печатает уведомление и выходит, не начиная настройку. До начала нужен установленный GitHub CLI — программа gh для работы с GitHub из терминала — и выполненный в нём вход командой gh auth login. Claude Code проверяет, установлен ли он, и предупреждает, когда его нет. В чужих разборах на этом спотыкаются первым делом: ставят gh, входят в него и запускают команду заново.

Быстрый путь — четыре шага.

В работающем Claude Code наберите /install-github-app и выберите репозиторий.
Разрешите установку приложения GitHub на этот репозиторий. Приложение можно поставить на все репозитории сразу или только на выбранные.
Дождитесь, пока Claude Code сохранит учётные данные секретом репозитория — под именем ANTHROPIC_API_KEY для ключа API или CLAUDE_CODE_OAUTH_TOKEN для токена подписки. Секрет репозитория — это закрытое значение, которое GitHub хранит у себя и подставляет в запуск, не показывая в файлах.
Создайте и слейте запрос на слияние, который Claude Code откроет сам: он приносит в репозиторий выбранные файлы рабочих процессов, уже настроенные на этот секрет. После слияния упоминание @claude в репозитории работает.

Ручной путь собирает то же самое своими руками и нужен тому, кто настраивает связку со стороны GitHub, у кого быстрый путь сорвался или кому нужен полный разбор файлов. Приложение Claude ставится на репозиторий со страницы приложений GitHub, учётные данные заводятся секретом репозитория, а файл рабочего процесса из примеров Anthropic копируется в каталог .github/workflows/. Файл примера рабочий сразу, править его не обязательно. В чужих разборах его всё-таки дополняют: пока в файле не записано, что именно агент должен сделать и куда положить ответ, разбор выходит общим.

Какие права получает приложение GitHub

Права приложение просит один раз — при установке, и набор принимается сразу весь. Anthropic приводит его целиком.

Право	Уровень
Actions	чтение и запись
Checks	чтение и запись
Contents	чтение и запись
Discussions	чтение и запись
Issues	чтение и запись
Members	чтение
Metadata	чтение
Pull requests	чтение и запись
Repository hooks	чтение и запись
Statuses	чтение
Workflows	чтение и запись

Рабочий процесс опирается из этого набора на три права. Содержимое репозитория нужно ему, чтобы править файлы, обсуждения — чтобы отвечать в них, запросы на слияние — чтобы открывать их и отправлять в них изменения. Почему остальных прав больше, чем нужно, Anthropic объясняет сам: у приложения GitHub набор прав один на все его возможности, поэтому в него попадает и то, чем рабочий процесс не пользуется. Принять часть набора нельзя — GitHub этого не даёт, и при установке вы соглашаетесь со всем сразу.

Выход для тех, кому нужен набор поуже, назван там же: сделать своё приложение GitHub и дать ему только три права — содержимое, обсуждения и запросы на слияние. Тот же совет звучит и в чужих разборах, только шире: вместе с правами приложения ограничивают и перечень инструментов, разрешённых агенту в каждом отдельном рабочем процессе.

Что Claude Code делает на GitHub: обсуждения, правки, проверка кода

Поведений четыре, и каждое закрывает свою работу.

Отвечает на упоминание. Когда в рабочем процессе не задано задание, агент ждёт @claude. Считается упоминание в комментарии к обсуждению или к запросу на слияние, в проверке запроса на слияние и в теле или заголовке только что открытого обсуждения. Дальше агент разбирает код, вносит правки и отправляет коммиты. Ход работы он пишет ответом в том же обсуждении и обновляет этот ответ, пока работает. Обращаются к нему обычными словами: реализуй эту возможность по описанию обсуждения; как лучше сделать вход по паролю для этого адреса; почини ошибку типов в таком-то разделе. Заголовка обсуждения агенту хватает как задания — тело можно оставить пустым. Ответ появляется не сразу, и пока он идёт, ход работы видно в журнале запуска. Исход бывает двух видов: агент либо открывает запрос на слияние сам, либо присылает ссылку на его создание с заполненными заголовком и описанием.

Работает без упоминания, по событию. Если в рабочем процессе задание задано, агент запускается сам на любом событии репозитория и никого не ждёт. Ответ в этом случае по умолчанию уходит не комментарием, а в журнал запуска.

Проверяет запрос на слияние и пишет замечания в строки кода. Отдельная проверка разбирает изменения на фоне всей вашей кодовой базы. Она ищет ошибки в логике, слабые места в безопасности, необработанные крайние случаи и незаметные поломки прежнего поведения. Замечание ставится прямо в ту строку, где нашлось, и помечается степенью важности. Важное — ошибка, которую надо исправить до слияния. Мелочь — то, что стоит поправить, но слияние оно не держит. Уже бывшее — ошибка, которая жила в коде и этим запросом не внесена. Слияние проверка не одобряет и не блокирует: её отметка всегда завершается нейтральным исходом, поэтому правила защиты ветки на ней не срабатывают, а порядок работы команды не меняется. Что именно агент отмечает, настраивается файлом CLAUDE.md или REVIEW.md в репозитории, и это работает: в чужих разборах правило из такого файла соблюдается буквально, вплоть до поиска забытых отладочных строк.

Следит за открытым запросом на слияние и чинит его сам. Агент подписывается на события запроса. Когда падает проверка или приходит замечание, он разбирается и отправляет исправление — но только если оно очевидно и не спорит с тем, о чём его просили раньше. Спорное он молча не делает. Когда замечание можно понять по-разному или оно задевает устройство проекта, агент спрашивает до того, как что-то менять.

Границы Anthropic называет прямо, и их стоит знать до установки.

Запуск проходит только у того, у кого есть право записи в репозиторий.
Действия другого робота принимаются после того, как он внесён в список разрешённых: так обрывается круг, в котором роботы вызывают друг друга.
Расхождение веток разбирают руками. GitHub не сообщает о том, что основная ветка ушла вперёд и появился конфликт слияния, поэтому самостоятельное исправление на него не реагирует; конфликт разрешают, открыв сеанс и попросив перебазировать ветку.
Ответы в обсуждениях появляются под именем владельца учётной записи и помечены как написанные агентом. Отдельно Anthropic предупреждает: если в репозитории есть автоматика, срабатывающая на комментарии, ответ агента её запустит.

Claude Code в браузере и на телефоне: доступ к репозиториям

Сеанс Claude Code открывается и без терминала — в браузере, а значит и с телефона. Доступ к репозиториям ему дают двумя способами, и различаются они охватом. Приложение Claude, разрешённое при первом входе, открывает сеансу любой общедоступный репозиторий и те закрытые, на которые приложение установлено. Команда /web-setup, набранная в вашем терминале, отправляет в учётную запись Claude ваш ключ GitHub CLI — и тогда сеанс достаёт до любого репозитория, до которого достаёт этот ключ, независимо от того, установлено там приложение или нет. Установка приложения на репозиторий заодно включает в нём самостоятельное исправление запросов на слияние.

Площадка при этом важна. Клонирование репозитория и создание запроса на слияние Anthropic привязывает именно к GitHub. Репозиторий с другой площадки в облачный сеанс отправить можно — свёртком с вашей машины, — но отправить результат обратно на ту площадку сеанс не сможет. Самостоятельно размещённый GitHub Enterprise Server поддерживается для планов Team и Enterprise. Сам рабочий цикл в сеансе тот же, что и в терминале, и он разобран в статье как пользоваться Claude Code; в какие пределы упирается работа на разных планах, собрано в статье про лимиты Claude Code.

Команды Claude Code, которые работают с GitHub

Их четыре, и одна уже убрана из программы.

/install-github-app — ставит приложение Claude на репозиторий и по ходу дела настраивает рабочие процессы и секреты. Проводит по выбору репозитория и по настройке связки. Работает только с репозиториями на github.com.
/autofix-pr — открывает облачный сеанс, который следит за запросом на слияние текущей ветки и отправляет исправления, когда падает проверка или приходят замечания. Открытый запрос команда находит сама по выбранной ветке; для работы нужен GitHub CLI.
/web-setup — подключает вашу учётную запись GitHub к сеансам Claude Code в браузере, используя ваши учётные данные GitHub CLI.
/pr-comments — убрана в версии 2.1.91. Anthropic советует вместо неё просто попросить агента посмотреть замечания к запросу на слияние. Часть чужих руководств до сих пор описывает её как рабочую, и по ним она не сработает.

Что нужно, чтобы Claude Code отвечал на упоминание

Причины Anthropic перечисляет для двух случаев. Когда агент молчит на @claude, проверяют пять вещей: установлено ли приложение GitHub на этот репозиторий; включены ли рабочие процессы у репозитория; заведены ли ключ API или токен в секретах репозитория; написано ли в комментарии именно @claude целым словом, а не /claude и не @claude-bot; есть ли у автора комментария право записи в репозиторий.

Второй случай — запуск проверок на коммитах самого агента. Причина названа одна: GitHub не запускает рабочие процессы на коммитах, сделанных со стандартным токеном GITHUB_TOKEN. Если вы передаёте этот токен связке, его убирают, чтобы она работала от имени приложения Claude, либо передают токен своего приложения.

Чужие разборы добавляют к списку Anthropic своё. Разбор, который выходит общим, вместо подробного — признак того, что агенту не разрешён инструмент gh в файле рабочего процесса. Упоминание, отмеченное значком, но оставшееся без ответа в обсуждении, выправляют так: в задание дописывают прямую просьбу опубликовать ответ комментарием. Запуск, падающий с сообщением о том, что учётные данные годятся только для Claude Code, проходит после того, как в файле рабочего процесса явно названа модель. А отправка первой ветки срывается вовсе не на связке: локальная ветка называется master, а отправляют её в main — агент это замечает и предлагает переименовать ветку до отправки.

Готовые наборы для Claude Code из чужих репозиториев на GitHub

Вокруг Claude Code складывается отдельный слой: люди выкладывают в репозитории готовые настройки — команды, навыки, правила и обработчики событий — и берут их оттуда целыми наборами. Такие сборники и приводят на GitHub тех, кто ищет не документацию, а готовое. Брать чужой набор целиком стоит с тем же вниманием, с каким вы смотрите на права приложения: это указания, которые ваш агент начнёт выполнять. Как устроен отдельный навык и что лежит внутри его файла, разобрано в статье про skills для Claude Code.

Картинка, которая уходит в тот же запрос на слияние

Связку с GitHub ставят ради одного: чтобы правка доходила до репозитория без ручных шагов. Работает это ровно до того места, где правка меняет вид. Обновилось описание проекта — к нему нужен новый кадр. Поменялась страница продукта — нужен кадр под неё. Вышел выпуск — нужна картинка к заметке о нём. Агент, который уже отправил коммиты и открыл запрос на слияние, здесь останавливается: рисование не входит в его инструменты.

Умение делать изображения добавляют навыком. У GEN202 для этого заготовлена одна просьба словами — она напечатана целиком на странице генерации изображений из Claude Code, откуда её копируют и отдают агенту. По ней он открывает описание навыка, настраивает по нему вызовы и запоминает порядок у себя, а ключ берёт из переменной окружения. Отдельного расширения под каждый агент ставить не нужно: подключение у GEN202 одно и то же для любого.

Дальше кадр делается в том же разговоре и уходит в ту же ветку, что и код. Скажите агенту, во что картинка встанет, — форму кадра он подберёт под это место сам. У Nano Banana 2 их пятнадцать: широкие 16:9 и 21:9 ложатся в шапку страницы, узкие 4:1 и 8:1 — в полосу над заголовком, 1:1 годится под значок. Рядом с ней навык открывает Nano Banana Pro, GPT Image 2 в двух режимах и Grok Imagine Image 2.0.

Счёт идёт за готовый кадр, и это совпадает с тем, как картинка здесь и появляется — по одной, под конкретную правку. Nano Banana 2 берёт за кадр 7,2 ₽ в невысоком разрешении и 14,4 ₽ в 4K; остальные ставки открыты в каталоге. Счёт пополняют рублями с карты российского банка, и при первом входе на него начисляется 50 приветственных кредитов (25 ₽). Навык рисует картинки.

Частые вопросы

Есть ли способ подключить Claude Code к GitHub бесплатно? Сама связка отдельных денег не стоит, но работать она будет только от платного доступа: рабочему процессу нужны либо ключ API, либо токен подписки, и без них запуск не пройдёт. Бесплатного Claude Code у Anthropic нет ни в одном виде. Разбор планов и того, что даёт каждый, собран в статье про подписку Claude Code.

Нужен ли сервер MCP, чтобы Claude Code работал с GitHub? Нет. Всё описанное выше работает через приложение GitHub и рабочие процессы, и сервер MCP для этого не заводится. Сервер решает другую задачу — подключает агенту внешний источник, которого у него нет; когда он нужен и чем отличается от навыка, разобрано в статье про MCP для Claude Code.

Чем это отличается от встроенного помощника GitHub? Местом работы и тем, откуда берётся ответ. Встроенный помощник живёт внутри GitHub и редактора, а Claude Code — это агент, который работает в вашем каталоге и приходит на GitHub через приложение и рабочие процессы. Ещё одно различие в том, что вы настраиваете: у встроенного помощника набор возможностей задан заранее, у Claude Code — файлом рабочего процесса, где вы называете и задание, и разрешённые инструменты. Сравнение двух оболочек для командной строки собрано в статье Claude Code или Codex, а разбор того, какая модель Anthropic под какую работу подходит, — в статье какую модель Claude выбрать.

За что платится каждый запуск связки? Anthropic называет два вида расхода. Первый — минуты GitHub Actions: связка выполняется на машинах GitHub и расходует их время. Второй — токены: каждое обращение считается по длине запроса и ответа, сложности задачи и размеру кодовой базы; если вы входите токеном подписки, запуски идут по ней, а не по счёту за API. Своих чисел Anthropic здесь не называет. Сократить расход он советует точными просьбами, коротким CLAUDE.md — он читается при каждом запуске, — пределом на число ходов и на время работы и ограничением числа одновременных запусков. Цены планов разобраны в статье про подписку Claude Code.

Работает ли связка с репозиторием не на GitHub? Связку — нет: и быстрое подключение, и клонирование с созданием запроса на слияние Anthropic привязывает к github.com. Сам Claude Code при этом остаётся рабочим: он читает проект, правит файлы и выполняет обычные команды git в вашем каталоге независимо от того, где лежит удалённый репозиторий, — а готовые изменения вы отправляете туда сами. Этот круг работы разобран в статье как пользоваться Claude Code.

Сколько стоит одна картинка через навык? Считается каждый готовый кадр, и ставка складывается из модели и разрешения: на Nano Banana Pro в 4K кадр стоит 21,6 ₽, а на Nano Banana 2 в невысоком разрешении — 7,2 ₽. Разница в цене и задаёт порядок работы: пробные кадры агент делает в низком разрешении, а высокое ставит на тот, который пойдёт в ветку. Ставки остальных моделей открыты в каталоге.

Страницы Anthropic — про GitHub Actions, про проверку кода, про Claude Code в браузере и перечень команд — проверены 12.09.2026.