Skip to main content
/code-review adalah perintah yang Anda ketik di prompt Claude Code, dalam sesi tempat Anda bekerja. Claude meninjau perubahan di branch Anda, mencari bug kebenaran (correctness), dan melaporkan temuannya di percakapan Anda. Bergantung pada model dan tingkat effort Anda, review juga mencakup perapian terkait penggunaan ulang, penyederhanaan, dan efisiensi. Perintah ini berfungsi di paket apa pun. Review berjalan di sesi Anda sendiri, sehingga dihitung terhadap penggunaan paket Anda atau penagihan API dengan cara yang sama seperti bagian lain dari sesi tersebut.
Agar setiap pull request dalam repositori ditinjau secara otomatis di GitHub, lihat Code Review, layanan terkelola yang diaktifkan oleh Owner untuk organisasi Anda.
/review adalah alias dari /code-review. Sebelum v2.1.223, /review adalah perintah terpisah yang menjalankan review read-only satu kali terhadap pull request GitHub.
1

Jalankan /code-review

Jalankan perintah:
Tanpa target, review mencakup perubahan di branch Anda saat ini. Untuk mengarahkan review ke pull request, branch lain, path, atau rentang commit, lihat Pilih apa yang akan ditinjau.Anda juga dapat menambahkan flag:
  • --fix: juga meminta Claude menerapkan temuan ke working tree Anda setelah review. Suntingannya melewati mode izin Anda.
  • --comment: memposting temuan pada pull request GitHub sebagai komentar inline, atau pada merge request GitLab sebagai satu catatan
2

Lanjutkan bekerja

Review berjalan sebagai subagent latar belakang dengan context window-nya sendiri, sehingga tidak memenuhi percakapan Anda. Temuan muncul di percakapan Anda saat review selesai.
3

Tindak lanjuti temuan

Minta Claude memperbaiki apa yang ditemukan review. Dengan --fix atau --comment, Claude menerapkan atau memposting temuan sebagai bagian dari review, dan Anda mungkin diminta untuk menyetujui suntingannya.

​
Pilih apa yang akan ditinjau

Untuk meninjau sesuatu selain branch Anda saat ini, ketikkan target setelah tingkat effort dan flag apa pun. Claude menerima teks tersebut sebagai target review. Target dapat berupa nomor pull request, nama branch, path file, atau rentang revisi Git. Temukan apa yang ingin Anda tinjau di kolom pertama dan ketikkan apa yang ditunjukkan kolom kedua: Tanpa target, /code-review meninjau commit di branch Anda yang belum ada di branch upstream-nya (commit yang lebih baru dari upstream), ditambah perubahan Anda yang belum di-commit. Jika branch tidak memiliki upstream, Claude membandingkan terhadap main, atau terhadap commit sebelumnya. Dengan ultra, Claude Code membaca target secara berbeda, sebagaimana dijelaskan dalam Teks setelah tingkat effort dan flag.

​
Apa yang dibaca dan disunting review

Periksa hal-hal berikut sebelum Anda menjalankan review, terutama dengan --fix:
  • Suntingan: tanpa --fix, instruksi review hanya meminta laporan dari Claude. Dengan --fix, instruksi tersebut juga memintanya menerapkan temuan ke working tree Anda. Dalam kedua kasus, setiap suntingan melewati mode izin Anda.
  • Rewind: review latar belakang menerapkan suntingan --fix-nya di luar checkpoint sesi Anda. Setelah itu, /rewind hanya memulihkan file yang sudah disunting Claude di percakapan Anda. Suntingan review pada file lain tetap ada, jadi gunakan git untuk mengembalikannya. Ketika review berjalan di foreground, review menyunting working tree Anda selama giliran Anda sendiri, sehingga /rewind memulihkan suntingannya seperti biasa.
  • Instruksi: review mengikuti CLAUDE.md Anda, termasuk dalam eksekusi -p non-interaktif. Review tidak membaca REVIEW.md. File tersebut mengonfigurasi layanan Code Review terkelola pada pull request GitHub.

​
Cara temuan dilaporkan

Claude melaporkan temuan sebagai teks dalam balasan pada kedua eksekusi berikut:
  • Dalam sesi terminal, tempat /code-review menjalankan review sebagai subagent hasil fork
  • Dalam eksekusi -p dengan output teks atau JSON
Dalam aplikasi host yang meminta daftar temuan, seperti aplikasi desktop, Claude melaporkan temuan review melalui tool ReportFindings. Laporan muncul sebagai daftar temuan, dan setiap entri menampilkan lokasi file, ringkasan satu kalimat, dan tag kategori seperti correctness jika temuan memilikinya. Permintaan host berlaku di setiap tingkat effort dan memerlukan Claude Code v2.1.218 atau yang lebih baru. Ketika Claude memperbaiki temuan yang dilaporkan di kemudian hari dalam sesi, Claude melaporkannya lagi. Claude Code kemudian menandai setiap temuan dalam daftar temuan yang diperbarui sebagai diperbaiki, dilewati, atau tidak perlu perubahan.

​
Sesuaikan effort dan argumen

Selain --fix dan --comment, perintah ini menerima flag berikut:
  • --post: pada review cloud ultra terhadap pull request github.com, memilih terlebih dahulu opsi memposting temuan yang sudah selesai ke PR dalam dialog peluncuran. Lihat Posting temuan ke pull request. Memerlukan Claude Code v2.1.227 atau yang lebih baru.
  • --max-findings <n>, --max-findings all, atau --max-findings default: melaporkan hingga n temuan, atau setiap temuan dengan all, sebagai pengganti batas biasa review. Ketika review melapor melalui tool temuan, batasnya adalah 32. Review berikutnya menggunakan ulang nilai yang Anda ketik hingga Anda memberikan --max-findings default, tetapi nilai yang diberikan dalam eksekusi -p non-interaktif tidak diingat. Memerlukan Claude Code v2.1.288 atau yang lebih baru.
Berikan tingkat effort untuk menyeimbangkan cakupan dengan tingkat keyakinan. Pada low, review melaporkan temuan yang paling diyakininya, sehingga Anda melihat lebih sedikit false positive. Dari medium hingga max, review memperluas cakupannya. Ketika Anda tidak mengetik tingkat, review menggunakan ulang tingkat terakhir dari low hingga max yang Anda ketik, bahkan di sesi sebelumnya. Claude Code menampilkan pemberitahuan seperti Reusing high effort, the level you typed last time. Aturan berikut menentukan tingkat mana yang digunakan suatu eksekusi:
  • Mengetik tingkat: tingkat yang Anda ketik, seperti /code-review high, mengubah apa yang digunakan ulang oleh eksekusi berikutnya
  • Eksekusi non-interaktif: tingkat yang Anda berikan dalam eksekusi -p non-interaktif tidak memperbarui tingkat yang diingat
  • ultra: review tidak menggunakan maupun memperbarui tingkat yang diingat
  • Tidak pernah mengetik tingkat: review menggunakan effort sesi saat ini
Sebelum v2.1.223, /code-review tanpa tingkat selalu menggunakan effort sesi saat ini.

​
Posting temuan ke merge request GitLab

Ketika Anda memberikan --comment untuk merge request GitLab, Claude Code memposting temuan melalui CLI glab milik GitLab. Memerlukan Claude Code v2.1.257 atau yang lebih baru. Ketika glab tidak terinstal, Claude mencetak temuan di terminal sebagai gantinya. Berikan merge request sebagai URL-nya atau referensi !123. Claude Code memperlakukan angka atau nama branch saja sebagai merge request hanya jika origin checkout berada di gitlab.com. Pada instance GitLab yang dikelola sendiri, berikan bentuk URL atau !123.

​
Teks setelah tingkat effort dan flag

Setelah tingkat effort dan flag, Claude Code membaca sisa baris sebagai target review. Argumen ultra mengubah cara pembacaan tersebut:
  • Dengan ultra: Claude Code membaca satu kata sebagai base branch atau nomor PR. Teks yang lebih panjang yang tidak menyebut branch atau PR menjadi catatan yang dilampirkan ke review. /code-review ultra check my auth changes meninjau branch Anda saat ini, dan Claude mengaitkan temuan dengan catatan Anda.
  • Tanpa ultra: semua yang tersisa adalah target review, bahkan ketika diawali dengan nama perintah lain. /code-review /fix-issue 123 meninjau dengan /fix-issue 123 sebagai teks target alih-alih memuat /fix-issue sebagai skill bertumpuk kedua. Sebelum v2.1.218, perintah yang ditumpuk setelah /code-review diekspansi sebagai skill tersendiri.

​
Jalankan di foreground

Untuk membuat review berjalan di foreground, lakukan salah satu dari berikut ini:
  • Jalankan dalam mode non-interaktif, dengan flag -p atau Agent SDK. Claude Code menunggu review dan menyertakan temuan dalam respons, kecuali untuk ultra, yang tidak menunggu review cloud.
  • Atur CLAUDE_CODE_DISABLE_BACKGROUND_TASKS ke 1, yang juga mematikan setiap fitur tugas latar belakang lainnya
  • Jalankan /code-review lagi saat review sebelumnya masih berlangsung
Sebelum v2.1.218, review berjalan di dalam percakapan Anda.

​
Biarkan Claude memulai review

Claude dapat memulai /code-review sendiri, tanpa Anda mengetik perintahnya:
  • Saat Anda meminta dengan bahasa biasa: minta Claude meninjau perubahan Anda dan Claude dapat menjalankan skill tersebut
  • Dari tugas terjadwal: tugas terjadwal dengan /code-review sebagai prompt-nya menjalankan review
Tugas terjadwal tidak pernah meluncurkan review cloud, jadi jadwalkan /code-review tanpa argumen ultra. Untuk mencegah Claude maupun tugas terjadwal memulai review sambil tetap membiarkan /code-review tersedia untuk Anda ketik, tambahkan entri skillOverrides ke file pengaturan seperti ~/.claude/settings.json:
Sebelum v2.1.246, Claude memulai /code-review sendiri hanya jika feature flag yang diambil dari Anthropic mengaktifkannya. Dalam sesi yang tidak mengambil feature flag, /code-review hanya berjalan saat Anda mengetiknya, dan /code-review terjadwal sampai ke Claude sebagai teks biasa.

​
Tingkatkan ke ultrareview

/code-review ultra --fix menjalankan ultrareview yang lebih mendalam di cloud, lalu meminta Claude menerapkan temuannya ke working tree Anda saat temuan tersebut kembali ke sesi Anda. Ultrareview menggunakan cakupannya sendiri:
  • Apa yang dibandingkan: branch Anda saat ini terhadap branch default repositori, ditambah perubahan yang belum di-commit dan yang di-stage di working tree
  • File sensitif: untuk perubahan yang belum di-commit pada file yang bernama seperti kredensial atau kunci, seperti file .env dan *.tfvars, Claude Code mengikuti aturan untuk mengunggah repositori lokal ke sesi cloud
  • Base yang berbeda: berikan nama branch, seperti /code-review ultra develop, untuk membandingkan terhadap base yang berbeda
Ketika targetnya adalah pull request github.com, Anda dapat meminta Claude memposting temuan yang sudah selesai ke PR sebagai komentar dari akun GitHub Anda. Memerlukan Claude Code v2.1.227 atau yang lebih baru.
Ultrareview memerlukan autentikasi dengan akun claude.ai. Ultrareview tidak tersedia di Amazon Bedrock, Agent Platform dari Google Cloud, atau Microsoft Foundry, maupun untuk organisasi yang mengaktifkan Zero Data Retention atau menerapkan konfigurasi HIPAA. Dalam kasus ini, /code-review ultra menjalankan review lokal di sesi Anda sebagai gantinya. Organisasi yang menggunakan kunci enkripsi yang dikelola pelanggan (CMEK) tidak dapat menjalankan ultrareview. Untuk meninjau perubahan Anda secara lokal, jalankan /code-review.
Untuk menjalankan review cloud dari skrip atau job CI, gunakan subperintah claude ultrareview, yang menunggu temuan dan mencetaknya ke stdout.

​
Ubah atau kembangkan review

/code-review adalah skill bawaan: instruksinya dibangun ke dalam Claude Code, sehingga tidak ada file SKILL.md di disk untuk dibuka atau disunting. Untuk memberikan aturan proyek yang harus diikuti setiap review, tambahkan ke CLAUDE.md Anda. Untuk melangkah lebih jauh, mulailah dari salah satu halaman berikut:
  • Ganti perintah: skill proyek atau pribadi bernama code-review berjalan menggantikan skill bawaan, dan alias /review tetap menjalankan review bawaan. Lihat Menyelesaikan skill yang memiliki nama sama.
  • Bangun reviewer Anda sendiri: tulis subagent reviewer atau skill review
  • Gunakan perintah terkait: /simplify meninjau hanya untuk perapian dan menerapkan perbaikannya, dan /verify menjalankan aplikasi Anda untuk memastikan perubahan berfungsi
Perintah ini bernama /simplify sebelum v2.1.147, ketika perintah tersebut menerapkan perbaikan secara default. Jika Anda membuat skrip /simplify untuk menemukan bug, beralihlah ke /code-review --fix.
  • Code Review: layanan terkelola yang meninjau setiap pull request di GitHub untuk organisasi Anda
  • Ultrareview: penyiapan, batasan, dan biaya review cloud yang lebih mendalam
  • Perintah: referensi satu baris untuk /code-review, /review, /simplify, dan /verify
  • Skills: cara kerja skill bawaan dan cara menulis skill Anda sendiri