> ## 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 użycie przewodnik

> Claude Code 集成指南 - Ace Data Cloud

Claude Code to narzędzie **Agentic Coding** wprowadzone przez Anthropic, znane również jako jeden z najsilniejszych agentów programistycznych na świecie. Claude Code GitHub Actions może zintegrować zdolności programowania AI z twoim przepływem pracy GitHub, wystarczy w PR lub Issue użyć `@claude`, aby Claude automatycznie analizował kod, tworzył PR, realizował funkcje i naprawiał błędy.

Dokument ten głównie opisuje, jak skonfigurować i używać Claude Code GitHub Actions za pomocą usługi proxy AceData Cloud.

## Proces aplikacji

Aby korzystać z Claude Code, najpierw przejdź do [strony usługi Claude Messages](https://platform.acedata.cloud/documents/claude-messages) i kliknij przycisk „Acquire”, aby uzyskać potrzebne poświadczenia:

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

Jeśli nie jesteś zalogowany lub zarejestrowany, automatycznie zostaniesz przekierowany na stronę logowania, aby zarejestrować się i zalogować, po zalogowaniu lub rejestracji automatycznie wrócisz na bieżącą stronę.

Podczas pierwszej aplikacji otrzymasz darmowy limit, aby bezpłatnie wypróbować usługi Claude Code.

## Cechy funkcjonalne

* **Natychmiastowe tworzenie PR**: Opisz wymagania, a Claude automatycznie stworzy kompletny Pull Request
* **Automatyczne realizowanie kodu**: W Issue użyj `@claude`, aby przekształcić Issue w działający kod
* **Zgodność z normami projektu**: Automatycznie odczytuje `CLAUDE.md`, przestrzegając twojego stylu kodowania i norm projektu
* **Bezpieczne i niezawodne**: Kod działa na Runnerze GitHub, bezpieczeństwo danych jest zapewnione

## Kroki konfiguracyjne

### Krok 1: Zainstaluj aplikację Claude GitHub

Przejdź do [https://github.com/apps/claude](https://github.com/apps/claude) i zainstaluj aplikację Claude GitHub w swoim repozytorium.

![Strona instalacji aplikacji GitHub Claude](https://cdn.acedata.cloud/ba4b8df66d.png)

Aplikacja wymaga następujących uprawnień do repozytoriów:

| Uprawnienia       | Poziom         | Opis                              |
| ----------------- | -------------- | --------------------------------- |
| **Zawartość**     | Odczyt i zapis | Modyfikacja plików repozytorium   |
| **Problemy**      | Odczyt i zapis | Odpowiadanie na problemy          |
| **Pull requests** | Odczyt i zapis | Tworzenie PR i wprowadzanie zmian |

### Krok 2: Dodaj klucz API

Dodaj klucz API AceData Cloud jako sekret repozytorium:

1. Wejdź do repozytorium **Ustawienia** → **Sekrety i zmienne** → **Akcje**
2. Kliknij **Nowy sekret repozytorium**
3. W polu Nazwa wpisz `ANTHROPIC_API_KEY`, a w polu Wartość wprowadź token API uzyskany w AceData Cloud
4. Kliknij **Dodaj sekret**, aby zapisać

> **Wskazówka**: Token API można zobaczyć w [konsoli AceData Cloud](https://platform.acedata.cloud/console).

### Krok 3: Utwórz plik Workflow

Utwórz plik `.github/workflows/claude.yml` w repozytorium:

```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 }}
```

Jeśli potrzebujesz użyć punktu końcowego API proxy AceData Cloud, musisz również ustawić zmienną środowiskową w 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"
```

## Sposób użycia

### Użycie w komentarzach Issue lub PR

Po zakończeniu konfiguracji, w każdym komentarzu w Issue lub PR użyj `@claude`, a Claude automatycznie odpowie:

```
@claude Zrealizuj funkcję na podstawie opisu tego Issue
@claude Sprawdź bezpieczeństwo kodu w tym PR
@claude Napraw błąd TypeError w komponencie dashboard użytkownika
@claude Jak zaimplementować uwierzytelnianie użytkowników w tym punkcie końcowym?
```

### Automatyczna recenzja kodu

Utwórz Workflow, który automatycznie wykonuje recenzję kodu przy otwieraniu 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"
```

### Automatyzacja zadań cyklicznych

Utwórz automatyczne zadanie wykonywane cyklicznie:

```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: "Generuj podsumowanie wczorajszych commitów i raport o niezamkniętych Issue"
        env:
          ANTHROPIC_BASE_URL: "https://api.acedata.cloud"
```

## Opis parametrów akcji

| Parametr            | Opis                                                         | Wymagany |
| ------------------- | ------------------------------------------------------------ | -------- |
| `anthropic_api_key` | Klucz API                                                    | Tak      |
| `prompt`            | Instrukcja dla Claude (tekst lub umiejętność, np. `/review`) | Nie      |
| `claude_args`       | Parametry przekazywane do CLI Claude Code                    | Nie      |
| `github_token`      | Token GitHub                                                 | Nie      |
| `trigger_phrase`    | Niestandardowa fraza wyzwalająca (domyślnie `@claude`)       | Nie      |

### Często używane parametry claude\_args

```yaml theme={null}
claude_args: "--max-turns 5 --model claude-sonnet-4-5-20250929"
```

| Parametr          | Opis                                         |
| ----------------- | -------------------------------------------- |
| `--max-turns`     | Maksymalna liczba tur rozmowy (domyślnie 10) |
| `--model`         | Używany model                                |
| `--mcp-config`    | Ścieżka do pliku konfiguracyjnego MCP        |
| `--allowed-tools` | Dozwolone narzędzia (oddzielone przecinkami) |
| `--debug`         | Włącz wyjście debugowania                    |

## Najlepsze praktyki

### Konfiguracja CLAUDE.md

Utwórz plik `CLAUDE.md` w katalogu głównym repozytorium, definiując wytyczne dotyczące stylu kodu, standardy recenzji i normy projektu, a Claude automatycznie będzie przestrzegał tych zasad.

### Uwagi dotyczące bezpieczeństwa

* **Nigdy nie** zapisuj klucza API bezpośrednio w pliku Workflow
* Zawsze używaj sekretów GitHub (np. `${{ secrets.ANTHROPIC_API_KEY }}`)
* Ogranicz uprawnienia akcji do minimalnego niezbędnego zakresu
* Przeprowadzaj ręczną recenzję sugestii Claude przed scaleniem

### Kontrola kosztów

* Używaj wyraźnych instrukcji `@claude`, aby zredukować niepotrzebne wywołania API
* Ustaw rozsądne ograniczenia `--max-turns` dla liczby tur rozmowy
* Ustaw limit czasu na poziomie Workflow
* Użyj kontroli współbieżności GitHub, aby ograniczyć liczbę równoległych uruchomień

## Często zadawane pytania

### Claude nie odpowiada na polecenie @claude?

1. Upewnij się, że aplikacja Claude GitHub została poprawnie zainstalowana
2. Sprawdź, czy Workflow jest włączony
3. Upewnij się, że klucz API został ustawiony jako sekret repozytorium
4. Upewnij się, że w komentarzu używasz `@claude` (nie `/claude`)

### Błąd uwierzytelnienia?

1. Potwierdź, że klucz API jest ważny i ma wystarczające uprawnienia
2. Sprawdź, czy nazwa sekretu jest poprawna (`ANTHROPIC_API_KEY`)
3. Jeśli używasz `ANTHROPIC_BASE_URL`, upewnij się, że URL jest poprawny

### Jak sprawdzić pozostały limit?

Zaloguj się do [konsoli AceData Cloud](https://platform.acedata.cloud/console), aby zobaczyć aktualny limit i wykorzystanie konta.

## Dowiedz się więcej

* 📖 [Oficjalna dokumentacja Claude Code GitHub Actions](https://code.claude.com/docs/en/github-actions)
* 📂 [Repozytorium claude-code-action](https://github.com/anthropics/claude-code-action)
* 📋 [Przykład Workflow](https://github.com/anthropics/claude-code-action/tree/main/examples)
* 🔧 [Usługa Claude Code w AceData Cloud](https://platform.acedata.cloud/documents/claude-messages)
* 💬 W przypadku jakichkolwiek pytań, zapraszamy do kontaktu z naszym wsparciem na platformie