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, Funktionen implementieren und Fehler beheben - und dabei stets die Standards Ihres Projekts einhalten.

Claude Code GitHub Actions befindet sich derzeit in der Beta-Phase. Funktionen und Funktionalität können sich weiterentwickeln, während wir die Erfahrung verfeinern.

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
  • Befolgt Ihre 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 den Runnern von Github

Was kann Claude tun?

Claude Code bietet leistungsstarke GitHub Actions, die Ihre Arbeitsweise mit Code transformieren:

Claude Code Action

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

Repository ansehen →

Claude Code Action (Base)

Die Grundlage für den Aufbau benutzerdefinierter GitHub-Workflows mit Claude. Dieses erweiterbare Framework gibt Ihnen vollen Zugriff auf Claudes Fähigkeiten zur Erstellung maßgeschneiderter Automatisierung.

Repository ansehen →

Schnellstart

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 Schnellstartmethode ist nur für direkte Anthropic API-Nutzer verfügbar. Wenn Sie AWS Bedrock oder Google Vertex AI verwenden, lesen Sie bitte den Abschnitt Verwendung mit AWS Bedrock & Google Vertex AI.

Wenn das Setup-Skript fehlschlägt

Wenn der Befehl /install-github-app fehlschlägt oder Sie eine 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 aus examples/claude.yml in das .github/workflows/-Verzeichnis Ihres Repositories
1

Testen Sie die Action

Nachdem Sie entweder den Schnellstart oder die manuelle Einrichtung abgeschlossen haben, testen Sie die Action, indem Sie @claude in einem Issue- oder PR-Kommentar erwähnen!

Beispielanwendungsfälle

Claude Code GitHub Actions kann Ihnen bei verschiedenen Aufgaben helfen. Vollständige Arbeitsbeispiele finden Sie im examples-Verzeichnis.

Issues in PRs umwandeln

# In an issue comment:
@claude implement this feature based on the issue description

Claude analysiert das Issue, schreibt den Code und erstellt einen PR zur Überprüfung.

Implementierungshilfe erhalten

# In a PR comment:
@claude how should I implement user authentication for this endpoint?

Claude analysiert Ihren Code und gibt Ihnen spezifische Implementierungshinweise.

Fehler schnell beheben

# In an issue:
@claude fix the TypeError in the user dashboard component

Claude lokalisiert den Fehler, implementiert eine Lösung und erstellt einen PR.

Best Practices

CLAUDE.md-Konfiguration

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

Sicherheitsüberlegungen

⚠️ WICHTIG: 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 mit dem Namen ANTHROPIC_API_KEY hinzu
  • Referenzieren Sie ihn in Workflows: anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
  • Beschränken Sie Action-Berechtigungen auf das Notwendige
  • Überprüfen Sie Claudes Vorschläge vor dem Zusammenführen

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

Leistungsoptimierung

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

CI-Kosten

Bei der Verwendung von Claude Code GitHub Actions sollten Sie die damit verbundenen Kosten beachten:

GitHub Actions-Kosten:

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

API-Kosten:

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

Tipps zur Kostenoptimierung:

  • Verwenden Sie spezifische @claude-Befehle, um unnötige API-Aufrufe zu reduzieren
  • Konfigurieren Sie angemessene max_turns-Limits, um übermäßige Iterationen zu verhindern
  • Setzen Sie vernünftige timeout_minutes, um unkontrollierte Workflows zu vermeiden
  • Erwägen Sie die Verwendung von GitHubs Concurrency-Kontrollen, um parallele Ausführungen zu begrenzen

Konfigurationsbeispiele

Für einsatzbereite Workflow-Konfigurationen für verschiedene Anwendungsfälle, einschließlich:

  • Grundlegende Workflow-Einrichtung für Issue- und PR-Kommentare
  • Automatisierte Code-Reviews bei Pull Requests
  • Benutzerdefinierte Implementierungen für spezifische Bedürfnisse

Besuchen Sie das examples-Verzeichnis im Claude Code Action Repository.

Das Examples-Repository enthält vollständige, getestete Workflows, die Sie direkt in Ihr .github/workflows/-Verzeichnis kopieren können.

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 gleichbleibender 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 aktiviertem Vertex AI
  2. Workload Identity Federation konfiguriert für GitHub Actions
  3. Ein Dienstkonto mit den erforderlichen Berechtigungen
  4. Eine GitHub App (empfohlen) oder Verwendung des 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 Verwendung des 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 erforderlich für diese Integration)
  4. Legen Sie die erforderlichen Berechtigungen fest:
    • Repository-Berechtigungen:
      • Contents: Lesen & Schreiben
      • Issues: Lesen & Schreiben
      • Pull requests: Lesen & Schreiben
  5. Klicken Sie auf “GitHub App erstellen”
  6. Nach der Erstellung klicken Sie auf “Privaten Schlüssel generieren” 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 “App installieren” in der linken Seitenleiste
    • Wählen Sie Ihr Konto oder Ihre Organisation
    • Wählen Sie “Nur ausgewählte Repositories” und wählen Sie das spezifische Repository
    • Klicken Sie auf “Installieren”
  9. Fügen Sie den privaten Schlüssel als Secret zu Ihrem Repository hinzu:
    • Gehen Sie zu den Einstellungen Ihres Repositories → Secrets und Variablen → Actions
    • Erstellen Sie ein neues Secret mit dem Namen APP_PRIVATE_KEY mit dem Inhalt der .pem-Datei
  10. Fügen Sie die App-ID als Secret hinzu:
  • Erstellen Sie ein neues Secret mit dem Namen APP_ID mit der ID Ihrer GitHub App

Diese App wird mit der actions/create-github-app-token Action verwendet, um Authentifizierungs-Tokens 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. Installation von: https://github.com/apps/claude
  2. Keine zusätzliche Konfiguration für die Authentifizierung erforderlich
2

Cloud-Anbieter-Authentifizierung konfigurieren

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

3

Erforderliche Secrets hinzufügen

Fügen Sie die folgenden Secrets zu Ihrem Repository hinzu (Einstellungen → Secrets und Variablen → 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, stellen Sie sicher, dass Workflows aktiviert sind, vergewissern Sie sich, dass der API-Schlüssel in den Repository-Secrets gesetzt ist, und bestätigen Sie, dass der Kommentar @claude (nicht /claude) enthält.

CI läuft nicht bei Claudes Commits

Stellen Sie sicher, dass Sie die GitHub-App oder eine benutzerdefinierte App verwenden (nicht Actions-Benutzer), überprüfen Sie, ob Workflow-Trigger die notwendigen Ereignisse enthalten, und verifizieren Sie, dass 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 überprüfen Sie die Konfiguration der Anmeldeinformationen und stellen Sie sicher, dass Secrets in Workflows korrekt benannt sind.

Erweiterte Konfiguration

Action-Parameter

Die Claude Code Action unterstützt diese Schlüsselparameter:

ParameterBeschreibungErforderlich
promptDer an Claude zu sendende PromptJa*
prompt_filePfad zur Datei mit dem PromptJa*
anthropic_api_keyAnthropic API-SchlüsselJa**
max_turnsMaximale GesprächsrundenNein
timeout_minutesAusführungs-TimeoutNein

*Entweder prompt oder prompt_file erforderlich
**Erforderlich für direkte Anthropic API, nicht für Bedrock/Vertex

Alternative Integrationsmethoden

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

  • Benutzerdefinierte GitHub-App: Für Organisationen, die gebrandete Benutzernamen oder benutzerdefinierte Authentifizierungsabläufe 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 Tokens 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.

Anpassen 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 Stammverzeichnis 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.