Code Review für Claude Code einrichten

Code Review analysiert Ihre GitHub-Pull-Requests und veröffentlicht Erkenntnisse als Inline-Kommentare in den Codezeilen, in denen Probleme gefunden wurden. Eine Flotte spezialisierter Agenten untersucht die Codeänderungen im Kontext Ihrer vollständigen Codebasis und sucht nach Logikfehlern, Sicherheitslücken, fehlerhaften Grenzfällen und Regressionen.

Dieser Artikel behandelt die Aktivierung von Code Review, die Konfiguration von Review-Triggern, die Anpassung von Flaggungen und die Behebung häufiger Setup-Probleme.

Hinweis: Code Review befindet sich in der Forschungsvorschau und ist in Team- und Enterprise-Plänen verfügbar. Es ist nicht für Organisationen mit aktivierter Nulldatenspeicherung verfügbar. Die Code-Review-Nutzung wird separat über Nutzungsguthaben abgerechnet und zählt nicht gegen die in Ihrem Plan enthaltene Nutzung.

Wie Code Review funktioniert

Sobald eine Organisation Code Review aktiviert, kann es automatisch ausgelöst werden, wenn ein Pull Request geöffnet wird, bei jedem Push oder nur wenn jemand manuell eine Überprüfung anfordert. Wenn eine Überprüfung ausgeführt wird, analysieren mehrere Agenten parallel den Diff und den umgebenden Code. Jeder Agent sucht nach einer anderen Klasse von Problemen, dann überprüft ein Verifizierungsschritt die Ergebnisse gegen das tatsächliche Codeverhalten, um falsch positive Ergebnisse herauszufiltern.

Erkenntnisse werden dedupliziert, nach Schweregrad eingestuft und als Inline-Kommentare in den spezifischen Zeilen veröffentlicht, in denen Probleme gefunden wurden. Wenn keine Probleme gefunden werden, veröffentlicht Claude einen kurzen Bestätigungskommentar auf dem PR. Überprüfungen genehmigen oder blockieren Ihren PR nicht, daher bleiben vorhandene Review-Workflows intakt.

Überprüfungen skalieren in den Kosten mit der Größe und Komplexität des PR und werden im Durchschnitt in 20 Minuten abgeschlossen.

Schweregrade

Jeder Fund ist mit einem Schweregrad gekennzeichnet:

Marker	Schweregrad	Bedeutung
🔴	Normal	Ein Fehler, der vor dem Zusammenführen behoben werden sollte
🟡	Nit	Ein kleineres Problem, das behoben werden sollte, aber nicht blockierend ist
🟣	Bereits vorhanden	Ein Fehler, der in der Codebasis vorhanden ist, aber nicht durch diesen PR eingeführt wurde

Erkenntnisse enthalten einen ausklappbaren Abschnitt mit erweiterten Überlegungen, den Sie erweitern können, um zu sehen, warum Claude das Problem gekennzeichnet hat und wie es das Problem überprüft hat.

Was Code Review überprüft

Standardmäßig konzentriert sich Code Review auf Korrektheit: Fehler, die die Produktion unterbrechen würden, nicht auf Formatierungspräferenzen oder fehlende Testabdeckung. Sie können erweitern, was es überprüft, indem Sie Anleitungsdateien zu Ihrem Repository hinzufügen.

Code Review einrichten

Die folgenden Schritte behandeln das Setup für Repositories auf github.com. Wenn sich Ihre Repositories auf einer selbstgehosteten GitHub Enterprise Server (GHES)-Instanz befinden, lesen Sie Claude Code mit GitHub Enterprise Server für die vollständige Setup-Anleitung.

Besitzer und Hauptbesitzer von Team- und Enterprise-Plänen können Code Review einmal für die Organisation aktivieren und auswählen, welche Repositories einbezogen werden sollen. Zusätzlich zu einer Besitzerrolle in Ihrer Claude-Organisation benötigen Sie die Berechtigung, GitHub Apps in Ihrer GitHub-Organisation zu installieren.

Gehen Sie zu Organisationseinstellungen > Claude Code und suchen Sie den Abschnitt Code Review.
Klicken Sie auf „Konfigurieren
Folgen Sie den Anweisungen, um die Claude GitHub App in Ihrer GitHub-Organisation zu installieren. Die App fordert Lese- und Schreibberechtigungen für Inhalte, Probleme und Pull Requests an.
Wählen Sie aus, welche Repositories für Code Review aktiviert werden sollen. Wenn Sie ein Repository nicht sehen, bestätigen Sie, dass Sie der Claude GitHub App während der Installation Zugriff darauf gewährt haben.
Legen Sie einen Review-Trigger für jedes Repository mithilfe des Dropdowns Review Behavior fest (siehe den nächsten Abschnitt für Details zu jeder Option).

Um das Setup zu überprüfen, öffnen Sie einen Test-PR. Wenn Sie einen automatischen Trigger gewählt haben, sollte eine Check-Run namens Claude Code Review innerhalb weniger Minuten angezeigt werden. Wenn Sie „Manuell

Wählen Sie einen Review-Trigger

Nach dem Setup zeigt der Abschnitt Code Review Ihre Repositories in einer Tabelle. Wählen Sie für jedes Repository aus, wann Überprüfungen ausgeführt werden:

Einmal nach PR-Erstellung: Die Überprüfung wird einmal ausgeführt, wenn ein PR geöffnet oder als überprüfungsbereit markiert wird.
Nach jedem Push: Die Überprüfung wird bei jedem Push zum PR-Branch ausgeführt und erfasst neue Probleme, während sich der PR entwickelt. Claude löst Threads automatisch auf, wenn Sie zuvor gekennzeichnete Probleme beheben. Dies führt die meisten Überprüfungen durch und kostet am meisten.
Manuell: Überprüfungen werden nur gestartet, wenn jemand „@claude review

Die Repositories-Tabelle zeigt auch die durchschnittlichen Kosten pro Überprüfung für jedes Repository basierend auf der letzten Aktivität.

Überprüfungen manuell auslösen

Kommentieren Sie „@claude review

Damit der Kommentar eine Überprüfung auslöst:

Veröffentlichen Sie ihn als Top-Level-PR-Kommentar, nicht als Inline-Kommentar auf einer Diff-Zeile.
Setzen Sie „@claude review" an den Anfang des Kommentars."
Sie müssen über Besitzer-, Mitglieds- oder Mitarbeiterzugriff auf das Repository verfügen.
Der PR muss offen sein und kein Entwurf.

Wenn bereits eine Überprüfung läuft, wird die Anfrage in die Warteschlange eingereiht, bis die laufende Überprüfung abgeschlossen ist.

Überprüfungen anpassen

Code Review liest zwei Dateien aus Ihrem Repository, um zu bestimmen, welche Probleme gekennzeichnet werden. Beide ergänzen die standardmäßigen Korrektheitsprüfungen.

CLAUDE.md

Code Review liest die CLAUDE.md-Dateien Ihres Repositorys und behandelt neu eingeführte Verstöße als Anmerkungen auf niedriger Ebene. Wenn Ihr PR Code so ändert, dass eine CLAUDE.md-Aussage veraltet wird, kennzeichnet Claude, dass auch die Dokumentation aktualisiert werden muss.

Claude liest CLAUDE.md-Dateien auf jeder Ebene Ihrer Verzeichnishierarchie, daher gelten Regeln in der CLAUDE.md eines Unterverzeichnisses nur für Dateien unter diesem Pfad.

REVIEW.md

Fügen Sie eine REVIEW.md-Datei zum Repository-Root hinzu, um überprüfungsspezifische Regeln festzulegen. Verwenden Sie sie zum Codieren von:

Unternehmens- oder Team-Stilrichtlinien
Sprach- oder Framework-spezifische Konventionen, die nicht von Lintern abgedeckt werden
Dinge, die Claude immer kennzeichnen sollte (z. B. „jede neue API-Route muss einen Integrationstest haben")"
Dinge, die Claude überspringen sollte (z. B. „keine Kommentare zu generiertem Code")"

Claude erkennt REVIEW.md automatisch im Repository-Root. Es ist keine Konfiguration erforderlich.

Preisgestaltung und Nutzung

Code Review wird basierend auf der Token-Nutzung abgerechnet. Jede Überprüfung kostet durchschnittlich 15–25 USD und skaliert mit der PR-Größe, der Codebase-Komplexität und der Anzahl der Probleme, die überprüft werden müssen.

Die Code Review-Nutzung wird separat über Nutzungsguthaben abgerechnet und zählt nicht gegen die in Ihrem Plan enthaltene Nutzung. Der von Ihnen gewählte Überprüfungs-Trigger beeinflusst die Gesamtkosten:

Einmal nach PR-Erstellung wird einmal pro PR ausgeführt.
Nach jedem Push wird bei jedem Push ausgeführt und multipliziert die Kosten mit der Anzahl der Pushes.
Manuell verursacht keine Kosten, bis jemand „@claude review" kommentiert. Nach diesem Kommentar werden zusätzliche Pushes zum PR automatisch überprüft."

Die Kosten erscheinen auf Ihrer Anthropic-Rechnung, unabhängig davon, ob Ihre Organisation AWS Bedrock oder Google Vertex AI für andere Claude Code-Funktionen nutzt.

Um eine monatliche Ausgabenbegrenzung festzulegen, gehen Sie zu Organisationseinstellungen > Nutzung und konfigurieren Sie das Limit für den Claude Code Review-Service.

Überwachen Sie die Ausgaben über das wöchentliche Kostendiagramm im Analytics-Dashboard oder die durchschnittliche Kostenspalte pro Repository in den Admin-Einstellungen.

Nutzung anzeigen

Gehen Sie zum Code Review Analytics-Dashboard, um die Aktivität in Ihrer Organisation zu sehen. Das Dashboard zeigt:

Überprüfte PRs: Tägliche Anzahl der überprüften Pull Requests im ausgewählten Zeitraum.
Kosten pro Woche: Wöchentliche Ausgaben für Code Review.
Feedback: Anzahl der Überprüfungskommentare, die automatisch gelöst wurden, weil jemand das Problem behoben hat.
Repository-Aufschlüsselung: Pro-Repository-Anzahl der überprüften PRs und gelösten Kommentare.

Fehlerbehebung

Repositories werden nach der Installation der GitHub-App nicht angezeigt

Wenn Sie die Claude GitHub-App installiert haben, aber Ihre Repositories nicht im Admin-Panel angezeigt werden:

Bestätigen Sie, dass die Claude GitHub-App Zugriff auf die Repositories hat, die Sie erwarten. Gehen Sie zu den Einstellungen Ihrer GitHub-Organisation, suchen Sie die Claude GitHub-App unter Installierte GitHub-Apps, und überprüfen Sie, ob sie Zugriff auf alle Repositories oder nur auf ausgewählte hat.
Wenn Ihre Organisation GitHub Enterprise Cloud mit Enterprise Managed Users (EMU) verwendet, stellen Sie sicher, dass die Claude GitHub OAuth-App auf Unternehmensebene autorisiert ist. EMU-Unternehmen können einschränken, welche OAuth-Apps genehmigt sind, und die Claude-App muss explizit zugelassen werden.
Versuchen Sie, die GitHub-Integration zu trennen und erneut zu verbinden. Gehen Sie zu Organisationseinstellungen > Claude Code, entfernen Sie die Repository-Konfiguration, und führen Sie das Setup erneut durch.
Wenn das Problem weiterhin besteht, kontaktieren Sie unser Support-Team mit Ihrem Organisationsnamen und GitHub-Organisationsnamen, damit wir das Problem untersuchen können.

Code Review startet nicht bei einem neuen PR

Wenn nach dem Öffnen eines PR kein Check Run angezeigt wird:

Bestätigen Sie, dass das Repository in Ihren Admin-Einstellungen aufgelistet und aktiviert ist.
Überprüfen Sie die Einstellung für den Überprüfungs-Trigger. Wenn sie auf „Manuell
Stellen Sie sicher, dass der PR kein Entwurf ist. Code Review wird nicht bei Entwurfs-PRs ausgeführt.
Überprüfen Sie, dass die Claude GitHub-App in den Einstellungen Ihrer GitHub-Organisation weiterhin Zugriff auf das Repository hat.

GitHub Enterprise Cloud mit IP-Einschränkungen

Wenn Ihre GitHub Enterprise Cloud-Organisation den Zugriff nach IP-Adresse einschränkt, kann die Claude GitHub-App möglicherweise nicht auf Ihre Repositories zugreifen. Um dies zu beheben, aktivieren Sie die IP-Zulassungslisten-Vererbung für installierte GitHub-Apps in Ihren GitHub-Unternehmenseinstellungen. Die Claude GitHub-App registriert ihre IP-Bereiche, daher ermöglicht das Aktivieren dieser Einstellung den Zugriff ohne manuelle Konfiguration. Um die Bereiche stattdessen manuell zu Ihrer Zulassungsliste hinzuzufügen oder andere Firewalls zu konfigurieren, siehe Anthropic API IP-Adressen.

GitHub Enterprise Server (selbstgehostet)

Selbstgehosteter GitHub Enterprise Server (GHES) wird durch einen separaten Setup-Ablauf unterstützt. Siehe Claude Code mit GitHub Enterprise Server für vollständige Anweisungen.

Häufige GHES-Setup-Probleme:

Fehler „Public cannot be private
GitHub Enterprise Cloud mit Data Residency ist ein anderes Produkt. Data Residency-Mandanten (Hostnamen, die *.ghe.com entsprechen) werden von Code Review nicht unterstützt. Nur selbstgehosteter GitHub Enterprise Server und Standard-github.com-Repositories werden unterstützt.

Häufig gestellte Fragen

Ist Code Review als Funktion beim Erstellen einer benutzerdefinierten Rolle verfügbar?

Nein, Code Review kann derzeit nicht zu einer benutzerdefinierten Rolle hinzugefügt werden.