Skip to main content
/code-review ist ein Befehl, den Sie in der Claude Code-Eingabe eingeben, und zwar in der Sitzung, in der Sie arbeiten. Claude prüft die Änderungen auf Ihrem Branch, sucht nach Korrektheitsfehlern und berichtet die Ergebnisse in Ihrer Konversation. Abhängig von Ihrem Modell und Ihrer Effort-Stufe deckt das Review auch Bereinigungen in Bezug auf Wiederverwendung, Vereinfachung und Effizienz ab. Der Befehl funktioniert mit jedem Plan. Das Review läuft in Ihrer eigenen Sitzung und wird daher genauso wie der Rest der Sitzung auf die Nutzung Ihres Plans oder die API-Abrechnung angerechnet.
Wenn jeder Pull Request in einem Repository auf GitHub automatisch geprüft werden soll, lesen Sie Code Review, einen verwalteten Dienst, den ein Owner für Ihre Organisation aktiviert.
/review ist ein Alias von /code-review. Vor v2.1.223 war /review ein separater Befehl, der ein einstufiges, nur lesendes Review eines GitHub-Pull-Requests ausführte.
1

/code-review ausführen

Führen Sie den Befehl aus:
Ohne Ziel umfasst das Review die Änderungen auf Ihrem aktuellen Branch. Um das Review stattdessen auf einen Pull Request, einen anderen Branch, einen Pfad oder einen Bereich von Commits zu richten, lesen Sie Festlegen, was geprüft wird.Sie können auch Flags hinzufügen:
  • --fix: fordert Claude zusätzlich auf, die Ergebnisse nach dem Review auf Ihren Arbeitsbaum anzuwenden. Die Bearbeitungen durchlaufen Ihren Berechtigungsmodus.
  • --comment: veröffentlicht die Ergebnisse in einem GitHub-Pull-Request als Inline-Kommentare oder in einem GitLab Merge Request als einzelne Notiz
2

Weiterarbeiten

Das Review läuft als Subagent im Hintergrund mit eigenem Kontextfenster und füllt daher Ihre Konversation nicht. Die Ergebnisse erscheinen in Ihrer Konversation, sobald das Review abgeschlossen ist.
3

Auf die Ergebnisse reagieren

Bitten Sie Claude, die im Review gefundenen Probleme zu beheben. Mit --fix oder --comment wendet Claude die Ergebnisse im Rahmen des Reviews an oder veröffentlicht sie, und Sie werden möglicherweise gebeten, die Bearbeitungen zu genehmigen.

​
Festlegen, was geprüft wird

Um etwas anderes als Ihren aktuellen Branch zu prüfen, geben Sie nach der Effort-Stufe und etwaigen Flags ein Ziel ein. Claude erhält diesen Text als Review-Ziel. Ein Ziel kann eine Pull-Request-Nummer, ein Branch-Name, ein Dateipfad oder ein Git-Revisionsbereich sein. Suchen Sie in der ersten Spalte, was Sie prüfen lassen möchten, und geben Sie ein, was die zweite Spalte zeigt: Ohne Ziel prüft /code-review die Commits Ihres Branches, die seinem Upstream-Branch voraus sind, sowie Ihre nicht committeten Änderungen. Wenn der Branch keinen Upstream hat, vergleicht Claude mit main oder mit dem vorherigen Commit. Mit ultra liest Claude Code das Ziel anders, wie unter Text nach der Effort-Stufe und den Flags beschrieben.

​
Was das Review liest und bearbeitet

Prüfen Sie Folgendes, bevor Sie ein Review ausführen, insbesondere mit --fix:
  • Bearbeitungen: Ohne --fix fordern die Anweisungen des Reviews Claude nur zu einem Bericht auf. Mit --fix fordern sie Claude zusätzlich auf, die Ergebnisse auf Ihren Arbeitsbaum anzuwenden. In beiden Fällen durchläuft jede Bearbeitung Ihren Berechtigungsmodus.
  • Zurückspulen: Ein Review im Hintergrund wendet seine --fix-Bearbeitungen außerhalb der Checkpoints Ihrer Sitzung an. Danach stellt /rewind nur die Dateien wieder her, die Claude bereits in Ihrer Konversation bearbeitet hatte. Die Bearbeitungen des Reviews an anderen Dateien bleiben bestehen; verwenden Sie Git, um sie rückgängig zu machen. Wenn das Review im Vordergrund läuft, bearbeitet es Ihren Arbeitsbaum während Ihres eigenen Turns, sodass /rewind seine Bearbeitungen wie gewohnt wiederherstellt.
  • Anweisungen: Das Review folgt Ihrer CLAUDE.md, auch in einem nicht interaktiven -p-Lauf. Es liest REVIEW.md nicht. Diese Datei konfiguriert den verwalteten Code Review-Dienst für GitHub-Pull-Requests.

​
Wie Ergebnisse gemeldet werden

Claude meldet die Ergebnisse in beiden der folgenden Läufe als Text in der Antwort:
  • In einer Terminal-Sitzung, in der /code-review das Review als abgezweigten Subagenten ausführt
  • In einem -p-Lauf mit Text- oder JSON-Ausgabe
In einer Host-Anwendung, die die Ergebnisliste anfordert, etwa der Desktop-App, meldet Claude die Ergebnisse des Reviews stattdessen über das ReportFindings-Tool. Der Bericht erscheint als Ergebnisliste, und jeder Eintrag zeigt den Speicherort in der Datei, eine Zusammenfassung in einem Satz und eine Kategorie-Kennzeichnung wie correctness, sofern das Ergebnis eine besitzt. Eine Anfrage des Hosts gilt auf jeder Effort-Stufe und erfordert Claude Code v2.1.218 oder höher. Wenn Claude gemeldete Ergebnisse später in der Sitzung behebt, meldet es sie erneut. Claude Code markiert dann jedes Ergebnis in der aktualisierten Ergebnisliste als behoben, übersprungen oder keine Änderung erforderlich.

​
Effort und Argumente anpassen

Neben --fix und --comment akzeptiert der Befehl folgende Flags:
  • --post: wählt bei einem ultra-Cloud-Review eines github.com-Pull-Requests im Startdialog das Veröffentlichen der fertigen Ergebnisse im PR vorab aus. Siehe Ergebnisse im Pull Request veröffentlichen. Erfordert Claude Code v2.1.227 oder höher.
  • --max-findings <n>, --max-findings all oder --max-findings default: meldet bis zu n Ergebnisse oder mit all jedes Ergebnis, anstelle des üblichen Limits des Reviews. Wo das Review über das Ergebnis-Tool berichtet, liegt das Limit bei 32. Spätere Reviews verwenden den eingegebenen Wert erneut, bis Sie --max-findings default übergeben; ein in einem nicht interaktiven -p-Lauf übergebener Wert wird jedoch nicht gespeichert. Erfordert Claude Code v2.1.288 oder höher.
Übergeben Sie eine Effort-Stufe, um zwischen Abdeckung und Sicherheit abzuwägen. Bei low meldet das Review die Ergebnisse, bei denen es am sichersten ist, sodass Sie weniger Fehlalarme sehen. Von medium bis max erweitert das Review die Abdeckung. Wenn Sie keine Stufe eingeben, verwendet das Review die zuletzt von Ihnen eingegebene Stufe von low bis max erneut, auch aus einer früheren Sitzung. Claude Code zeigt einen Hinweis wie Reusing high effort, the level you typed last time an. Diese Regeln bestimmen, welche Stufe ein Lauf verwendet:
  • Eingeben einer Stufe: Eine von Ihnen eingegebene Stufe wie /code-review high ändert, was spätere Läufe erneut verwenden
  • Nicht interaktive Läufe: Eine Stufe, die Sie in einem nicht interaktiven -p-Lauf übergeben, aktualisiert die gespeicherte Stufe nicht
  • ultra: Das Review verwendet die gespeicherte Stufe weder, noch aktualisiert es sie
  • Nie eine Stufe eingegeben: Das Review verwendet den aktuellen Effort der Sitzung
Vor v2.1.223 verwendete ein /code-review ohne Stufe immer den aktuellen Effort der Sitzung.

​
Ergebnisse in einem GitLab Merge Request veröffentlichen

Wenn Sie --comment für einen GitLab Merge Request übergeben, veröffentlicht Claude Code die Ergebnisse über die glab-CLI von GitLab. Erfordert Claude Code v2.1.257 oder höher. Wenn glab nicht installiert ist, gibt Claude die Ergebnisse stattdessen im Terminal aus. Übergeben Sie den Merge Request als URL oder als !123-Referenz. Claude Code behandelt eine bloße Nummer oder einen Branch-Namen nur dann als Merge Request, wenn der Origin des Checkouts auf gitlab.com liegt. Übergeben Sie bei einer selbstverwalteten GitLab-Instanz die URL oder die Form !123.

​
Text nach der Effort-Stufe und den Flags

Nach der Effort-Stufe und den Flags liest Claude Code den Rest der Zeile als Review-Ziel. Das Argument ultra ändert diese Lesart:
  • Mit ultra: Claude Code liest ein einzelnes Wort als Basis-Branch oder PR-Nummer. Längerer Text, der keinen Branch und keinen PR benennt, wird zu einer Notiz, die dem Review beigefügt wird. /code-review ultra check my auth changes prüft Ihren aktuellen Branch, und Claude bezieht die Ergebnisse auf Ihre Notiz.
  • Ohne ultra: Alles Übrige ist das Review-Ziel, auch wenn es mit einem anderen Befehlsnamen beginnt. /code-review /fix-issue 123 prüft mit /fix-issue 123 als Zieltext, anstatt /fix-issue als zweiten gestapelten Skill zu laden. Vor v2.1.218 wurde ein nach /code-review gestapelter Befehl als eigener Skill expandiert.

​
Im Vordergrund ausführen

Um das Review im Vordergrund auszuführen, wählen Sie eine der folgenden Möglichkeiten:
  • Führen Sie es im nicht interaktiven Modus aus, mit dem -p-Flag oder dem Agent SDK. Claude Code wartet auf das Review und nimmt die Ergebnisse in die Antwort auf, außer bei ultra, das nicht auf das Cloud-Review wartet.
  • Setzen Sie CLAUDE_CODE_DISABLE_BACKGROUND_TASKS auf 1, was auch alle anderen Funktionen für Hintergrundaufgaben deaktiviert
  • Führen Sie /code-review erneut aus, während ein früheres Review noch läuft
Vor v2.1.218 lief das Review innerhalb Ihrer Konversation.

​
Claude das Review starten lassen

Claude kann /code-review selbstständig starten, ohne dass Sie den Befehl eingeben:
  • Wenn Sie in natürlicher Sprache fragen: Bitten Sie Claude, Ihre Änderungen zu prüfen, und es kann den Skill ausführen
  • Aus einer geplanten Aufgabe: Eine geplante Aufgabe mit /code-review als Prompt führt das Review aus
Eine geplante Aufgabe startet niemals das Cloud-Review; planen Sie /code-review daher ohne das Argument ultra. Um zu verhindern, dass Claude und geplante Aufgaben das Review starten, während /code-review für Sie zur Eingabe verfügbar bleibt, fügen Sie einen skillOverrides-Eintrag zu einer Einstellungsdatei wie ~/.claude/settings.json hinzu:
Vor v2.1.246 startete Claude /code-review nur dann selbstständig, wenn ein von Anthropic abgerufenes Feature-Flag dies aktivierte. In Sitzungen, die keine Feature-Flags abrufen, lief /code-review nur, wenn Sie es eingaben, und ein geplantes /code-review erreichte Claude als reiner Text.

​
Zu Ultrareview eskalieren

/code-review ultra --fix führt das tiefergehende Ultrareview in der Cloud aus und fordert Claude anschließend auf, die Ergebnisse auf Ihren Arbeitsbaum anzuwenden, sobald sie in Ihrer Sitzung eintreffen. Ultrareview verwendet einen eigenen Umfang:
  • Was verglichen wird: Ihr aktueller Branch mit dem Standard-Branch des Repositorys, zuzüglich nicht committeter und gestagter Änderungen im Arbeitsbaum
  • Sensible Dateien: Bei nicht committeten Änderungen an Dateien, deren Namen auf Anmeldedaten oder Schlüssel hindeuten, etwa .env- und *.tfvars-Dateien, folgt Claude Code den Regeln für das Hochladen eines lokalen Repositorys in eine Cloud-Sitzung
  • Eine andere Basis: Übergeben Sie einen Branch-Namen wie /code-review ultra develop, um mit einer anderen Basis zu vergleichen
Wenn das Ziel ein github.com-Pull-Request ist, können Sie Claude die fertigen Ergebnisse im PR veröffentlichen lassen, als Kommentar von Ihrem GitHub-Konto. Erfordert Claude Code v2.1.227 oder höher.
Ultrareview erfordert die Authentifizierung mit einem claude.ai-Konto. Es ist nicht verfügbar auf Amazon Bedrock, Google Clouds Agent Platform oder Microsoft Foundry sowie nicht für Organisationen, bei denen Zero Data Retention aktiviert oder die HIPAA-Konfiguration angewendet ist. In diesen Fällen führt /code-review ultra stattdessen ein lokales Review in Ihrer Sitzung aus. Organisationen, die kundenverwaltete Verschlüsselungsschlüssel (CMEK) verwenden, können Ultrareview nicht ausführen. Um Ihre Änderungen lokal zu prüfen, führen Sie /code-review aus.
Um ein Cloud-Review aus einem Skript oder CI-Job auszuführen, verwenden Sie den claude ultrareview-Unterbefehl, der auf die Ergebnisse wartet und sie auf stdout ausgibt.

​
Das Review ändern oder darauf aufbauen

/code-review ist ein mitgelieferter Skill: Seine Anweisungen sind in Claude Code integriert, daher gibt es keine SKILL.md-Datei auf der Festplatte, die Sie öffnen oder bearbeiten könnten. Um jedem Review Projektregeln mitzugeben, fügen Sie diese zu Ihrer CLAUDE.md hinzu. Um weiter zu gehen, beginnen Sie mit einer dieser Seiten:
  • Den Befehl ersetzen: Ein Projekt- oder persönlicher Skill namens code-review läuft anstelle des mitgelieferten, und der Alias /review führt weiterhin das mitgelieferte Review aus. Siehe Skills mit gleichem Namen auflösen.
  • Eigenen Reviewer erstellen: Schreiben Sie einen Reviewer-Subagenten oder einen Review-Skill
  • Einen verwandten Befehl verwenden: /simplify prüft nur auf Bereinigungen und wendet seine Korrekturen an, und /verify führt Ihre App aus, um zu bestätigen, dass eine Änderung funktioniert
Der Befehl hieß vor v2.1.147 /simplify und wendete damals standardmäßig Korrekturen an. Wenn Sie /simplify zur Fehlersuche in Skripten verwendet haben, wechseln Sie zu /code-review --fix.
  • Code Review: der verwaltete Dienst, der jeden Pull Request auf GitHub für Ihre Organisation prüft
  • Ultrareview: Einrichtung, Limits und Kosten des tiefergehenden Cloud-Reviews
  • Befehle: die einzeilige Referenz für /code-review, /review, /simplify und /verify
  • Skills: wie mitgelieferte Skills funktionieren und wie Sie eigene schreiben