Claude Code GitHub Actions

Claude Code GitHub Actions bringt KI-gestützte Automatisierung in Ihren GitHub-Workflow. Mit einer einfachen @claude-Erwähnung in einem beliebigen PR oder Issue kann Claude Ihren Code analysieren, Pull Requests erstellen, Features implementieren und Bugs beheben – alles während er die Standards Ihres Projekts befolgt.

Claude Code GitHub Actions basiert auf dem Claude Code SDK, das die programmgesteuerte 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 erforderlichen Änderungen
Automatisierte Code-Implementierung: Verwandeln Sie Issues in funktionierenden Code mit einem einzigen Befehl
Befolgt Ihre Standards: Claude respektiert Ihre CLAUDE.md-Richtlinien und vorhandene Code-Muster
Einfaches Setup: Beginnen Sie in Minuten mit unserem Installer und API-Schlüssel
Sicher von Anfang an: Ihr Code bleibt auf Githubs Runnern

Was kann Claude tun?

Claude Code bietet eine leistungsstarke GitHub Action, die verändert, wie Sie mit Code arbeiten:

Claude Code Action

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

Setup

Schnelles Setup

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 erforderlichen Secrets.

Sie müssen ein Repository-Administrator sein, um die GitHub-App zu installieren und Secrets hinzuzufügen
Die GitHub-App fordert Lese- und Schreibberechtigungen für Contents, Issues und Pull Requests an
Diese Schnellstart-Methode ist nur für direkte Claude 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.

Manuelles Setup

Wenn der Befehl /install-github-app fehlschlägt oder Sie das manuelle Setup bevorzugen, folgen Sie bitte diesen manuellen Setupanweisungen:

Installieren Sie die Claude GitHub-App in Ihrem Repository: https://github.com/apps/claude Die Claude GitHub-App erfordert die folgenden Repository-Berechtigungen:
- Contents: Lesen & Schreiben (zum Ändern von Repository-Dateien)
- Issues: Lesen & Schreiben (zum Antworten auf Issues)
- Pull requests: Lesen & Schreiben (zum Erstellen von PRs und Pushen von Änderungen)
Weitere Details zu Sicherheit und Berechtigungen finden Sie in der Sicherheitsdokumentation.
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 Verzeichnis .github/workflows/ Ihres Repositorys

Nach Abschluss des Schnellstarts oder des manuellen Setups 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 ein Update 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 Ihnen, Ihre Workflows auf die GA-Version zu aktualisieren. Die neue Version vereinfacht die Konfiguration und fügt gleichzeitig leistungsstarke neue Funktionen wie automatische Modusterkennung hinzu.

Wesentliche Änderungen

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

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

Breaking Changes Referenz

Alte Beta-Eingabe	Neue v1.0-Eingabe
`mode`	(Entfernt - automatisch erkannt)
`direct_prompt`	`prompt`
`override_prompt`	`prompt` mit GitHub-Variablen
`custom_instructions`	`claude_args: --system-prompt`
`max_turns`	`claude_args: --max-turns`
`model`	`claude_args: --model`
`allowed_tools`	`claude_args: --allowedTools`
`disallowed_tools`	`claude_args: --disallowedTools`
`claude_env`	`settings` JSON-Format

Vorher- und Nachher-Beispiel

Beta-Version:

- uses: anthropics/claude-code-action@beta
  with:
    mode: "tag"
    direct_prompt: "Review this PR for security issues"
    anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
    custom_instructions: "Follow our coding standards"
    max_turns: "10"
    model: "claude-sonnet-4-5-20250929"

GA-Version (v1.0):

- uses: anthropics/claude-code-action@v1
  with:
    prompt: "Review this PR for security issues"
    anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
    claude_args: |
      --system-prompt "Follow our coding standards"
      --max-turns 10
      --model claude-sonnet-4-5-20250929

Die Action erkennt jetzt automatisch, ob sie im interaktiven Modus (antwortet auf @claude-Erwähnungen) oder im Automatisierungsmodus (wird sofort mit einem Prompt ausgeführt) 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 einsatzbereite Workflows für verschiedene Szenarien.

Grundlegender 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 }}
          # Responds to @claude mentions in comments

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: "Generate a summary of yesterday's commits and open issues"
          claude_args: "--model claude-opus-4-1-20250805"

Häufige Anwendungsfälle

In Issue- oder PR-Kommentaren:

@claude implement this feature based on the issue description
@claude how should I implement user authentication for this endpoint?
@claude fix the TypeError in the user dashboard component

Claude wird automatisch den Kontext analysieren und angemessen antworten.

Best Practices

CLAUDE.md-Konfiguration

Erstellen Sie eine CLAUDE.md-Datei im Root-Verzeichnis Ihres Repositorys, 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!

Umfassende Sicherheitsanleitungen einschließlich Berechtigungen, Authentifizierung und Best Practices finden Sie in der Claude Code Action-Sicherheitsdokumentation. 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 }}
Begrenzen 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.

Optimierung der Leistung

Verwenden Sie Issue-Vorlagen, 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 wird auf GitHub-gehosteten Runnern ausgeführt, 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
Die Token-Nutzung variiert je nach Aufgabenkomplexität und Codebasis-Größe
Siehe Claudes 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 in claude_args, um übermäßige Iterationen zu verhindern
Legen Sie Workflow-Level-Timeouts fest, um unkontrollierte 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: "Your instructions here" # Optional
    claude_args: "--max-turns 5" # Optional CLI arguments

Wichtige Funktionen:

Einheitliche Prompt-Schnittstelle - Verwenden Sie prompt für alle Anweisungen
Slash-Befehle - Vordefinierte Prompts wie /review oder /fix
CLI-Passthrough - Beliebiges 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.

Wenn Claude auf Issue- oder PR-Kommentare antwortet, antwortet er automatisch auf @claude-Erwähnungen. Für andere Events verwenden Sie den Parameter prompt, 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, während Sie die gleiche Funktionalität beibehalten.

Voraussetzungen

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

Für Google Cloud Vertex AI:

Ein Google Cloud-Projekt mit aktiviertem Vertex AI
Workload Identity Federation für GitHub Actions konfiguriert
Ein Service-Konto mit 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 in AWS konfiguriert
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-Provider)

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

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: Website Ihrer Organisation oder die Repository-URL
Konfigurieren Sie die App-Einstellungen:
- Webhooks: Deaktivieren Sie “Active” (nicht erforderlich für diese Integration)
Legen Sie die erforderlichen Berechtigungen fest:
- Repository-Berechtigungen:
  - Contents: Lesen & Schreiben
  - Issues: Lesen & Schreiben
  - Pull requests: Lesen & Schreiben
Klicken Sie auf “Create GitHub App”
Klicken Sie nach der Erstellung auf “Generate a private key” und speichern Sie die heruntergeladene .pem-Datei
Notieren Sie Ihre App-ID auf der App-Einstellungsseite
Installieren Sie die App in Ihrem Repository:
- Klicken Sie auf der Einstellungsseite Ihrer App 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 Claude 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 erforderlich für die Authentifizierung

Konfigurieren Sie die Cloud-Provider-Authentifizierung

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

AWS Bedrock

Konfigurieren Sie AWS, um GitHub Actions die sichere Authentifizierung ohne Speicherung von Anmeldedaten zu ermöglichen.

Sicherheitshinweis: Verwenden Sie Repository-spezifische Konfigurationen und gewähren Sie nur die minimal erforderlichen Berechtigungen.

Erforderliches Setup:

Aktivieren Sie Amazon Bedrock:
- Fordern Sie Zugriff auf Claude-Modelle in Amazon Bedrock an
- Für regionsübergreifende Modelle fordern Sie Zugriff in allen erforderlichen Regionen an
Richten Sie GitHub OIDC Identity Provider ein:
- Provider-URL: https://token.actions.githubusercontent.com
- Audience: sts.amazonaws.com
Erstellen Sie IAM-Rolle für GitHub Actions:
- Vertrauenswürdiger Entity-Typ: Web Identity
- Identity Provider: token.actions.githubusercontent.com
- Berechtigungen: AmazonBedrockFullAccess-Richtlinie
- Konfigurieren Sie Trust Policy für Ihr spezifisches Repository

Erforderliche Werte:Nach dem Setup benötigen Sie:

AWS_ROLE_TO_ASSUME: Das ARN der von Ihnen erstellten IAM-Rolle

OIDC ist sicherer als die Verwendung statischer AWS-Zugangsschlüssel, da Anmeldedaten temporär sind und automatisch rotiert werden.

Siehe AWS-Dokumentation für detaillierte OIDC-Setup-Anweisungen.

Google Vertex AI

Konfigurieren Sie Google Cloud, um GitHub Actions die sichere Authentifizierung ohne Speicherung von Anmeldedaten zu ermöglichen.

Sicherheitshinweis: Verwenden Sie Repository-spezifische Konfigurationen und gewähren Sie nur die minimal erforderlichen Berechtigungen.

Erforderliches Setup:

Aktivieren Sie APIs in Ihrem Google Cloud-Projekt:
- IAM Credentials API
- Security Token Service (STS) API
- Vertex AI API
Erstellen Sie Workload Identity Federation-Ressourcen:
- Erstellen Sie einen Workload Identity Pool
- Fügen Sie einen GitHub OIDC-Provider hinzu mit:
  - Issuer: https://token.actions.githubusercontent.com
  - Attribut-Mappings für Repository und Owner
  - Sicherheitsempfehlung: Verwenden Sie Repository-spezifische Attribut-Bedingungen
Erstellen Sie ein Service-Konto:
- Gewähren Sie nur die Vertex AI User-Rolle
- Sicherheitsempfehlung: Erstellen Sie ein dediziertes Service-Konto pro Repository
Konfigurieren Sie IAM-Bindungen:
- Erlauben Sie dem Workload Identity Pool, das Service-Konto zu imitieren
- Sicherheitsempfehlung: Verwenden Sie Repository-spezifische Principal-Sets

Erforderliche Werte:Nach dem Setup benötigen Sie:

GCP_WORKLOAD_IDENTITY_PROVIDER: Der vollständige Provider-Ressourcenname
GCP_SERVICE_ACCOUNT: Die Service-Konto-E-Mail-Adresse

Workload Identity Federation eliminiert die Notwendigkeit herunterladbarer Service-Konto-Schlüssel und verbessert die Sicherheit.

Für detaillierte Setup-Anweisungen konsultieren Sie die Google Cloud Workload Identity Federation-Dokumentation.

Fügen Sie erforderliche Secrets hinzu

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

Für Claude API (direkt):

Für API-Authentifizierung:
- ANTHROPIC_API_KEY: Ihr Claude 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)

Erstellen Sie Workflow-Dateien

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

AWS Bedrock-Workflow

Voraussetzungen:

AWS Bedrock-Zugriff 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-Zugriff
`APP_ID`	Ihre GitHub-App-ID (aus 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: anthropics/claude-code-action@v1
        with:
          github_token: ${{ steps.app-token.outputs.token }}
          use_bedrock: "true"
          claude_args: '--model us.anthropic.claude-sonnet-4-5-20250929-v1:0 --max-turns 10'

Das Modell-ID-Format für Bedrock enthält das Regions-Präfix (z. B. us.anthropic.claude...) und das Versions-Suffix.

Google Vertex AI-Workflow

Voraussetzungen:

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

Erforderliche GitHub-Secrets:

Secret-Name	Beschreibung
`GCP_WORKLOAD_IDENTITY_PROVIDER`	Workload Identity Provider-Ressourcenname
`GCP_SERVICE_ACCOUNT`	Service-Konto-E-Mail mit Vertex AI-Zugriff
`APP_ID`	Ihre GitHub-App-ID (aus 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: anthropics/claude-code-action@v1
        with:
          github_token: ${{ steps.app-token.outputs.token }}
          trigger_phrase: "@claude"
          use_vertex: "true"
          claude_args: '--model claude-sonnet-4@20250514 --max-turns 10'
        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, daher müssen Sie sie nicht hardcodieren.

Fehlerbehebung

Claude antwortet nicht auf @claude-Befehle

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

CI wird nicht auf Claudes Commits ausgeführt

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

Authentifizierungsfehler

Bestätigen Sie, dass der API-Schlüssel gültig ist und ausreichende Berechtigungen hat. Überprüfen Sie für Bedrock/Vertex 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:

Parameter	Beschreibung	Erforderlich
`prompt`	Anweisungen für Claude (Text oder Slash-Befehl)	Nein*
`claude_args`	CLI-Argumente, die an Claude Code übergeben werden	Nein
`anthropic_api_key`	Claude API-Schlüssel	Ja**
`github_token`	GitHub-Token für API-Zugriff	Nein
`trigger_phrase`	Benutzerdefinierte Trigger-Phrase (Standard: “@claude”)	Nein
`use_bedrock`	Verwenden Sie AWS Bedrock statt Claude API	Nein
`use_vertex`	Verwenden Sie Google Vertex AI statt Claude API	Nein

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

Verwendung von claude_args

Der Parameter claude_args akzeptiert beliebige Claude Code CLI-Argumente:

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

Häufige Argumente:

--max-turns: Maximale Konversations-Turns (Standard: 10)
--model: Zu verwendendes Modell (z. B. claude-sonnet-4-5-20250929)
--mcp-config: Pfad zur MCP-Konfiguration
--allowed-tools: Komma-getrennte Liste zulässiger Tools
--debug: Debug-Ausgabe aktivieren

Alternative Integrationsmethoden

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

Benutzerdefinierte GitHub-App: Für Organisationen, die Branded-Benutzernamen oder benutzerdefinierte Authentifizierungsflows 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 die Claude Code Action-Dokumentation für detaillierte Anleitungen zu Authentifizierung, Sicherheit und erweiterte Konfiguration.

Anpassung von Claudes Verhalten

Sie können Claudes Verhalten auf zwei Arten konfigurieren:

CLAUDE.md: Definieren Sie Coding-Standards, Review-Kriterien und projektspezifische Regeln in einer CLAUDE.md-Datei im Root-Verzeichnis Ihres Repositorys. Claude wird diese Richtlinien beim Erstellen von PRs und beim Antworten auf Anfragen befolgen. Weitere Details finden Sie in unserer Memory-Dokumentation.
Benutzerdefinierte Prompts: Verwenden Sie den Parameter prompt 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 beim Erstellen von PRs und beim Antworten auf Anfragen befolgen.

Erste Schritte

Mit Claude Code entwickeln

Claude Agent SDK

Bereitstellung

Verwaltung

Konfiguration

Referenz

Ressourcen

​Warum Claude Code GitHub Actions verwenden?

​Was kann Claude tun?

​Claude Code Action

​Setup

​Schnelles Setup

​Manuelles Setup

​Upgrade von Beta

​Wesentliche Änderungen

​Breaking Changes Referenz

​Vorher- und Nachher-Beispiel

​Beispiel-Anwendungsfälle

​Grundlegender Workflow

​Verwendung von Slash-Befehlen

​Benutzerdefinierte Automatisierung mit Prompts

​Häufige Anwendungsfälle

​Best Practices

​CLAUDE.md-Konfiguration

​Sicherheitsüberlegungen

​Optimierung der Leistung

​CI-Kosten

​Konfigurationsbeispiele

​Verwendung mit AWS Bedrock & Google Vertex AI

​Voraussetzungen

​Für Google Cloud Vertex AI:

​Für AWS Bedrock:

​Für Claude API (direkt):

​Für Google Cloud Vertex AI

​Für AWS Bedrock

​Fehlerbehebung

​Claude antwortet nicht auf @claude-Befehle

​CI wird nicht auf Claudes Commits ausgeführt

​Authentifizierungsfehler

​Erweiterte Konfiguration

​Action-Parameter

​Verwendung von claude_args

​Alternative Integrationsmethoden

​Anpassung von Claudes Verhalten

Warum Claude Code GitHub Actions verwenden?

Was kann Claude tun?

Claude Code Action

Setup

Schnelles Setup

Manuelles Setup

Upgrade von Beta

Wesentliche Änderungen

Breaking Changes Referenz

Vorher- und Nachher-Beispiel

Beispiel-Anwendungsfälle

Grundlegender Workflow

Verwendung von Slash-Befehlen

Benutzerdefinierte Automatisierung mit Prompts

Häufige Anwendungsfälle

Best Practices

CLAUDE.md-Konfiguration

Sicherheitsüberlegungen

Optimierung der Leistung

CI-Kosten

Konfigurationsbeispiele

Verwendung mit AWS Bedrock & Google Vertex AI

Voraussetzungen

Für Google Cloud Vertex AI:

Für AWS Bedrock:

Für Claude API (direkt):

Für Google Cloud Vertex AI

Für AWS Bedrock

Fehlerbehebung

Claude antwortet nicht auf @claude-Befehle

CI wird nicht auf Claudes Commits ausgeführt

Authentifizierungsfehler

Erweiterte Konfiguration

Action-Parameter

Verwendung von claude_args

Alternative Integrationsmethoden

Anpassung von Claudes Verhalten