Claude Code GitHub Actions

Erfahren Sie, wie Sie Claude Code in Ihren Entwicklungs-Workflow mit Claude Code GitHub Actions integrieren

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. Für automatische Reviews, die auf jedem PR ohne Trigger gepostet werden, siehe GitHub Code Review.

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

Manuelles Setup

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

1. 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.

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 Verzeichnis .github/workflows/ Ihres Repositories

Upgrade von Beta

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 leistungsstarke neue Funktionen wie automatische Modusterkennung 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 Moduskonfiguration: 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 usw. zu claude_args

Breaking Changes Referenz

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-6"

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: |
      --append-system-prompt "Follow our coding standards"
      --max-turns 10
      --model claude-sonnet-4-6

Beispiel-Anwendungsfälle

Claude Code GitHub Actions kann Ihnen bei einer Vielzahl von Aufgaben helfen. Das Beispielverzeichnis enthält einsatzbereite 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 }}
          # Responds to @claude mentions in comments

Verwendung von skills

Der prompt-Input akzeptiert eine skill-Invokation sowie einfachen Text:

• Für einen skill in Ihrem Repository-Verzeichnis .claude/skills/ führen Sie actions/checkout vor dem Action-Schritt aus und übergeben Sie /skill-name.
• Für einen skill, der in einem Plugin verpackt ist, installieren Sie das Plugin mit den Inputs plugin_marketplaces und plugins und übergeben Sie den namespaced /plugin-name:skill-name.

Der folgende Workflow installiert das code-review-Plugin und führt seinen skill bei jedem neuen oder aktualisierten Pull Request aus:

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 }}
          plugin_marketplaces: "https://github.com/anthropics/claude-code.git"
          plugins: "code-review@claude-code-plugins"
          prompt: "/code-review:code-review ${{ github.repository }}/pull/${{ github.event.pull_request.number }}"

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 opus"

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 Repositories, um Code-Style-Richtlinien, Review-Kriterien, projektspezifische Regeln und bevorzugte Muster zu definieren. Diese Datei leitet Claudes Verständnis Ihrer Projektstandards.

Sicherheitsüberlegungen

Umfassende Sicherheitsleitlinien 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 Notwendigste
• Überprüfen Sie Claudes Vorschläge vor dem Mergen

Verwenden Sie immer GitHub Secrets (zum Beispiel ${{ secrets.ANTHROPIC_API_KEY }}), anstatt API-Schlüssel direkt in Ihren Workflow-Dateien zu hardcodieren.

Optimierung der Leistung

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 wird auf GitHub-gehosteten Runnern ausgeführt, die Ihre GitHub Actions-Minuten verbrauchen
• Siehe Abrechnungsdokumentation von GitHub 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 Codebase-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 Ausführungen 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
• Skills - Rufen Sie installierte skills direkt aus dem Prompt auf
• CLI-Passthrough - Jedes Claude Code CLI-Argument über claude_args
• Flexible Trigger - Funktioniert mit jedem GitHub-Event

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

Verwendung mit Amazon 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:

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

Für Amazon Bedrock:

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

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-6 --max-turns 10'

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-5@20250929 --max-turns 10'
env:
ANTHROPIC_VERTEX_PROJECT_ID: ${{ steps.auth.outputs.project_id }}
CLOUD_ML_REGION: us-east5
VERTEX_REGION_CLAUDE_4_5_SONNET: us-east5

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. 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 v1 verwendet eine vereinfachte Konfiguration:

*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

Übergeben Sie CLI-Argumente

Der Parameter claude_args akzeptiert alle Claude Code CLI-Argumente:

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

Häufige Argumente:

• --max-turns: Maximale Gesprächs-Turns (Standard: 10)
• --model: Zu verwendendes Modell (zum Beispiel claude-sonnet-4-6)
• --mcp-config: Pfad zur MCP-Konfiguration
• --allowedTools: Komma-getrennte Liste zulässiger Tools. Der Alias --allowed-tools funktioniert auch.
• --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 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 die Claude Code Action-Dokumentation für detaillierte Leitfäden zu Authentifizierung, Sicherheit und erweiterte Konfiguration.

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-Verzeichnis Ihres Repositories. Claude wird diese Richtlinien beim Erstellen von PRs und Antworten auf Anfragen befolgen. Weitere Details finden Sie in unserer Memory-Dokumentation.
2. 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 Antworten auf Anfragen befolgen.