Claude Code GitHub Actions використання посібник

Claude Code — це інструмент Agentic Coding, розроблений компанією Anthropic, також відомий як один з найпотужніших програмних агентів у світі. Claude Code GitHub Actions дозволяє інтегрувати можливості AI програмування у ваш GitHub робочий процес, просто вказавши @claude у PR або Issue, щоб Claude автоматично проаналізував код, створив PR, реалізував функціонал, виправив Bug. Цей документ в основному описує, як налаштувати та використовувати 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 App

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

Цей додаток потребує наступних прав доступу до репозиторію:

Права	Рівень	Опис
Contents	Read & Write	Змінювати файли репозиторію
Issues	Read & Write	Відповідати на Issue
Pull requests	Read & Write	Створювати PR та вносити зміни

Крок другий: додавання API ключа

Додайте API ключ AceData Cloud як Secret репозиторію:

Перейдіть у 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 у компоненті user dashboard
@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`	Параметри, передані CLI Claude Code	Ні
`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 (наприклад, ${{ secrets.ANTHROPIC_API_KEY }})
Обмежте права доступу Action до мінімально необхідних
Перед злиттям вручну перевіряйте рекомендації Claude

Контроль витрат

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

Поширені запитання

Claude не відповідає на команду @claude?

Переконайтеся, що Claude GitHub App правильно встановлено
Перевірте, чи активовано Workflow
Переконайтеся, що API ключ налаштовано як Secret репозиторію
Переконайтеся, що в коментарі використано @claude (не /claude)

Помилка автентифікації?

Підтвердіть, що API ключ дійсний і має достатні права
Перевірте, чи правильна назва Secret ( ANTHROPIC_API_KEY )
Якщо використовується ANTHROPIC_BASE_URL, підтвердіть, що URL правильний

Як переглянути залишок квоти?

Увійдіть в консоль AceData Cloud, щоб переглянути залишок квоти та використання вашого облікового запису.

Дізнайтеся більше

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

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

​Функціональні можливості

​Кроки налаштування

​Крок перший: встановлення Claude GitHub App

​Крок другий: додавання API ключа

​Крок третій: створення файлу Workflow

​Спосіб використання

​Використання в коментарях до Issue або PR

​Автоматичний код-рев’ю

​Автоматизація за розкладом

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

​Звичайні параметри claude_args

​Найкращі практики

​Налаштування CLAUDE.md

​Заходи безпеки

​Контроль витрат

​Поширені запитання

​Claude не відповідає на команду @claude?

​Помилка автентифікації?

​Як переглянути залишок квоти?

​Дізнайтеся більше