Claude Code GitHub Actions użycie przewodnik

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 i kliknij przycisk „Acquire”, aby uzyskać potrzebne poświadczenia:

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 i zainstaluj aplikację Claude GitHub w swoim repozytorium. Strona instalacji aplikacji GitHub Claude

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:

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

Wskazówka: Token API można zobaczyć w konsoli AceData Cloud.

Krok 3: Utwórz plik Workflow

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

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:

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:

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:

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

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?

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

Błąd uwierzytelnienia?

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

Jak sprawdzić pozostały limit?

Zaloguj się do konsoli AceData Cloud, aby zobaczyć aktualny limit i wykorzystanie konta.

Dowiedz się więcej

📖 Oficjalna dokumentacja Claude Code GitHub Actions
📂 Repozytorium claude-code-action
📋 Przykład Workflow
🔧 Usługa Claude Code w AceData Cloud
💬 W przypadku jakichkolwiek pytań, zapraszamy do kontaktu z naszym wsparciem na platformie

​Proces aplikacji

​Cechy funkcjonalne

​Kroki konfiguracyjne

​Krok 1: Zainstaluj aplikację Claude GitHub

​Krok 2: Dodaj klucz API

​Krok 3: Utwórz plik Workflow

​Sposób użycia

​Użycie w komentarzach Issue lub PR

​Automatyczna recenzja kodu

​Automatyzacja zadań cyklicznych

​Opis parametrów akcji

​Często używane parametry claude_args

​Najlepsze praktyki

​Konfiguracja CLAUDE.md

​Uwagi dotyczące bezpieczeństwa

​Kontrola kosztów

​Często zadawane pytania

​Claude nie odpowiada na polecenie @claude?

​Błąd uwierzytelnienia?

​Jak sprawdzić pozostały limit?

​Dowiedz się więcej