Claude Code GitHub Actions

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 Ihrer Projektstandards.

Claude Code GitHub Actions befindet sich derzeit in der Beta-Phase. Features 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
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 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 verwenden, um jeden benutzerdefinierten Workflow auf Basis von Claude Code zu erstellen.

Repository anzeigen →

Claude Code Action (Base)

Die Grundlage für die Erstellung benutzerdefinierter GitHub-Workflows mit Claude. Dieses erweiterbare Framework gibt Ihnen vollen Zugang zu Claudes Fähigkeiten für die Erstellung maßgeschneiderter Automatisierung.

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, befolgen Sie bitte diese manuellen Einrichtungsanweisungen:

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

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

Beispiel-Anwendungsfälle

Claude Code GitHub Actions kann Ihnen bei einer Vielzahl von Aufgaben helfen. Für vollständige funktionierende Beispiele siehe das examples-Verzeichnis.

Issues in PRs verwandeln

In einem Issue-Kommentar:

@claude implementiere dieses Feature basierend auf der Issue-Beschreibung

Claude wird das Issue analysieren, den Code schreiben und einen PR zur Überprüfung erstellen.

Implementierungshilfe erhalten

In einem PR-Kommentar:

@claude wie sollte ich die Benutzerauthentifizierung für diesen Endpoint implementieren?

Claude wird Ihren Code analysieren und spezifische Implementierungsanleitungen bereitstellen.

Bugs schnell beheben

In einem Issue:

@claude behebe den TypeError in der Benutzer-Dashboard-Komponente

Claude wird den Bug lokalisieren, eine Lösung implementieren und einen PR erstellen.

Best Practices

CLAUDE.md-Konfiguration

Erstellen Sie eine CLAUDE.md-Datei im Stammverzeichnis Ihres Repositorys, um Code-Stil-Richtlinien, Überprüfungskriterien, 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 Ihren Workflow-Dateien zu hardcodieren.

Leistungsoptimierung

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

Kostenoptimierungstipps:

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 entlaufende Workflows zu vermeiden
Erwägen Sie die Verwendung von GitHubs Concurrency-Kontrollen, um parallele Läufe zu begrenzen

Konfigurationsbeispiele

Für gebrauchsfertige 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 Beibehaltung derselben Funktionalität.

Voraussetzungen

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

Für Google Cloud Vertex AI:

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

Für AWS Bedrock:

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

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 die Erstellung Ihrer eigenen GitHub-App:

Gehen Sie zu https://github.com/settings/apps/new
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
Konfigurieren Sie die App-Einstellungen:
- Webhooks: Deaktivieren Sie “Active” (nicht für diese Integration benötigt)
Setzen Sie die erforderlichen Berechtigungen:
- Repository-Berechtigungen:
  - Contents: Read & Write
  - Issues: Read & Write
  - Pull requests: Read & Write
Klicken Sie auf “Create GitHub App”
Nach der Erstellung klicken Sie auf “Generate a private key” und speichern Sie die heruntergeladene .pem-Datei
Notieren Sie sich Ihre App-ID von der App-Einstellungsseite
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”
Fügen Sie den privaten Schlüssel als Secret zu Ihrem Repository hinzu:
- Gehen Sie zu den Einstellungen Ihres Repositorys → Secrets and variables → Actions
- Erstellen Sie ein neues Secret namens APP_PRIVATE_KEY mit dem Inhalt der .pem-Datei
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:

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

Konfigurieren Sie die Cloud-Anbieter-Authentifizierung

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

AWS Bedrock

Google Vertex AI

Erforderliche Secrets hinzufügen

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

Für Anthropic API (Direkt):

Für API-Authentifizierung:
- ANTHROPIC_API_KEY: Ihr Anthropic API-Schlüssel von console.anthropic.com
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

Für GCP-Authentifizierung:
- GCP_WORKLOAD_IDENTITY_PROVIDER
- GCP_SERVICE_ACCOUNT
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

Für AWS-Authentifizierung:
- AWS_ROLE_TO_ASSUME
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)

Workflow-Dateien erstellen

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

AWS Bedrock-Workflow

Voraussetzungen:

AWS Bedrock-Zugang aktiviert mit Claude-Modell-Berechtigungen
GitHub als OIDC-Identity-Provider in AWS konfiguriert
IAM-Rolle mit Bedrock-Berechtigungen, die GitHub Actions vertraut

Erforderliche GitHub-Secrets:

Secret-Name	Beschreibung
`AWS_ROLE_TO_ASSUME`	ARN der IAM-Rolle für Bedrock-Zugang
`APP_ID`	Ihre GitHub-App-ID (aus den App-Einstellungen)
`APP_PRIVATE_KEY`	Der private Schlüssel, den Sie für Ihre GitHub-App generiert haben

name: Claude PR Action 

permissions:
  contents: write
  pull-requests: write
  issues: write
  id-token: write 

on:
  issue_comment:
    types: [created]
  pull_request_review_comment:
    types: [created]
  issues:
    types: [opened, assigned]

jobs:
  claude-pr:
    if: |
      (github.event_name == 'issue_comment' && contains(github.event.comment.body, '@claude')) ||
      (github.event_name == 'pull_request_review_comment' && contains(github.event.comment.body, '@claude')) ||
      (github.event_name == 'issues' && contains(github.event.issue.body, '@claude'))
    runs-on: ubuntu-latest
    env:
      AWS_REGION: us-west-2
    steps:
      - name: Checkout repository
        uses: actions/checkout@v4

      - name: Generate GitHub App token
        id: app-token
        uses: actions/create-github-app-token@v2
        with:
          app-id: ${{ secrets.APP_ID }}
          private-key: ${{ secrets.APP_PRIVATE_KEY }}

      - name: Configure AWS Credentials (OIDC)
        uses: aws-actions/configure-aws-credentials@v4
        with:
          role-to-assume: ${{ secrets.AWS_ROLE_TO_ASSUME }}
          aws-region: us-west-2

      - uses: ./.github/actions/claude-pr-action
        with:
          trigger_phrase: "@claude"
          timeout_minutes: "60"
          github_token: ${{ steps.app-token.outputs.token }}
          use_bedrock: "true"
          model: "us.anthropic.claude-3-7-sonnet-20250219-v1:0"

Das Modell-ID-Format für Bedrock enthält das Regionspräfix (z.B. us.anthropic.claude...) und Versionssuffix.

Google Vertex AI-Workflow

Voraussetzungen:

Vertex AI API in Ihrem GCP-Projekt aktiviert
Workload Identity Federation für GitHub konfiguriert
Service-Account mit Vertex AI-Berechtigungen

Erforderliche GitHub-Secrets:

Secret-Name	Beschreibung
`GCP_WORKLOAD_IDENTITY_PROVIDER`	Work-Identity-Provider-Ressourcenname
`GCP_SERVICE_ACCOUNT`	Service-Account-E-Mail mit Vertex AI-Zugang
`APP_ID`	Ihre GitHub-App-ID (aus den App-Einstellungen)
`APP_PRIVATE_KEY`	Der private Schlüssel, den Sie für Ihre GitHub-App generiert haben

name: Claude PR Action

permissions:
  contents: write
  pull-requests: write
  issues: write
  id-token: write  

on:
  issue_comment:
    types: [created]
  pull_request_review_comment:
    types: [created]
  issues:
    types: [opened, assigned]

jobs:
  claude-pr:
    if: |
      (github.event_name == 'issue_comment' && contains(github.event.comment.body, '@claude')) ||
      (github.event_name == 'pull_request_review_comment' && contains(github.event.comment.body, '@claude')) ||
      (github.event_name == 'issues' && contains(github.event.issue.body, '@claude'))
    runs-on: ubuntu-latest
    steps:
      - name: Checkout repository
        uses: actions/checkout@v4

      - name: Generate GitHub App token
        id: app-token
        uses: actions/create-github-app-token@v2
        with:
          app-id: ${{ secrets.APP_ID }}
          private-key: ${{ secrets.APP_PRIVATE_KEY }}

      - name: Authenticate to Google Cloud
        id: auth
        uses: google-github-actions/auth@v2
        with:
          workload_identity_provider: ${{ secrets.GCP_WORKLOAD_IDENTITY_PROVIDER }}
          service_account: ${{ secrets.GCP_SERVICE_ACCOUNT }}
      
      - uses: ./.github/actions/claude-pr-action
        with:
          trigger_phrase: "@claude"
          timeout_minutes: "60"
          github_token: ${{ steps.app-token.outputs.token }}
          use_vertex: "true"
          model: "claude-3-7-sonnet@20250219"
        env:
          ANTHROPIC_VERTEX_PROJECT_ID: ${{ steps.auth.outputs.project_id }}
          CLOUD_ML_REGION: us-east5
          VERTEX_REGION_CLAUDE_3_7_SONNET: us-east5

Die Projekt-ID wird automatisch aus dem Google Cloud-Authentifizierungsschritt abgerufen, sodass Sie sie nicht hardcodieren müssen.

Fehlerbehebung

Claude antwortet 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 den 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), überprüfen Sie, ob Workflow-Trigger die notwendigen Events 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 Anmeldedaten-Konfiguration und stellen Sie sicher, dass Secrets in Workflows korrekt benannt sind.

Erweiterte Konfiguration

Action-Parameter

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

Parameter	Beschreibung	Erforderlich
`prompt`	Der an Claude zu sendende Prompt	Ja*
`prompt_file`	Pfad zur Datei mit Prompt	Ja*
`anthropic_api_key`	Anthropic API-Schlüssel	Ja**
`max_turns`	Maximale Konversationsrunden	Nein
`timeout_minutes`	Ausführungs-Timeout	Nein

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

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:

CLAUDE.md: Definieren Sie Codierungsstandards, Überprüfungskriterien und projektspezifische Regeln in einer CLAUDE.md-Datei im Stammverzeichnis Ihres Repositorys. Claude wird diese Richtlinien befolgen, wenn er PRs erstellt und auf Anfragen antwortet. Schauen Sie sich unsere Memory-Dokumentation für weitere Details an.
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.

Erste Schritte

Mit Claude entwickeln

Bereitstellung

Verwaltung

Referenz

Ressourcen

Claude Code GitHub Actions

Warum Claude Code GitHub Actions verwenden?

Was kann Claude tun?

Claude Code Action

Claude Code Action (Base)

Einrichtung

Schnelle Einrichtung

Manuelle Einrichtung

Beispiel-Anwendungsfälle

Issues in PRs verwandeln

Implementierungshilfe erhalten

Bugs schnell beheben

Best Practices

CLAUDE.md-Konfiguration

Sicherheitsüberlegungen

Leistungsoptimierung

CI-Kosten

Konfigurationsbeispiele

Verwendung mit AWS Bedrock & Google Vertex AI

Voraussetzungen

Für Google Cloud Vertex AI:

Für AWS Bedrock:

Für Anthropic API (Direkt):

Für Google Cloud Vertex AI

Für AWS Bedrock

Fehlerbehebung

Claude antwortet nicht auf @claude-Befehle

CI läuft nicht bei Claudes Commits

Authentifizierungsfehler

Erweiterte Konfiguration

Action-Parameter

Alternative Integrationsmethoden

Anpassung von Claudes Verhalten

Erste Schritte

Mit Claude entwickeln

Bereitstellung

Verwaltung

Referenz

Ressourcen

​Warum Claude Code GitHub Actions verwenden?

​Was kann Claude tun?

​Claude Code Action

​Claude Code Action (Base)

​Einrichtung

​Schnelle Einrichtung

​Manuelle Einrichtung

​Beispiel-Anwendungsfälle

​Issues in PRs verwandeln

​Implementierungshilfe erhalten

​Bugs schnell beheben

​Best Practices

​CLAUDE.md-Konfiguration

​Sicherheitsüberlegungen

​Leistungsoptimierung

​CI-Kosten

​Konfigurationsbeispiele

​Verwendung mit AWS Bedrock & Google Vertex AI

​Voraussetzungen

​Für Google Cloud Vertex AI:

​Für AWS Bedrock:

​Für Anthropic API (Direkt):

​Für Google Cloud Vertex AI

​Für AWS Bedrock

​Fehlerbehebung

​Claude antwortet nicht auf @claude-Befehle

​CI läuft nicht bei Claudes Commits

​Authentifizierungsfehler

​Erweiterte Konfiguration

​Action-Parameter

​Alternative Integrationsmethoden

​Anpassung von Claudes Verhalten

Warum Claude Code GitHub Actions verwenden?

Was kann Claude tun?

Claude Code Action

Claude Code Action (Base)

Einrichtung

Schnelle Einrichtung

Manuelle Einrichtung

Beispiel-Anwendungsfälle

Issues in PRs verwandeln

Implementierungshilfe erhalten

Bugs schnell beheben

Best Practices

CLAUDE.md-Konfiguration

Sicherheitsüberlegungen

Leistungsoptimierung

CI-Kosten

Konfigurationsbeispiele

Verwendung mit AWS Bedrock & Google Vertex AI

Voraussetzungen

Für Google Cloud Vertex AI:

Für AWS Bedrock:

Für Anthropic API (Direkt):

Für Google Cloud Vertex AI

Für AWS Bedrock

Fehlerbehebung

Claude antwortet nicht auf @claude-Befehle

CI läuft nicht bei Claudes Commits

Authentifizierungsfehler

Erweiterte Konfiguration

Action-Parameter

Alternative Integrationsmethoden

Anpassung von Claudes Verhalten