Урок 7. GitHub Actions и Code Review

Конспект урока «GitHub Actions and Code Review» из бесплатного курса Anthropic Claude Code in Action. Оригинал урока: https://anthropic.skilljar.com/claude-code-in-action/486936

Это пересказ на русском, а не перевод. Права на курс принадлежат Anthropic.

Где передавать рутину

Лучшее место — пул-реквест: там идёт ревью, туда приземляются изменения, там же копится основная рутина. Подключить Клода можно двумя способами, и они решают разные задачи. Один — управляемый сервис, который просто включают. Второй — GitHub Action, который ты собираешь сам.

Готовый путь: Code Review

Самый простой вариант. Сервис на стороне Anthropic ревьюит пул-реквесты через GitHub- приложение Claude. Собирать и хостить нечего: включил — и он начинает оставлять замечания инлайн-комментариями прямо на нужных строках.

Включает администратор организации из админских настроек Claude Code: там есть раздел Code review с кнопкой Configure, которая привязывает сервис к репозиториям. Дальше админ ставит GitHub-приложение, выбирает отслеживаемые репозитории и решает, когда ревью запускается:

• один раз при открытии PR;
• на каждый push в PR;
• только когда кто-то напишет @claude review.

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

Приятная деталь: замечания дедуплицируются и ранжируются. Вместо стены придирок читаешь несколько действительно стоящих внимания проблем.

Границы сервиса

• Он никогда не апрувит и не блокирует PR. Решение остаётся за человеком: Клод отмечает, ты решаешь.
• Автоисправления в сервисе нет — он только публикует находки.
• Пока это research preview, доступный на планах team и enterprise, так что поведение будет меняться.

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

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

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

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

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

Параметр	Назначение
anthropic_api_key	необязательный
github_token	по умолчанию secrets.GITHUB_TOKEN
trigger_phrase	что экшен слушает в комментариях, по умолчанию @claude
use_bedrock / use_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 сделай то, что описано в связанной задаче», и экшен подхватывает: Клод пушит коммиты и оставляет комментарии о проделанном.

Workflow по расписанию

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

Тонкая настройка через claude_args

Здесь живут все регулировки. Что стоит знать:

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

Что выбрать

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

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