Claude Code + GitHub:PR и ревью через gh

Самая частая ручная рутина после правок кода — открыть GitHub, создать ветку, написать описание pull request, потом вычитать чей-то PR в веб-интерфейсе. Всё это можно отдать Claude Code, если на машине стоит и залогинен gh — официальная консольная утилита GitHub. Claude вызывает её как обычную команду и делает весь круг: ветка, коммит, push, PR, ревью. Ты остаёшься в чате терминала, не переключаясь на сайт.

Часть 1 · Понятие

Зачем тут gh CLI

Расшифруем. gh (произносится «джи-эйч») — это GitHub CLI, официальная программа от GitHub для работы из командной строки. Она умеет то же, что веб-интерфейс: создавать pull request (запрос на слияние твоих правок в основную ветку), смотреть диффы, читать и писать комментарии, закрывать issue (задачи в трекере). Claude Code — агент в терминале; у него есть инструмент Bash, которым он запускает команды. Связка простая: Claude пишет gh pr create, как ты бы написал руками, и GitHub получает PR.

Важно не путать git и gh. git — это система контроля версий: коммиты, ветки, история — всё локально. gh — надстройка именно над сервисом GitHub: PR, ревью, issue. Базовый безопасный воркфлоу с ветками и откатами разобран отдельно в гайде про Claude Code и Git — здесь же мы поверх него добавляем работу с самим GitHub.

git и gh — кто за что

Часть 2 · Установка

Связываем за один логин

Сначала проверь, установлен ли gh, и авторизуйся. Это делается руками один раз, не в чате Claude — чтобы токен авторизации не светился в истории разговора:

# Проверяем, что gh установлен (если нет — ставим через пакетный менеджер)
gh --version

# Логинимся в GitHub: gh откроет браузер и сохранит сессию
gh auth login

# Проверяем, что авторизация прошла
gh auth status

Дальше дай Claude право пользоваться gh. Самый аккуратный путь — разрешить чтение и создание PR, но необратимое (мерж, удаление веток) оставить под ручное подтверждение:

{
  "permissions": {
    // Разрешаем агенту читать и создавать PR через gh
    "allow": ["Bash(gh pr create:*)", "Bash(gh pr diff:*)", "Bash(gh pr view:*)"],
    // Опасное — только через явное подтверждение человека
    "ask": ["Bash(gh pr merge:*)", "Bash(gh repo delete:*)"]
  }
}

Часть 3 · Pull request

Claude создаёт PR сам

Самый частый сценарий: ты закончил фичу и хочешь PR. Не нужно помнить синтаксис — попроси словами, Claude сам подберёт команды:

> закоммить изменения с осмысленным сообщением и открой pull request

# Под капотом Claude сделает примерно это:
#   git checkout -b feat/login-rate-limit
#   git add -A && git commit -m "..."
#   git push -u origin feat/login-rate-limit
#   gh pr create --title "..." --body "..."

Заголовок и тело PR Claude пишет по сути изменений, а не «Update files». Если хочешь свой шаблон описания (чек-лист, ссылка на задачу) — скажи об этом в той же фразе: «в описании PR добавь раздел „Что проверить“ и ссылку на issue #42».

Часть 4 · Ревью

Ревью чужого PR по чек-листу

Обратная сторона — разобрать чужой pull request. Claude вытягивает дифф и комментарии через gh и проходит правки по понятному чек-листу, а не «на глаз». Лучший способ дать ему контекст — встроить вывод команд прямо в задачу через синтаксис !`команда` (в скилах и кастомных командах он подставляет результат команды в промт):

---
description: Разбирает pull request по чек-листу
allowed-tools: Bash(gh *)
---

## Контекст PR
- Дифф: !`gh pr diff`
- Комментарии: !`gh pr view --comments`
- Изменённые файлы: !`gh pr diff --name-only`

## Задача
Разбери этот PR: структура, обработка ошибок, безопасность, тесты.
Дай список замечаний по приоритету. Не предлагай мерж — это решает человек.

Вызов /pr-review подставит в промт живой дифф открытого PR, и Claude разберёт его, как ревьюер. Это тот же чек-лист, что в гайде про отладку с Claude Code: искать корневую причину, а не латать симптом. Про создание своих команд — в гайде про кастомные slash-команды.

Агент не мержит за тебя. Он даёт разбор, а кнопку «Merge» жмёшь ты.

Часть 5 · Автоматизация

Авторевью каждого PR в CI

Если ревью нужно стабильно на каждый PR (особенно в команде) — выноси его в CI. CI — это автоматический запуск на сервере GitHub при событии, например «открыт pull request». Вот минимальный рабочий workflow:

name: Code Review
on:
  pull_request:
    types: [opened, synchronize] # на открытие PR и на каждый новый коммит
jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          plugin_marketplaces: "https://github.com/anthropics/claude-code.git"
          plugins: "code-review@claude-code-plugins"
          prompt: "/code-review:code-review ${{ github.repository }}/pull/${{ github.event.pull_request.number }}"

Вопросы

Частые вопросы

Читать дальше

Соседние гайды