Claude Code GitHub Actions bringt KI-gestützte Automatisierung in Ihren GitHub-Workflow. Mit einer einfachen @claude-Erwähnung in jedem PR oder Issue kann Claude Ihren Code analysieren, Pull Requests erstellen, Features implementieren und Bugs beheben - alles unter Einhaltung der Standards Ihres Projekts.

Claude Code GitHub Actions basiert auf dem Claude Code SDK, das die programmatische Integration von Claude Code in Ihre Anwendungen ermöglicht. Sie können das SDK verwenden, um benutzerdefinierte Automatisierungs-Workflows über GitHub Actions hinaus zu erstellen.

Warum Claude Code GitHub Actions verwenden?

  • Sofortige PR-Erstellung: Beschreiben Sie, was Sie benötigen, und Claude erstellt einen vollständigen PR mit allen notwendigen Änderungen
  • Automatisierte Code-Implementierung: Verwandeln Sie Issues mit einem einzigen Befehl in funktionierenden Code
  • Folgt Ihren Standards: Claude respektiert Ihre CLAUDE.md-Richtlinien und bestehende Code-Muster
  • Einfache Einrichtung: Starten Sie in wenigen Minuten mit unserem Installer und API-Schlüssel
  • Standardmäßig sicher: Ihr Code bleibt auf Githubs Runnern

Was kann Claude tun?

Claude Code bietet eine leistungsstarke GitHub Action, die Ihre Arbeitsweise mit Code transformiert:

Claude Code Action

Diese GitHub Action ermöglicht es Ihnen, Claude Code innerhalb Ihrer GitHub Actions-Workflows auszuführen. Sie können dies verwenden, um jeden benutzerdefinierten Workflow auf Basis von Claude Code zu erstellen.

Repository anzeigen →

Einrichtung

Schnelle Einrichtung

Der einfachste Weg, diese Action einzurichten, ist über Claude Code im Terminal. Öffnen Sie einfach claude und führen Sie /install-github-app aus.

Dieser Befehl führt Sie durch die Einrichtung der GitHub-App und der erforderlichen Secrets.

  • Sie müssen ein Repository-Administrator sein, um die GitHub-App zu installieren und Secrets hinzuzufügen - Diese Schnellstart-Methode ist nur für direkte Anthropic API-Benutzer verfügbar. Wenn Sie AWS Bedrock oder Google Vertex AI verwenden, lesen Sie bitte den Abschnitt Verwendung mit AWS Bedrock & Google Vertex AI.

Manuelle Einrichtung

Wenn der /install-github-app-Befehl fehlschlägt oder Sie die manuelle Einrichtung bevorzugen, folgen Sie bitte diesen manuellen Einrichtungsanweisungen:

  1. Installieren Sie die Claude GitHub-App in Ihrem Repository: https://github.com/apps/claude
  2. Fügen Sie ANTHROPIC_API_KEY zu Ihren Repository-Secrets hinzu (Erfahren Sie, wie Sie Secrets in GitHub Actions verwenden)
  3. Kopieren Sie die Workflow-Datei von examples/claude.yml in das .github/workflows/-Verzeichnis Ihres Repositories

Nach Abschluss der Schnellstart- oder manuellen Einrichtung testen Sie die Action, indem Sie @claude in einem Issue oder PR-Kommentar markieren!

Upgrade von Beta

Claude Code GitHub Actions v1.0 führt Breaking Changes ein, die eine Aktualisierung Ihrer Workflow-Dateien erfordern, um von der Beta-Version auf v1.0 zu aktualisieren.

Wenn Sie derzeit die Beta-Version von Claude Code GitHub Actions verwenden, empfehlen wir, dass Sie Ihre Workflows aktualisieren, um die GA-Version zu verwenden. Die neue Version vereinfacht die Konfiguration und fügt gleichzeitig leistungsstarke neue Features wie automatische Modus-Erkennung hinzu.

Wesentliche Änderungen

Alle Beta-Benutzer müssen diese Änderungen an ihren Workflow-Dateien vornehmen, um zu aktualisieren:

  1. Aktualisieren Sie die Action-Version: Ändern Sie @beta zu @v1
  2. Entfernen Sie die Modus-Konfiguration: Löschen Sie mode: "tag" oder mode: "agent" (wird jetzt automatisch erkannt)
  3. Aktualisieren Sie Prompt-Eingaben: Ersetzen Sie direct_prompt durch prompt
  4. Verschieben Sie CLI-Optionen: Konvertieren Sie max_turns, model, custom_instructions, etc. zu claude_args

Breaking Changes Referenz

Alte Beta-EingabeNeue v1.0-Eingabe
mode(Entfernt - automatisch erkannt)
direct_promptprompt
override_promptprompt mit GitHub-Variablen
custom_instructionsclaude_args: --system-prompt
max_turnsclaude_args: --max-turns
modelclaude_args: --model
allowed_toolsclaude_args: --allowedTools
disallowed_toolsclaude_args: --disallowedTools
claude_envsettings JSON-Format

Vorher und Nachher Beispiel

Beta-Version:

- uses: anthropics/claude-code-action@beta
  with:
    mode: "tag"
    direct_prompt: "Überprüfen Sie diesen PR auf Sicherheitsprobleme"
    anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
    custom_instructions: "Folgen Sie unseren Coding-Standards"
    max_turns: "10"
    model: "claude-3-5-sonnet-20241022"

GA-Version (v1.0):

- uses: anthropics/claude-code-action@v1
  with:
    prompt: "Überprüfen Sie diesen PR auf Sicherheitsprobleme"
    anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
    claude_args: |
      --system-prompt "Folgen Sie unseren Coding-Standards"
      --max-turns 10
      --model claude-sonnet-4-20250514

Die Action erkennt jetzt automatisch, ob sie im interaktiven Modus (reagiert auf @claude-Erwähnungen) oder Automatisierungsmodus (läuft sofort mit einem Prompt) ausgeführt werden soll, basierend auf Ihrer Konfiguration.

Beispiel-Anwendungsfälle

Claude Code GitHub Actions kann Ihnen bei einer Vielzahl von Aufgaben helfen. Das examples-Verzeichnis enthält gebrauchsfertige Workflows für verschiedene Szenarien.

Basis-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 }}
          # Reagiert auf @claude-Erwähnungen in Kommentaren

Verwendung von Slash-Befehlen

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"

Benutzerdefinierte Automatisierung mit Prompts

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: "Erstelle eine Zusammenfassung der gestrigen Commits und offenen Issues"
          claude_args: "--model claude-opus-4-1-20250805"

Häufige Anwendungsfälle

In Issue- oder PR-Kommentaren:

@claude implementiere dieses Feature basierend auf der Issue-Beschreibung
@claude wie sollte ich Benutzerauthentifizierung für diesen Endpoint implementieren?
@claude behebe den TypeError in der Benutzer-Dashboard-Komponente

Claude wird automatisch den Kontext analysieren und entsprechend antworten.

Best Practices

CLAUDE.md-Konfiguration

Erstellen Sie eine CLAUDE.md-Datei im Root Ihres Repositories, um Code-Style-Richtlinien, Review-Kriterien, projektspezifische Regeln und bevorzugte Muster zu definieren. Diese Datei leitet Claudes Verständnis Ihrer Projektstandards.

Sicherheitsüberlegungen

Committen Sie niemals API-Schlüssel direkt in Ihr Repository!

Verwenden Sie immer GitHub Secrets für API-Schlüssel:

  • Fügen Sie Ihren API-Schlüssel als Repository-Secret namens ANTHROPIC_API_KEY hinzu
  • Referenzieren Sie ihn in Workflows: anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
  • Beschränken Sie Action-Berechtigungen auf nur das Notwendige
  • Überprüfen Sie Claudes Vorschläge vor dem Mergen

Verwenden Sie immer GitHub Secrets (z.B. ${{ secrets.ANTHROPIC_API_KEY }}) anstatt API-Schlüssel direkt in Ihre Workflow-Dateien zu hardcoden.

Performance-Optimierung

Verwenden Sie Issue-Templates, um Kontext bereitzustellen, halten Sie Ihre CLAUDE.md prägnant und fokussiert, und konfigurieren Sie angemessene Timeouts für Ihre Workflows.

CI-Kosten

Bei der Verwendung von Claude Code GitHub Actions sollten Sie sich der damit verbundenen Kosten bewusst sein:

GitHub Actions-Kosten:

  • Claude Code läuft auf GitHub-gehosteten Runnern, die Ihre GitHub Actions-Minuten verbrauchen
  • Siehe GitHubs Abrechnungsdokumentation für detaillierte Preise und Minutenlimits

API-Kosten:

  • Jede Claude-Interaktion verbraucht API-Token basierend auf der Länge von Prompts und Antworten
  • Token-Verbrauch variiert je nach Aufgabenkomplexität und Codebase-Größe
  • Siehe Claudes Preisseite für aktuelle Token-Raten

Kostenoptimierungs-Tipps:

  • Verwenden Sie spezifische @claude-Befehle, um unnötige API-Aufrufe zu reduzieren
  • Konfigurieren Sie angemessene --max-turns in claude_args, um übermäßige Iterationen zu verhindern
  • Setzen Sie Workflow-Level-Timeouts, um entlaufende Jobs zu vermeiden
  • Erwägen Sie die Verwendung von GitHubs Concurrency-Kontrollen, um parallele Läufe zu begrenzen

Konfigurationsbeispiele

Die Claude Code Action v1 vereinfacht die Konfiguration mit einheitlichen Parametern:

- uses: anthropics/claude-code-action@v1
  with:
    anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
    prompt: "Ihre Anweisungen hier" # Optional
    claude_args: "--max-turns 5" # Optionale CLI-Argumente

Hauptmerkmale:

  • Einheitliche Prompt-Schnittstelle - Verwenden Sie prompt für alle Anweisungen
  • Slash-Befehle - Vorgefertigte Prompts wie /review oder /fix
  • CLI-Durchleitung - Jedes Claude Code CLI-Argument über claude_args
  • Flexible Trigger - Funktioniert mit jedem GitHub-Event

Besuchen Sie das examples-Verzeichnis für vollständige Workflow-Dateien.

Bei der Antwort auf Issue- oder PR-Kommentare reagiert Claude automatisch auf @claude-Erwähnungen. Für andere Events verwenden Sie den prompt-Parameter, um Anweisungen bereitzustellen.

Verwendung mit AWS Bedrock & Google Vertex AI

Für Unternehmensumgebungen können Sie Claude Code GitHub Actions mit Ihrer eigenen Cloud-Infrastruktur verwenden. Dieser Ansatz gibt Ihnen Kontrolle über Datenresidenz und Abrechnung bei Beibehaltung derselben Funktionalität.

Voraussetzungen

Bevor Sie Claude Code GitHub Actions mit Cloud-Anbietern einrichten, benötigen Sie:

Für Google Cloud Vertex AI:

  1. Ein Google Cloud-Projekt mit aktivierter Vertex AI
  2. Workload Identity Federation konfiguriert für GitHub Actions
  3. Ein Service Account mit den erforderlichen Berechtigungen
  4. Eine GitHub App (empfohlen) oder verwenden Sie das Standard-GITHUB_TOKEN

Für AWS Bedrock:

  1. Ein AWS-Konto mit aktiviertem Amazon Bedrock
  2. GitHub OIDC Identity Provider konfiguriert in AWS
  3. Eine IAM-Rolle mit Bedrock-Berechtigungen
  4. Eine GitHub App (empfohlen) oder verwenden Sie das Standard-GITHUB_TOKEN
1

Erstellen Sie eine benutzerdefinierte GitHub App (Empfohlen für 3P-Anbieter)

Für beste Kontrolle und Sicherheit bei der Verwendung von 3P-Anbietern wie Vertex AI oder Bedrock empfehlen wir, Ihre eigene GitHub App zu erstellen:

  1. Gehen Sie zu https://github.com/settings/apps/new
  2. Füllen Sie die grundlegenden Informationen aus:
    • GitHub App-Name: Wählen Sie einen eindeutigen Namen (z.B. “YourOrg Claude Assistant”)
    • Homepage-URL: Die Website Ihrer Organisation oder die Repository-URL
  3. Konfigurieren Sie die App-Einstellungen:
    • Webhooks: Deaktivieren Sie “Active” (nicht für diese Integration benötigt)
  4. Setzen Sie die erforderlichen Berechtigungen:
    • Repository-Berechtigungen:
      • Contents: Read & Write
      • Issues: Read & Write
      • Pull requests: Read & Write
  5. Klicken Sie auf “Create GitHub App”
  6. Nach der Erstellung klicken Sie auf “Generate a private key” und speichern Sie die heruntergeladene .pem-Datei
  7. Notieren Sie Ihre App-ID von der App-Einstellungsseite
  8. Installieren Sie die App in Ihrem Repository:
    • Von der Einstellungsseite Ihrer App klicken Sie auf “Install App” in der linken Seitenleiste
    • Wählen Sie Ihr Konto oder Ihre Organisation
    • Wählen Sie “Only select repositories” und wählen Sie das spezifische Repository
    • Klicken Sie auf “Install”
  9. Fügen Sie den privaten Schlüssel als Secret zu Ihrem Repository hinzu:
    • Gehen Sie zu den Einstellungen Ihres Repositories → Secrets and variables → Actions
    • Erstellen Sie ein neues Secret namens APP_PRIVATE_KEY mit dem Inhalt der .pem-Datei
  10. Fügen Sie die App-ID als Secret hinzu:
  • Erstellen Sie ein neues Secret namens APP_ID mit der ID Ihrer GitHub App

Diese App wird mit der actions/create-github-app-token Action verwendet, um Authentifizierungs-Token in Ihren Workflows zu generieren.

Alternative für Anthropic API oder wenn Sie keine eigene Github App einrichten möchten: Verwenden Sie die offizielle Anthropic App:

  1. Installieren Sie von: https://github.com/apps/claude
  2. Keine zusätzliche Konfiguration für Authentifizierung erforderlich
2

Konfigurieren Sie die Cloud-Anbieter-Authentifizierung

Wählen Sie Ihren Cloud-Anbieter und richten Sie sichere Authentifizierung ein:

3

Erforderliche Secrets hinzufügen

Fügen Sie die folgenden Secrets zu Ihrem Repository hinzu (Settings → Secrets and variables → Actions):

Für Anthropic API (Direkt):

  1. Für API-Authentifizierung:

  2. Für GitHub App (wenn Sie Ihre eigene App verwenden):

    • APP_ID: Die ID Ihrer GitHub App
    • APP_PRIVATE_KEY: Der Inhalt des privaten Schlüssels (.pem)

Für Google Cloud Vertex AI

  1. Für GCP-Authentifizierung:

    • GCP_WORKLOAD_IDENTITY_PROVIDER
    • GCP_SERVICE_ACCOUNT
  2. Für GitHub App (wenn Sie Ihre eigene App verwenden):

    • APP_ID: Die ID Ihrer GitHub App
    • APP_PRIVATE_KEY: Der Inhalt des privaten Schlüssels (.pem)

Für AWS Bedrock

  1. Für AWS-Authentifizierung:

    • AWS_ROLE_TO_ASSUME
  2. Für GitHub App (wenn Sie Ihre eigene App verwenden):

    • APP_ID: Die ID Ihrer GitHub App
    • APP_PRIVATE_KEY: Der Inhalt des privaten Schlüssels (.pem)
4

Workflow-Dateien erstellen

Erstellen Sie GitHub Actions-Workflow-Dateien, die sich mit Ihrem Cloud-Anbieter integrieren. Die folgenden Beispiele zeigen vollständige Konfigurationen für sowohl AWS Bedrock als auch Google Vertex AI:

Fehlerbehebung

Claude reagiert nicht auf @claude-Befehle

Überprüfen Sie, ob die GitHub App korrekt installiert ist, prüfen Sie, ob Workflows aktiviert sind, stellen Sie sicher, dass der API-Schlüssel in Repository-Secrets gesetzt ist, und bestätigen Sie, dass der Kommentar @claude enthält (nicht /claude).

CI läuft nicht bei Claudes Commits

Stellen Sie sicher, dass Sie die GitHub App oder benutzerdefinierte App verwenden (nicht Actions-Benutzer), prüfen Sie, ob Workflow-Trigger die notwendigen Events enthalten, und überprüfen Sie, ob App-Berechtigungen CI-Trigger einschließen.

Authentifizierungsfehler

Bestätigen Sie, dass der API-Schlüssel gültig ist und ausreichende Berechtigungen hat. Für Bedrock/Vertex prüfen Sie die Anmeldedaten-Konfiguration und stellen Sie sicher, dass Secrets in Workflows korrekt benannt sind.

Erweiterte Konfiguration

Action-Parameter

Die Claude Code Action v1 verwendet eine vereinfachte Konfiguration:

ParameterBeschreibungErforderlich
promptAnweisungen für Claude (Text oder Slash-Befehl)Nein*
claude_argsCLI-Argumente, die an Claude Code weitergegeben werdenNein
anthropic_api_keyAnthropic API-SchlüsselJa**
github_tokenGitHub-Token für API-ZugangNein
trigger_phraseBenutzerdefinierte Trigger-Phrase (Standard: “@claude”)Nein
use_bedrockAWS Bedrock anstelle der Anthropic API verwendenNein
use_vertexGoogle Vertex AI anstelle der Anthropic API verwendenNein

*Prompt ist optional - wenn für Issue/PR-Kommentare weggelassen, reagiert Claude auf Trigger-Phrase
**Erforderlich für direkte Anthropic API, nicht für Bedrock/Vertex

Verwendung von claude_args

Der claude_args-Parameter akzeptiert beliebige Claude Code CLI-Argumente:

claude_args: "--max-turns 5 --model claude-sonnet-4-20250514 --mcp-config /path/to/config.json"

Häufige Argumente:

  • --max-turns: Maximale Gesprächsrunden (Standard: 10)
  • --model: Zu verwendendes Modell (z.B. claude-sonnet-4-20250514)
  • --mcp-config: Pfad zur MCP-Konfiguration
  • --allowed-tools: Kommagetrennte Liste erlaubter Tools
  • --debug: Debug-Ausgabe aktivieren

Alternative Integrationsmethoden

Während der /install-github-app-Befehl der empfohlene Ansatz ist, können Sie auch:

  • Benutzerdefinierte GitHub App: Für Organisationen, die gebrandete Benutzernamen oder benutzerdefinierte Authentifizierungs-Flows benötigen. Erstellen Sie Ihre eigene GitHub App mit erforderlichen Berechtigungen (contents, issues, pull requests) und verwenden Sie die actions/create-github-app-token Action, um Token in Ihren Workflows zu generieren.
  • Manuelle GitHub Actions: Direkte Workflow-Konfiguration für maximale Flexibilität
  • MCP-Konfiguration: Dynamisches Laden von Model Context Protocol-Servern

Siehe das Claude Code Action Repository für detaillierte Dokumentation.

Anpassung von Claudes Verhalten

Sie können Claudes Verhalten auf zwei Arten konfigurieren:

  1. CLAUDE.md: Definieren Sie Coding-Standards, Review-Kriterien und projektspezifische Regeln in einer CLAUDE.md-Datei im Root Ihres Repositories. Claude wird diese Richtlinien befolgen, wenn er PRs erstellt und auf Anfragen antwortet. Schauen Sie sich unsere Memory-Dokumentation für weitere Details an.
  2. Benutzerdefinierte Prompts: Verwenden Sie den prompt-Parameter in der Workflow-Datei, um workflow-spezifische Anweisungen bereitzustellen. Dies ermöglicht es Ihnen, Claudes Verhalten für verschiedene Workflows oder Aufgaben anzupassen.

Claude wird diese Richtlinien befolgen, wenn er PRs erstellt und auf Anfragen antwortet.