WissenClaude Code & Vibe Coding

Claude Code in einer Pipeline einsetzen, automatisierte Prüfung vor jedem Deploy

Der unbeaufsichtigte Modus lässt Claude Code ohne Rückfragen laufen, genau das braucht eine Pipeline. Wie du eine automatisierte Prüfung vor jedem Deploy aufsetzt.

Tommy Hummel-Nguyen
Tommy Hummel-Nguyen · Ingenieur, kein Softwareentwickler ·

Ein Kollege, der jeden Pull Request liest, bevor er zum Kunden geht, aber nie schläft und nie eine Zeile überfliegt, weil er müde ist. Genau diese Rolle kann Claude Code in einer Pipeline übernehmen, wenn du ihm den Modus gibst, in dem er ohne Rückfragen durchläuft.

Kurz gesagt

Claude Code lässt sich mit dem Schalter -p ohne Terminal-Dialog starten, er bekommt einen Auftrag, arbeitet ihn komplett durch und gibt das Ergebnis als Text zurück. Genau das braucht eine Pipeline, keine Person, die auf Rückfragen wartet. Über die offizielle GitHub-Aktion von Anthropic prüft Claude Code so automatisch jeden Pull Request, kommentiert Probleme direkt im Diff und kann den Merge blockieren, bevor fehlerhafter Code live geht.

Der Modus ohne Rückfragen

Normalerweise fragt Claude Code vor jeder riskanten Aktion nach, genau richtig, wenn ein Mensch danebensitzt. In einer Pipeline sitzt aber niemand danebensitzt, jede Rückfrage würde den Lauf für immer blockieren. Der Schalter -p (auch --print) startet Claude Code deshalb im unbeaufsichtigten Modus: der Agent bekommt den Auftrag, arbeitet den kompletten Denk- und Werkzeugloop durch, Dateien lesen, Befehle ausführen, Code prüfen, und beendet sich am Ende mit dem fertigen Ergebnis. Damit das ohne ständiges Anhalten läuft, kommt meist --allowedTools dazu, eine bewusst enge Liste, welche Werkzeuge erlaubt sind. Für einen reinen Review reicht oft Lesezugriff, Dateien ändern muss so ein Prüf-Lauf normalerweise gar nicht können.

So sieht das in GitHub Actions aus

Am schnellsten kommst du dahin über /install-github-app direkt in Claude Code, der Befehl richtet die GitHub-App und die nötigen Secrets für dich ein. Dahinter läuft die offizielle Aktion anthropics/claude-code-action, die den kompletten Claude Code Unterbau in einem GitHub-Runner startet, ganz ohne lokale Installation. Eine typische Datei .github/workflows/claude.yml löst bei jedem neuen oder aktualisierten Pull Request aus, prüft den Diff auf Qualität und Bugs und braucht dafür im Kern nur das Secret ANTHROPIC_API_KEY und eine passende Berechtigung im Workflow. Über claude_args lassen sich zusätzliche Flags wie --max-turns oder --model direkt mitgeben, genau wie beim lokalen Aufruf im Terminal.

Was so eine Prüfung wirklich kostet

Ein automatisierter Review eines Diffs mit rund 500 Zeilen dauert nach Erfahrungswerten aus der Community zwischen 20 und 45 Sekunden und kostet etwa 0,03 US-Dollar an API-Tokens, deutlich weniger als die Zeit, die ein Mensch für denselben ersten Blick bräuchte. Wichtig dabei: diese Zahl gilt für einen einzelnen, engen Prüf-Lauf, nicht für einen Agenten, der bei jedem Fehler gleich selbst tief in der Codebasis herumschraubt.

Ich denke, der eigentliche Wert einer solchen Prüfung vor dem Deploy ist nicht, dass sie jeden Fehler findet, das schafft kein automatisierter Check. Sondern dass offensichtliche Probleme schon auffallen, bevor ein Mensch überhaupt draufschaut, und dein eigenes Review sich auf das konzentrieren kann, was wirklich Nachdenken braucht.

Quellen: Claude Code GitHub Actions (Claude Code Docs) · CI/CD and Headless Mode with Claude Code (Angelo Lima) · anthropics/claude-code-action (GitHub)

Häufige Fragen

Braucht Claude Code in der Pipeline Zugriff auf mein ganzes Repository?

Technisch ja, für den Kontext, aber über allowed-tools lässt sich einschränken, was er damit tun darf. Für einen reinen Review reicht Lesezugriff, Schreibrechte muss so ein Lauf normalerweise nicht haben.

Kann Claude Code in der Pipeline einen Merge automatisch blockieren?

Ja, wenn der Workflow so eingerichtet ist, dass ein gefundenes Problem den Job als fehlgeschlagen markiert, verhält sich das wie jeder andere CI-Check auch.

Ist der unbeaufsichtigte Modus riskant?

Nur außerhalb einer abgeschotteten Umgebung. In einer Pipeline mit eng begrenzten Rechten und ohne Zugriff auf echte Kundendaten ist das der vorgesehene Einsatz, siehe auch die vier Modi bei den Permissions.

Willst du das bei dir umsetzen?

In der Community zeige ich, was bei mir hält. Im Erstgespräch schauen wir uns dein Vorhaben konkret an.