> ## Documentation Index
> Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

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

> Claude Code 集成指南 - Ace Data Cloud

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](https://platform.acedata.cloud/documents/claude-messages) и нажмите кнопку «Acquire», чтобы получить необходимые учетные данные:

![](https://cdn.acedata.cloud/nyq0xz.png)

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

При первом запросе будет предоставлен бесплатный лимит, чтобы вы могли бесплатно опробовать сервис Claude Code.

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

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

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

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

Перейдите на [https://github.com/apps/claude](https://github.com/apps/claude) и установите приложение Claude GitHub в ваш репозиторий.

![Страница установки приложения GitHub Claude](https://cdn.acedata.cloud/ba4b8df66d.png)

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

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

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

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

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

> **Подсказка**: Токен API можно просмотреть в [консоли AceData Cloud](https://platform.acedata.cloud/console).

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

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

```yaml theme={null}
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:

```yaml theme={null}
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:

```yaml theme={null}
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"
```

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

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

```yaml theme={null}
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

```yaml theme={null}
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?

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

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

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

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

Войдите в [консоль AceData Cloud](https://platform.acedata.cloud/console), чтобы увидеть текущий остаток и использование вашего аккаунта.

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

* 📖 [Официальная документация Claude Code GitHub Actions](https://code.claude.com/docs/en/github-actions)
* 📂 [Репозиторий claude-code-action](https://github.com/anthropics/claude-code-action)
* 📋 [Примеры рабочих процессов](https://github.com/anthropics/claude-code-action/tree/main/examples)
* 🔧 [Служба Claude Code AceData Cloud](https://platform.acedata.cloud/documents/claude-messages)
* 💬 Если у вас есть вопросы, пожалуйста, свяжитесь с нами через службу поддержки платформы