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