So verwenden Sie Claude Code mit GitHub Actions

Sind Sie bereit, Ihren Workflow mit Claude Code und GitHub Actions aufzuladen? Stellen Sie sich vor, Sie hätten einen KI-Teamkollegen, der Pull Requests überprüft, Fehler behebt oder sogar neue Funktionen direkt in Ihrem GitHub-Repository schreibt. Klingt nach Magie, oder? Anthropics Claude Code macht dies zur Realität, indem es sich nahtlos in GitHub Actions integriert und Aufgaben mit einer einfachen @claude-Erwähnung automatisiert. Ich bin in den Docs von Anthropic und im GitHub-Repository über dieses Juwel gestolpert, und es ist ein Game-Changer für Entwickler. In diesem Tutorial führe ich Sie durch die Einrichtung von Claude Code in GitHub Actions, die Erstellung eines Workflows zur Überprüfung von PRs und die Erkundung seiner Möglichkeiten. Lassen Sie uns eintauchen und Ihr Repository intelligenter machen!

💡

Arbeiten Sie mit APIs oder dokumentieren Sie Projekte? Laden Sie APIdog herunter, um das Entwerfen, Testen und Teilen von API-Dokumenten zu optimieren – perfekt für Ihre Claude Code-Projekte!

button

Warum Claude Code und GitHub Actions rocken?

Claude Code ist Anthropics agentisches Coding-Tool, das in Ihrem Terminal oder Ihrer IDE lebt und Ihre Codebasis wie ein Profi versteht. In Kombination mit GitHub Actions wird es zu einem virtuellen Teamkollegen, der Code-Reviews automatisiert, Funktionen implementiert und Probleme direkt in Ihrem Repository priorisiert. Es befindet sich in der Beta-Phase (Stand Mai 2025), glänzt aber bereits bei Aufgaben wie:

Code Reviews: Analysiert PRs auf Fehler, Stil und Standards.
Feature Implementation: Verwandelt Problembeschreibungen in funktionierenden Code.
Bug Fixes: Erkennt und behebt Fehler mit PRs, die zum Zusammenführen bereit sind.

Das GitHub-Repository anthropics/claude-code-action hebt seine Fähigkeit hervor, auf @claude-Kommentare zu reagieren, was es interaktiv und entwicklerfreundlich macht. Richten wir es ein!

Einrichten von Claude Code für GitHub Actions

Bevor wir Ihr Repository automatisieren, bereiten wir Ihre Umgebung vor. Dies ist anfängerfreundlich, und ich halte es kurz!

1. Anforderungen prüfen:

GitHub Repository: Sie benötigen Administratorzugriff, um Secrets und Apps hinzuzufügen.
Anthropic API Key: Holen Sie sich einen von console.anthropic.com. Kostenlose Konten funktionieren, aber kostenpflichtige Pläne (Pro/Max) bieten mehr Nutzung.
System: Jedes Betriebssystem (macOS, Linux, Windows mit WSL2) mit Git und einem Terminal.
Claude Code CLI (optional für die Einrichtung): Installieren Sie über npm install -g @anthropic-ai/claude-code.

2. Installieren Sie die Claude GitHub App:

Öffnen Sie Ihr Terminal und führen Sie aus:

claude
/install-github-app

Dies führt Sie zur Installation der Claude GitHub App (github.com/apps/claude) in Ihrem Repository. Befolgen Sie die Anweisungen, um Ihr Repository auszuwählen und Berechtigungen zu autorisieren.
Wenn ein 404-Fehler auftritt, aktualisieren Sie Ihr gh-Token: gh auth refresh -h github.com -s workflow und versuchen Sie es erneut.
Hinweis: Dieser Quickstart ist für Anthropic API-Benutzer. Für AWS Bedrock oder Google Vertex AI siehe manuelle Einrichtung in Anthropics Docs.

3. Fügen Sie Ihren API-Schlüssel hinzu:

Nach der Installation erstellt die CLI einen PR mit einer Workflow-Datei (.github/workflows/claude.yml). Bevor Sie zusammenführen, fügen Sie Ihren Anthropic API-Schlüssel als GitHub-Secret hinzu:
Gehen Sie zu Settings > Secrets and variables > Actions Ihres Repositorys.
Fügen Sie ein Secret namens ANTHROPIC_API_KEY mit Ihrem Schlüssel von Anthropics Konsole hinzu.
Führen Sie den PR zusammen, um den Workflow zu aktivieren.

Ich habe dies in 10 Minuten in einem Test-Repository eingerichtet – super reibungslos.

Hinweis: Verwenden Sie immer GitHub Secrets für API-Schlüssel!

Erstellen eines Claude Code-Workflows in GitHub Actions

Lassen Sie uns nun einen GitHub Actions-Workflow erstellen, um Claude Code PRs automatisch überprüfen zu lassen. Wir verwenden die anthropics/claude-code-action aus dem GitHub-Repository.

1. Erstellen Sie die Workflow-Datei:

Wenn /install-github-app sie nicht erstellt hat, fügen Sie manuell .github/workflows/claude.yml in Ihrem Repository hinzu:

name: Claude Code Review
on:
  pull_request:
    types: [opened, synchronize]
jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v4
        with:
          fetch-depth: 0
      - name: Run Claude Code Review
        uses: anthropics/claude-code-action@beta
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          direct_prompt: |
            Review the PR changes. Focus on code quality, potential bugs, and adherence to project standards. Suggest improvements and provide a detailed explanation.

Dies löst Claude Code bei neuen oder aktualisierten PRs aus und überprüft den Code auf Qualität und Fehler.

2. Testen Sie den Workflow:

Übertragen Sie eine Änderung auf einen Branch und öffnen Sie einen PR. Claude Code wird ausgeführt und einen Kommentar mit seiner Überprüfung posten (z. B. „Potenzieller Nullzeiger in main.py gefunden. Ziehen Sie das Hinzufügen einer Überprüfung in Betracht…“).
Ich habe dies in einem Python-Repository getestet, und Claude hat einen fehlenden Typ-Hinweis erkannt – genau richtig!

3. Passen Sie den Trigger an:

Möchten Sie die manuelle Steuerung? Ändern Sie den Workflow so, dass er auf Kommentare reagiert:

on:
  issue_comment:
    types: [created]
jobs:
  claude:
    if: contains(github.event.comment.body, '@claude')
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: anthropics/claude-code-action@beta
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}

Kommentieren Sie nun @claude review this PR, um ihn auszulösen.

Verwenden von Claude Code für erweiterte Aufgaben

Claude Code in GitHub Actions ist nicht nur für Überprüfungen gedacht – es kann Funktionen implementieren oder Fehler beheben. So können Sie das Level erhöhen:

1. Implementieren Sie eine Funktion:

Erstellen Sie ein Problem: „Benutzerauthentifizierung zum Login-Endpunkt hinzufügen.“
Kommentar: @claude implement this feature based on the issue description.
Claude analysiert das Problem, schreibt Code und erstellt einen PR. Ich habe dies für eine REST-API ausprobiert, und es hat ein grundlegendes JWT-Auth-Setup hinzugefügt – beeindruckend

2. Beheben Sie einen Fehler:

Beschreiben Sie in einem Problem den Fehler: „TypeError in dashboard.js.“
Kommentar: @claude fix the TypeError in the user dashboard component.
Claude findet das Problem, pusht eine Korrektur und öffnet einen PR.

3. Fügen Sie Projektstandards hinzu:

Erstellen Sie eine CLAUDE.md-Datei in Ihrem Repository-Stammverzeichnis, um Codierungsstandards zu definieren (z. B. „Verwenden Sie PEP 8 für Python“). Claude respektiert diese Richtlinien während der Überprüfungen und Implementierungen.

Beispielimplementierung:

1. Zuerst hinterlässt ein Benutzer einen Kommentar mit dem Tag @Claude und bittet ihn, Feedback zu bearbeiten, was Claudes automatisierte Antwort über GitHub Actions auslöst.

2. Dann antwortet Claude automatisch auf den Kommentar, führt die angeforderten Aktionen aus (z. B. API-Fehlerbehandlung, Deduplizierung) und stellt eine Checkliste der abgeschlossenen Aufgaben bereit.

3. Schließlich genehmigt ein Prüfer (z. B. Frontend-Entwickler) die von Claude vorgenommenen Änderungen, der Pull Request wird erfolgreich zusammengeführt und geschlossen, was darauf hindeutet, dass Claudes Änderungen die Überprüfung bestanden haben.

Erkunden der GitHub Actions-Funktionen von Claude Code

Möchten Sie Claude Code weiter vorantreiben? Hier sind ein paar coole Tricks:

Bildanalyse: Laden Sie einen Screenshot in einem Kommentar hoch (z. B. @claude fix this UI bug [screenshot]), und Claude analysiert ihn, um Korrekturen vorzuschlagen. Ideal für visuelle Fehler
Benutzerdefinierte Tools: Aktivieren Sie Tools wie Bash(git:*), GlobTool oder MCP (Model Control Protocol)-Server für erweiterte Aufgaben (z. B. Abrufen von Daten). Siehe das GitHub-Repository für Beispiele.
Schnellere Runner: Verwenden Sie Depot-Runner (runs-on: depot-ubuntu-latest) für eine schnellere, günstigere Ausführung im Vergleich zu den Standard-Runnern von GitHub.
SDK-Integration: Erstellen Sie benutzerdefinierte Workflows mit dem Claude Code SDK für Aufgaben, die über GitHub Actions hinausgehen.

Ich habe mit der Bildanalyse für einen CSS-Fehler experimentiert, und Claude hat die Korrektur gemeistert – umwerfend!

Zusammenfassung: Claude Code mit GitHub Actions meistern

Gut gemacht! Sie haben gerade Claude Code in GitHub Actions freigeschaltet, um Code-Reviews zu automatisieren, Funktionen zu implementieren und Fehler zu beseitigen! Von der Installation der GitHub App bis zur Erstellung von Workflows sind Sie jetzt bereit, Ihr Repository zu einem Produktivitätshaus zu machen. Versuchen Sie, MCP-Tools hinzuzufügen, CLAUDE.md zu optimieren oder Ihre APIs mit APIdog zu dokumentieren. Teilen Sie Ihre Claude Code-Erfolge auf X oder Reddit – ich freue mich darauf, Ihre PRs leuchten zu sehen! Viel Spaß beim Codieren!

button