claude code github: коммиты, пулл-реквесты, @claude и ревью в github actions

claude code github — это три режима работы. в обычной сессии claude сам делает коммиты, ветки и открывает pull request через gh cli. через github actions он отвечает на @claude в issue и pr прямо на github. и он может ревьюить каждый пулл-реквест автоматически. ставится всё командой /install-github-app или вручную за три шага, а платишь минутами github actions и токенами api (или подпиской). ниже — по шагам, с yaml из официальной документации, сверено на 14 октября 2026.

зачем вайбкодеру git и github

когда код пишет агент, правок за вечер бывает больше, чем ты успеваешь прочитать. git записывает каждое состояние проекта коммитом: можно посмотреть, что поменялось, и откатиться к версии, которая работала. github хранит копию репозитория в облаке — это бэкап, если умер ноутбук, и место, где живут pull request, issue и автоматизация.

у claude code есть свои чекпоинты: перед каждым твоим запросом он снимает копию файлов, а откатиться можно через /rewind или двойной Esc. но документация прямо пишет, что это не замена git. чекпоинты не видят файлы, изменённые bash-командами вроде rm, mv, cp, не возвращают правки фоновых субагентов, а снимки удаляются примерно через 30 дней после последнего сохранения. для настоящей истории и бэкапа нужен git, а для работы с кем-то ещё — github.

claude code и git локально: коммиты, ветки, pr через gh

в обычной сессии claude сам вызывает git: смотрит diff, создаёт ветку, пишет сообщение коммита. если ты ещё не запускал агента, начни со статьи claude code: как пользоваться. для github документация советует поставить gh cli: claude умеет через него создавать issue, открывать pull request и читать комментарии. без gh он может ходить в api github, но неавторизованные запросы часто упираются в лимиты.

gh скачивается с cli.github.com, после установки один раз входишь:

gh auth login

дальше достаточно попросить словами. в рекомендованном порядке работы последний шаг звучит как «закоммить с понятным описанием и открой pr». можно и по частям: сначала «опиши изменения в модуле авторизации», потом «создай pr», потом «дополни описание pr».

что ещё полезно знать:

• когда claude создаёт pr через gh pr create, сессия привязывается к нему. найти её потом можно командой claude --from-pr 1234 с номером своего pr;
• для параллельной работы есть worktree — отдельная копия репозитория на своей ветке: claude --worktree feature-auth. в репозитории должен быть хотя бы один коммит, иначе команда упадёт с ошибкой;
• ревью до пуша делает команда /code-review: она смотрит коммиты ветки впереди upstream и незакоммиченные правки. флаг --fix применяет находки, --comment публикует их в pull request построчными комментариями.

важная деталь: правки фонового /code-review --fix не попадают в чекпоинты, и /rewind их не отменит. откатывать их документация предлагает через git — ещё один довод коммитить до того, как пускать агента в код.

claude code github actions: что это и чем отличается от code review

у anthropic два похожих продукта, и их часто путают.

экшен построен на claude agent sdk и запускает claude code прямо на раннере github. на тарифах без code review можно ревьюить локально через /code-review, а автоматическое ревью собрать на actions — пример ниже.

установка: /install-github-app или вручную

в обоих вариантах нужны права администратора репозитория. быстрый путь работает только с репозиториями на github.com: если remote на gitlab.com или bitbucket.org, команда выведет уведомление и выйдет.

быстрая установка

1. поставь gh и войди: gh auth login. claude code проверяет его и предупредит, если его нет.
2. открой claude в папке репозитория и введи /install-github-app.
3. claude code установит github app claude и настроит секрет. если у него уже есть api-ключ, он возьмёт его; если нет — предложит создать долгоживущий токен по подписке или вставить ключ. секрет сохранится как ANTHROPIC_API_KEY (ключ) или CLAUDE_CODE_OAUTH_TOKEN (подписка).
4. выбери workflow: ответы на @claude, ревью или оба. claude code запушит ветку с файлами и откроет github с готовым pull request.
5. создай и смерджи этот pr. пока он не влит, @claude не работает.

остановить установку на полпути можно клавишей Esc: текущий шаг доделается, следующие не начнутся.

ручная установка

1. поставь github app claude на репозиторий. экшену нужны три права: contents, issues и pull requests на чтение и запись.
2. добавь секрет в настройках репозитория: ANTHROPIC_API_KEY — ключ из консоли platform.claude.com, или CLAUDE_CODE_OAUTH_TOKEN — токен подписки pro, max, team или enterprise, который выпускает команда claude setup-token.
3. скопируй examples/claude.yml из репозитория экшена в .github/workflows/. это рабочий файл, не заготовка.

вот минимальный workflow из документации, который отвечает на упоминания:

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 }}

если ты выбрал токен подписки, строку с anthropic_api_key меняешь на claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}. условие if не даёт раннеру стартовать на комментариях без @claude, а actions: read позволяет claude читать результаты ci в pr.

@claude в issue и pull request

если в workflow нет параметра prompt, экшен работает в интерактивном режиме: ждёт @claude в комментарии к issue или pr, в ревью pr, в заголовке или тексте нового issue. ответ и ход работы появляются комментарием в той же ветке обсуждения, claude обновляет его по мере работы. просить можно обычным языком:

@claude реализуй фичу по описанию в этом issue
@claude как лучше сделать авторизацию для этого эндпоинта?
@claude почини TypeError в компоненте дашборда

если задан prompt, включается режим автоматизации: claude запускается по любому событию github без упоминания, в том числе по расписанию (cron). результат по умолчанию пишется в лог запуска. у текстового промпта нет доступа к shell и api github, пока ты не разрешишь нужные инструменты через --allowedTools в claude_args. по расписанию github запускает workflow только из основной ветки.

если @claude молчит, документация советует проверить: стоит ли app на репозитории, включены ли workflow, есть ли секрет, написано ли @claude целым словом (не /claude и не @claude-bot) и есть ли у автора комментария права на запись.

автоматическое ревью пулл-реквестов

через github actions

этот workflow из документации ставит плагин code-review и запускает ревью, когда pr открыли, обновили, переоткрыли или сняли с черновика. это тот же плагин, что и в ревью-workflow быстрой установки:

name: Code Review
on:
  pull_request:
    types: [opened, synchronize, ready_for_review, reopened]
jobs:
  review:
    runs-on: ubuntu-latest
    permissions:
      contents: read
      pull-requests: read
      issues: read
      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 }}
          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: '--allowedTools "mcp__github_inline_comment__create_inline_comment"'

флаг --comment публикует ревью в самом pr: построчно на каждую проблему или одним итоговым комментарием, если проблем нет. без него находки останутся только в логе. строку claude_args не удаляй: без неё экшен не запустит mcp-сервер, который пишет построчные комментарии. черновики, закрытые pr, тривиальные pr и те, где claude уже комментировал, он пропускает. в публичных репозиториях github не отдаёт секреты запускам из форков, поэтому ревью работает только для pr из веток того же репозитория.

управляемый code review

на team и enterprise владелец организации включает ревью в claude.ai/admin-settings/claude-code и для каждого репозитория выбирает режим: один раз после создания pr, после каждого пуша или вручную. вручную ревью запускает комментарий @claude review, а @claude review always ещё и подписывает pr на ревью при следующих пушах. находки помечаются как important (баг до мерджа), nit (мелочь) и pre-existing (баг был до этого pr). проверка всегда завершается нейтрально и мердж не блокирует. что флагать, настраивается файлом REVIEW.md в корне репозитория.

безопасность: секреты, права токена и кто может вызвать

• ключи только в секретах. api-ключ и oauth-токен никогда не коммитятся в репозиторий, в workflow на них ссылаются так: ${{ secrets.ANTHROPIC_API_KEY }}.
• права app шире, чем нужно экшену. одно приложение claude обслуживает и экшен, и code review, поэтому при установке ты выдаёшь весь набор: среди прочего actions, workflows, contents, issues и pull requests на запись. github не даёт принять только часть. если это неприемлемо, документация предлагает свой github app только с contents, issues и pull requests — но code review с ним работать не будет.
• в workflow — минимум прав. в блоке permissions оставляй только то, что нужно задаче, и читай изменения claude перед мерджем.
• кто может вызвать. на событиях issue и pr экшен проверяет, что у автора есть права на запись в репозиторий. пустить конкретных людей без записи можно параметром allowed_non_write_users вместе со своим github_token. ботов экшен отклоняет, если их нет в allowed_bots, — так боты не зациклят claude друг на друге.
• секрет для организации. для общего секрета лучше api-ключ, а не oauth-токен: токен привязан к подписке того, кто запускал claude setup-token. и учти: удаление секрета не отзывает ключ — его нужно удалить ещё и в консоли.

сколько стоит: минуты github actions и токены

каждый запуск тратит два ресурса. первый — минуты github actions, потому что экшен работает на раннерах github. по документации github, actions бесплатны для публичных репозиториев на стандартных раннерах. для приватных в месяц включено:

сверх лимита linux-раннер на 2 ядра стоит $0,006 за минуту, лимит обнуляется в начале расчётного периода.

второй ресурс — токены. расход зависит от длины промптов и ответов, сложности задачи и размера кодовой базы. по прайсу anthropic sonnet 5.5 стоит $2 за миллион входных токенов и $10 за миллион выходных, opus 5.5 — $4 и $20. если подключил токен подписки, запуски идут в счёт подписки, а не api; что выгоднее, я разбирал в статье claude code подписка: сколько стоят pro, max и api. управляемый code review — отдельная статья расходов: в среднем $15–25 за ревью, а режим «после каждого пуша» умножает это на число пушей.

как экономить, по документации: пиши конкретные запросы к @claude, давай контекст через шаблоны issue, держи CLAUDE.md коротким (его читают на каждом запуске), ставь таймауты на workflow, ограничивай параллельные запуски и число ходов:

claude_args: "--max-turns 5"

skills claude github: где лежат официальные навыки

официальные skills anthropic лежат в публичном репозитории github.com/anthropics/skills. внутри папка skills/ с примерами, спецификация agent skills в spec/ и шаблон в template/. многие навыки открыты под apache 2.0, а навыки для документов (docx, pdf, pptx, xlsx) — source-available, не open source. в claude code репозиторий подключается как маркетплейс плагинов:

/plugin marketplace add anthropics/skills
/plugin install document-skills@anthropic-agent-skills
/plugin install example-skills@anthropic-agent-skills

в readme честно написано, что навыки даны для демонстрации и обучения, и перед важной работой их нужно проверить у себя. свои skills удобно хранить прямо в репозитории, в .claude/skills/: они уходят в git вместе с кодом, а экшен может запустить такой навык, если передать /имя-навыка в prompt после шага checkout. как написать свой — в статье claude code skills: что это и как написать свой.

вопросы

нужен ли платный github?

для старта нет. в публичных репозиториях actions на стандартных раннерах бесплатны, а на бесплатном тарифе для приватных репозиториев включено 2 000 минут в месяц.

можно ли подключить github actions без api-ключа, по подписке?

да. на pro, max, team и enterprise выпускаешь токен командой claude setup-token, кладёшь в секрет CLAUDE_CODE_OAUTH_TOKEN и передаёшь через claude_code_oauth_token. запуски будут идти в счёт подписки.

работает ли это с gitlab?

/install-github-app — только для github.com. для gitlab у anthropic отдельная инструкция по gitlab ci/cd, а локальный /code-review --comment умеет писать находки в merge request через glab.

заблокирует ли ревью claude мердж?

нет. code review не одобряет и не блокирует pr, его проверка всегда завершается нейтрально. если хочешь не пускать в main код с серьёзными находками, документация показывает, как прочитать итог проверки в своём ci через gh api.

источники

• claude code github actions — документация claude code
• code review — документация claude code
• common workflows — документация claude code
• best practices — документация claude code
• checkpointing — документация claude code
• about billing for github actions — документация github
• pricing — документация claude
• anthropics/skills — github