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 Null-Datenspeicherung verfügbar. Die Code-Review-Nutzung wird separat über zusätzliche Nutzung 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 anhand des tatsächlichen 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 PR-Größe und -Komplexität 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

Eigentümer und Primäreigentümer von Team- und Enterprise-Plänen können Code Review einmalig für die Organisation aktivieren und auswählen, welche Repositories einbezogen werden sollen. Zusätzlich zu einer Eigentümerrolle 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", um den GitHub App-Installationsfluss zu starten.
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" gewählt haben, kommentieren Sie "@claude review" auf dem PR, um die erste Überprüfung zu starten.

Wählen Sie einen Review-Trigger

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

Einmal nach PR-Erstellung: Die Überprüfung wird einmalig 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" auf einem PR kommentiert. Nützlich für Repositories mit hohem Datenverkehr, bei denen Sie auswählen möchten, welche PRs überprüft werden.

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

Überprüfungen manuell auslösen

Kommentieren Sie "@claude review" auf einem Pull Request, um eine Überprüfung zu starten und diesen PR für zukünftige Push-ausgelöste Überprüfungen zu aktivieren. Dies funktioniert unabhängig vom konfigurierten Trigger des Repositories.

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

Veröffentlichen Sie ihn als Top-Level-PR-Kommentar, nicht als Inline-Kommentar in einer Diff-Zeile.
Setzen Sie "@claude review" an den Anfang des Kommentars.
Sie müssen über Eigentümer-, 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 steuern, was es kennzeichnet. Beide sind zusätzlich zu den standardmäßigen Korrektheitsprüfungen.

CLAUDE.md

Code Review liest die CLAUDE.md-Dateien Ihres Repositories und behandelt neu eingeführte Verstöße als Nit-Level-Erkenntnisse. Wenn Ihr PR Code so ändert, dass eine CLAUDE.md-Aussage veraltet wird, kennzeichnet Claude, dass die Dokumentation auch 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 zu Ihrem Repository-Root hinzu, um überprüfungsspezifische Regeln zu codieren. 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. "nicht auf generiertem Code kommentieren")

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 PR-Größe, Codebasis-Komplexität und wie vielen Problemen eine Überprüfung erforderlich ist.

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

Einmal nach PR-Erstellung wird einmalig 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 lösen zusätzliche Pushes zum PR automatisch Überprüfungen aus.

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 verwendet.

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

Ü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 anzuzeigen. Das Dashboard zeigt:

Überprüfte PRs: Tägliche Anzahl der überprüften Pull Requests über den ausgewählten Zeitraum.
Kosten wöchentlich: Wöchentliche Ausgaben für Code Review.
Feedback: Anzahl der Review-Kommentare, die automatisch aufgelöst wurden, weil jemand das Problem behoben hat.
Repository-Aufschlüsselung: Pro-Repository-Anzahl der überprüften PRs und aufgelö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 wird auf einem neuen PR nicht gestartet

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

Bestätigen Sie, dass das Repository in Ihren Admin-Einstellungen aufgelistet und aktiviert ist.
Überprüfen Sie die Review-Trigger-Einstellung. Wenn sie auf "Manuell" eingestellt ist, müssen Sie "@claude review" auf dem PR kommentieren, um eine Überprüfung zu starten.
Stellen Sie sicher, dass der PR kein Entwurf ist. Code Review wird nicht auf Entwurfs-PRs ausgeführt.
Überprüfen Sie, dass die Claude GitHub App in den Einstellungen Ihrer GitHub-Organisation immer noch 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)

Code Review erfordert derzeit Repositories, die auf github.com gehostet werden, daher wird selbstgehosteter GitHub Enterprise Server noch nicht 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.