Claude Code GitHub Actions Использование Руководство

Claude Code — это инструмент Agentic Coding, выпущенный компанией Anthropic, также известный как один из самых мощных программных агентов в мире. Claude Code GitHub Actions позволяет интегрировать возможности AI программирования в ваш рабочий процесс GitHub, просто упомянув @claude в PR или Issue, и Claude автоматически проанализирует код, создаст PR, реализует функции и исправит ошибки. Этот документ в основном описывает, как настроить и использовать Claude Code GitHub Actions через прокси-сервис AceData Cloud.

Процесс подачи заявки

Чтобы использовать Claude Code, сначала перейдите на страницу сервиса Claude Messages и нажмите кнопку «Acquire», чтобы получить необходимые учетные данные:

Если вы еще не вошли в систему или не зарегистрированы, вы будете автоматически перенаправлены на страницу входа, где вас пригласят зарегистрироваться и войти в систему. После входа в систему вы будете автоматически возвращены на текущую страницу. При первом запросе будет предоставлен бесплатный лимит, чтобы вы могли бесплатно опробовать сервис Claude Code.

Функциональные особенности

Мгновенное создание PR: опишите требования, и Claude автоматически создаст полный Pull Request
Автоматическая реализация кода: в Issue упомяните @claude, и Issue будет преобразован в исполняемый код
Соблюдение стандартов проекта: автоматически считывает CLAUDE.md, соблюдая ваш стиль кода и стандарты проекта
Безопасность и надежность: код выполняется на Runner GitHub, безопасность данных гарантирована

Шаги настройки

Шаг первый: Установка приложения Claude GitHub

Перейдите на https://github.com/apps/claude и установите приложение Claude GitHub в ваш репозиторий. Страница установки приложения GitHub Claude

Страница установки приложения GitHub Claude

Это приложение требует следующие разрешения на репозиторий:

Разрешение	Уровень	Описание
Contents	Read & Write	Изменение файлов репозитория
Issues	Read & Write	Ответ на Issue
Pull requests	Read & Write	Создание PR и отправка изменений

Шаг второй: Добавление API ключа

Добавьте API ключ AceData Cloud в качестве секрета репозитория:

Перейдите в Settings → Secrets and variables → Actions
Нажмите New repository secret
В поле Name укажите ANTHROPIC_API_KEY, в поле Value введите токен API, полученный в AceData Cloud
Нажмите Add secret для сохранения

Подсказка: Токен API можно просмотреть в консоли AceData Cloud.

Шаг третий: Создание файла Workflow

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

name: Claude Code
on:
  issue_comment:
    types: [created]
  pull_request_review_comment:
    types: [created]
  issues:
    types: [opened, assigned]
  pull_request:
    types: [opened, synchronize]

jobs:
  claude:
    runs-on: ubuntu-latest
    steps:
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}

Если необходимо использовать прокси API конечную точку AceData Cloud, также нужно установить переменные окружения в Workflow:

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 }}
        env:
          ANTHROPIC_BASE_URL: "https://api.acedata.cloud"

Способы использования

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

После завершения настройки, в любом комментарии к Issue или PR упомяните @claude, и Claude автоматически ответит:

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

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

Создайте Workflow, который автоматически выполняет проверку кода при открытии PR:

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"
          claude_args: "--max-turns 5"
        env:
          ANTHROPIC_BASE_URL: "https://api.acedata.cloud"

Автоматизация по расписанию

Создайте автоматизированную задачу, выполняемую по расписанию:

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: "Сгенерируйте сводку по коммитам за вчера и отчет по незакрытым Issue"
        env:
          ANTHROPIC_BASE_URL: "https://api.acedata.cloud"

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

Параметр	Описание	Обязательный
`anthropic_api_key`	API ключ	Да
`prompt`	Команда для Claude (текст или Skill, например, `/review`)	Нет
`claude_args`	Параметры, передаваемые в Claude Code CLI	Нет
`github_token`	GitHub Token	Нет
`trigger_phrase`	Пользовательская триггерная фраза (по умолчанию `@claude`)	Нет

Распространенные параметры claude_args

claude_args: "--max-turns 5 --model claude-sonnet-4-5-20250929"

Параметр	Описание
`--max-turns`	Максимальное количество раундов диалога (по умолчанию 10)
`--model`	Используемая модель
`--mcp-config`	Путь к конфигурационному файлу MCP
`--allowed-tools`	Разрешенные инструменты (через запятую)
`--debug`	Включить отладочный вывод

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

Настройка CLAUDE.md

Создайте файл CLAUDE.md в корневом каталоге репозитория, определите руководство по стилю кода, стандарты проверки и проектные нормы, и Claude будет автоматически следовать этим правилам.

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

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

Контроль затрат

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

Часто задаваемые вопросы

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

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

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

Убедитесь, что API-ключ действителен и имеет достаточные права
Проверьте, правильно ли указано имя секрета (ANTHROPIC_API_KEY)
Если используется ANTHROPIC_BASE_URL, убедитесь, что URL правильный

Как посмотреть оставшийся лимит?

Войдите в консоль AceData Cloud, чтобы увидеть текущий остаток и использование вашего аккаунта.

Узнать больше

📖 Официальная документация Claude Code GitHub Actions
📂 Репозиторий claude-code-action
📋 Примеры рабочих процессов
🔧 Служба Claude Code AceData Cloud
💬 Если у вас есть вопросы, пожалуйста, свяжитесь с нами через службу поддержки платформы

​Процесс подачи заявки

​Функциональные особенности

​Шаги настройки

​Шаг первый: Установка приложения Claude GitHub

​Шаг второй: Добавление API ключа

​Шаг третий: Создание файла Workflow

​Способы использования

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

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

​Автоматизация по расписанию

​Описание параметров Action

​Распространенные параметры claude_args

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

​Настройка CLAUDE.md

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

​Контроль затрат

​Часто задаваемые вопросы

​Claude не отвечает на команду @claude?

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

​Как посмотреть оставшийся лимит?

​Узнать больше