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