Коротко: Claude Code и GitHub связывают четырьмя способами. Локально он сам делает ветки и pull request, команда
/code-reviewпроверяет твою ветку, GitHub Action отвечает на@claudeв задачах и PR, а сервис Code Review (планы Team и Enterprise) сам ревьюит pull request. На 19 ноября 2026 года последний выпуск действия -v1.0.283(опубликован в тот же день), лицензия MIT.
Четыре способа связать Claude Code и GitHub
Слова «Claude Code и GitHub» называют четыре разные вещи, и первая ошибка - взять не ту. Сводка по официальной документации Anthropic:
| Способ | Что запускает | Где работает | Что нужно |
|---|---|---|---|
| Локально | Ты просишь Claude сделать ветку, коммит или PR | Твой компьютер | Claude Code, git, GitHub CLI |
/code-review |
Ты, командой на своей ветке | Твоя сессия Claude Code | Любой тариф |
GitHub Action (@claude) |
Комментарий с @claude или событие репозитория |
Твои раннеры GitHub Actions | Права администратора репозитория, ключ API или токен подписки |
| Code Review (сервис) | Активность в pull request или комментарий @claude review |
Инфраструктура Anthropic | План Team или Enterprise, включает Owner организации |
Как выбрать. Работаешь один и хочешь, чтобы агент вёл ветки и PR на твоём компьютере: первые два способа, ничего настраивать на GitHub не нужно. Хочешь написать в задаче @claude и получить ответ или правки без открытого терминала: GitHub Action. Команда на Team или Enterprise и нужно ревью каждого PR без файлов workflow: Code Review. Если ещё не установил Claude Code, начни со статьи про установку Claude Code.
Локально: ветки, PR и /code-review
В этом способе Claude Code и GitHub связаны через git и GitHub CLI, настраивать приложения на GitHub не нужно. Ты в своей сессии просишь словами: «создай pr для моих изменений». Если Claude создал PR командой gh pr create, сессия привязывается к нему: найти её позже можно командой claude --from-pr 1234 (подставь свой номер). В документации советуют просмотреть сгенерированный PR до отправки и попросить Claude указать риски.
Проверить ветку до PR можно командой /code-review. Она работает на любом тарифе и расходует лимит твоей сессии так же, как остальная работа. Что она умеет по документации:
- без аргументов проверяет текущую ветку и незакоммиченные изменения, а
/code-review 1234берёт pull request по номеру,main...my-featureсравнивает две ветки,src/auth- путь; - флаг
--fixпросит Claude применить найденное к рабочей папке, флаг--commentпубликует находки в pull request на GitHub построчными комментариями; /review- псевдоним этой команды;- проверка следует твоему
CLAUDE.md, а файлREVIEW.mdне читает: он нужен только сервису Code Review. Как писатьCLAUDE.md, разобрано в статье про правила проекта.
GitHub Action: @claude в задачах и PR
Действие anthropics/claude-code-action запускает Claude Code внутри workflow репозитория. В документации сказано: напиши @claude в комментарии к pull request или issue, и Claude разберёт код, внесёт изменения и запушит коммиты. Запуск идёт на твоих раннерах GitHub Actions.
Быстрая установка
Нужны права администратора репозитория. Команда работает только с репозиториями на github.com: если удалённый репозиторий на gitlab.com или bitbucket.org, она печатает уведомление и выходит. Для Amazon Bedrock, Google Cloud и Microsoft Foundry в документации есть отдельная страница про облачных провайдеров.
- Поставь GitHub CLI и выполни
gh auth login. Если установка сообщит о нехватке прав GitHub CLI, выполни команду, которую она напечатает, и начни снова. - В папке репозитория открой
claudeи выполни команду:
/install-github-app
- Иди по подсказкам. Claude Code установит приложение Claude GitHub и подготовит секрет. Если у него уже есть ключ API, он его переиспользует. Иначе выбери между долгоживущим токеном подписки и ключом API. Секрет сохранится в репозитории под именем
ANTHROPIC_API_KEYилиCLAUDE_CODE_OAUTH_TOKEN. - Claude Code отправит ветку с выбранными файлами workflow и откроет GitHub с заготовкой pull request. Создай его и слей: пока файл не попал в репозиторий,
@claudeне заработает. - Напиши в любом issue или PR комментарий вроде
@claude объясни, что делает этот файли посмотри ответ. Нет ответа - открой вкладку Actions и проверь, запустился ли workflow.
Прервать установку можно клавишей Esc: начатый шаг дойдёт до конца, следующие не начнутся. Если выбрать workflow ревью, Claude оставляет находки комментариями в самом pull request (до версии Claude Code 2.1.229 они попадали только в журнал запуска) и пропускает, например, черновики. Чтобы обновить старый workflow ревью, запусти /install-github-app ещё раз и выбери «Update workflow file with latest version».
Ручная установка
Она нужна, если Claude Code локально не запускаешь, команда не сработала или хочешь полностью контролировать файлы. Три шага из документации:
- Установи приложение Claude GitHub на репозиторий. Действию нужны три разрешения: Contents (чтение и запись), Issues (чтение и запись), Pull requests (чтение и запись).
- Добавь секрет:
ANTHROPIC_API_KEYилиCLAUDE_CODE_OAUTH_TOKEN. - Скопируй
examples/claude.ymlиз репозитория действия в.github/workflows/.
Рабочий файл из документации (проверено 19 ноября 2026), он отвечает на @claude в комментариях к задачам и PR:
name: Claude Code
on:
issue_comment:
types: [created]
pull_request_review_comment:
types: [created]
jobs:
claude:
if: contains(github.event.comment.body, '@claude')
runs-on: ubuntu-latest
permissions:
contents: write
pull-requests: write
issues: write
id-token: write
actions: read
steps:
- uses: actions/checkout@v6
with:
fetch-depth: 1
- uses: anthropics/claude-code-action@v1
with:
anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
Чем не стандартные строки отличаются от шаблона:
id-token: writeнужен для входа через приложение Claude GitHub: без него получишь ошибку OIDC;actions: readпозволяет Claude читать результаты CI в PR;if: contains(...)не даёт раннеру стартовать на комментариях без@claude.
Если вход через подписку, замени строку входа на claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}. В примерах документации стоит @v1; последний выпуск репозитория на 19 ноября - v1.0.283; выпуск v1.0.282 вышел днём раньше, так что перед копированием сверь свежий номер в списке выпусков.
Как ведёт себя Claude
Режим выбирается по файлу. Нет входа prompt - интерактивный режим: Claude ждёт @claude в комментарии, в обзоре PR или в заголовке и теле нового issue, и отвечает комментарием на месте. Есть prompt - режим автоматизации: запуск без упоминания, а результат по умолчанию попадает в журнал запуска, не в комментарий.
Куда он пишет, по документации действия:
- в задаче - всегда создаёт новую ветку;
- в открытом PR - пушит в ветку этого PR. Исключение - PR из форка: Claude пушит в ветку
pr-Nв твоём репозитории, а ветка самого форка не обновляется; - в закрытом PR - создаёт новую ветку;
- сам pull request по умолчанию не открывает, а даёт ссылку на заполненную страницу создания: так остаются в силе правила защиты ветки;
- отвечает, обновляя один комментарий, а не плодя новые.
Ключ API или подписка: что положить в секрет
| Секрет | Откуда берётся | Вход в действие | Заметка |
|---|---|---|---|
ANTHROPIC_API_KEY |
Ключ API из Claude Console | anthropic_api_key |
Работа оплачивается как API |
CLAUDE_CODE_OAUTH_TOKEN |
Команда claude setup-token |
claude_code_oauth_token |
Планы Pro, Max, Ultra, Team, Enterprise; работа идёт за счёт подписки |
Чтобы Claude Code и GitHub заработали вместе в Action, в репозитории нужен один из двух секретов. Для общего секрета на организацию документация советует ключ API: токен привязан к подписке того, кто его выпустил. Хранить его нужно только в GitHub Secrets, а в репозиторий ключи не коммитить. Как получить ключ и чем он отличается от входа по подписке, разобрано в статье про Claude Code API, а про оплату из России - в отдельном разборе.
Ревью pull request: два пути
Свой workflow. Документация показывает пример, где при открытии и обновлении PR запускается плагин code-review и публикует находки. Две строки решают, куда уйдёт ревью: флаг --comment в prompt публикует его в PR (без него Claude ничего не опубликует, а находки останутся в журнале запуска), а строка claude_args с --allowedTools "mcp__github_inline_comment__create_inline_comment" запускает сервер построчных комментариев. Claude пропускает черновики, закрытые PR, тривиальные изменения и PR, где он уже комментировал. На публичных репозиториях GitHub не отдаёт секреты запускам из форков, поэтому такой workflow ревьюит PR только из веток внутри репозитория.
Сервис Code Review. Это управляемая услуга: workflow не нужны, ревью идёт на инфраструктуре Anthropic.
- Доступен организациям на планах Team и Enterprise; репозитории на GitHub, включая GitHub Enterprise Server. Недоступен при включённом Zero Data Retention и при конфигурации HIPAA.
- Включает Owner организации Claude: Admin settings → Claude Code → переключатель Allow code review, затем GitHub-приложение и выбор репозиториев.
- Внутри ревью репозиторий только читается, код не собирается и не запускается, коммиты не пушатся.
- Находки приходят комментариями с пометками 🔴 Important, 🟡 Nit и 🟣 Pre-existing, плюс проверка Claude Code Review. Ревью никогда не одобряет PR и не блокирует его.
- Правила ревью задаёт файл
REVIEW.mdиз основной ветки, а не из изменений самого PR.
Управлять можно комментарием в PR (команду пишет человек с правом записи). Команда стоит на отдельной строке в начале нового комментария верхнего уровня, не в построчном комментарии к диффу:
| Команда | Что делает |
|---|---|
@claude review |
Один ревью сейчас, без подписки на будущие пуши |
@claude review always |
Ревью сейчас и после каждого следующего пуша. Исключения: для draft-PR и PR из форка автоматических ревью после пуша нет. У draft подписка начинает действовать после ready for review, для форка ревью запрашивают отдельным комментарием |
@claude review stop |
Снимает подписку PR на ревью после пушей, не запуская и не отменяя ревью (также off и pause). Работает, если подписку включил always в режиме репозитория «Вручную» или «Один раз после создания PR» |
Я сам плачу за Claude картой для подписок «Плати по миру»: выпускается за пару минут, пополняется рублями через СБП. Оформить картуРеклама. ООО "Капибара". ИНН 9703231520. erid: CQH36pWzJqNS1hfhQNyQNjbmhaUSfywWpWF3LE48uoYyEF
Что Claude на GitHub не делает
В связке Claude Code и GitHub Claude не делает следующего, по разделу ограничений действия:
- не одобряет pull request и не отправляет формальные ревью;
- не пушит в произвольные ветки: по умолчанию только в ту, где его запустили (для PR из форка это
pr-Nв твоём репозитории, ветка форка остаётся как была; не запускай CI с секретами на этой ветке, она содержит коммиты автора форка); - не сливает ветки и не делает rebase, это прописано в его инструкции, даже если разрешить git-команды флагом;
- не выходит за репозиторий, где его вызвали;
- Bash-команды выполняет, только если их покрывает правило разрешений или они проходят автоматическую проверку.
Следствие: рецензент-человек и правила защиты веток остаются на месте. Claude готовит ветку и находки, а слияние решаешь ты.
Права, безопасность и деньги
Права приложения. Приложение Claude GitHub связывает Claude Code и GitHub в Action и общее для всех функций Claude с GitHub (Action, Code Review, автоисправление PR в облачных сессиях), поэтому просит широкий набор: Actions, Checks, Contents, Discussions, Issues, Pull requests, Workflows, Repository hooks и другие. GitHub не даёт принять часть из них. Если организации нужны только Contents, Issues и Pull requests, документация предлагает собственное приложение: оно покроет только Action, а Code Review и автоисправление потребуют официального.
Кто может запускать. Действие проверяет, что автор события имеет право записи, а бота без записи в allowed_bots отвергает. Параметр allowed_non_write_users в документации безопасности назван рискованным: использовать его можно лишь в заданиях с минимальными правами.
Чужие PR. Если автор PR не имеет права записи, действие по умолчанию запрещает распространённые команды запуска кода репозитория (менеджеры пакетов, тест-раннеры, интерпретаторы и оболочки), даже если claude_args их разрешает; читать и править файлы, коммитить и пушить Claude при этом может. Это не песочница, а список частых команд: правило вроде Bash(./scripts/test.sh) остаётся разрешённым, а другие способы записи команды могут в список не попасть. Если такой код может запуститься, добавляй свои запреты через --disallowedTools. Чтобы вообще не работать с PR из форков, задай allow_fork_prs: "false".
Деньги. Action расходует минуты GitHub Actions и токены; при входе через токен подписки токены берутся из подписки. Удерживают расход так: конкретные запросы @claude, короткий CLAUDE.md, --max-turns в claude_args, таймаут задания и ограничение параллельных запусков. У Code Review фиксированной цены за ревью нет: он считается по токенам из кредитов использования организации. Репозиторий, добавленный из админки, стартует с режима «После каждого пуша», который запускает больше всего ревью; в этом режиме остановить ревью комментарием нельзя, помогает только перевод PR в черновик. Для пилота выбирай «Один раз после создания PR» или ручной режим и поставь месячный лимит. Лимиты подписки Claude Code разобраны в статье про лимиты.
Если Claude не отвечает
Когда связка Claude Code и GitHub молчит, иди по таблице сверху вниз.
| Что видишь | Причина по документации | Что сделать |
|---|---|---|
Нет ответа на @claude |
Нет приложения, выключены workflows, нет секрета, у автора нет права записи | Проверь по порядку, затем смотри вкладку Actions |
Слово написано как /claude или @claude-bot |
Триггер - @claude целым словом |
Напиши @claude как отдельное слово |
| Ошибка OIDC | Нет id-token: write в permissions |
Добавь право в workflow |
| CI не запускается на коммитах Claude | Коммиты от GITHUB_TOKEN не запускают workflows |
Убери вход github_token, чтобы Claude шёл как приложение |
| Ошибки входа | Ключ или токен недействительны | Проверь вход локальной командой claude |
@claude в комментарии из другого workflow не срабатывает |
Пользователь github-actions не запускает другие workflows |
Используй личный токен доступа (PAT) или собственный токен приложения |
Что дальше
Если пользуешься и Codex, парная статья - Codex и ревью pull request. Сравнить два инструмента помогает разбор Codex или Claude Code. Подключать к агенту внешние сервисы, включая GitHub, учат в статье про MCP в Claude Code.
Как собрана эта статья
Факты о связке Claude Code и GitHub (команды, права, ограничения, ценообразование) сверены 19 ноября 2026 года с документацией Claude Code, с репозиторием anthropics/claude-code-action (README, документы безопасности, ограничений и FAQ, список выпусков) и с официальными страницами Code Review. Пересказы блогов за источник не брались. Установку, workflow и ревью на собственном репозитории в этой статье мы не запускали: команды сверены с документацией, а не прогнаны.
Хочешь, чтобы агент и в ревью, и в работе читал твои правила проекта? В ClaudeBase есть материал «Правила агента: CLAUDE.md и AGENTS.md»: правила записываются один раз. Открой страницу доступа ClaudeBase, чтобы сверить его со своими задачами. Статья открыта без оплаты; материалы и подключение базы доступны после оплаты.