Связка «Claude Code и GitHub» закрывает два разных сценария: работу с репозиторием на вашем компьютере и автоматизацию прямо в облаке GitHub. Разберём оба, без магии и без выдуманных команд – где-то отметим, что точную команду стоит сверить с актуальной документацией.
Если коротко: Claude Code умеет вести git и создавать pull request локально через gh CLI, а официальная GitHub-интеграция (приложение и GitHub Action) подключает Claude прямо в репозиторий – он отвечает на @-упоминания в issue и PR и запускает авто-ревью в GitHub Actions.
Содержание
- Два способа связать Claude Code и GitHub
- Локально: gh CLI, git, ветки и PR
- GitHub Action и приложение: авто-ревью и issue-to-PR
- Шаг 1: Подготовьте репозиторий
- Шаг 2: Локальная связка через gh CLI
- Шаг 3: Подключите GitHub-интеграцию
- Шаг 4: Первый авто-ревью через @-упоминание
- Пример: от issue до PR с ревью
- Частые вопросы и ошибки
- 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 и как он устроен, а затем возвращайтесь к интеграции. Смежные сценарии собраны в разделе про Claude Code.
Локально: gh CLI, git, ветки и PR
На локальном уровне ничего экзотического. Claude Code управляет репозиторием теми же инструментами, что и вы – командной строкой git и официальной утилитой GitHub gh CLI.
На практике это выглядит так. Вы ставите задачу обычными словами – «поправь функцию валидации и заведи PR» – и Claude Code сам выполняет цепочку: создаёт ветку, вносит правки в файлы, делает коммит с осмысленным сообщением, пушит ветку и открывает pull request через gh.
# 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.
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, а не в чьём-то терминале. Это и есть агентный подход к разработке – задачу ставят словами, агент выполняет шаги сам.
Шаг 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.
Шаг 4: Первый авто-ревью через @-упоминание
Когда приложение установлено и workflow на месте, проверьте связку на живом примере. Откройте любой pull request и оставьте комментарий с @-упоминанием бота и просьбой сделать ревью – например, «@claude посмотри изменения и оставь замечания».
GitHub Action подхватит событие, Claude прочитает diff и оставит комментарии прямо в PR. Если ничего не произошло – загляните во вкладку Actions репозитория: там видно, запустился ли workflow и не упал ли он на доступе к секрету.
Пример: от issue до PR с ревью
Соберём всё вместе на реалистичном сценарии.
Допустим, в проекте завели issue: «Форма регистрации не валидирует email». Дальше связка работает так:
- В issue вы упоминаете бота: «@claude собери фикс для этой задачи».
- Action запускается, Claude читает описание и код, создаёт ветку и открывает pull request с черновой реализацией.
- На этот PR можно натравить авто-ревью – вторым @-упоминанием попросить разобрать собственный diff или дождаться ревью от другого участника.
- Вы проверяете предложенные изменения, при необходимости правите и мёржите.
Локальный и облачный уровни тут стыкуются естественно: то, что 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 пошагово, а на практическом воркшопе проходим от первого 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, а не на память – детали интеграции обновляются.
