Skip to main content
Claude Code GitHub Actions привносит автоматизацию на основе ИИ в ваш рабочий процесс GitHub. С простым упоминанием @claude в любом PR или issue, Claude может анализировать ваш код, создавать pull requests, реализовывать функции и исправлять ошибки — всё при соблюдении стандартов вашего проекта. Для автоматических проверок, размещаемых на каждом PR без триггера, см. GitHub Code Review.
Claude Code GitHub Actions построен на основе Claude Agent SDK, который обеспечивает программную интеграцию Claude Code в ваши приложения. Вы можете использовать SDK для создания пользовательских рабочих процессов автоматизации за пределами GitHub Actions.

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

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

Что может делать Claude?

Claude Code предоставляет мощный GitHub Action, который преобразует способ работы с кодом:

Claude Code Action

Этот GitHub Action позволяет вам запускать Claude Code в ваших рабочих процессах GitHub Actions. Вы можете использовать это для создания любого пользовательского рабочего процесса на основе Claude Code. Просмотреть репозиторий →

Настройка

Быстрая настройка

Запустите /install-github-app в терминале Claude Code для интерактивной настройки интеграции. Команда устанавливает Claude GitHub App в вашем репозитории и затем проводит вас через добавление GitHub Actions workflows и секрета API ключа. После установки GitHub App команда спрашивает, продолжить ли с настройкой GitHub Actions. В Claude Code v2.1.187 и более поздних версиях вы можете выбрать Skip for now (Пропустить на время), чтобы остановиться только с установленным App и вернуться к шагам workflow и секрета, запустив /install-github-app снова. Более ранние версии переходят прямо к выбору workflow.
  • Вы должны быть администратором репозитория для установки GitHub app и добавления секретов
  • GitHub app будет запрашивать права на чтение и запись для Contents, Issues и Pull requests
  • Этот метод быстрого старта доступен только для прямых пользователей Claude API. Если вы используете Amazon Bedrock или Google Cloud’s Agent Platform, см. раздел Использование с Amazon Bedrock и Google Cloud.

Ручная настройка

Если команда /install-github-app не сработала или вы предпочитаете ручную настройку, следуйте этим инструкциям ручной настройки:
  1. Установите Claude GitHub app в ваш репозиторий: https://github.com/apps/claude Claude GitHub app требует следующих разрешений репозитория:
    • Contents: Чтение и запись (для изменения файлов репозитория)
    • Issues: Чтение и запись (для ответа на issues)
    • Pull requests: Чтение и запись (для создания PR и отправки изменений)
    Для получения дополнительной информации о безопасности и разрешениях см. документацию по безопасности.
  2. Добавьте ANTHROPIC_API_KEY в секреты вашего репозитория (Узнайте, как использовать секреты в GitHub Actions)
  3. Скопируйте файл рабочего процесса из examples/claude.yml в папку .github/workflows/ вашего репозитория
После завершения быстрой настройки или ручной настройки протестируйте действие, отметив @claude в комментарии issue или PR.

Обновление с бета-версии

Claude Code GitHub Actions v1.0 вводит критические изменения, которые требуют обновления ваших файлов рабочего процесса для обновления с бета-версии на v1.0.
Если вы в настоящее время используете бета-версию Claude Code GitHub Actions, мы рекомендуем обновить ваши рабочие процессы для использования версии GA. Новая версия упрощает конфигурацию, добавляя мощные новые функции, такие как автоматическое обнаружение режима.

Существенные изменения

Все пользователи бета-версии должны внести эти изменения в свои файлы рабочего процесса для обновления:
  1. Обновите версию действия: Измените @beta на @v1
  2. Удалите конфигурацию режима: Удалите mode: "tag" или mode: "agent" (теперь автоматически обнаруживается)
  3. Обновите входные данные prompt: Замените direct_prompt на prompt
  4. Переместите параметры CLI: Преобразуйте max_turns, model, custom_instructions и т.д. в claude_args

Справочник критических изменений

Пример до и после

Бета-версия:
Версия GA (v1.0):
Действие теперь автоматически обнаруживает, следует ли запускать в интерактивном режиме (отвечает на упоминания @claude) или в режиме автоматизации (запускается немедленно с prompt) на основе вашей конфигурации.

Примеры использования

Claude Code GitHub Actions может помочь вам с различными задачами. Каталог примеров содержит готовые к использованию рабочие процессы для различных сценариев.

Базовый рабочий процесс

Использование skills

Входной параметр prompt принимает как вызов skill, так и простой текст:
  • Для skill в каталоге .claude/skills/ вашего репозитория запустите actions/checkout перед шагом action и передайте /skill-name.
  • Для skill, упакованного в plugin, установите plugin с помощью входных параметров plugin_marketplaces и plugins и передайте /plugin-name:skill-name с пространством имён.
Следующий рабочий процесс устанавливает plugin code-review и запускает его skill для каждого нового или обновлённого pull request:

Пользовательская автоматизация с prompts

Распространённые случаи использования

В комментариях issue или PR:
Claude автоматически проанализирует контекст и ответит соответствующим образом.

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

Конфигурация CLAUDE.md

Создайте файл CLAUDE.md в корне вашего репозитория для определения рекомендаций по стилю кода, критериев проверки, правил, специфичных для проекта, и предпочитаемых паттернов. Этот файл направляет понимание Claude стандартов вашего проекта.

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

Никогда не коммитьте API ключи непосредственно в ваш репозиторий.
Для полного руководства по безопасности, включая разрешения, аутентификацию и лучшие практики, см. документацию по безопасности Claude Code Action. Всегда используйте GitHub Secrets для API ключей:
  • Добавьте ваш API ключ как секрет репозитория с именем ANTHROPIC_API_KEY
  • Ссылайтесь на него в рабочих процессах: anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
  • Ограничьте разрешения действия только необходимыми
  • Проверьте предложения Claude перед слиянием
Всегда используйте GitHub Secrets (например, ${{ secrets.ANTHROPIC_API_KEY }}) вместо жёсткого кодирования API ключей непосредственно в ваши файлы рабочего процесса.

Оптимизация производительности

Используйте шаблоны issues для предоставления контекста, держите ваш CLAUDE.md кратким и сосредоточенным, и настройте соответствующие тайм-ауты для ваших рабочих процессов.

Затраты CI

При использовании Claude Code GitHub Actions помните о связанных затратах: Затраты GitHub Actions: Затраты API:
  • Каждое взаимодействие Claude потребляет токены API на основе длины prompts и ответов
  • Использование токенов варьируется в зависимости от сложности задачи и размера кодовой базы
  • См. страницу цен Claude для получения текущих ставок токенов
Советы по оптимизации затрат:
  • Используйте специфичные команды @claude для уменьшения ненужных вызовов API
  • Настройте соответствующий --max-turns в claude_args для предотвращения чрезмерных итераций
  • Установите тайм-ауты на уровне рабочего процесса, чтобы избежать неконтролируемых заданий
  • Рассмотрите использование элементов управления параллелизмом GitHub для ограничения параллельных запусков

Примеры конфигурации

Claude Code Action v1 упрощает конфигурацию с унифицированными параметрами:
Ключевые функции:
  • Унифицированный интерфейс prompt - Используйте prompt для всех инструкций
  • Skills - Вызывайте установленные skills непосредственно из prompt
  • Passthrough CLI - Любой аргумент Claude Code CLI через claude_args
  • Гибкие триггеры - Работает с любым событием GitHub
Посетите каталог примеров для полных файлов рабочего процесса.
При ответе на комментарии issue или PR, Claude автоматически отвечает на упоминания @claude. Для других событий используйте параметр prompt для предоставления инструкций.

Использование с Amazon Bedrock и Google Cloud

Для корпоративных сред вы можете использовать Claude Code GitHub Actions с вашей собственной облачной инфраструктурой. Этот подход даёт вам контроль над местоположением данных и выставлением счётов при сохранении той же функциональности.

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

Перед настройкой Claude Code GitHub Actions с облачными провайдерами вам нужно:

Для Google Cloud’s Agent Platform:

  1. Проект Google Cloud с включённым Google Cloud’s Agent Platform
  2. Workload Identity Federation, настроенный для GitHub Actions
  3. Сервисный аккаунт с необходимыми разрешениями
  4. GitHub App (рекомендуется) или использование стандартного GITHUB_TOKEN

Для Amazon Bedrock:

  1. Аккаунт AWS с включённым Amazon Bedrock
  2. GitHub OIDC Identity Provider, настроенный в AWS
  3. IAM роль с разрешениями Amazon Bedrock
  4. GitHub App (рекомендуется) или использование стандартного GITHUB_TOKEN
1

Создайте пользовательский GitHub App (Рекомендуется для 3P провайдеров)

Для лучшего контроля и безопасности при использовании 3P провайдеров, таких как Google Cloud’s Agent Platform или Amazon Bedrock, мы рекомендуем создать свой собственный GitHub App:
  1. Перейдите на https://github.com/settings/apps/new
  2. Заполните основную информацию:
    • GitHub App name: Выберите уникальное имя (например, “YourOrg Claude Assistant”)
    • Homepage URL: Веб-сайт вашей организации или URL репозитория
  3. Настройте параметры приложения:
    • Webhooks: Снимите флажок “Active” (не требуется для этой интеграции)
  4. Установите необходимые разрешения:
    • Repository permissions:
      • Contents: Read & Write
      • Issues: Read & Write
      • Pull requests: Read & Write
  5. Нажмите “Create GitHub App”
  6. После создания нажмите “Generate a private key” и сохраните загруженный файл .pem
  7. Запишите ID вашего приложения со страницы параметров приложения
  8. Установите приложение в ваш репозиторий:
    • Со страницы параметров вашего приложения нажмите “Install App” в левой боковой панели
    • Выберите ваш аккаунт или организацию
    • Выберите “Only select repositories” и выберите конкретный репозиторий
    • Нажмите “Install”
  9. Добавьте приватный ключ как секрет в ваш репозиторий:
    • Перейдите в Settings вашего репозитория → Secrets and variables → Actions
    • Создайте новый секрет с именем APP_PRIVATE_KEY с содержимым файла .pem
  10. Добавьте ID приложения как секрет:
  • Создайте новый секрет с именем APP_ID с ID вашего GitHub App
Это приложение будет использоваться с действием actions/create-github-app-token для генерации токенов аутентификации в ваших рабочих процессах.
Альтернатива для Claude API или если вы не хотите настраивать свой Github app: Используйте официальное приложение Anthropic:
  1. Установите из: https://github.com/apps/claude
  2. Дополнительная конфигурация для аутентификации не требуется
2

Настройте аутентификацию облачного провайдера

Выберите вашего облачного провайдера и установите безопасную аутентификацию:
Настройте AWS, чтобы разрешить GitHub Actions безопасно аутентифицироваться без сохранения учётных данных.
Примечание по безопасности: Используйте конфигурации, специфичные для репозитория, и предоставляйте только минимально необходимые разрешения.
Требуемая настройка:
  1. Включите Amazon Bedrock:
    • Запросите доступ к моделям Claude в Amazon Bedrock
    • Для кроссрегиональных моделей запросите доступ во всех необходимых регионах
  2. Установите GitHub OIDC Identity Provider:
    • Provider URL: https://token.actions.githubusercontent.com
    • Audience: sts.amazonaws.com
  3. Создайте IAM Role для GitHub Actions:
    • Trusted entity type: Web identity
    • Identity provider: token.actions.githubusercontent.com
    • Permissions: политика AmazonBedrockFullAccess
    • Настройте политику доверия для вашего конкретного репозитория
Требуемые значения:После настройки вам понадобятся:
  • AWS_ROLE_TO_ASSUME: ARN IAM роли, которую вы создали
OIDC более безопасен, чем использование статических AWS ключей доступа, потому что учётные данные являются временными и автоматически ротируются.
См. документацию AWS для получения подробных инструкций по настройке OIDC.
Настройте Google Cloud, чтобы разрешить GitHub Actions безопасно аутентифицироваться без сохранения учётных данных.
Примечание по безопасности: Используйте конфигурации, специфичные для репозитория, и предоставляйте только минимально необходимые разрешения.
Требуемая настройка:
  1. Включите API в вашем проекте Google Cloud:
    • IAM Credentials API
    • Security Token Service (STS) API
    • Google Cloud’s Agent Platform API
  2. Создайте ресурсы Workload Identity Federation:
    • Создайте Workload Identity Pool
    • Добавьте GitHub OIDC провайдера с:
      • Issuer: https://token.actions.githubusercontent.com
      • Attribute mappings для репозитория и владельца
      • Рекомендация по безопасности: Используйте условия атрибутов, специфичные для репозитория
  3. Создайте сервисный аккаунт:
    • Предоставьте только роль Vertex AI User
    • Рекомендация по безопасности: Создайте выделенный сервисный аккаунт для каждого репозитория
  4. Настройте IAM привязки:
    • Разрешите Workload Identity Pool олицетворять сервисный аккаунт
    • Рекомендация по безопасности: Используйте наборы принципалов, специфичные для репозитория
Требуемые значения:После настройки вам понадобятся:
  • GCP_WORKLOAD_IDENTITY_PROVIDER: Полное имя ресурса провайдера
  • GCP_SERVICE_ACCOUNT: Адрес электронной почты сервисного аккаунта
Workload Identity Federation исключает необходимость в загружаемых ключах сервисного аккаунта, улучшая безопасность.
Для получения подробных инструкций по настройке обратитесь к документации Google Cloud Workload Identity Federation.
3

Добавьте необходимые секреты

Добавьте следующие секреты в ваш репозиторий (Settings → Secrets and variables → Actions):

Для Claude API (Direct):

  1. Для аутентификации API:
  2. Для GitHub App (если используете свой app):
    • APP_ID: ID вашего GitHub App
    • APP_PRIVATE_KEY: Содержимое приватного ключа (.pem)

Для Google Cloud’s Agent Platform

  1. Для аутентификации GCP:
    • GCP_WORKLOAD_IDENTITY_PROVIDER
    • GCP_SERVICE_ACCOUNT
  2. Для GitHub App (если используете свой app):
    • APP_ID: ID вашего GitHub App
    • APP_PRIVATE_KEY: Содержимое приватного ключа (.pem)

Для AWS Bedrock

  1. Для аутентификации AWS:
    • AWS_ROLE_TO_ASSUME
  2. Для GitHub App (если используете свой app):
    • APP_ID: ID вашего GitHub App
    • APP_PRIVATE_KEY: Содержимое приватного ключа (.pem)
4

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

Создайте файлы рабочего процесса GitHub Actions, которые интегрируются с вашим облачным провайдером. Примеры ниже показывают полные конфигурации как для Amazon Bedrock, так и для Google Cloud’s Agent Platform:
Предварительные требования:
  • Доступ Amazon Bedrock включён с разрешениями модели Claude
  • GitHub настроен как OIDC поставщик идентификации в AWS
  • IAM роль с разрешениями Amazon Bedrock, которая доверяет GitHub Actions
Требуемые секреты GitHub:
Формат ID модели для Amazon Bedrock включает префикс региона (например, us.anthropic.claude-sonnet-4-6).
Предварительные требования:
  • Google Cloud’s Agent Platform API включён в вашем проекте GCP
  • Workload Identity Federation настроена для GitHub
  • Сервисный аккаунт с разрешениями Google Cloud’s Agent Platform
Требуемые секреты GitHub:
ID проекта автоматически извлекается из шага аутентификации Google Cloud, поэтому вам не нужно жёстко кодировать его.

Troubleshooting

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

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

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

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

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

Подтвердите, что API ключ действителен и имеет достаточные разрешения. Для Amazon Bedrock или Google Cloud’s Agent Platform проверьте конфигурацию учётных данных и убедитесь, что секреты правильно названы в рабочих процессах.

Расширенная конфигурация

Параметры действия

Claude Code Action v1 использует упрощённую конфигурацию: *Prompt опционален — при пропуске для комментариев issue/PR, Claude отвечает на фразу триггера
**Требуется для прямого Claude API, не требуется для Amazon Bedrock или Google Cloud’s Agent Platform

Передайте аргументы CLI

Параметр claude_args принимает любые аргументы Claude Code CLI:
Распространённые аргументы:
  • --max-turns: Максимальное количество ходов разговора (по умолчанию: 10)
  • --model: Модель для использования (например, claude-sonnet-5)
  • --mcp-config: Путь к конфигурации MCP
  • --allowedTools: Список разрешённых инструментов, разделённый запятыми. Также работает псевдоним --allowed-tools.
  • --debug: Включить вывод отладки

Альтернативные методы интеграции

Хотя команда /install-github-app является рекомендуемым подходом, вы также можете:
  • Пользовательский GitHub App: Для организаций, нуждающихся в фирменных именах пользователей или пользовательских потоках аутентификации. Создайте свой собственный GitHub App с необходимыми разрешениями (contents, issues, pull requests) и используйте действие actions/create-github-app-token для генерации токенов в ваших рабочих процессах.
  • Ручные GitHub Actions: Прямая конфигурация рабочего процесса для максимальной гибкости
  • Конфигурация MCP: Динамическая загрузка серверов Model Context Protocol
См. документацию Claude Code Action для получения подробных руководств по аутентификации, безопасности и расширенной конфигурации.

Настройка поведения Claude

Вы можете настроить поведение Claude двумя способами:
  1. CLAUDE.md: Определите стандарты кодирования, критерии проверки и правила, специфичные для проекта, в файле CLAUDE.md в корне вашего репозитория. Claude будет следовать этим рекомендациям при создании PR и ответе на запросы. Ознакомьтесь с нашей документацией Memory для получения дополнительной информации.
  2. Пользовательские prompts: Используйте параметр prompt в файле рабочего процесса для предоставления инструкций, специфичных для рабочего процесса. Это позволяет вам настроить поведение Claude для различных рабочих процессов или задач.
Claude будет следовать этим рекомендациям при создании PR и ответе на запросы.