# Claude Code и GitHub в 2026: автоматизация PR, ревью и Actions

Связка «Claude Code и GitHub» закрывает два разных сценария: работу с репозиторием на вашем компьютере и автоматизацию прямо в облаке GitHub. Разберём оба, без магии и без выдуманных команд – где-то отметим, что точную команду стоит сверить с актуальной документацией.

Если коротко: **Claude Code умеет вести git и создавать pull request локально через `gh` CLI, а официальная GitHub-интеграция (приложение и GitHub Action) подключает Claude прямо в репозиторий – он отвечает на @-упоминания в issue и PR и запускает авто-ревью в GitHub Actions.**

## Содержание

- [Два способа связать Claude Code и GitHub](#два-способа-связать-claude-code-и-github)
- [Локально: gh CLI, git, ветки и PR](#локально-gh-cli-git-ветки-и-pr)
- [GitHub Action и приложение: авто-ревью и issue-to-PR](#github-action-и-приложение-авто-ревью-и-issue-to-pr)
- [Шаг 1: Подготовьте репозиторий](#шаг-1-подготовьте-репозиторий)
- [Шаг 2: Локальная связка через gh CLI](#шаг-2-локальная-связка-через-gh-cli)
- [Шаг 3: Подключите GitHub-интеграцию](#шаг-3-подключите-github-интеграцию)
- [Шаг 4: Первый авто-ревью через @-упоминание](#шаг-4-первый-авто-ревью-через-упоминание)
- [Пример: от issue до PR с ревью](#пример-от-issue-до-pr-с-ревью)
- [Частые вопросы и ошибки](#частые-вопросы-и-ошибки)
- [FAQ](#faq)

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

Прежде чем настраивать, важно развести два уровня. Они не конкурируют – их используют вместе.

Первый уровень – **локальный**. Claude Code запущен у вас на машине, видит файлы проекта и работает с git напрямую. Здесь он создаёт ветки, коммиты и оформляет pull request от вашего имени.

Второй уровень – **облачный**. Официальная GitHub-интеграция ставит Claude прямо в репозиторий через GitHub Action. Теперь он реагирует на события в GitHub: новый issue, комментарий с @-упоминанием, открытый PR – и работает в CI без вашего терминала.

| Уровень | Где работает | Что делает |
|---|---|---|
| Локальный | Терминал, ваш компьютер | Ветки, коммиты, создание PR через `gh` |
| Облачный (Action) | GitHub Actions, CI | Авто-ревью PR, ответ на @-упоминания, issue-to-PR |

Если вы только начинаете, разберитесь сначала с базой – [что такое Claude Code и как он устроен](/guides/chto-takoe-claude-code/), а затем возвращайтесь к интеграции. Смежные сценарии собраны в [разделе про Claude Code](/claude-code/).

## Локально: gh CLI, git, ветки и PR

На локальном уровне ничего экзотического. Claude Code управляет репозиторием теми же инструментами, что и вы – командной строкой git и официальной утилитой GitHub `gh` CLI.

На практике это выглядит так. Вы ставите задачу обычными словами – «поправь функцию валидации и заведи PR» – и Claude Code сам выполняет цепочку: создаёт ветку, вносит правки в файлы, делает коммит с осмысленным сообщением, пушит ветку и открывает pull request через `gh`.

```bash
# Claude Code выполняет примерно такую последовательность
git checkout -b fix/validation
# ... правки в файлах ...
git add .
git commit -m "Исправил валидацию email"
git push -u origin fix/validation
gh pr create --title "Fix: валидация email" --body "Описание изменений"
```

Важная оговорка: `gh` CLI – отдельная утилита от GitHub, её нужно установить и авторизовать заранее (`gh auth login`). После этого Claude Code пользуется ей как обычным инструментом. Никаких особых «команд для Claude» тут нет – он просто умеет вызывать git и `gh` так же, как умеет запускать любые консольные команды.

Этот режим удобен, когда вы хотите контролировать процесс: видите каждый шаг в терминале, подтверждаете действия и проверяете результат перед пушем. Чтобы ускорить повторяющиеся сценарии вроде «собери ветку и PR по этой задаче», их удобно вынести в [пользовательские команды Claude Code](/guides/claude-code-commands/).

## GitHub Action и приложение: авто-ревью и issue-to-PR

Второй уровень интереснее. У Claude Code есть официальная GitHub-интеграция – GitHub-приложение плюс GitHub Action, которые ставят Claude внутрь вашего репозитория. Теперь он работает не в вашем терминале, а в облаке GitHub, реагируя на события.

Главная механика – **@-упоминание**. Вы пишете комментарий в issue или pull request и упоминаете бота (обычно `@claude`), описывая, что нужно сделать. Action запускается, Claude читает контекст обсуждения и кода и отвечает – правкой, разбором или новым PR.

Что это даёт на практике:

- **Авто-ревью pull request.** Claude разбирает diff, находит потенциальные баги, проблемы стиля и логики, оставляет комментарии – как ревьюер-человек, только мгновенно и круглосуточно.
- **Issue-to-PR.** Из текстового описания задачи в issue Claude может собрать черновой pull request с реализацией – вы упоминаете его в issue, он создаёт ветку и открывает PR.
- **Ответ на вопросы по коду.** Упомянули в обсуждении – Claude объяснит, как работает участок кода, или предложит вариант исправления.

Ценность очевидна для команды: ревью перестаёт быть бутылочным горлышком, рутинные задачи из бэклога превращаются в черновые PR, а контекст обсуждения остаётся в самом GitHub, а не в чьём-то терминале. Это и есть [агентный подход](/guides/chto-takoe-ii-agent/) к разработке – задачу ставят словами, агент выполняет шаги сам.

## Шаг 1: Подготовьте репозиторий

Дальше – общий маршрут настройки. Точные команды и имена ниже стоит сверять с актуальной документацией Anthropic, потому что детали интеграции обновляются.

Убедитесь, что у вас есть репозиторий на GitHub и права администратора в нём – без них не получится установить приложение и добавить секреты. Локально пусть будет установлен и авторизован `gh` CLI: проверить можно командой `gh auth status`.

## Шаг 2: Локальная связка через gh CLI

Для локального уровня отдельная установка не нужна – достаточно работающего git и `gh`. Запустите Claude Code в папке проекта и поставьте задачу, которая требует ветки и PR. Он сам пройдёт цепочку «ветка – коммит – push – `gh pr create`».

Если шаг с авторизацией `gh` ещё не сделан, выполните `gh auth login` и пройдите вход в свой аккаунт GitHub. После этого Claude Code сможет открывать pull request от вашего имени.

## Шаг 3: Подключите GitHub-интеграцию

Для облачного уровня нужно поставить GitHub-приложение Claude в репозиторий и добавить workflow для GitHub Actions. В Claude Code для этого есть встроенная команда настройки – ориентируйтесь на `/install-github-app` (точное имя сверьте с документацией). Она помогает установить приложение, добавить workflow-файл в `.github/workflows/` и подсказывает, какой секрет с ключом доступа нужно завести в настройках репозитория.

Технически интеграции нужен доступ к моделям Claude – обычно это ключ Anthropic, сохранённый как секрет репозитория (например, `ANTHROPIC_API_KEY` в Settings – Secrets). Точное имя секрета и состав workflow-файла берите из официального примера, не вписывайте на память.

Если вы только разбираетесь с установкой самого Claude Code, держите рядом отдельный разбор – [как установить Claude Code](/guides/kak-ustanovit-claude-code/).

## Шаг 4: Первый авто-ревью через @-упоминание

Когда приложение установлено и workflow на месте, проверьте связку на живом примере. Откройте любой pull request и оставьте комментарий с @-упоминанием бота и просьбой сделать ревью – например, «@claude посмотри изменения и оставь замечания».

GitHub Action подхватит событие, Claude прочитает diff и оставит комментарии прямо в PR. Если ничего не произошло – загляните во вкладку Actions репозитория: там видно, запустился ли workflow и не упал ли он на доступе к секрету.

## Пример: от issue до PR с ревью

Соберём всё вместе на реалистичном сценарии.

Допустим, в проекте завели issue: «Форма регистрации не валидирует email». Дальше связка работает так:

1. В issue вы упоминаете бота: «@claude собери фикс для этой задачи».
2. Action запускается, Claude читает описание и код, создаёт ветку и открывает pull request с черновой реализацией.
3. На этот PR можно натравить авто-ревью – вторым @-упоминанием попросить разобрать собственный diff или дождаться ревью от другого участника.
4. Вы проверяете предложенные изменения, при необходимости правите и мёржите.

Локальный и облачный уровни тут стыкуются естественно: то, что Claude собрал в облаке, вы дотягиваете в своём терминале через `gh pr checkout`, и наоборот – локальный PR уходит на авто-ревью в CI.

## Частые вопросы и ошибки

Несколько типичных граблей, на которых застревают при настройке.

**Action не запускается.** Чаще всего дело в правах или в том, что workflow-файл не попал в ветку по умолчанию. Проверьте вкладку Actions и наличие файла в `.github/workflows/`.

**Ошибка доступа к моделям.** Если в логах Action видна проблема с авторизацией – не заведён или неверно назван секрет с ключом. Сверьте имя секрета с тем, что ждёт workflow.

**`gh: command not found` локально.** `gh` CLI не установлен или не в PATH. Поставьте утилиту GitHub CLI и выполните `gh auth login`.

**Бот не реагирует на @-упоминание.** Убедитесь, что приложение установлено именно в этот репозиторий и что вы упоминаете правильное имя бота. Точное имя для упоминания смотрите в документации интеграции.

Если хочется не собирать это по кусочкам, а пройти путь с разбором на реальном проекте – мы в сообществе EdgeLab Space разбираем связку Claude Code с GitHub пошагово, а на [практическом воркшопе](https://go.edgelab.space/blog-ws) проходим от первого PR до настроенного авто-ревью вместе. Это превращает «вроде понятно» в работающий пайплайн за пару вечеров.

## FAQ

### Как подключить Claude Code к GitHub?

Есть два пути, и обычно их совмещают. Локально достаточно установленного и авторизованного `gh` CLI (`gh auth login`) – тогда Claude Code сам создаёт ветки, коммиты и pull request в вашем терминале. Для автоматизации в облаке ставят официальное GitHub-приложение Claude и добавляют workflow для GitHub Actions: в Claude Code для этого есть встроенная команда настройки (ориентир – `/install-github-app`, точное имя сверьте с документацией). После установки Claude отвечает на @-упоминания прямо в issue и PR.

### Может ли Claude Code сам делать ревью PR?

Да. Через официальную GitHub-интеграцию Claude запускается в GitHub Actions и разбирает diff pull request: ищет потенциальные баги, проблемы логики и стиля и оставляет комментарии в PR – как ревьюер-человек. Запустить ревью можно @-упоминанием бота в комментарии к PR (например, «@claude посмотри изменения»). Это не отменяет проверку человеком, но снимает рутину и ускоряет цикл ревью.

### Нужен ли GitHub Actions?

Только для облачного уровня – авто-ревью, ответов на @-упоминания и issue-to-PR. Если вам достаточно того, что Claude Code ведёт ветки и открывает PR из вашего терминала через `gh` CLI, GitHub Actions не нужен вовсе. Actions подключают, когда хочется, чтобы Claude реагировал на события в репозитории сам, без запущенного у вас терминала.

### Что нужно, чтобы интеграция заработала?

Минимум – аккаунт и репозиторий на GitHub с правами администратора, доступ к моделям Claude (обычно ключ Anthropic, сохранённый как секрет репозитория) и установленное GitHub-приложение Claude с добавленным workflow-файлом. Локальному режиму хватает git и авторизованного `gh` CLI. Точные имена секрета и состав workflow-файла берите из официального примера Anthropic, а не на память – детали интеграции обновляются.