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

​

Setup

• Schnelles Setup: Führen Sie /install-github-app aus Claude Code aus. Claude Code installiert die GitHub App, fügt Ihr Authentifizierungsgeheimnis hinzu und bereitet den Workflow-Pull-Request für Sie vor
• Manuelles Setup: Installieren Sie die App, fügen Sie das Geheimnis 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 vollständige Kontrolle über die Workflow-Dateien möchten

​

Schnelles Setup

• Wenn Claude Code bereits einen API-Schlüssel hat, verwendet es diesen Schlüssel wieder und bietet an, das vorhandene ANTHROPIC_API_KEY-Geheimnis des Repositories zu behalten, 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 hat, wählen Sie Workflow-Datei mit neuester Version aktualisieren. Claude Code pusht frische Kopien der Workflow-Dateien zu einem neuen Branch und öffnet den Pull Request, genauso wie eine erste Installation.
• Fügen Sie das --comment-Argument und die claude_args-Zeile aus dem Review-Workflow-Beispiel selbst zur eingecheckten Datei hinzu, was alle anderen Änderungen beibehält, die Sie daran vorgenommen haben.

​

Manuelles Setup

​

Setup für eine Organisation

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

• anthropic_federation_rule_id: die Verbund-Regel-ID, fdrl_...
• anthropic_organization_id: Ihre Anthropic-Organisations-ID
• anthropic_service_account_id: die Dienstkonto-ID, svac_.... Optional, da die Verbund-Regel, die Sie in der Console erstellen, bereits ein Dienstkonto anvisiert
• anthropic_workspace_id: die Workspace-ID, wrkspc_.... Optional, wenn die Verbund-Regel ein einzelnes Workspace anvisiert

​

Deinstallieren

• Workflow-Dateien: Löschen Sie die Workflows, die anthropics/claude-code-action aus .github/workflows/ verwenden. Wenn Sie schnelles Setup verwendet haben, suchen Sie nach claude.yml und, wenn Sie den Review-Workflow ausgewählt haben, claude-code-review.yml. Mit den gelöschten Workflows wird die Claude Code GitHub Action nicht mehr ausgeführt
• Geheimnisse: Löschen Sie das ANTHROPIC_API_KEY- oder CLAUDE_CODE_OAUTH_TOKEN-Geheimnis aus dem Repository und aus Geheimnissen auf Organisationsebene für Actions, wenn Sie es über Repositories hinweg geteilt haben. Wenn Sie ein Geheimnis löschen, bleibt die Anmeldedaten, die es hielt, gültig. Um einen API-Schlüssel vollständig zu deaktivieren, löschen Sie auch den Schlüssel in der Claude Console
• GitHub App: Deinstallieren Sie die Claude GitHub App in Ihren Repository- oder Organisationseinstellungen unter GitHub Apps, aber nur, wenn Sie sie nicht für eine andere Claude-Funktion verwenden, wie Code Review oder Web-Auto-Fix

​

GitHub App-Berechtigungen

​

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-code.git"
          plugins: "code-review@claude-code-plugins"
          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