GitHub Actions в Claude Code

Claude Code GitHub Actions привносит автоматизацию на основе ИИ в ваши рабочие процессы GitHub.

Просто упомянув его в PR или Issue@claude, Claude может анализировать код, создавать Pull Request, реализовывать функции и исправлять ошибки, следуя стандартным рекомендациям вашего проекта.


Почему стоит использовать Claude Code GitHub Actions

  • Мгновенное создание PR: Опишите, что вам нужно, и Claude сможет создать полноценный Pull Request
  • Автоматическая реализация кода: Превращайте Issues в работающий код одной командой
  • Соблюдает стандарты проекта: Уважает вашиCLAUDE.mdрекомендации и существующие шаблоны кода
  • Просто и быстро: Начните за несколько минут
  • Безопасно и надёжно: Код продолжает работать на раннерах GitHub

Быстрый старт

Способ 1: Автоматическая установка (рекомендуется)

Выполните в терминале Claude Code:

/install-github-app

Это проведёт вас через:

  • Настройка GitHub App
  • Добавление необходимых секретов

Требования: Вы должны быть администратором репозитория. GitHub App требует разрешения на чтение/запись для For, Issues и Pull requests. Применимо только к пользователям, напрямую использующим Claude API (AWS Bedrock и Google Vertex AI не поддерживаются).

Способ 2: Ручная установка

Шаг 1: Установите Claude GitHub App

Посетите:https://github.com/apps/claude

Необходимые разрешения:

  • Содержимое: Разрешения на чтение/запись
  • Проблемы: Разрешения на чтение/запись
  • Запросы на слияние: Разрешения на чтение/запись

Шаг 2: Добавьте API-ключ

Добавьте в секреты репозиторияANTHROPIC_API_KEY

Шаг 3: Создайте файл рабочего процесса

Скопируйте из файла примера:examples/claude.ymlв.github/workflows/


Конфигурация рабочего процесса

Базовый рабочий процесс (реакция на упоминания @claude)

name: Claude Code
on:
  issue_comment:
    types: [created]
  pull_request_review_comment:
    types: [created]
jobs:
  claude:
    runs-on: ubuntu-latest
    steps:
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}

Автоматическая проверка кода

name: Code Review
on:
  pull_request:
    types: [opened, synchronize]
jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          prompt: "Review this pull request for code quality, correctness, and security."
          claude_args: "--max-turns 5"

Запланированные задачи

name: Daily Report
on:
  schedule:
    - cron: "0 9 * * *"
jobs:
  report:
    runs-on: ubuntu-latest
    steps:
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          prompt: "Generate a summary of yesterday's commits and open issues"
          claude_args: "--model opus"

Часто используемые команды @claude

Использование в комментариях PR или Issue:

@claude implement this feature based on the issue description
@claude how should I implement user authentication for this endpoint?
@claude fix the TypeError in the user dashboard component
@claude review this PR for security issues
@claude add tests for this new function

Пояснение параметров Action

Параметр Описание Обязательный
prompt Инструкции для Claude (простой текст или имя навыка) Нет*
claude_args Аргументы CLI, передаваемые Claude Code нет
anthropic_api_key API-ключ Claude Да**
github_token Токен GitHub (для доступа к API) нет
trigger_phrase Пользовательское триггерное слово (по умолчанию:@claude) нет
use_bedrock Использовать AWS Bedrock вместо Claude API нет
use_vertex Использовать Google Vertex AI вместо Claude API нет

*Пропускать prompt при использовании в комментариях issue/PR; Claude отвечает на триггерное слово

**Обязательно при использовании Claude API напрямую, не требуется для Bedrock/Vertex

Общие параметры CLI

Параметр Описание
--max-turns Максимальное число ходов диалога (по умолчанию 10)
--model Модель для использования (например,claude-sonnet-4-6)
--mcp-config Путь к файлу конфигурации MCP
--allowedTools Разрешённые инструменты (через запятую)
--append-system-prompt Добавить системный промпт
--debug Включить отладочный вывод

Примеры claude_args

claude_args: |
  --max-turns 5
  --model claude-sonnet-4-6
  --mcp-config /path/to/config.json
  --append-system-prompt "Follow our coding standards"

Интеграция с AWS Bedrock

Предварительные требования

  • Доступ к AWS Bedrock включён с разрешениями для модели Claude
  • GitHub настроен как поставщик удостоверений OIDC в AWS
  • Роль IAM с разрешениями Bedrock

Обязательные секреты

Имя секрета Описание
AWS_ROLE_TO_ASSUME ARN роли IAM для доступа к Bedrock
APP_ID ID приложения GitHub
APP_PRIVATE_KEY Закрытый ключ приложения GitHub

Пример рабочего процесса Bedrock

name: Claude PR Action
permissions:
  contents: write
  pull-requests: write
  issues: write
  id-token: write

on:
  issue_comment:
    types: [created]
  pull_request_review_comment:
    types: [created]

jobs:
  claude-pr:
    if: |
      (github.event_name == 'issue_comment' && contains(github.event.comment.body, '@claude')) ||
      (github.event_name == 'pull_request_review_comment' && contains(github.event.comment.body, '@claude'))
    runs-on: ubuntu-latest
    env:
      AWS_REGION: us-west-2
    steps:
      - name: Checkout repository
        uses: actions/checkout@v4

      - name: Generate GitHub App token
        id: app-token
        uses: actions/create-github-app-token@v2
        with:
          app-id: ${{ secrets.APP_ID }}
          private-key: ${{ secrets.APP_PRIVATE_KEY }}

      - name: Configure AWS Credentials (OIDC)
        uses: aws-actions/configure-aws-credentials@v4
        with:
          role-to-assume: ${{ secrets.AWS_ROLE_TO_ASSUME }}
          aws-region: us-west-2

      - uses: anthropics/claude-code-action@v1
        with:
          github_token: ${{ steps.app-token.outputs.token }}
          use_bedrock: "true"
          claude_args: '--model us.anthropic.claude-sonnet-4-6 --max-turns 10'

Интеграция с Google Vertex AI

Предварительные требования

  • API Vertex AI включён в проекте GCP
  • Федерация удостоверений рабочих нагрузок настроена для GitHub
  • Сервисная учётная запись с разрешениями Vertex AI

Обязательные секреты

Имя секрета Описание
GCP_WORKLOAD_IDENTITY_PROVIDER Имя ресурса поставщика удостоверений рабочих нагрузок
GCP_SERVICE_ACCOUNT Адрес электронной почты сервисной учётной записи с доступом к Vertex AI
APP_ID ID приложения GitHub
APP_PRIVATE_KEY Закрытый ключ приложения GitHub

Пример рабочего процесса Vertex AI

name: Claude PR Action
permissions:
  contents: write
  pull-requests: write
  issues: write
  id-token: write

on:
  issue_comment:
    types: [created]

jobs:
  claude-pr:
    if: github.event_name == 'issue_comment' && contains(github.event.comment.body, '@claude')
    runs-on: ubuntu-latest
    steps:
      - name: Checkout repository
        uses: actions/checkout@v4

      - name: Generate GitHub App token
        id: app-token
        uses: actions/create-github-app-token@v2
        with:
          app-id: ${{ secrets.APP_ID }}
          private-key: ${{ secrets.APP_PRIVATE_KEY }}

      - name: Authenticate to Google Cloud
        id: auth
        uses: google-github-actions/auth@v2
        with:
          workload_identity_provider: ${{ secrets.GCP_WORKLOAD_IDENTITY_PROVIDER }}
          service_account: ${{ secrets.GCP_SERVICE_ACCOUNT }}

      - uses: anthropics/claude-code-action@v1
        with:
          github_token: ${{ steps.app-token.outputs.token }}
          trigger_phrase: "@claude"
          use_vertex: "true"
          claude_args: '--model claude-sonnet-4-5@20250929 --max-turns 10'
        env:
          ANTHROPIC_VERTEX_PROJECT_ID: ${{ steps.auth.outputs.project_id }}
          CLOUD_ML_REGION: us-east5

Обновление с бета-версии (критические изменения v1.0)

Входные данные бета-версии Новые входные данные v1.0
mode (Удалено — определяется автоматически)
direct_prompt prompt
override_prompt с переменными GitHubprompt
custom_instructions claude_args: --append-system-prompt
max_turns claude_args: --max-turns
model claude_args: --model
allowed_tools claude_args: --allowedTools
disallowed_tools claude_args: --disallowedTools

Сравнение до и после обновления

Бета-версия:

- uses: anthropics/claude-code-action@beta
  with:
    mode: "tag"
    direct_prompt: "Review this PR for security issues"
    anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
    custom_instructions: "Follow our coding standards"
    max_turns: "10"
    model: "claude-sonnet-4-6"

GA-версия (v1.0):

- uses: anthropics/claude-code-action@v1
  with:
    prompt: "Review this PR for security issues"
    anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
    claude_args: |
      --append-system-prompt "Follow our coding standards"
      --max-turns 10
      --model claude-sonnet-4-6

Устранение неполадок

Claude не отвечает на команды @claude

  • Убедитесь, что приложение GitHub установлено правильно
  • Проверьте, включен ли рабочий процесс
  • Убедитесь, что API-ключ задан в секретах репозитория
  • Убедитесь, что комментарий содержит@claude(не/claude)

CI не запускается на коммитах от Claude

  • Используйте GitHub App или пользовательское приложение (не используйте пользователя Actions)
  • Проверьте, что триггеры workflow включают необходимые события
  • Убедитесь, что разрешения приложения включают триггеры CI

Ошибки аутентификации

  • Убедитесь, что API-ключ действителен и имеет достаточные разрешения
  • Для Bedrock/Vertex: проверьте конфигурацию учетных данных
  • Убедитесь, что имена секретов указаны правильно в workflow

Вопросы безопасности

  • Никогда не коммитьте API-ключи напрямуюв репозиторий
  • Используйте GitHub Secrets для хранения ключей API:${{ secrets.ANTHROPIC_API_KEY }}
  • Ограничьте разрешения действий; предоставляйте только необходимые разрешения
  • Проверяйте предложения Claude перед слиянием
  • Для AWS/GCP: используйте провайдеры идентификации OIDC вместо статических учётных данных
  • Создайте выделенные сервисные аккаунты для каждого репозитория

Соображения о стоимости

Разбивка затрат

  • Затраты на GitHub Actions: запуск на исполнителях, размещённых на GitHub, расходует минуты GitHub Actions
  • Затраты на API: каждое взаимодействие с Claude расходует токены API в зависимости от длины запроса/ответа

Рекомендации по оптимизации затрат

  • Используйте конкретные@claudeкоманды, сократите ненужные вызовы API
  • Настройте соответствующие--max-turnsОграничьте количество раундов диалога
  • Установите тайм-ауты рабочего процесса, чтобы задачи не выходили из-под контроля
  • Используйте средства управления параллелизмом GitHub, чтобы ограничить параллельные запуски

Лучшие практики

1. Создайте CLAUDE.md

Создайте в корне репозиторияCLAUDE.mdфайл, определите руководство по стилю кода и правила, специфичные для проекта:

# 项目开发规范

## 代码风格
- 使用 TypeScript 4.x
- 遵循 ESLint 配置
- 函数必须有 JSDoc 注释

## PR 要求
- 必须通过所有 CI 检查
- 至少一个代码审查
- 更新相关文档

## 禁止事项
- 不要修改 `migrations/` 目录
- 不要提交 `.env` 文件

2. Используйте конкретные команды @claude

@claude review this PR for SQL injection vulnerabilities
@claude add unit tests for the new validateEmail function

3. Настройте соответствующие ограничения

jobs:
  claude:
    runs-on: ubuntu-latest
    timeout-minutes: 15  # 设置超时
    steps:
      - uses: anthropics/claude-code-action@v1
        with:
          claude_args: "--max-turns 5 --allowedTools Read,Grep,Glob,Bash,Write,Edit"

4. Сценарии автоматизации CI/CD

  • Автоматическое ревью PR: Автоматически запускать ревью при открытии или обновлении PR
  • Автоматическая классификация Issue: Автоматически добавлять метки и исполнителей при создании нового Issue
  • Запланированные отчеты: Генерировать ежедневную статистику кода или отчеты по безопасности
  • Автоматические исправления: Автоматически анализировать и пытаться исправить при сбое CI
Другие расширения