Anthropic Academy Courses My Profile Sign Out

GitHub Actions и ревью кода

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

Управляемый путь: Code Review

Самый простой вариант — Code Review. Это хостящийся у Anthropic сервис, который ревьюит ваши пул-реквесты через приложение Claude GitHub. Вам нечего строить или хостить. Вы его включаете, и он начинает постить находки в виде инлайн-комментариев прямо на строках, которые важны.

Администратор организации включает его в настройках администратора Claude Code. Там есть раздел Code review с кнопкой Configure, которая подключает его к вашим репозиториям.

Дальше админ устанавливает приложение Claude GitHub, выбирает, за какими репозиториями оно следит, и решает, когда оно выполняется. Есть несколько вариантов по времени:

  • Один раз при открытии PR
  • При каждом пуше в PR
  • Только когда кто-то пишет комментарий @claude review

Когда включено, всё выполняется на инфраструктуре Anthropic. Набор ревью-агентов анализирует дифф на фоне всего вашего кода, а не только изменённых строк в изоляции. Затем он постит находки как инлайн-комментарии на конкретных строках, с метками серьёзности, со сводной таблицей в прогоне проверки.

Вот как выглядит одна из таких находок. Она попадает комментарием от Claude прямо на строку, с понятным объяснением и предложенным исправлением.

Приятная часть — он дедуплицирует и ранжирует находки. Так что вместо стены придирок вы читаете горсть реальных проблем, достойных вашего внимания.

Что Code Review будет и не будет делать

Пара вещей о границах, которые стоит держать в уме:

  • Он никогда не одобряет и не блокирует PR. Суждение остаётся за человеком. Claude подсвечивает вещи; решаете вы.
  • Управляемого автоисправления нет. Сервис только постит находки.
  • Сейчас это исследовательское превью, доступное на тарифах team и enterprise, так что ожидайте, что поведение будет меняться.

Поскольку в сервисе нет автоисправления, применение находки — это локальное действие. Из собственного терминала команда /code-review ревьюит дифф, а её флаг --fix применяет находки к вашему рабочему дереву. Так что поток такой: Claude находит это в PR, вы стягиваете и исправляете локально.

Путь «сделай сам»: GitHub Action

Code Review занимается ревью. Когда задача шире ревью, вы тянетесь к GitHub Action. Это для кастомного CI: внедрение изменений из комментария, выполнение запланированных отчётов, всё, для чего вы обычно писали бы workflow. Он запускает агента на комментариях к PR, запланированных задачах и любом событии GitHub.

Настройка начинается внутри Claude Code. Выполните команду /install-github-app. Для этого нужен админ репозитория. Слеш-команда проведёт вас через установку приложения GitHub и настройку секрета с ключом API Anthropic на репозитории.

Сам экшен — это anthropics/claude-code-action@v1. Вот входы, которые вы реально будете использовать:

  • anthropic_api_key — необязательный.
  • github_token — по умолчанию secrets.GITHUB_TOKEN.
  • trigger_phrase — что экшен слушает в комментариях. По умолчанию @claude.
  • use_bedrock / use_vertex — переключение на этих провайдеров, если вы на Bedrock или Vertex.
  • prompt — инструкция для прогона.
  • claude_args — строка аргументов CLI, передаваемых напрямую в Claude Code.

Workflow, который отвечает на @claude

Положите workflow в .github/workflows/claude.yaml, и он будет слушать @claude в комментариях к PR и комментариях к issue. Основной шаг выглядит так:

```

  • uses: anthropics/claude-code-action@v1

with:

anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}

github_token: ${{ secrets.GITHUB_TOKEN }}

trigger_phrase: "@claude"

prompt: "Your instructions here"

claude_args: "--max-turns 5 --model claude-sonnet-5"

```

Теперь кто-то пишет на пул-реквесте @claude implement the spec in the linked Linear issue, и экшен это подхватывает. Claude пушит коммиты и постит комментарии с описанием того, что сделал.

Workflow, который выполняется по расписанию

Тот же экшен работает для ежедневной сводки. Триггер cron срабатывает, скажем, в 9:00 UTC, экшен выполняется, и Claude постит результаты. Можно также добавить триггер workflow_dispatch, чтобы запускать его вручную со вкладки Actions.

Когда экшен выполняется, можно наблюдать его работу по шагам на вкладке Actions, как любой другой workflow GitHub.

Настройка прогона через claude_args

Строка claude_args — место тонкой настройки. Несколько ручек, которые стоит знать:

  • --max-turns 5 ставит жёсткий лимит на цикл агента, чтобы он не мог работать вечно.
  • Режим разрешений. Для задачи без присмотра нужен такой, чтобы не останавливаться и не спрашивать, ведь отвечать некому.
  • Разрешённые инструменты. Дайте задаче ровно то, что ей нужно, и ничего больше. Для отчёта это означает только чтение.

Что использовать?

Короткая версия:

  • Для ревью PR идите управляемым путём. Включите Code Review, пусть приложение GitHub постит инлайн-находки, а исправления применяйте локально через /code-review --fix.
  • Тянитесь к экшену, когда задача больше, чем ревью. Используйте /install-github-app для настройки, один workflow для упоминаний @claude, один для cron, а вся настройка живёт в claude_args.

Начните с управляемого сервиса. Переходите к экшену в тот момент, когда нужно, чтобы Claude реально что-то делал в CI, а не просто комментировал.