Was Sie zum Aktivieren von Code Review benötigen
Prüfen Sie zunächst, ob Ihre Organisation für Code Review infrage kommt. Stellen Sie dann sicher, dass Sie über die folgenden Zugriffsrechte verfügen oder jemanden haben, der sie besitzt:Code Review aktivieren
1
Auf den Schalter Allow code review klicken
Öffnen Sie den Abschnitt Code review unter Admin settings > Claude Code und klicken Sie auf den Schalter Allow code review.Wenn Code Review sofort ohne Dialog aktiviert wird, hat Ihre Organisation die Claude GitHub App bereits verknüpft oder Repositorys hinzugefügt. Fahren Sie mit Weitere Repositorys hinzufügen fort und kehren Sie dann für den letzten Schritt zurück.
2
Ihr GitHub-Konto verbinden
Wenn sich ein Dialog Connect GitHub öffnet, klicken Sie auf Connect. Wenn Ihre Organisation GitHub Enterprise Server verwendet, wählen Sie zuerst Ihre Instanz im Dialog aus. GitHub fordert Sie auf, Claude zu autorisieren, und leitet Sie dann zur Admin-Seite zurück, auf der der Dialog Add a repository geöffnet ist.Wenn sich Add a repository direkt geöffnet hat, ist Ihr Konto bereits verbunden. Fahren Sie in diesem Fall mit dem nächsten Schritt fort.
3
Die Claude GitHub App installieren
Wenn die gewünschten Repositorys im Dialog Add a repository aufgeführt sind oder Sie sie dort über die Suche finden, fahren Sie mit dem nächsten Schritt fort. Der Dialog listet ein Repository nur auf, wenn die Claude GitHub App darauf zugreifen kann. Wenn die Repositorys also nicht angezeigt werden, installieren Sie die App:
- Klicken Sie auf Install GitHub App. Wenn keine Repositorys aufgeführt sind, ist dies eine Schaltfläche im Dialog. Andernfalls befindet sie sich unten im Filtermenü für GitHub-Organisationen im Dialog. Die Installationsseite von GitHub öffnet sich in einem neuen Tab.
- Wählen Sie die GitHub-Organisation aus, der die Repositorys gehören.
- Wählen Sie aus, auf welche Repositorys die App zugreifen kann.
- Bestätigen Sie die angeforderten Berechtigungen. Der Berechtigungsumfang ist größer, als ein Review ihn benötigt, und wird von anderen Claude-Funktionen wie GitHub Actions mitgenutzt. Siehe worauf ein Review zugreifen kann und die vollständige Liste der Berechtigungen.
- Wenn die Installation abgeschlossen ist, kehrt der Tab zu Claude zurück. Wenn dort eine Schaltfläche Finish connecting GitHub angezeigt wird, klicken Sie darauf, um die Installation mit Ihrer Claude-Organisation zu verknüpfen.
- Wechseln Sie zurück zum Tab der Admin-Seite, wo die Liste im Dialog aktualisiert wird.
4
Repositorys auswählen
Wählen Sie die Repositorys aus, die überprüft werden sollen, und klicken Sie dann auf Continue. Zum Hinzufügen eines Repositorys benötigt das verbundene GitHub-Konto Schreibzugriff darauf. Sie können später weitere Repositorys hinzufügen.
5
Auf Finish klicken
Anschließend erscheint ein Dialog Code review is set up. Klicken Sie auf Finish, um Code Review zu aktivieren. Wenn Sie den Dialog auf andere Weise schließen, bleiben Ihre Repositorys hinzugefügt, aber Allow code review bleibt ausgeschaltet, und Sie aktivieren es über den Schalter.Jedes Repository ist anfangs so eingestellt, dass nach jedem Push ein Review erfolgt, was die meisten Reviews auslöst. Um weniger Reviews auszuführen, legen Sie fest, wann Reviews ausgeführt werden.
6
Mit einem Test-Pull-Request überprüfen
Öffnen Sie einen Test-Pull-Request in einem der hinzugefügten Repositorys und markieren Sie ihn nicht als Entwurf. Innerhalb weniger Minuten erscheint ein Check-Run namens Claude Code Review. Wenn Sie das Repository bereits auf Manual (@claude review) eingestellt haben, kommentieren Sie
@claude review im Pull Request, um das erste Review zu starten.Wenn kein Check-Run erscheint, siehe Kein Check-Run erscheint im Test-Pull-Request.Sobald das Review vorliegt, senden Sie Ihren Entwicklern Reviews in einem Pull Request lesen und anfordern. Dort werden die Schweregrade, die Kommentarbefehle und der Umgang mit Befunden erläutert.Standardwerte für Ihre Organisation festlegen
Als Owner entscheiden Sie, wie gründlich Reviews sind und wie oft sie ausgeführt werden. Beides finden Sie im Abschnitt Code review unter Admin settings > Claude Code.Standard-Review-Level festlegen
Das Review-Level bestimmt, wie gründlich jedes Review ist, und ein gründlicheres Review kostet mehr. Sie legen einen Standardwert für die Organisation fest und können ihn für einzelne Repositorys überschreiben.- Organisationsstandard: Wählen Sie unter Review level ein Level aus und bestätigen Sie mit Change level. Jedes Repository verwendet dieses Level, sofern Sie dem Repository kein eigenes zuweisen.
- Ein einzelnes Repository: Klicken Sie in der Zeile des Repositorys auf Edit und wählen Sie dort ein Review level aus. Die erste Option, Default, folgt der Organisation. Das Level wird gespeichert, sobald Sie es auswählen.
Festlegen, wann Reviews ausgeführt werden
Jedes Repository hat eine eigene Einstellung Review runs, die bestimmt, wann seine Pull Requests überprüft werden.- Once after PR creation: Ein Review wird ausgeführt, wenn ein Pull Request geöffnet, erneut geöffnet oder als bereit für das Review markiert wird
- After every push: Ein Review wird bei Pushes auf den Pull-Request-Branch ausgeführt. So werden neue Probleme erkannt, während sich der Pull Request weiterentwickelt, und Threads werden automatisch aufgelöst, wenn Sie gekennzeichnete Probleme beheben
- Manual (@claude review): Das Öffnen eines Pull Requests oder ein Push darauf startet kein Review. Kommentieren Sie
@claude review, um eines anzufordern, oder@claude review always, um den Pull Request zusätzlich für Reviews bei nachfolgenden Pushes zu abonnieren.
- Entwürfe und Pull Requests aus Forks: Unabhängig von der gewählten Option überspringen automatische Reviews beide
- Neue Repositorys: Ein Repository, das Sie über den Dialog Add a repository hinzufügen, startet mit After every push. Wenn seine GitHub-Organisation als Ganzes abgedeckt ist, übernimmt es stattdessen die Einstellung aus der Zeile dieser Organisation.
Hinweiskommentare ein- oder ausschalten
Ein Hinweiskommentar ist ein kurzer Kommentar, den Claude in einem Pull Request veröffentlicht, wenn kein Review startet, und der erklärt, warum und was als Nächstes zu tun ist. Show tips on pull requests ist standardmäßig eingeschaltet. Wenn die Einstellung aktiviert ist, veröffentlicht Claude in jedem der folgenden Fälle einen Hinweis und erklärt:- Das Repository ist auf Manual eingestellt: wie ein Review per Kommentar angefordert wird
- Der Pull Request stammt aus einem Fork: dass ein Maintainer das Review anfordern kann
- Ein Bot oder jemand ohne Schreibzugriff kommentiert
@claude review: dass kein Review gestartet wurde und wer eines anfordern kann - Die GitHub-Organisation ist nicht mit Ihrer Claude-Organisation verknüpft: dass Reviews pausiert sind und wie die Verknüpfung hergestellt wird
Was Entwickler ändern können
Entwickler wenden sich an Sie, um das Review-Level, die Einstellung Review runs oder die Auswahl der Repositorys mit Reviews zu ändern. Über GitHub können sie ohne die Owner-Rolle Folgendes tun:- Ein Review anfordern:
@claude reviewin einem Pull Request kommentieren. Dies erfordert Schreibzugriff auf das Repository und funktioniert auch bei Entwürfen und Pull Requests aus Forks, die automatische Reviews überspringen. - Einen Pull Request für ein Review bei jedem Push abonnieren:
@claude review alwaysin einem Pull Request kommentieren, der kein Entwurf ist und nicht aus einem Fork stammt, etwa in einem Repository, das auf Manual eingestellt ist - Ändern, was Reviews kennzeichnen:
REVIEW.md- undCLAUDE.md-Dateien in das Repository committen, zum Beispiel um eine Prüfung hinzuzufügen
Repositorys verwalten
Sie können Repositorys einzeln hinzufügen oder eine ganze GitHub-Organisation auf einmal abdecken und Reviews überall dort beenden, wo Sie sie nicht möchten.Weitere Repositorys hinzufügen
Um nach der Einrichtung Repositorys hinzuzufügen, klicken Sie im Abschnitt Code review oberhalb der Tabelle Repositories auf Add. Der Dialog Add a repository öffnet sich. Wählen Sie Repositorys aus und klicken Sie auf Continue.- Ein Repository wird nicht aufgeführt: siehe Ein Repository wird in Add a repository nicht aufgeführt.
- Sie möchten alle Repositorys einer GitHub-Organisation: Decken Sie die Organisation ab, statt Repositorys einzeln auszuwählen
Eine ganze GitHub-Organisation abdecken
Um Code Review für alle Repositorys einer GitHub-Organisation zu aktivieren, legen Sie Review runs in der Zeile der Organisation in der Tabelle Repositories fest. Damit wird jedes Repository dort abgedeckt, auf das die Claude GitHub App zugreifen kann, einschließlich später hinzugefügter Repositorys. Dies kann die Ausgaben erheblich erhöhen. Dafür müssen alle folgenden Voraussetzungen erfüllt sein:- Das GitHub-Konto, das Sie mit Claude verbunden haben, ist Owner dieser GitHub-Organisation.
- Die Organisation befindet sich auf github.com. Instanzen von GitHub Enterprise Server und persönliche GitHub-Konten kommen nicht infrage.
- Ein monatliches Ausgabenlimit ist festgelegt, entweder für Ihre Claude-Organisation oder für Code Review.
- Abdeckung: Jedes Repository wird ab seinem nächsten Pull Request abgedeckt. Wenn die Claude GitHub App nur für ausgewählte Repositorys statt für alle installiert wurde, überprüft Claude diese Repositorys. Ändern Sie den Repository-Zugriff der App auf GitHub, um die übrigen abzudecken.
- Bestehende Einstellungen: Jedes Repository in dieser GitHub-Organisation übernimmt die ausgewählte Option, einschließlich Repositorys, die Sie einzeln eingestellt hatten. Ein erneutes Festlegen der Zeile bewirkt dasselbe. Repositorys, die Sie in ihren eigenen Zeilen ausgeschaltet haben, bleiben ausgeschaltet.
- Spätere individuelle Änderungen: Ein Repository, das Sie später abweichend von seiner Organisation einstellen, wird in der Tabelle als Custom gekennzeichnet.
- Review-Level: Eine Organisationszeile hat kein eigenes Review-Level.
Code Review ausschalten oder ein Repository entfernen
Wählen Sie im Abschnitt Code review unter Admin settings > Claude Code das Steuerelement, das zu dem passt, was Sie beenden möchten:- Ein Repository, das in der Liste bleiben soll: Klicken Sie in seiner Zeile auf Edit und schalten Sie Code review aus. Die Tabelle zeigt das Repository als Off an.
- Ein Repository entfernen: Klicken Sie in seiner Zeile auf Edit und dann unten im Dialog auf Remove repository. Reviews werden dort beendet, und eine andere Claude-Organisation kann dieses Repository anschließend einrichten. Solange die GitHub-Organisation des Repositorys als Ganzes abgedeckt ist, können Sie es nicht entfernen. Schalten Sie stattdessen seinen Schalter Code review aus.
- Eine ganze GitHub-Organisation: Klicken Sie in der Zeile der Organisation auf Edit und wählen Sie Off. Dadurch werden auch Repositorys in dieser Organisation ausgeschaltet, die Sie einzeln hinzugefügt haben.
- Alles: Schalten Sie Allow code review aus. In keinem Repository starten neue Reviews, und Ihre Repository-Liste bleibt erhalten, sodass Sie die Funktion später wieder einschalten können.
Verwandte Ressourcen
- Kosten und Nutzung von Code Review: wie sich das Review-Level und der Zeitpunkt der Reviews auf die Ausgaben auswirken, wie Sie ein Ausgabenlimit festlegen und wo Sie die Nutzung einsehen
- Reviews in einem Pull Request lesen und anfordern: was Entwickler in einem Pull Request sehen und die Kommentarbefehle
- Code Review anpassen: mit
REVIEW.mdundCLAUDE.mdabstimmen, was Claude kennzeichnet - GitHub Enterprise Server: eine selbst gehostete GitHub-Instanz vor der Einrichtung verbinden