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 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.
Funktionsweise von Code Review
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 Problemklasse, dann überprüft ein Verifizierungsschritt die Ergebnisse anhand des tatsächlichen Codeverhaltens, um falsch positive Ergebnisse auszufiltern.
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 erweiterten Reasoning-Bereich, in dem Sie sehen können, 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 Bereich 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
Review-Trigger wählen
Nach dem Setup zeigt der Bereich 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 in 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 steuern, was es kennzeichnet. Beide sind zusätzlich zu den standardmäßigen Korrektheitsprüfungen.
CLAUDE.md
Code Review liest die CLAUDE.md-Dateien deines Repositorys und behandelt neu eingeführte Verstöße als Nit-Level-Erkenntnisse. Wenn dein 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 deiner Verzeichnishierarchie, daher gelten Regeln in der CLAUDE.md eines Unterverzeichnisses nur für Dateien unter diesem Pfad.
REVIEW.md
Füge eine REVIEW.md-Datei zum Stammverzeichnis deines Repositorys hinzu, um überprüfungsspezifische Regeln zu definieren. Verwende 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 im Stammverzeichnis des Repositorys automatisch. 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 Komplexität der Codebasis und der Anzahl der Probleme, die eine Überprüfung erfordern.
Die Code Review-Nutzung wird separat über Nutzungsguthaben abgerechnet und zählt nicht gegen die in deinem Plan enthaltene Nutzung. Der von dir 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 deiner Anthropic-Rechnung, unabhängig davon, ob deine Organisation AWS Bedrock oder Google Vertex AI für andere Claude Code-Funktionen nutzt.
Um eine monatliche Ausgabenbegrenzung festzulegen, gehe zu Organisationseinstellungen > Nutzung und konfiguriere das Limit für den Claude Code Review-Dienst.
Überwache die Ausgaben über das wöchentliche Kostendiagramm im Analytics-Dashboard oder die durchschnittliche Kostenspalte pro Repository in den Administratoreinstellungen.
Nutzung anzeigen
Gehe zum Code Review Analytics-Dashboard, um die Aktivität in deiner 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 du die Claude GitHub-App installiert hast, aber deine Repositories nicht im Admin-Panel angezeigt werden:
Bestätige, dass die Claude GitHub-App Zugriff auf die Repositories hat, die du erwartest. Gehe zu den Einstellungen deiner GitHub-Organisation, suche die Claude GitHub-App unter Installierte GitHub-Apps und überprüfe, ob sie Zugriff auf alle Repositories oder nur auf ausgewählte hat.
Wenn deine Organisation GitHub Enterprise Cloud mit Enterprise Managed Users (EMU) nutzt, autorisiere Claude, während du mit deinem verwalteten Konto angemeldet bist und eine aktive SSO-Sitzung hast. Es gibt keinen separaten Genehmigungsschritt auf Unternehmensebene.
Versuche, dein GitHub-Konto in Claude zu trennen und erneut zu verbinden. Gehe zu Anpassen > Connectors, trenne GitHub und verbinde es erneut. Welche Repositories die App aufrufen kann, wird auf GitHub-Seite verwaltet und ist in Schritt 1 abgedeckt.
Wenn das Problem weiterhin besteht, kontaktiere unser Support-Team mit deinem 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 keine Check-Run angezeigt wird:
Bestätige, dass das Repository in deinen Administratoreinstellungen aufgelistet und aktiviert ist.
Überprüfe die Einstellung für den Überprüfungs-Trigger. Wenn sie auf „Manuell
Stelle sicher, dass der PR kein Entwurf ist. Code Review wird nicht bei Entwurfs-PRs ausgeführt.
Überprüfe, dass die Claude GitHub-App in den Einstellungen deiner GitHub-Organisation immer noch Zugriff auf das Repository hat.
GitHub Enterprise Cloud mit IP-Einschränkungen
Wenn deine GitHub Enterprise Cloud-Organisation den Zugriff nach IP-Adresse einschränkt, kann die Claude GitHub-App möglicherweise nicht auf deine Repositories zugreifen. Um dies zu beheben, aktiviere die IP-Zulassungslisten-Vererbung für installierte GitHub-Apps in deinen 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 deiner 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-Flow 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. GitHub Enterprise Cloud mit Datenresidenz (.ghe.com) wird ebenfalls unterstützt. Ein Owner folgt dem GitHub Enterprise Server Admin-Setup und gibt den
ghe.com-Hostnamen ein.
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.
Verwandte Ressourcen
Plugins — Durchsuche den Plugin-Marketplace, einschließlich eines Code-Review-Plugins zum Ausführen von On-Demand-Überprüfungen lokal vor dem Push.
GitHub Actions — Führen Sie Claude in Ihren eigenen GitHub Actions-Workflows für benutzerdefinierte Automatisierung über Code Review hinaus aus.
GitLab CI/CD — Selbst gehostete Claude-Integration für GitLab-Pipelines.
