Claude Code в GitHub Actions: настройка ревью и исправлений

Главное изменение — разработчику больше не нужно оставаться у компьютера. Раньше приходилось открывать репозиторий, запускать Claude, переносить результат в GitHub и поддерживать локальную сессию. С Action мейнтейнер оставляет конкретный запрос, а позже возвращается к комментарию или предложенным изменениям. Работа может начаться и после окончания рабочего дня разработчика, но время на проверку результата всё равно потребуется.

Руководство основано на актуальной документации Anthropic, проверенной 15 октября 2026 года. Приведённый ниже workflow — стартовая конфигурация с намеренно узкими возможностями. Она не означает, что любую задачу можно решить без участия человека.

Claude Code в GitHub Actions: дежурный помощник для репозитория

Представьте GitHub App как пропуск, workflow — как рабочее задание, а раннер — как временное рабочее место. Workflow — это файл конфигурации, который указывает GitHub, когда запускать работу; раннер — машина, которая её выполняет.

Action может отвечать на упоминания в задачах и пул-реквестах. Если передать prompt, он будет выполнять автоматическое задание. Небольшой команде проще начать с явных запросов: так можно найти полезные сценарии, прежде чем платить за ревью каждого изменения. Использование Action.

Установите приложение и влейте workflow

Для установки через мастер нужен доступ администратора репозитория. Авторизуйтесь в установленном GitHub CLI командой gh auth login, откройте claude в репозитории и выполните /install-github-app. Выберите рабочие процессы и способ аутентификации — API-ключ или подписку, — затем создайте и влейте подготовленный PR с workflow. Установка проходит локально; последующие задания выполняются на GitHub. Официальная инструкция по быстрой настройке.

При ручной настройке результат будет тем же:

1. Установите Claude GitHub App в выбранный репозиторий.
2. Откройте в репозитории Settings → Secrets and variables → Actions и добавьте один секрет для аутентификации из таблицы ниже.
3. Скопируйте рабочий пример Anthropic в .github/workflows/claude.yml, выберите соответствующий входной параметр аутентификации и влейте файл в репозиторий.
4. Оставьте комментарий с @claude и конкретным запросом.

Это официальные шаги ручной установки; здесь отдельно обозначен выбор учётных данных. Руководство по настройке Action.

Для работы через подписку выполните локально claude setup-token и сохраните результат как секрет. Anthropic описывает этот способ для планов Pro, Max, Team и Enterprise. Созданный токен действует один год, поэтому назначьте ответственного за его обновление. Аутентификация по токену.

Способ оплаты зависит от учётных данных: запуски с API-ключом оплачиваются по тарифам API, а запуски с OAuth-токеном используют подписку Claude. Использование раннеров GitHub Actions учитывается отдельно. Токен подписки принадлежит человеку, который его создал; для секретов, общих для нескольких репозиториев, Anthropic рекомендует API-ключ. Аутентификация и расходы.

При стандартной настройке приложения личный токен доступа GitHub не нужен. Доступ к GitHub и аутентификация в Claude — разные вещи: первый обеспечивает приложение, вторую — выбранный секрет. Параметры аутентификации.

Начните с ограниченного workflow по упоминанию

Используйте эту конфигурацию для доверенных репозиториев команды и небольших изменений в файлах. Она позволяет читать и редактировать файлы, а также создавать коммиты через API GitHub. Доступа к командной оболочке у Claude нет, поэтому в этой конфигурации он не сможет запускать ваши команды тестирования. Выполнение тестов оставьте обычному CI — автоматическим проверкам предлагаемых изменений.

Сохраните конфигурацию в .github/workflows/claude.yml. Ссылки на Actions, actions/checkout@v6 и anthropics/claude-code-action@v1, взяты из актуального примера Anthropic. Лимит в пять ходов и тайм-аут в пятнадцать минут — выбранные здесь стартовые настройки, а не значения Anthropic по умолчанию. Официальный workflow.

name: Claude on request
on:
  issue_comment:
    types: [created]
  pull_request_review_comment:
    types: [created]

jobs:
  claude:
    if: contains(github.event.comment.body, '@claude')
    runs-on: ubuntu-latest
    timeout-minutes: 15
    concurrency:
      group: claude-small-team
      cancel-in-progress: false
    permissions:
      contents: write
      issues: write
      pull-requests: write
      id-token: write
    steps:
      - uses: actions/checkout@v6
        with:
          fetch-depth: 1
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          use_commit_signing: true
          claude_args: |
            --max-turns 5
            --tools "Read,Glob,Grep,Edit,Write"
            --disallowedTools "Bash,WebFetch,WebSearch"

Чтобы использовать подписку, замените строку anthropic_api_key на claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}. Укажите только один способ аутентификации. Сохраните id-token: write: это разрешение нужно стандартному механизму аутентификации GitHub App. Официальный workflow и аутентификация, справочник входных параметров.

Каждая настройка решает свою задачу:

• --tools выбирает встроенные инструменты, доступные Claude. Read, Glob и Grep используются для изучения файлов, Edit и Write — для их изменения. Этот параметр не ограничивает инструменты MCP — отдельно подключённые инструменты, через которые Action взаимодействует с GitHub.
• --allowedTools разрешает использовать перечисленные инструменты без запроса подтверждения. Это не исчерпывающий список доступных инструментов. В нашей конфигурации инструменты командной оболочки и доступа к вебу явно запрещены строкой --disallowedTools.
• --max-turns ограничивает число рабочих итераций агента. Он не задаёт предел расхода токенов или денег; при достижении лимита запуск может завершиться ошибкой, оставив работу незаконченной. Справочник CLI.

use_commit_signing: true направляет создание коммитов через API GitHub. Благодаря этому конфигурация позволяет сохранять изменения, не предоставляя Claude доступ к командам git в оболочке. Дополнительный секрет для подписи не требуется. Инструменты Action для работы с GitHub остаются доступны, поэтому конфигурация допускает запись. Подпись коммитов, реализация Action.

Фиксированная группа concurrency допускает только одно выполняющееся задание этого workflow в репозитории. При стандартном поведении очереди новый ожидающий запрос может вытеснить предыдущий ожидающий запрос: это не очередь с гарантированным сохранением задач. Тайм-аут ограничивает общее время задания, включая подготовку. Параллельное выполнение в GitHub, синтаксис workflow.

Попробуйте запрос @claude review this PR for missing permission checks; report findings without changing files. Для задачи используйте @claude fix the null handling described above, change only the parser and its regression test, and state which checks were not run.

По умолчанию человеку, который запускает Action, нужен доступ на запись в репозиторий, а запуски от ботов заблокированы. При исправлении задачи ожидайте ветку и ссылку, по которой человек сможет создать PR. Уточните этот порядок в инструкциях команды. Безопасность Action.

Подключите автоматическое ревью после пробного периода

Для автоматического ревью PR выберите соответствующий workflow при настройке через /install-github-app. Его плагин code-review использует --comment и приведённое ниже разрешение на инструмент комментирования, чтобы публиковать найденные проблемы. Официальный пример ревью.

В этом отдельном workflow для ревью входные параметры Action включают:

plugin_marketplaces: "https://github.com/anthropics/claude-code.git"
plugins: "code-review@claude-code-plugins"
prompt: "/code-review:code-review --comment ${{ github.repository }}/pull/${{ github.event.pull_request.number }}"
claude_args: >-
  --max-turns 5
  --allowedTools "mcp__github_inline_comment__create_inline_comment"

Используйте эти параметры в официальном workflow для pull_request, а не в приведённом выше workflow по упоминанию. Сохраните его шаг checkout, аутентификацию и разрешения задания, добавьте тайм-аут и пропускайте PR из форков с помощью if: github.event.pull_request.head.repo.full_name == github.repository. Рассматривайте лимит ходов как настройку для пробного запуска: ревью, которому не хватило ходов, остаётся незавершённым. Согласно документации, навык ревью также пропускает некоторые PR, в том числе черновики.

Настраивайте доступ приложения и инструменты отдельно

Сначала установите приложение только в выбранные репозитории. Официальное приложение Claude использует общий набор разрешений для нескольких функций Claude, а GitHub не позволяет принять лишь часть этого набора. Короткий блок permissions в YAML не сужает права установленного приложения. Модель разрешений приложения.

Если такие права слишком широки, создайте собственное приложение с доступом к Contents, Issues и Pull requests. Для этого понадобятся секреты APP_ID и APP_PRIVATE_KEY, а также шаг, который создаёт токен приложения и передаёт его в github_token. Командам, готовым отказаться от статических API-ключей Claude, руководство по настройке предлагает федерацию удостоверений рабочих нагрузок: она обменивает удостоверение задания GitHub на краткосрочный доступ к API. Настройка собственного приложения и федерации.

Добавьте краткий CLAUDE.md с приоритетами ревью, допустимыми областями изменений и требованиями к подтверждению корректности исправлений. Инструкции направляют работу, а разрешения репозитория и ограничения инструментов обеспечивают контроль доступа. Прежде чем разрешать запуски без участия человека, проверьте настроенные хуки — команды, автоматически выполняемые при событиях жизненного цикла, — и дополнительные серверы инструментов. Инструкции проекта. Наш обзор Claude Code поможет шире оценить этот инструмент, а руководство по слеш-командам объясняет команды, используемые при настройке.

Шесть задач, с которых стоит начать

Начните с задач, которые легко описать и результат которых легко проверить. Это предлагаемые сценарии работы, а не измеренная экономия времени или гарантии результата.

Стартовая конфигурация не позволяет устанавливать зависимости или запускать набор тестов. Если задача этого требует, добавьте отдельную проверенную конфигурацию выполнения для доверенного кода, с разрешениями на конкретные команды и собственными лимитами. Даже разрешённая команда тестирования выполняет код репозитория; безобидное название команды не делает этот код безопасным.

Устраните эти сбои, прежде чем добавлять триггеры

PR из форков могут не получать доступ к секретам. GitHub обычно не передаёт секреты в запуски pull_request и pull_request_review_comment, вызванные PR из форков. Пустые учётные данные Claude в таких заданиях — следствие разграничения доверия. Не переходите на pull_request_target с выполнением кода форка только ради получения секретов. Задание issue_comment, запущенное мейнтейнером, тоже может иметь доступ к секретам: доверие к автору комментария не означает доверия к файлам PR. Рекомендации GitHub по безопасности форков.

Ограничения инструментов не обезвреживают код, выполняемый при запуске проекта. Action восстанавливает отдельные настройки Claude из базовой ветки, но скрипты и другие файлы проекта всё ещё могут поступать из PR. Проверяйте хуки и конфигурацию серверов инструментов наряду с перечнем инструментов, разрешённых Claude. Границы доверия Action.

Время раннеров остаётся отдельным ограничением. Стандартные раннеры, размещённые на GitHub, бесплатны для публичных репозиториев. Для приватных репозиториев предусмотрены включённые в тариф лимиты и плата за превышение; если лимит исчерпан, а способ оплаты не указан, задания могут остановиться. Проверяйте страницу использования Actions вместе со статистикой Claude. Оплата GitHub Actions.

Лимиты запросов могут прервать корректно настроенный workflow. Минутные лимиты API охватывают запросы, а также входные и выходные токены — фрагменты текста, которые обрабатывает модель. При ошибке 429 с заголовком retry-after выждите перед повторной попыткой и сократите число одновременных заданий. Ошибка 429 из-за предела расходов для уровня аккаунта без такого заголовка требует разобраться с оплатой или лимитом, а не запускать задание снова и снова. При аутентификации через подписку продолжают действовать лимиты использования тарифного плана. Лимиты API, лимиты использования Claude.

Молчание бота и отсутствие запуска CI — разные проблемы. Если бот молчит, проверьте, что workflow находится в ветке по умолчанию, Actions включён, секрет соответствует входному параметру, а у автора комментария есть доступ на запись. Используйте полное упоминание @claude. Если не запускается последующий CI, проверьте, не заменил ли кто-нибудь аутентификацию приложения на github_token: ${{ secrets.GITHUB_TOKEN }}: GitHub подавляет многие события, созданные с этим токеном, а некоторые PR-workflow требуют одобрения. Поведение токена GitHub.

Две идеи для сервиса на основе этой связки

Самая перспективная идея — настройка и сопровождение ревью для небольших команд. Покупатель такого сервиса — технический руководитель, которому нужны полезные замечания, понятное распределение ответственности и предсказуемые ограничения работы. По оценке DataForSEO для англоязычного рынка США, полученной 15 октября 2026 года, запрос «ai code review» набирает 1,300 поисков в месяц. Это признак интереса, а не число клиентов. Первая версия, которую можно продавать, могла бы включать настройку одного репозитория, описание его приоритетов ревью в инструкциях, оценку замечаний на прошлых PR и регулярный отчёт об использовании и сбоях. Сложность — в усталости от ложных срабатываний: основная постоянная работа состоит в поддержании качества ревью по мере изменения кодовой базы. Простая обёртка над промптом почти не даёт причин оставаться с сервисом.

Агентству может пригодиться многоразовый пакет правил ревью для клиентских репозиториев. По оценке DataForSEO, в том же рынке запрос «ai code review tools» набирает 590 поисков в месяц, а «github ai code review» — 140. Минимальный продукт мог бы объединять переиспользуемый workflow, шаблоны инструкций для конкретных клиентов, сведения о владельцах учётных данных и проверки наличия лимитов. Он помог бы агентству сохранять единообразие настроек при передаче проектов. Сложность в том, что права доступа и тестовая среда у каждого клиента свои: чтобы шаблон оставался полезным, его нужно поддерживать и оценивать. Аудитории этих запросов пересекаются, поэтому складывать их частотности и выдавать сумму за размер рынка нельзя.

Выберите среду под задачу

Выбирайте GitHub Actions, когда работа привязана к событию в репозитории, а команда хочет управлять конфигурацией, правами доступа и журналами вместе с CI. Облачная сессия подходит для разовой задачи, которую вы хотите запустить и направлять из браузера при закрытом ноутбуке. Задание по расписанию подходит для сохранённой повторяющейся задачи — например, ночной проверки бэклога, — если вы предпочитаете встроенные средства расписания и настройки Claude сопровождению YAML-файла workflow. Routines также поддерживают триггеры GitHub и API, поэтому само по себе расписание не обязывает использовать Actions; routines пока остаются в статусе research preview. Облачные сессии, routines.

В понедельник поручите администратору репозитория установить приложение и влить ограниченный workflow. Дайте ему известный баг и конкретный запрос на ревью, затем сопоставьте результат с собственной оценкой команды. Добавляйте новые триггеры, только когда результаты оправдают затраты внимания и ресурсов.

Если вам нужна помощь с созданием и сопровождением такого процесса для команды, обратитесь за помощью с автоматизацией на базе ИИ.