Claude Code GitHub Actions

• Code Review: automatische Überprüfung bei jedem Pull Request, ohne einen Workflow zu schreiben
• Claude Code in der Cloud: Claude Code-Sitzungen, die auf Cloud-Infrastruktur statt auf Ihrem Computer ausgeführt werden
• Claude Agent SDK: benutzerdefinierte Automatisierung außerhalb von GitHub Actions. Die Claude Code GitHub Action basiert auf dem SDK
• GitHub Enterprise Server: Claude Code mit selbstgehostetem GitHub

​

Einrichtung

• Schnelleinrichtung: Führen Sie /install-github-app in Claude Code aus. Claude Code installiert die GitHub App, fügt Ihr Authentifizierungs-Secret hinzu und bereitet den Workflow-Pull-Request für Sie vor
• Manuelle Einrichtung: Installieren Sie die App, fügen Sie das Secret hinzu und kopieren Sie die Workflow-Datei selbst in Ihr Repository. Verwenden Sie diesen Weg, wenn Sie Claude Code nicht lokal ausführen, wenn der Befehl fehlschlägt oder wenn Sie die volle Kontrolle über die Workflow-Dateien wünschen

​

Schnelleinrichtung

• Wenn Claude Code bereits über einen API-Schlüssel verfügt, wird dieser Schlüssel wiederverwendet, und Claude Code bietet an, das vorhandene ANTHROPIC_API_KEY-Secret des Repositorys beizubehalten, falls bereits eines gesetzt ist
• Andernfalls wählen Sie zwischen dem Erstellen eines langlebigen Tokens mit Ihrem Claude-Abonnement und dem Einfügen eines API-Schlüssels

• Führen Sie /install-github-app erneut aus. Wenn das Repository bereits eine claude.yml enthält, wählen Sie Update workflow file with latest version. Claude Code pusht neue Kopien der Workflow-Dateien in einen neuen Branch und öffnet den Pull Request, genau wie bei einer Erstinstallation.
• Fügen Sie das Argument --comment und die Zeile claude_args aus dem Beispiel für den Review-Workflow selbst in die eingecheckte Datei ein. Dadurch bleiben alle anderen Änderungen erhalten, die Sie daran vorgenommen haben.

​

Manuelle Einrichtung

​

Einrichtung für eine Organisation

• Installieren Sie die Claude GitHub App einmalig auf Organisationsebene und wählen Sie alle Repositorys oder eine ausgewählte Liste
• Speichern Sie das Authentifizierungs-Secret als Actions-Secret auf Organisationsebene, damit nicht jedes Repository eine eigene Kopie benötigt
• Fügen Sie die Workflow-Datei jedem Repository hinzu, das die Claude Code GitHub Action ausführen soll, oder definieren Sie den Job einmalig als wiederverwendbaren Workflow, den jedes Repository aufruft

• anthropic_federation_rule_id: die ID der Federation-Regel, fdrl_...
• anthropic_organization_id: die ID Ihrer Anthropic-Organisation
• anthropic_service_account_id: die ID des Dienstkontos, svac_.... Optional, da die Federation-Regel, die Sie in der Console erstellen, bereits auf ein Dienstkonto verweist
• anthropic_workspace_id: die Workspace-ID, wrkspc_.... Optional, wenn die Federation-Regel auf einen einzelnen Workspace verweist

​

Deinstallation

• Workflow-Dateien: Löschen Sie die Workflows, die anthropics/claude-code-action verwenden, aus .github/workflows/. Wenn Sie die Schnelleinrichtung verwendet haben, suchen Sie nach claude.yml und, falls Sie den Review-Workflow ausgewählt haben, nach claude-code-review.yml. Sobald die Workflows gelöscht sind, wird die Claude Code GitHub Action nicht mehr ausgeführt
• Secrets: Löschen Sie das Secret ANTHROPIC_API_KEY oder CLAUDE_CODE_OAUTH_TOKEN aus dem Repository und aus den Actions-Secrets auf Organisationsebene, falls Sie es über mehrere Repositorys geteilt haben. Wenn Sie ein Secret löschen, bleiben die darin gespeicherten Anmeldedaten gültig. Um einen API-Schlüssel vollständig außer Betrieb zu nehmen, löschen Sie den Schlüssel zusätzlich in der Claude Console
• GitHub App: Deinstallieren Sie die Claude GitHub App in den Einstellungen Ihres Repositorys oder Ihrer Organisation unter GitHub Apps, jedoch nur, wenn Sie sie nicht für eine andere Claude-Funktion wie Code Review oder die automatische Korrektur im Web verwenden

​

Berechtigungen der GitHub App

​

Interaktive und Automatisierungsmodi

• Interaktiver Modus: Wenn der Workflow keine prompt-Eingabe bereitstellt, wartet Claude auf die Trigger-Phrase, @claude standardmäßig, in einem Issue- oder Pull-Request-Kommentar, in einer Pull-Request-Überprüfung oder im Body oder Titel eines neu geöffneten Issues, und antwortet dann auf diese Anfrage. Fortschritt und Ergebnisse erscheinen als Kommentar auf dem auslösenden Issue oder PR.
• Automatisierungsmodus: Wenn der Workflow eine prompt-Eingabe bereitstellt, wird Claude ohne Warten auf eine Erwähnung ausgeführt, unterliegt nur den Überprüfungen, wer Läufe auslösen kann. Standardmäßig erscheinen Ergebnisse im Workflow-Run-Log statt in einem Kommentar. Claude kann auf den Issue oder Pull Request posten, wenn der Prompt es anweist und er ein Tool hat, das posten kann, wie im Code-Review-Beispiel.

​

Wer kann Läufe auslösen

• Schreibzugriff: Bei Issue- und Pull-Request-Events muss der auslösende Benutzer Schreibzugriff auf das Repository haben. Um bestimmte Benutzer ohne Schreibzugriff zuzulassen, legen Sie allowed_non_write_users fest und übergeben Sie Ihre eigene github_token-Eingabe. Events, die kein Benutzer verfasst, wie ein schedule-Trigger, überspringen diese Überprüfung.
• Menschlicher Akteur: Bei jedem Event lehnt die Claude Code GitHub Action einen Bot-Akteur ab, es sei denn, Sie listen ihn in allowed_bots auf, was Bots daran hindert, Claude in einer Schleife auszulösen. Diese Überprüfung gilt auch für geplante Läufe, die GitHub einem Repository-Benutzer zuordnet, normalerweise dem, der zuletzt den cron-Zeitplan des Workflows geändert hat. Wenn dieser Benutzer ein Bot ist, listen Sie ihn in allowed_bots auf.

​

Beispiel-Anwendungsfälle

​

Reagieren Sie auf @claude-Erwähnungen

name: Claude Code
on:
  issue_comment:
    types: [created]
  pull_request_review_comment:
    types: [created]
jobs:
  claude:
    if: contains(github.event.comment.body, '@claude')
    runs-on: ubuntu-latest
    permissions:
      contents: write
      pull-requests: write
      issues: write
      id-token: write
      actions: read
    steps:
      - uses: actions/checkout@v6
        with:
          fetch-depth: 1
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}

• id-token: write: erforderlich für die Standard-GitHub-App-Authentifizierung der Claude Code GitHub Action
• actions: read: lässt Claude CI-Ergebnisse auf PRs lesen
• actions/checkout: gibt Claude eine lokale Kopie des Repositories zum Arbeiten
• if: verhindert, dass Runner bei Kommentaren starten, die @claude nicht erwähnen. Die Claude Code GitHub Action prüft auch die Trigger-Phrase selbst, bevor sie antwortet

@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

​

Führen Sie eine Skill aus

• Für eine Skill in Ihrem Repository-Verzeichnis .claude/skills/, führen Sie actions/checkout vor dem anthropics/claude-code-action-Schritt aus, damit die Skill-Dateien auf dem Runner verfügbar sind, und übergeben Sie dann /skill-name als prompt.
• Für eine Skill, die in einem Plugin verpackt ist, installieren Sie das Plugin mit den Eingaben plugin_marketplaces und plugins, und übergeben Sie dann den namespaced /plugin-name:skill-name als prompt. Die plugins-Eingabe nimmt plugin-name@marketplace-name, wobei der Marketplace-Name aus dem Manifest des Marketplace selbst kommt, nicht aus seiner Repository-URL.

name: Code Review
on:
  pull_request:
    types: [opened, synchronize, ready_for_review, reopened]
jobs:
  review:
    runs-on: ubuntu-latest
    permissions:
      contents: read
      pull-requests: read
      issues: read
      id-token: write
    steps:
      - uses: actions/checkout@v6
        with:
          fetch-depth: 1
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          plugin_marketplaces: "https://github.com/anthropics/claude-plugins-official.git"
          plugins: "code-review@claude-plugins-official"
          prompt: "/code-review:code-review --comment ${{ github.repository }}/pull/${{ github.event.pull_request.number }}"
          claude_args: '--allowedTools "mcp__github_inline_comment__create_inline_comment"'

• --comment: Claude postet seine Überprüfung auf dem Pull Request, als Inline-Kommentar zu jedem gefundenen Problem oder als einen Zusammenfassungs-Kommentar, wenn keine gefunden werden. Ohne ihn postet Claude nichts, und Sie lesen die Erkenntnisse im Workflow-Run-Log.
• claude_args: Behalten Sie diese Zeile bei, obwohl die Frontmatter allowed-tools der Skill selbst das gleiche Tool benennt, weil die Claude Code GitHub Action den MCP-Server startet, der Inline-Kommentare postet, nur wenn --allowedTools in claude_args ihn benennt.

​

Führen Sie nach einem Zeitplan aus

name: Daily Report
on:
  schedule:
    - cron: "0 9 * * *"
jobs:
  report:
    runs-on: ubuntu-latest
    permissions:
      contents: read
      issues: read
      id-token: write
    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-5-5
            --allowedTools "mcp__github__list_commits,mcp__github__list_issues"

​

Best Practices

​

Definieren Sie Projektstandards in CLAUDE.md

​

Schützen Sie Ihre Anmeldedaten

​

Verwalten Sie Kosten

• GitHub Actions-Minuten: Die Claude Code GitHub Action wird auf GitHub-gehosteten Runnern ausgeführt, die Ihre GitHub Actions-Minuten verbrauchen. Siehe Githubs Abrechnungsdokumentation für Preise und Minutenlimits.
• API-Tokens: Jede Interaktion verbraucht Tokens basierend auf der Länge von Prompts und Antworten, Aufgabenkomplexität und Codebase-Größe. Siehe Claudes Preisseite für aktuelle Token-Raten. Wenn Sie sich mit einem OAuth-Token authentifizieren, verwenden Läufe Ihr Claude-Abonnement statt API-Abrechnung.

• Schreiben Sie spezifische @claude-Anfragen, damit Claude weniger Turns benötigt, um zu beenden
• Verwenden Sie Issue-Templates, um Kontext im Voraus bereitzustellen
• Halten Sie Ihre CLAUDE.md prägnant, da Claude sie bei jedem Lauf liest
• Legen Sie --max-turns in claude_args fest, um Iterationen zu begrenzen
• Legen Sie Workflow-Level-Timeouts fest, um unkontrollierte Jobs zu vermeiden
• Verwenden Sie Githubs Concurrency-Kontrollen, um parallele Läufe zu begrenzen

​

Verwenden Sie einen Cloud-Provider

• Amazon Bedrock: use_bedrock: "true"
• Google Cloud’s Agent Platform: use_vertex: "true"
• Microsoft Foundry: use_foundry: "true"

​

Fehlerbehebung

​

Claude antwortet nicht auf @claude-Befehle

• Überprüfen Sie, dass die GitHub App auf dem Repository installiert ist
• Überprüfen Sie, dass Workflows für das Repository aktiviert sind
• Stellen Sie sicher, dass Ihr API-Schlüssel oder OAuth-Token in Repository-Geheimnissen gesetzt ist
• Bestätigen Sie, dass der Kommentar @claude als vollständiges Wort enthält, nicht /claude oder @claude-bot
• Bestätigen Sie, dass der kommentierende Benutzer Schreibzugriff auf das Repository hat. Siehe Wer kann Läufe auslösen für die Ausnahmen

​

CI wird nicht auf Claudes Commits ausgeführt

• GitHub löst keine Workflows auf Commits aus, die mit dem Standard-GITHUB_TOKEN gemacht werden. Wenn Sie github_token: ${{ secrets.GITHUB_TOKEN }} an die Claude Code GitHub Action übergeben, entfernen Sie es, damit es sich als Claude GitHub App authentifiziert, oder übergeben Sie stattdessen ein benutzerdefiniertes App-Token
• Überprüfen Sie, dass die Trigger Ihres CI-Workflows die Events enthalten, die Claudes Pushes produzieren, wie push oder pull_request

​

Authentifizierungsfehler

• Bestätigen Sie, dass der API-Schlüssel oder OAuth-Token gültig ist, indem Sie ihn lokal mit claude testen, bevor Sie den Workflow debuggen
• Für Bedrock, Agent Platform und Foundry siehe den Fehlerbehebungsabschnitt der Cloud-Provider-Seite

​

Erweiterte Konfiguration

​

Action-Parameter

​

Übergeben Sie CLI-Argumente

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

• --max-turns: Begrenzen Sie die Anzahl der Gesprächs-Turns
• --model: Zu verwendendes Modell, zum Beispiel claude-sonnet-5. Ohne dieses Argument verwendet die Claude Code GitHub Action das Claude Code Standard-Modell
• --mcp-config: Pfad zur MCP-Konfiguration
• --allowedTools: Komma-getrennte Liste zulässiger Tools. Der Alias --allowed-tools funktioniert auch
• --debug: Debug-Ausgabe aktivieren

​

Upgrade von Beta

1. Ändern Sie @beta zu @v1 in der uses-Zeile
2. Entfernen Sie die mode-Eingabe, da die Claude Code GitHub Action jetzt den Modus automatisch erkennt
3. Ersetzen Sie direct_prompt durch prompt
4. Verschieben Sie CLI-Optionen wie max_turns und model in claude_args. custom_instructions hat kein gleichnamiges Flag und wird zu --append-system-prompt

​

Was kommt als Nächstes

• Claude Code GitHub Actions mit Cloud-Providern verwenden: Leiten Sie Inferenz durch Amazon Bedrock, Google Cloud’s Agent Platform oder Microsoft Foundry
• Konfigurationsreferenz: die vollständige Liste der Action-Eingaben
• Beispielverzeichnis: einsatzbereite Workflows für weitere Szenarien
• Code Review: automatische Pull-Request-Überprüfung ohne Wartung einer Workflow-Datei