Claude Code GitHub Actions: @claude im eigenen Repo einrichten, ohne PR-Autoren deine Secrets zu überlassen
Die Installation ist ein einziger Befehl, und die Defaults der Action tun mehr, als die Workflow-Datei zeigt. Drei ihrer Kontrollen halten trotzdem weniger auf, als ihre Namen versprechen: die Prüfung auf Schreibrechte, der permissions-Block und die Befehlsbeschränkung bei Pull Requests von außen.
Inhalt
Claude Code GitHub Actions bringt Claude Code auf einen GitHub-Runner. Jemand schreibt @claude in ein Issue oder einen Pull Request, oder ein Workflow startet bei einem PR oder nach Zeitplan, und Claude kann den Kontext lesen, Dateien ändern, auf einen Branch pushen und in einem Kommentar antworten. Die Einrichtung ist ein Befehl, oder ein Secret plus eine Workflow-Datei.
Der Job, der das erledigt, hält deine Anthropic-Zugangsdaten und ein GitHub-Token mit Schreibrechten, und sein Input ist Text, oft von Leuten, die du nicht kennst. Die Action bringt dafür echte Schutzmechanismen mit. Drei davon halten weniger auf, als ihre Namen versprechen: Die Prüfung auf Schreibrechte entscheidet, wer einen Lauf starten darf, nicht wessen Worte Claude liest. Der permissions:-Block des Jobs grenzt nur eines der beiden GitHub-Tokens ein, die im Spiel sind. Und die Befehlsbeschränkung bei Pull Requests von außen ist eine Liste. Alles Folgende stammt aus der Doku von Anthropic, der Sicherheitsdoku der Action und den Empfehlungen von GitHub, gelesen am 22. November 2026. Ich habe das Tag v1 über die GitHub-API aufgelöst und claude setup-token --help ausgeführt; die Action selbst habe ich nicht laufen lassen.
Was braucht Claude Code GitHub Actions, bevor du anfängst?
Admin-Zugriff auf das Repository und eine Zugangsberechtigung. Laut Doku brauchen beide Einrichtungswege Admin-Zugriff, und /install-github-app funktioniert nur mit Remotes auf github.com; bei gitlab.com oder bitbucket.org gibt der Befehl einen Hinweis aus und beendet sich. In einer Organisation kann die Installation der App außerdem die Freigabe eines Owners brauchen.
Für die Claude-API gibt es drei Wege der Authentifizierung:
ANTHROPIC_API_KEY, ein Schlüssel aus der Claude Console, übergeben an den Inputanthropic_api_key.CLAUDE_CODE_OAUTH_TOKEN, lokal erzeugt mitclaude setup-token, übergeben anclaude_code_oauth_token. Die Doku nennt ihn für die Pläne Pro, Max, Ultra, Team und Enterprise. In Claude Code 2.1.330 lautet die Hilfezeile „Set up a long-lived authentication token (requires Claude subscription).“- Workload Identity Federation, die das statische Secret durch einen OIDC-Austausch ersetzt (
anthropic_federation_rule_id,anthropic_organization_idundid-token: writeim Job).
Für ein Secret, das mehrere Repositories teilen, empfiehlt die Doku den API-Schlüssel, „da ein OAuth-Token an das Abo der Person gebunden ist, die claude setup-token ausgeführt hat“. Meine Lesart: Das OAuth-Token ist eine Bequemlichkeit für ein persönliches Repository, und alles, wovon ein Team abhängt, sollte über einen Schlüssel oder Federation laufen. Bedrock, Google Cloud und Microsoft Foundry haben eigene Inputs (use_bedrock, use_vertex, use_foundry).
Jeder Lauf von Claude verbraucht API-Tokens oder Abo-Kontingent, und der Runner rechnet Actions-Minuten ab, sofern dein Repository und dein Runner-Typ überhaupt abgerechnet werden.
Wie richtet /install-github-app Claude Code GitHub Actions ein?
Es installiert die Claude GitHub App, speichert deine Zugangsdaten als Repository-Secret und pusht einen Branch mit den Workflow-Dateien. Laut Doku meldest du dich mit gh auth login an, startest claude im Repository, führst /install-github-app aus, installierst die App im Browser, wählst Set up GitHub Actions workflows, entscheidest dich für ein Abo-Token oder einen API-Schlüssel und bestätigst. Danach erstellst du aus dem gepushten Branch den Pull Request und mergst ihn; die Workflows werden mit dem Merge aktiv.
Lies, was die App verlangt, bevor du klickst. Die Doku listet Lesen und Schreiben auf Actions, Checks, Contents, Discussions, Issues, Pull requests, Repository creation, Repository hooks und Workflows, dazu Lesen auf Administration, Dependabot alerts, Members, Merge queues, Metadata und Statuses. Die Action „stützt sich auf drei der Berechtigungen der App“: Contents, Issues und Pull requests. Der Rest dient Code Review, Auto-Fix im Web und geplanten Funktionen, und „GitHub lässt dich keine Teilmenge akzeptieren“. Der manuelle Weg installiert dieselbe App, die Liste wird dadurch also nicht kürzer. Nur eine eigene App oder ein eigenes Token ändert sie.
Wie richtest du die Claude Code Action manuell ein?
App installieren, Secret anlegen und examples/claude.yml aus dem Repository der Action nach .github/workflows/ kopieren. Die Doku schlägt das vor, wenn du Claude Code nicht lokal nutzt, wenn der Befehl fehlschlägt oder wenn du volle Kontrolle willst. Das Beispiel, wie es committet ist, ohne seine auskommentierten Optionen:
name: Claude Code
on:
issue_comment:
types: [created]
pull_request_review_comment:
types: [created]
issues:
types: [opened, assigned]
pull_request_review:
types: [submitted]
jobs:
claude:
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')) ||
(github.event_name == 'pull_request_review' && contains(github.event.review.body, '@claude')) ||
(github.event_name == 'issues' && (contains(github.event.issue.body, '@claude') || contains(github.event.issue.title, '@claude')))
runs-on: ubuntu-latest
permissions:
contents: write
pull-requests: write
issues: write
id-token: write
actions: read # Required for Claude to read CI results on PRs
steps:
- name: Checkout repository
uses: actions/checkout@v6
with:
fetch-depth: 1
- name: Run Claude Code
id: claude
uses: anthropics/claude-code-action@v1
with:
anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}Mit einem Abo-Token wird die letzte Zeile zu:
claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}Ohne prompt reagiert die Action auf die Trigger-Phrase. Die Doku nennt das Tag-Modus; setzt du einen prompt, führt sie stattdessen diesen aus, und so bauen sie automatisches PR-Review und einen Cron-Report. Zwei Änderungen hinterlassen einen stummen Job, wenn du sie nur halb machst. Eine Änderung an trigger_phrase fasst die @claude-Strings im if: des Jobs nicht an, also beide anpassen. Wer für automatisches Review einen prompt ergänzt, braucht außerdem ein neues on: (zum Beispiel pull_request) und muss die Prüfung auf die Erwähnung entfernen. claude_args reicht CLI-Flags durch: --max-turns, --model, --allowedTools, --mcp-config. Workflows, die noch auf @beta laufen, brauchen den Migrationsleitfaden; die üblichen Änderungen sind @v1, mode streichen, direct_prompt wird zu prompt, und max_turns sowie model wandern in claude_args.
Wer kann die Claude Code Action auslösen, und wessen Text kommt trotzdem hinein?
Nur Leute mit Schreibrechten können einen Lauf starten, aber der Text von jedem kann darin landen. Laut Sicherheitsdoku prüft die Action den Repository-Zugriff bei Issue-, Pull-Request-, Kommentar- und Review-Events, und bei einem Kommentar prüft sie „die Schreibrechte des Kommentierenden“. Bots werden abgewiesen, außer sie stehen in allowed_bots, und die Doku warnt, dass '*' in einem öffentlichen Repository „von beliebigen Leuten erstellten GitHub Apps“ erlaubt, die Action „mit einem Prompt, den sie kontrollieren“, aufzurufen. Geplante und manuell gestartete Läufe überspringen die Prüfung; GitHub verlangt für das manuelle Starten ohnehin Schreibrechte.
Die Prüfung regelt, wer den Knopf drückt, nicht, was Claude liest. Eine Maintainerin, die unter dem Issue einer fremden Person @claude fix this schreibt, startet einen Lauf, dessen Kontext den Text der fremden Person enthält. Die Doku: „Claude liest den Inhalt trotzdem, um die Aufgabe zu verstehen, also prüf ihn vorher.“ Die Action entfernt aus diesem Inhalt HTML-Kommentare, unsichtbare Zeichen, Alt-Texte von Bildern und versteckte Attribute und warnt, dass „neue Umgehungstechniken auftauchen können“. Lies bei einem Issue von außen also das rohe Markdown, nicht die gerenderte Seite, die HTML-Kommentare versteckt. In einem öffentlichen Repository grenzt include_comments_by_actor ein, wessen Kommentare im Thread als Kontext weitergegeben werden. Das filtert die Diskussion, nicht die Anfrage, die den Lauf gestartet hat.
Was passiert, wenn die Claude Code Action auf einem Fork-Pull-Request läuft?
Ein @claude eines Maintainers in der PR-Unterhaltung lässt Claude auf dem Code des Beitragenden laufen, in einem Job, der deine Tokens hält. allow_fork_prs steht standardmäßig auf "true", und laut Doku „checkt der Tag-Modus den Head des Pull Requests aus, bei einem Pull Request von außen ist dieser Code also deren Code, auch wenn ein Maintainer den Lauf ausgelöst hat“. Die Action stellt zuerst ihre eigene Konfiguration wieder her (siehe unten), der Rest des Checkouts gehört aber dem Fork.
Hat der Autor des PRs keine Schreibrechte, greifen drei Schutzmaßnahmen:
restrict_untrusted_prs(Standard"true") verweigert „Paketmanager, Test-Runner, Interpreter und Shells“, auch wennclaude_argssie erlaubt. Claude kann weiterhin lesen, ändern, committen und pushen.- Die Konfiguration von Claude kommt aus deinem Default-Branch, nicht aus dem PR:
.claude/,.mcp.json,.claude.json,.gitmodules,.ripgreprc,CLAUDE.md,CLAUDE.local.md,AGENTS.mdund.husky/; die Versionen aus dem PR liegen zum Lesen unter.claude-pr/..npmrc,bunfig.tomlund getrackte Dateien innode_modules/werden ebenfalls ersetzt; dasnode_modules/des PRs bleibt nicht erhalten. - Bots zählen als Autoren ohne Schreibrechte, auch wenn sie in
allowed_botsstehen.
Die Doku sagt dann klar, wo das endet:
Das ist eine Liste gängiger Befehle, keine Sandbox.
Eine Regel wie Bash(./scripts/test.sh) bleibt erlaubt, und scripts/ steht nicht auf der Liste der wiederhergestellten Pfade. Nach meiner Lesart würde die Regel also die Version dieser Datei aus dem Fork ausführen. „Vertrauen folgt dem Autor des Pull Requests“: Öffnet ein Maintainer einen PR aus dem Branch einer fremden Person, zählt der Code als seiner.
Am leichtesten übersieht man den Push. Bei einem offenen Fork-PR pusht Claude auf einen Branch pr-N in deinem Repository, und dieser Branch „enthält die Commits des Forks ebenso wie die von Claude, und GitHubs Beschränkungen für Läufe aus Forks gelten für ihn nicht“. Jede per push ausgelöste CI, die ihn baut, führt den Code des Beitragenden mit deinen Secrets aus. Die Lösung der Doku: pr-* aus CI mit Secrets heraushalten (branches-ignore bei push-Triggern), nie daraus deployen und den Branch löschen, wenn du fertig bist.
Brauchst du Claude nicht auf Forks, setz allow_fork_prs: "false". Die Action überspringt dann jeden PR, dessen Branch in einem anderen Repository liegt, bei jedem Event und bevor sie irgendetwas auscheckt. Das Überspringen ist ein erfolgreicher Schritt ohne Ausgabe von Claude, ein Required Check, der nur die Action ausführt, wird also grün. Es deckt weder deine eigenen Schritte ab, die vorher Fork-Code auschecken, noch Issues oder Text: „Issues und Kommentare von externen Beitragenden erreichen Claude weiterhin.“
Begrenzt der permissions-Block in GitHub Actions das Token der Claude GitHub App?
Soweit die Doku es sagt, nein. Er grenzt GITHUB_TOKEN ein. Ohne den Input github_token „authentifiziert sich die Claude Code GitHub Action als Claude GitHub App“ und tauscht dafür ein OIDC-Token gegen ein App-Token; genau dafür steht id-token: write im Block. Die Sicherheitsdoku beschreibt das App-Token als kurzlebig und „speziell auf das Repository beschränkt, in dem es arbeitet“, und was es innerhalb dieses Repositorys darf, folgt aus den Rechten der App. Weder die Doku noch die FAQ sagen, dass der Block des Jobs es eingrenzt, während das Token des Workflows selbst „auf die deklarierten Berechtigungen des Jobs beschränkt ist und mit dem Ende des Jobs abläuft“.
Wer also den Block im Beispiel kürzt, kürzt GITHUB_TOKEN. Schreib ihn trotzdem explizit hin, und behalte id-token: write, solange du die App nutzt, sonst scheitert der Austausch. Wer actions: read streicht, begrenzt den Zugriff des Workflow-Tokens auf CI-Ergebnisse; das hält Claude nicht davon ab, über einen anderen Weg, den du erlaubst, an Logs zu kommen. Ein Cron-Report mit contents: read und issues: read ist für das Workflow-Token schreibgeschützt, nicht für das App-Token daneben.
Um zu begrenzen, was Claude über GitHub tun kann, tausch das Token aus:
- Eine eigene GitHub App.
docs/setup.mdnennt als Minimum Lesen und Schreiben auf Contents, Issues und Pull requests: „Das Token deiner App hat genau die Berechtigungen, die du konfiguriert hast, nicht mehr.“ Erzeuge es mitactions/und übergib es alscreate-github-app-token github_token. - Das eigene Token des Workflows, das eingebaute
GITHUB_TOKEN, übergeben alsgithub_token. Dann ist der Block des Jobs die Grenze. Kommentare erscheinen unter einem anderen Benutzer, laut FAQ aktualisiertuse_sticky_commentnicht mehr sauber, und GitHub startet keine normalen Workflows aus Pushes, die mit diesem Token gemacht wurden.
Ist der Auto-Modus in der Claude Code Action eine Sicherheitsgrenze?
Nein. Die Sicherheitsdoku betitelt den Abschnitt mit „Auto mode is a review, not a boundary“, also eine Prüfung, keine Grenze. Die Action lässt Claude inzwischen standardmäßig im Auto-Modus laufen: Lesen und Änderungen im Workspace laufen ohne Rückfrage, und „eine Sicherheitsprüfung entscheidet über jeden anderen Tool-Aufruf, den deine Allow-Regeln nicht abdecken“. Enge Regeln wie Bash(npm test) überspringen die Prüfung; breite wie Bash(*) werden ignoriert. „Sie fängt viele unsichere Aktionen ab, aber ein Aufruf kann trotzdem laufen, wenn die Prüfung ihn durchlässt.“
Das zählt, wenn dein Workflow --allowedTools als Obergrenze dessen betrachtet, was Claude ausführen darf. Im Auto-Modus kann die Prüfung mehr freigeben. Die Doku nennt die früheren Defaults als Ausweg:
# @claude mentions: workspace edits allowed, anything no rule covers denied
claude_args: --permission-mode acceptEdits
# workflows with a prompt: anything no rule covers denied
# claude_args: --permission-mode defaultDamit verliert die Prüfung die Möglichkeit, zusätzliche Aufrufe freizugeben. Deine Liste wird dadurch aber nicht zu den einzigen Tools im Spiel: acceptEdits erlaubt weiterhin Änderungen, und der Tag-Modus fügt eigene Git-Tools hinzu. Setzt du allowed_non_write_users oder allowed_bots, fällt der Default ebenfalls auf die früheren Modi zurück, „weil der Text anderer Leute diese Läufe ohne Prüfung der Schreibrechte erreicht“, außer du gibst selbst einen Modus an. Welchen Pfad des Klassifikators eine Sitzung auf dem Runner nimmt, habe ich nicht geprüft; den Klassifikator des Auto-Modus und sein Modell prüfen behandelt das lokale Claude Code.
Wo bricht pull_request_target ein Claude Code GitHub Actions Setup?
Dort, wo ein privilegierter Trigger auf einen Checkout von nicht vertrauenswürdigem Code trifft. Der Pwn-Request-Artikel von GitHub Security Lab fasst es in einer Zeile: „Den Workflow-Trigger pull_request_target mit einem expliziten Checkout eines nicht vertrauenswürdigen PRs zu kombinieren ist eine gefährliche Praxis, die zur Kompromittierung des Repositorys führen kann.“ Workflows mit diesem Trigger „haben Schreibrechte auf das Ziel-Repository“ und „Zugriff auf dessen Secrets“; ein normales pull_request aus einem Fork bekommt beides nicht. Die Seite von Anthropic sagt dasselbe aus ihrer Sicht: In öffentlichen Repositories „hält GitHub Secrets von Läufen zurück, die durch Fork-Pull-Requests ausgelöst werden“, weshalb ihr Review-Beispiel nur Branches im selben Repository abdeckt.
Die Doku der Action setzt die Regel fett: „Do not check out an untrusted ref into the workspace root before this action.“ Also keinen nicht vertrauenswürdigen Ref vor dieser Action ins Wurzelverzeichnis des Workspace auschecken. Ihr bevorzugtes Muster ist ein einfaches actions/checkout ohne ref:, das bei pull_request_target die Basis liefert. Sie zeigen auch, wie man den Head des PRs in ein Unterverzeichnis auscheckt und mit --add-dir übergibt. Das gibt Claude die Dateien zum Lesen. Es isoliert nichts, sobald irgendetwas im Job sie ausführt. Code aus einem Fork, der ausgeführt werden muss, gehört in einen pull_request-Job ohne Secrets, mit jedem privilegierten Folgeschritt auf workflow_run, die Aufteilung, die Security Lab empfiehlt.
Warum ist allowed_non_write_users der riskanteste Input der Claude Code Action?
Weil er die Prüfung abschaltet, auf die sich alles oben stützt. Die Doku markiert ihn als „RISKY“: Er „umgeht den wichtigsten Sicherheitsmechanismus dieser Action“ und gehört nur in Workflows mit sehr begrenzten Rechten, etwa für das Labeln von Issues. Er funktioniert nur mit einem eigenen github_token, und die Doku sagt, man solle GITHUB_TOKEN übergeben, nie einen Personal Access Token, weil ein statisches Token „über die Zeit per Prompt Injection teilweise oder ganz wiederhergestellt werden könnte“. Grenz den Block des Jobs und die erlaubten Tools auf die eine Aufgabe ein.
Das ist die Konfiguration hinter Clinejection, einem der echten Fälle von Prompt Injection gegen Coding-Agenten, die ich gesammelt habe: Ein Workflow zur Issue-Triage ließ die Action beim Event issues mit allowed_non_write_users: "*" und Bash unter ihren Tools laufen, und ein Issue-Titel wies Claude an, ein Paket zu installieren.
Solltest du die Claude Code Action auf einen Commit-SHA pinnen?
Ja. Die Secure-Use-Referenz von GitHub empfiehlt, Actions von Dritten auf einen vollständigen Commit-SHA zu pinnen, und stellt ihr Lockfile für Workflow-Abhängigkeiten inzwischen noch darüber: „Das ist der stärkste verfügbare Schutz und ersetzt das SHA-Pinning für Repositories, die ihn einführen.“ Nutzt dein Repository dieses Lockfile, nimm diesen Workflow mit hinein; sonst pinne. Am 22. November 2026 zeigte @v1 auf denselben Commit wie v1.0.286:
- uses: anthropics/claude-code-action@acfe7992852970efb4fee683d63d628e3e52df67 # v1.0.286v1 steht bei Patch 286, und der Auto-Modus als Default kam innerhalb dieser Version, ohne Sprung der Hauptversion. Pinne sie, pinne auch actions/checkout, und lies jedes Mal das Changelog, wenn du den Pin verschiebst.
Claude Code GitHub Actions: die kurze Checkliste
Bevor du den Beispiel-Workflow einfügst:
- Nimm für alles Geteilte einen API-Schlüssel oder Federation; das OAuth-Token bleibt für persönliche Repositories.
- Schreib den
permissions:-Block selbst, und denk daran, dass erGITHUB_TOKENbegrenzt. Um den GitHub-Zugriff von Claude zu begrenzen, übergib das Token deiner eigenen App oderGITHUB_TOKENalsgithub_token. - Entscheide dich bei Forks:
allow_fork_prs: "false", außer du willst Claude auf PRs von außen. Lässt du es an, lassrestrict_untrusted_prseingeschaltet und haltepr-*aus CI mit Secrets heraus. - Wähl den Berechtigungsmodus bewusst. Soll
--allowedToolsdie Obergrenze sein, ergänze--permission-mode acceptEditsoderdefault. - Check unter
pull_request_targetnie einen PR-Head ins Wurzelverzeichnis des Workspace aus. Giballowed_non_write_usersnur einem Job mit minimalen Rechten undGITHUB_TOKEN. - Pinne die Action.
- Lies das rohe Markdown eines Issues von außen, bevor du
@claudedarunter schreibst.
Die Prüfung der Schreibrechte sagt dir, wer gefragt hat. Sie sagt dir nichts darüber, wer das geschrieben hat, was Claude gelesen hat, oder wessen Code auf dem Branch liegt, auf den es pusht. Wenn du im Nachhinein eine zweite automatische Ebene willst: Claude Code Review und die Ebenen drumherum zeigt, was der verwaltete Reviewer beiträgt und was du mit jedem Plan nachbauen kannst.
01 / Diskussion
Hier gibt es keine Kommentarspalte. Diskussionen laufen auf X.
02 / Weitere Artikel
Codex-Sandbox-Berechtigungsprofile vs. die Claude-Code-Sandbox: was jede von beiden abschottet
Unter Ubuntu hat ein Codex-Profil mit einer Allowlist für einen einzigen Host eine nicht gelistete Seite mit 403 abgewiesen. Lösch zwei Zeilen, die wie ein unabhängiger Feature-Schalter aussehen, und dieselbe Seite antwortet mit 200, ohne Warnung. Der Netzwerkfilter von Claude Code kann nicht auf diese Weise wirkungslos werden; er ist aus, bis du ihn einschaltest, und ein Berechtigungsmodus geht einfach durch ihn hindurch.
Windows-11-Telemetrie für Coding Agents: was der Schalter für optionale Diagnosedaten in MissionControlAggregator stoppt, und das Entwickler-Flag, das Microsoft als erforderlich führt
Die Bitmap pro Agent ist als optional markiert, also sollte der übliche Schalter sie auf dem Rechner halten. Eine gröbere IsDeveloper-Kohorte aus derselben DLL steht in Microsofts Liste der erforderlichen Ereignisse, die sich unter Home und Pro nicht abwählen lassen. Einen Testlauf mit ausgeschaltetem Schalter hat noch niemand veröffentlicht.
Claude Code „Don't ask again“ und settings.local.json: So findest du die Passwörter in deinen Allow-Regeln, und das solltest du ändern
Im aktuellen Claude-Code-Release macht der Prompt aus dem Großteil eines Befehls eine Wildcard, bevor er die Regel speichert, und ein Passwort, das vor dem Programm steht, überlebt trotzdem. Das Session-Transkript behält den ganzen Befehl, und der sauberste Fix ist eine Kommandozeile, die das Secret gar nicht erst enthält.