Fehlerbehebung bei Code Review

Beheben Sie ein Code Review, das nicht gestartet wurde, fehlgeschlagen ist oder wegen des Budgets übersprungen wurde, finden Sie fehlende Befunde und lösen Sie Probleme bei der Einrichtung und mit REVIEW.md.

Wenn Code Review bei einem Pull Request nicht das tut, was Sie erwarten, beginnen Sie mit dem Check-Run Claude Code Review. Sein Titel gibt an, wie weit das Review gekommen ist.

Prüfen, wie weit das Review gekommen ist

Suchen Sie den Check-Run Claude Code Review in Ihrem Pull Request und ordnen Sie seinen Titel einem dieser häufigen Titel zu:

Ein Review wurde nicht gestartet

Prüfen Sie diese Fälle, wenn kein Check-Run Claude Code Review erscheint oder wenn Claude einen Kommentar postet, dass das Review übersprungen wurde.

Ein Kommentarbefehl hat kein Review gestartet

Nachdem Sie @claude review kommentiert haben, suchen Sie im Pull Request nach einem Check-Run Claude Code Review mit dem Titel Code review queued... oder Code review in progress.... Eine 👀-Reaktion auf Ihren Kommentar bestätigt nicht, dass ein Review folgt. Wenn kein Check-Run erscheint, prüfen Sie jede dieser Ursachen:

• Code Review ist für dieses Repository nicht aktiviert: Claude postet als Antwort auf den Befehl weder einen Kommentar noch einen Check-Run. Bitten Sie einen Owner, das Repository hinzuzufügen.
• Der Kommentar erfüllt eine Bedingung nicht: Es handelte sich um einen Inline-Kommentar oder einen Review-Text statt um einen neuen Kommentar auf oberster Ebene, oder der Befehl stand nicht am Anfang des Kommentars. Das Bearbeiten eines früheren Kommentars statt des Postens eines neuen zählt ebenfalls nicht, und der Pull Request muss offen sein. Lesen Sie die Bedingungen für Kommentarbefehle und posten Sie einen neuen Kommentar, der sie erfüllt.
• Sie haben keinen Schreibzugriff: Sie benötigen die Berechtigung write, maintain oder admin für das Repository. Bei einem Pull Request aus einem Fork zählt die Berechtigung für das Basis-Repository. Sofern der Pull Request nicht Ihr eigener ist, kann Claude mit einem Tipp antworten: „No review was started: manual reviews can only be requested by someone with write access to this repository.“ Bitten Sie stattdessen jemanden mit Schreibzugriff, den Kommentar zu verfassen.
• Das Budget ist aufgebraucht: Claude postet einen Kommentar, der mit „⚠️ Code review skipped“ beginnt. Lesen Sie Das Review wurde nicht ausgeführt und der PR zeigt eine Budgetmeldung.

Das Review wurde nicht ausgeführt und der PR zeigt eine Budgetmeldung

Wenn das Budget Ihrer Organisation ein Review nicht abdecken kann, überspringt Code Review das Review, und Claude postet im Pull Request einen Kommentar, der mit „⚠️ Code review skipped“ beginnt. In einigen dieser Fälle erscheint außerdem ein Check-Run mit dem Titel Code review declined.

Der Kommentar verlinkt auf claude.ai/admin-settings/usage, wo ein Admin das Budget wiederherstellt. Sein Wortlaut gibt an, welches Limit erreicht wurde:

• „has reached its monthly code review spending cap“: Das monatliche Ausgabenlimit für Code Review wurde erreicht. Reviews werden zu Beginn des nächsten Abrechnungszeitraums fortgesetzt. Um sie früher zu erhalten, bitten Sie einen Admin, das Limit zu erhöhen.
• „has no extra usage available to pay for this review“: Das Nutzungsguthaben Ihrer Organisation ist aufgebraucht, oder ihr allgemeines monatliches Ausgabenlimit wurde erreicht. Bitten Sie einen Admin, Nutzungsguthaben hinzuzufügen oder dieses Limit zu erhöhen.
• „is too low to start another review“: Der verbleibende Teil des Budgets oder Guthabens ist geringer als die erwarteten Kosten eines Reviews. Bitten Sie einen Admin, das Limit zu erhöhen oder Nutzungsguthaben hinzuzufügen.

Nachdem das Budget wiederhergestellt wurde, kommentieren Sie @claude review im Pull Request, um das übersprungene Review zu erhalten. Es gelten die Bedingungen für Kommentarbefehle, daher benötigt die kommentierende Person Schreibzugriff.

Ein fehlgeschlagenes oder abgelaufenes Review erneut auslösen

Wenn die Zusammenfassung des Check-Runs „The review session was interrupted before it could finish. A new review of this commit has been queued automatically.“ lautet, müssen Sie nichts tun. Dieses Review wird automatisch einmal wiederholt.

Andernfalls, wenn der Titel des Check-Runs Code review failed oder Code review timed out lautet, führen Sie das Review mit einem Kommentar oder einer erneuten Ausführung noch einmal aus:

• @claude review kommentieren: Posten Sie dies als Kommentar auf oberster Ebene im Pull Request. Dadurch wird ein neues Review gestartet, ohne den Pull Request für zukünftige Pushes zu abonnieren.
• Auf Re-run klicken: Wenn der Pull Request nicht aus einem Fork stammt, klicken Sie im Tab Checks von GitHub beim Check Claude Code Review auf Re-run. Die erneute Ausführung umfasst den aktuellen Head-Commit des Pull Requests und abonniert den Pull Request ebenfalls nicht.

Probleme finden, die nicht als Inline-Kommentare angezeigt werden

Wenn der Titel des Check-Runs besagt, dass Probleme gefunden wurden, Sie aber keine Inline-Review-Kommentare im Diff sehen, suchen Sie an diesen anderen Stellen, an denen Befunde angezeigt werden:

• Details des Check-Runs: Klicken Sie im Tab Checks neben dem Check Claude Code Review auf Details. Die Schweregradtabelle listet Befunde mit Datei, Zeile und Zusammenfassung auf, unabhängig davon, ob der Inline-Kommentar angenommen wurde.
• Anmerkungen unter Files changed: Öffnen Sie im PR den Tab Files changed. Ein Befund, der eine Zeile hat, aber nicht als Inline-Kommentar gepostet wurde, erscheint dort als Anmerkung an den betroffenen Zeilen.
• Review-Text: Befunde ohne Inline-Position oder außerhalb des aktuellen Diffs erscheinen im Review-Text unter der Überschrift Additional findings.

Der Check-Run erwähnt REVIEW.md

Dies sind vier der Meldungen, die ein Check-Run zu REVIEW.md enthalten kann:

• „This review applied the repository's review instructions (REVIEW.md) from its default branch, which is not protected against direct pushes.“: Das Review hat nur die Datei im Stammverzeichnis gelesen. Unter Aus welchem Branch REVIEW.md gelesen wird erfahren Sie, was sich durch das Schützen des Branches ändert.
• „were not applied to this review: branch protection could not be confirmed“: Das Review hat keine REVIEW.md gelesen.
• „they link to a file this pull request modifies, or carry more links than the review checks“: Das Review hat die REVIEW.md im Stammverzeichnis übersprungen oder die in der Meldung angegebene Anzahl von REVIEW.md-Dateien in Unterverzeichnissen. Prüfen Sie die übersprungene Datei auf jede der folgenden Ursachen. Prüfen Sie bei der REVIEW.md im Stammverzeichnis auch die Dateien, die sie einbindet:
  • Zu viele Links: Die Datei enthält mehr als 64 Markdown-Links. Reduzieren Sie die Links auf 64 oder weniger.
  • Ein Link, den das Review nicht parsen kann: Die Datei enthält einen fehlerhaften Markdown-Link. Korrigieren oder entfernen Sie den Link.
  • Ein Link auf eine geänderte Datei: Die Datei verlinkt auf eine Datei oder einen Ordner, die bzw. den dieser Pull Request ändert, und das Review konnte nicht nur die Zeilen mit diesem Link auslassen. Schreiben Sie die Regel direkt in REVIEW.md.
• „include line(s) in the root REVIEW.md were skipped on this review“: Ihre REVIEW.md im Stammverzeichnis wurde angewendet, die in diesen Zeilen genannten Dateien jedoch nicht. Prüfen Sie die Listen unter Andere Dateien in REVIEW.md einbinden und bei einem Skill auch unter Eine Skill-Datei einbinden.

Probleme bei der Einrichtung

Diese Fälle treten für einen Owner beim Einrichten von Code Review auf.

Ein Repository wird unter Add a repository nicht aufgeführt

Suchen Sie zuerst nach dem Namen des Repositorys, da der Dialog eine lange Liste nicht vollständig lädt. Der Dialog führt ein Repository nur auf, wenn die Claude GitHub App darauf zugreifen kann. Klicken Sie auf Install GitHub App und gewähren Sie der App Zugriff auf das Repository. Wenn keine Repositorys aufgeführt sind, ist Install GitHub App eine Schaltfläche im Dialog. Andernfalls befindet es sich unten im Filtermenü für GitHub-Organisationen des Dialogs.

Im Test-Pull-Request erscheint kein Check-Run

Vergewissern Sie sich, dass Allow code review aktiviert ist, dass das Repository im Abschnitt Code review unter Repositories aufgeführt ist und dass die Claude GitHub App Zugriff darauf hat. Automatische Reviews überspringen Pull Requests im Entwurfsstatus, und ein Repository, das auf Manual (@claude review) eingestellt ist, benötigt einen @claude review-Kommentar, um das erste Review zu starten.

Verwandte Ressourcen

• Reviews in einem Pull Request lesen und anfordern: was die Befunde und der Check-Run bedeuten sowie die Kommentarbefehle
• Code Review einrichten: für Owner, Code Review aktivieren und Repositorys verwalten
• Kosten und Nutzung von Code Review: die Ausgabenlimits hinter einer Budgetmeldung
• Code Review anpassen: welche Kopie von REVIEW.md ein Review liest