Claude Code: GitHub Actions

Claude Code GitHub Actions bringt KI-gesteuerte Automatisierung in Ihre GitHub-Workflows.

Indem Sie es einfach in einem PR oder Issue erwähnen@claude, kann Claude Code analysieren, Pull Requests erstellen, Funktionen implementieren und Fehler beheben und dabei die Standardrichtlinien Ihres Projekts befolgen.


Warum Claude Code GitHub Actions verwenden

  • Sofortige PR-Erstellung: Beschreiben Sie Ihre Anforderungen, und Claude kann einen vollständigen Pull Request erstellen
  • Automatisierte Code-Implementierung: Verwandeln Sie Issues mit nur einem Befehl in funktionierenden Code
  • Befolgt Projektstandards: Respektiert IhreCLAUDE.mdRichtlinien und bestehende Codemuster
  • Einfach und schnell: In wenigen Minuten startklar
  • Sicher und zuverlässig: Der Code läuft weiterhin auf den GitHub-Runnern

Schnellstart

Methode 1: Automatische Installation (Empfohlen)

Im Claude Code-Terminal ausführen:

/install-github-app

Dies führt Sie durch:

  • Einrichten einer GitHub-App
  • Hinzufügen erforderlicher Secrets

Voraussetzungen: Sie müssen Repository-Administrator sein. Die GitHub-App benötigt Lese-/Schreibberechtigungen für Contents, Issues und Pull requests. Gilt nur für Benutzer, die die Claude API direkt verwenden (AWS Bedrock und Google Vertex AI werden nicht unterstützt).

Methode 2: Manuelle Installation

Schritt 1: Claude GitHub App installieren

Besuchen Sie:https://github.com/apps/claude

Erforderliche Berechtigungen:

  • Inhalte: Lese-/Schreibberechtigungen
  • Issues: Lese-/Schreibberechtigungen
  • Pull requests: Lese-/Schreibberechtigungen

Schritt 2: API-Schlüssel hinzufügen

Zu Repository-Secrets hinzufügenANTHROPIC_API_KEY

Schritt 3: Workflow-Datei erstellen

Aus Beispieldatei kopieren:examples/claude.ymlauf.github/workflows/


Workflow-Konfiguration

Basis-Workflow (Auf @claude-Erwähnungen reagieren)

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

Automatische Codeüberprüfung

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 this pull request for code quality, correctness, and security."
          claude_args: "--max-turns 5"

Geplante Aufgaben

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"

Gängige @claude-Befehle

Verwendung in PR- oder Issue-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 review this PR for security issues
@claude add tests for this new function

Erläuterung der Action-Parameter

Parameter Beschreibung Erforderlich
prompt Anweisungen für Claude (Klartext oder Skill-Name) Nein*
claude_args An Claude Code übergebene CLI-Argumente nein
anthropic_api_key Claude-API-Schlüssel Ja**
github_token GitHub-Token (für API-Zugriff) nein
trigger_phrase Benutzerdefiniertes Triggerwort (Standard:@claude) nein
use_bedrock AWS Bedrock anstelle von Claude API verwenden nein
use_vertex Google Vertex AI anstelle von Claude API verwenden nein

*Prompt weglassen, wenn er in Issue-/PR-Kommentaren verwendet wird; Claude antwortet auf das Triggerwort

**Erforderlich bei direkter Nutzung der Claude API, nicht erforderlich für Bedrock/Vertex

Häufige CLI-Parameter

Parameter Beschreibung
--max-turns Maximale Anzahl an Gesprächsrunden (Standard: 10)
--model Zu verwendendes Modell (z. B.claude-sonnet-4-6)
--mcp-config Pfad zur MCP-Konfigurationsdatei
--allowedTools Zulässige Tools (kommagetrennt)
--append-system-prompt System-Prompt anhängen
--debug Debug-Ausgabe aktivieren

claude_args Beispiele

claude_args: |
  --max-turns 5
  --model claude-sonnet-4-6
  --mcp-config /path/to/config.json
  --append-system-prompt "Follow our coding standards"

AWS-Bedrock-Integration

Voraussetzungen

  • AWS-Bedrock-Zugriff aktiviert mit Berechtigungen für Claude-Modelle
  • GitHub als OIDC-Identitätsanbieter in AWS konfiguriert
  • IAM-Rolle mit Bedrock-Berechtigungen

Erforderliche Secrets

Secret-Name Beschreibung
AWS_ROLE_TO_ASSUME IAM-Rollen-ARN für Bedrock-Zugriff
APP_ID GitHub App-ID
APP_PRIVATE_KEY Privater Schlüssel der GitHub App

Bedrock-Workflow-Beispiel

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]

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'))
    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'

Google Vertex AI-Integration

Voraussetzungen

  • Vertex AI API im GCP-Projekt aktiviert
  • Workload Identity Federation für GitHub konfiguriert
  • Dienstkonto mit Vertex AI-Berechtigungen

Erforderliche Secrets

Secret-Name Beschreibung
GCP_WORKLOAD_IDENTITY_PROVIDER Ressourcenname des Workload Identity Providers
GCP_SERVICE_ACCOUNT E-Mail-Adresse des Dienstkontos mit Vertex AI-Zugriff
APP_ID GitHub App-ID
APP_PRIVATE_KEY Privater Schlüssel der GitHub App

Vertex AI Workflow-Beispiel

name: Claude PR Action
permissions:
  contents: write
  pull-requests: write
  issues: write
  id-token: write

on:
  issue_comment:
    types: [created]

jobs:
  claude-pr:
    if: github.event_name == 'issue_comment' && contains(github.event.comment.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

Upgrade von Beta (v1.0 Breaking Changes)

Beta-Eingabe Neue v1.0-Eingabe
mode (Entfernt - automatisch erkannt)
direct_prompt prompt
override_prompt mit GitHub-Variablenprompt
custom_instructions claude_args: --append-system-prompt
max_turns claude_args: --max-turns
model claude_args: --model
allowed_tools claude_args: --allowedTools
disallowed_tools claude_args: --disallowedTools

Vergleich vor und nach dem Upgrade

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

Fehlerbehebung

Claude reagiert nicht auf @claude-Befehle

  • Bestätigen, dass die GitHub-App korrekt installiert ist
  • Prüfen, ob der Workflow aktiviert ist
  • Sicherstellen, dass der API-Schlüssel in den Repository-Secrets festgelegt ist
  • Bestätigen, dass der Kommentar enthält@claude(nicht/claude)

CI wird bei Claudes Commits nicht ausgeführt

  • GitHub-App oder benutzerdefinierte App verwenden (nicht den Actions-Benutzer verwenden)
  • Prüfen, ob die Workflow-Trigger die erforderlichen Ereignisse enthalten
  • Bestätigen, dass die App-Berechtigungen CI-Trigger enthalten

Authentifizierungsfehler

  • Bestätigen, dass der API-Schlüssel gültig ist und ausreichende Berechtigungen hat
  • Für Bedrock/Vertex: Konfiguration der Anmeldeinformationen prüfen
  • Sicherstellen, dass die Secret-Namen im Workflow korrekt sind

Sicherheitsaspekte

  • API-Schlüssel niemals direktin das Repository committen
  • Verwende GitHub Secrets zum Speichern von API-Schlüsseln:${{ secrets.ANTHROPIC_API_KEY }}
  • Beschränke Action-Berechtigungen; gewähre nur notwendige Berechtigungen
  • Überprüfe Claudes Vorschläge vor dem Mergen
  • Für AWS/GCP: Verwende OIDC-Identitätsanbieter anstelle von statischen Anmeldedaten
  • Erstelle dedizierte Dienstkonten für jedes Repository

Kostenüberlegungen

Kostenaufschlüsselung

  • GitHub Actions-Kosten: Die Ausführung auf von GitHub gehosteten Runnern verbraucht GitHub Actions-Minuten
  • API-Kosten: Jede Claude-Interaktion verbraucht API-Tokens basierend auf der Länge von Prompt und Antwort

Vorschläge zur Kostenoptimierung

  • Verwende spezifische@claudeBefehle, reduziere unnötige API-Aufrufe
  • Angemessen konfigurieren--max-turnsGesprächsrunden begrenzen
  • Workflow-Timeouts festlegen, um zu verhindern, dass Aufgaben außer Kontrolle geraten
  • GitHub-Concurrency-Controls verwenden, um parallele Ausführungen zu begrenzen

Best Practices

1. CLAUDE.md erstellen

Im Repository-Stammverzeichnis erstellenCLAUDE.mdDatei, definieren Sie einen Code-Style-Guide und projektspezifische Regeln:

# 项目开发规范

## 代码风格
- 使用 TypeScript 4.x
- 遵循 ESLint 配置
- 函数必须有 JSDoc 注释

## PR 要求
- 必须通过所有 CI 检查
- 至少一个代码审查
- 更新相关文档

## 禁止事项
- 不要修改 `migrations/` 目录
- 不要提交 `.env` 文件

2. Spezifische @claude-Befehle verwenden

@claude review this PR for SQL injection vulnerabilities
@claude add unit tests for the new validateEmail function

3. Angemessene Limits konfigurieren

jobs:
  claude:
    runs-on: ubuntu-latest
    timeout-minutes: 15  # 设置超时
    steps:
      - uses: anthropics/claude-code-action@v1
        with:
          claude_args: "--max-turns 5 --allowedTools Read,Grep,Glob,Bash,Write,Edit"

4. CI/CD-Automatisierungsszenarien

  • Automatische PR-Überprüfung: Überprüfung automatisch auslösen, wenn ein PR geöffnet oder aktualisiert wird
  • Automatische Issue-Klassifizierung: Automatisch Labels und Assignees hinzufügen, wenn ein neues Issue erstellt wird
  • Geplante Berichte: Tägliche Code-Statistiken oder Sicherheitsberichte generieren
  • Automatisierte Korrekturen: Automatisch analysieren und versuchen, Korrekturen durchzuführen, wenn CI fehlschlägt
Weitere Erweiterungen