ВойтиПолучить доступ

Инструменты13 минобновлено

Claude Code и GitHub: @claude в задачах, ревью PR и GitHub Actions

Коротко: 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 в документации есть отдельная страница про облачных провайдеров.

  1. Поставь GitHub CLI и выполни gh auth login. Если установка сообщит о нехватке прав GitHub CLI, выполни команду, которую она напечатает, и начни снова.
  2. В папке репозитория открой claude и выполни команду:
/install-github-app
  1. Иди по подсказкам. Claude Code установит приложение Claude GitHub и подготовит секрет. Если у него уже есть ключ API, он его переиспользует. Иначе выбери между долгоживущим токеном подписки и ключом API. Секрет сохранится в репозитории под именем ANTHROPIC_API_KEY или CLAUDE_CODE_OAUTH_TOKEN.
  2. Claude Code отправит ветку с выбранными файлами workflow и откроет GitHub с заготовкой pull request. Создай его и слей: пока файл не попал в репозиторий, @claude не заработает.
  3. Напиши в любом 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 локально не запускаешь, команда не сработала или хочешь полностью контролировать файлы. Три шага из документации:

  1. Установи приложение Claude GitHub на репозиторий. Действию нужны три разрешения: Contents (чтение и запись), Issues (чтение и запись), Pull requests (чтение и запись).
  2. Добавь секрет: ANTHROPIC_API_KEY или CLAUDE_CODE_OAUTH_TOKEN.
  3. Скопируй 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, чтобы сверить его со своими задачами. Статья открыта без оплаты; материалы и подключение базы доступны после оплаты.

Спрашивают

Пять вопросов по теме

Нужна ли подписка Claude или ключ API, чтобы @claude работал в GitHub?

Нужен один из двух входов. Ключ API из Claude Console кладётся в секрет ANTHROPIC_API_KEY, токен подписки (его выдаёт claude setup-token на планах Pro, Max, Ultra, Team и Enterprise) - в секрет CLAUDE_CODE_OAUTH_TOKEN. Для общего секрета на организацию документация советует ключ API: токен привязан к подписке того, кто его выпустил.

Чем GitHub Action с @claude отличается от Code Review?

Action - это твой workflow: он работает на твоих раннерах GitHub, отвечает на @claude и может запушить правки. Code Review - управляемый сервис для планов Team и Enterprise: его включает Owner организации, ревью идёт на инфраструктуре Anthropic, репозиторий в нём только читается, а результат - комментарии и проверка Claude Code Review, которая ничего не блокирует.

Может ли Claude одобрить или слить pull request?

Нет. По документации действия Claude не отправляет формальные ревью, не одобряет pull request и по своей инструкции не сливает ветки и не делает rebase. Он пушит коммиты в ветку, где его запустили, и даёт ссылку на заполненную страницу создания PR. Решение о слиянии остаётся за человеком и правилами защиты ветки.

Почему Claude не отвечает на @claude в комментарии?

Документация называет пять причин: не установлено приложение Claude GitHub, выключены workflows, нет секрета с ключом или токеном, в комментарии нет слова @claude целиком (а не /claude или @claude-bot) или у автора комментария нет права записи в репозиторий. Проверяй их по порядку, начиная с вкладки Actions: там видно, запустился ли workflow.

Сколько стоит работа Claude Code в GitHub?

У Action два расхода: минуты GitHub Actions на раннерах и токены Claude - по ключу API или за счёт подписки, если вход через токен. Сумму держат в рамках флагом --max-turns, таймаутом задания и ограничением параллельных запусков. Code Review цены за ревью не имеет: он списывает использование с кредитов организации, а лимит ставит Owner.

Источники