Code Review

Siapkan ulasan PR otomatis yang menangkap kesalahan logika, kerentanan keamanan, dan regresi menggunakan analisis multi-agen dari seluruh basis kode Anda

Code Review sedang dalam pratinjau penelitian, tersedia untuk langganan Teams dan Enterprise. Tidak tersedia untuk organisasi dengan Zero Data Retention yang diaktifkan.

Code Review menganalisis permintaan tarik GitHub Anda dan memposting temuan sebagai komentar sebaris pada baris kode tempat ditemukannya masalah. Armada agen khusus memeriksa perubahan kode dalam konteks basis kode lengkap Anda, mencari kesalahan logika, kerentanan keamanan, kasus tepi yang rusak, dan regresi halus.

Temuan diberi tag berdasarkan tingkat keparahan dan tidak menyetujui atau memblokir PR Anda, sehingga alur kerja ulasan yang ada tetap utuh. Anda dapat menyesuaikan apa yang Claude tandai dengan menambahkan file CLAUDE.md atau REVIEW.md ke repositori Anda.

Untuk menjalankan Claude di infrastruktur CI Anda sendiri alih-alih layanan terkelola ini, lihat GitHub Actions atau GitLab CI/CD. Untuk repositori pada instans GitHub yang di-host sendiri, lihat GitHub Enterprise Server.

Halaman ini mencakup:

• Cara kerja ulasan
• Penyiapan
• Memicu ulasan secara manual dengan @claude review dan @claude review once
• Menyesuaikan ulasan dengan CLAUDE.md dan REVIEW.md
• Harga
• Pemecahan masalah jalankan yang gagal dan komentar yang hilang

​

Cara kerja ulasan

Setelah admin mengaktifkan Code Review untuk organisasi Anda, ulasan dipicu ketika PR dibuka, pada setiap push, atau ketika diminta secara manual, tergantung pada perilaku yang dikonfigurasi repositori. Mengomentari @claude review memulai ulasan pada PR dalam mode apa pun.

Ketika ulasan berjalan, beberapa agen menganalisis diff dan kode sekitarnya secara paralel pada infrastruktur Anthropic. Setiap agen mencari kelas masalah yang berbeda, kemudian langkah verifikasi memeriksa kandidat terhadap perilaku kode aktual untuk menyaring positif palsu. Hasilnya dideduplikasi, diurutkan berdasarkan tingkat keparahan, dan diposting sebagai komentar sebaris pada baris spesifik tempat masalah ditemukan. Jika tidak ada masalah yang ditemukan, Claude memposting komentar konfirmasi singkat pada PR.

Ulasan diskalakan dalam biaya dengan ukuran dan kompleksitas PR, selesai rata-rata dalam 20 menit. Admin dapat memantau aktivitas ulasan dan pengeluaran melalui dasbor analitik.

​

Tingkat keparahan

Setiap temuan diberi tag dengan tingkat keparahan:

Penanda	Keparahan	Arti
🔴	Penting	Bug yang harus diperbaiki sebelum penggabungan
🟡	Nit	Masalah kecil, layak diperbaiki tetapi tidak memblokir
🟣	Sudah ada sebelumnya	Bug yang ada di basis kode tetapi tidak diperkenalkan oleh PR ini

Temuan mencakup bagian penalaran yang dapat diperluas yang dapat Anda perluas untuk memahami mengapa Claude menandai masalah dan bagaimana Claude memverifikasi masalah.

​

Output jalankan pemeriksaan

Selain komentar ulasan sebaris, setiap ulasan mengisi jalankan pemeriksaan Claude Code Review yang muncul bersama pemeriksaan CI Anda. Perluas tautan Details untuk melihat ringkasan setiap temuan di satu tempat, diurutkan berdasarkan keparahan:

Keparahan	File:Baris	Masalah
🔴 Penting	src/auth/session.ts:142	Penyegaran token berjalan dengan logout, meninggalkan sesi basi aktif
🟡 Nit	src/auth/session.ts:88	parseExpiry secara diam-diam mengembalikan 0 pada input yang salah bentuk

Setiap temuan juga muncul sebagai anotasi di tab Files changed, ditandai langsung pada baris diff yang relevan. Temuan Penting dirender dengan penanda merah, nit dengan peringatan kuning, dan bug yang sudah ada sebelumnya dengan pemberitahuan abu-abu. Anotasi dan tabel keparahan ditulis ke jalankan pemeriksaan secara independen dari komentar ulasan sebaris, sehingga tetap tersedia bahkan jika GitHub menolak komentar sebaris pada baris yang bergerak.

Jalankan pemeriksaan selalu selesai dengan kesimpulan netral sehingga tidak pernah memblokir penggabungan melalui aturan perlindungan cabang. Jika Anda ingin menggerbang penggabungan pada temuan Code Review, baca rincian keparahan dari output jalankan pemeriksaan di CI Anda sendiri. Baris terakhir dari teks Details adalah komentar yang dapat dibaca mesin yang dapat diurai alur kerja Anda dengan gh dan jq:

gh api repos/OWNER/REPO/check-runs/CHECK_RUN_ID \
  --jq '.output.text | split("bughunter-severity: ")[1] | split(" -->")[0] | fromjson'

Ini mengembalikan objek JSON dengan hitungan per keparahan, misalnya {"normal": 2, "nit": 1, "pre_existing": 0}. Kunci normal menyimpan hitungan temuan Penting; nilai bukan nol berarti Claude menemukan setidaknya satu bug yang layak diperbaiki sebelum penggabungan.

​

Apa yang Code Review periksa

Secara default, Code Review berfokus pada kebenaran: bug yang akan merusak produksi, bukan preferensi pemformatan atau cakupan pengujian yang hilang. Anda dapat memperluas apa yang diperiksa dengan menambahkan file panduan ke repositori Anda.

​

Siapkan Code Review

Admin mengaktifkan Code Review sekali untuk organisasi dan memilih repositori mana yang akan disertakan.

1. Buka pengaturan admin Claude Code

   Buka claude.ai/admin-settings/claude-code dan temukan bagian Code Review. Anda memerlukan akses admin ke organisasi Claude Anda dan izin untuk memasang GitHub Apps di organisasi GitHub Anda.

2. Mulai penyiapan

   Klik Setup. Ini memulai alur instalasi GitHub App.

3. Pasang Claude GitHub App

   Ikuti petunjuk untuk memasang Claude GitHub App ke organisasi GitHub Anda. Aplikasi meminta izin repositori ini:

   • Contents: baca dan tulis
   • Issues: baca dan tulis
   • Pull requests: baca dan tulis

   Code Review menggunakan akses baca ke konten dan akses tulis ke permintaan tarik. Kumpulan izin yang lebih luas juga mendukung GitHub Actions jika Anda mengaktifkannya nanti.

4. Pilih repositori

   Pilih repositori mana yang akan diaktifkan untuk Code Review. Jika Anda tidak melihat repositori, pastikan Anda memberikan akses Claude GitHub App ke repositori tersebut selama instalasi. Anda dapat menambahkan lebih banyak repositori nanti.

5. Atur pemicu ulasan per repo

   Setelah penyiapan selesai, bagian Code Review menampilkan repositori Anda dalam tabel. Untuk setiap repositori, gunakan dropdown Review Behavior untuk memilih kapan ulasan berjalan:

   • Once after PR creation: ulasan berjalan sekali ketika PR dibuka atau ditandai siap untuk ditinjau
   • After every push: ulasan berjalan pada setiap push ke cabang PR, menangkap masalah baru saat PR berkembang dan secara otomatis menyelesaikan utas ketika Anda memperbaiki masalah yang ditandai
   • Manual: ulasan dimulai hanya ketika seseorang mengomentari @claude review atau @claude review once pada PR; @claude review juga berlangganan PR ke ulasan pada push berikutnya

   Meninjau pada setiap push menjalankan ulasan paling banyak dan biaya paling banyak. Mode manual berguna untuk repo lalu lintas tinggi di mana Anda ingin memilih PR tertentu untuk ditinjau, atau hanya mulai meninjau PR Anda setelah siap.

Tabel repositori juga menampilkan biaya rata-rata per ulasan untuk setiap repo berdasarkan aktivitas terbaru. Gunakan menu tindakan baris untuk mengaktifkan atau menonaktifkan Code Review per repositori, atau untuk menghapus repositori sepenuhnya.

Untuk memverifikasi penyiapan, buka PR pengujian. Jika Anda memilih pemicu otomatis, jalankan pemeriksaan bernama Claude Code Review muncul dalam beberapa menit. Jika Anda memilih Manual, komentari @claude review pada PR untuk memulai ulasan pertama. Jika tidak ada jalankan pemeriksaan yang muncul, konfirmasi repositori terdaftar di pengaturan admin Anda dan Claude GitHub App memiliki akses ke repositori tersebut.

​

Memicu ulasan secara manual

Dua perintah komentar memulai ulasan sesuai permintaan. Keduanya berfungsi terlepas dari pemicu yang dikonfigurasi repositori, sehingga Anda dapat menggunakannya untuk memilih PR tertentu ke dalam ulasan dalam mode Manual atau untuk mendapatkan ulasan kembali segera di mode lain.

Perintah	Apa yang dilakukannya
@claude review	Memulai ulasan dan berlangganan PR ke ulasan yang dipicu push ke depannya
@claude review once	Memulai ulasan tunggal tanpa berlangganan PR ke push masa depan

Gunakan @claude review once ketika Anda menginginkan umpan balik tentang keadaan saat ini dari PR tetapi tidak menginginkan setiap push berikutnya untuk menimbulkan ulasan. Ini berguna untuk PR yang berjalan lama dengan push yang sering, atau ketika Anda menginginkan pendapat kedua sekali saja tanpa mengubah perilaku ulasan PR.

Agar perintah apa pun memicu ulasan:

• Posting sebagai komentar PR tingkat atas, bukan komentar sebaris pada baris diff
• Letakkan perintah di awal komentar, dengan once pada baris yang sama jika Anda menggunakan bentuk satu kali
• Anda harus memiliki akses pemilik, anggota, atau kolaborator ke repositori
• PR harus terbuka

Tidak seperti pemicu otomatis, pemicu manual berjalan pada PR draf, karena permintaan eksplisit menandakan Anda menginginkan ulasan sekarang terlepas dari status draf.

Jika ulasan sudah berjalan pada PR tersebut, permintaan antri sampai ulasan yang sedang berlangsung selesai. Anda dapat memantau kemajuan melalui jalankan pemeriksaan pada PR.

​

Sesuaikan ulasan

Code Review membaca dua file dari repositori Anda untuk memandu apa yang ditandai. Keduanya bersifat aditif di atas pemeriksaan kebenaran default:

• CLAUDE.md: instruksi proyek bersama yang digunakan Claude Code untuk semua tugas, bukan hanya ulasan. Gunakan ketika panduan juga berlaku untuk sesi Claude Code interaktif.
• REVIEW.md: panduan khusus ulasan, dibaca secara eksklusif selama ulasan kode. Gunakan untuk aturan yang ketat tentang apa yang ditandai atau dilewati selama ulasan dan akan mengacaukan CLAUDE.md umum Anda.

​

CLAUDE.md

Code Review membaca file CLAUDE.md repositori Anda dan memperlakukan pelanggaran yang baru diperkenalkan sebagai temuan tingkat nit. Ini berfungsi dua arah: jika PR Anda mengubah kode dengan cara yang membuat pernyataan CLAUDE.md ketinggalan zaman, Claude menandai bahwa dokumen perlu diperbarui juga.

Claude membaca file CLAUDE.md di setiap tingkat hierarki direktori Anda, jadi aturan di CLAUDE.md subdirektori hanya berlaku untuk file di bawah jalur tersebut. Lihat dokumentasi memori untuk lebih lanjut tentang cara kerja CLAUDE.md.

Untuk panduan khusus ulasan yang tidak ingin Anda terapkan pada sesi Claude Code umum, gunakan REVIEW.md sebagai gantinya.

​

REVIEW.md

Tambahkan file REVIEW.md ke akar repositori Anda untuk aturan khusus ulasan. Gunakan untuk mengkodekan:

• Panduan gaya perusahaan atau tim: “lebih suka pengembalian awal daripada kondisional bersarang”
• Konvensi khusus bahasa atau kerangka kerja yang tidak dicakup oleh linter
• Hal-hal yang Claude harus selalu tandai: “rute API baru harus memiliki tes integrasi”
• Hal-hal yang Claude harus lewati: “jangan berkomentar tentang pemformatan dalam kode yang dihasilkan di bawah /gen/”

Contoh REVIEW.md:

# Panduan Ulasan Kode

## Selalu periksa
- Titik akhir API baru memiliki tes integrasi yang sesuai
- Migrasi basis data kompatibel ke belakang
- Pesan kesalahan tidak membocorkan detail internal kepada pengguna

## Gaya
- Lebih suka pernyataan `match` daripada pemeriksaan `isinstance` berantai
- Gunakan logging terstruktur, bukan interpolasi f-string dalam panggilan log

## Lewati
- File yang dihasilkan di bawah `src/gen/`
- Perubahan hanya pemformatan dalam file `*.lock`

Claude secara otomatis menemukan REVIEW.md di akar repositori. Tidak ada konfigurasi yang diperlukan.

​

Lihat penggunaan

Buka claude.ai/analytics/code-review untuk melihat aktivitas Code Review di seluruh organisasi Anda. Dasbor menampilkan:

Bagian	Apa yang ditampilkan
PRs reviewed	Hitungan harian permintaan tarik yang ditinjau selama rentang waktu yang dipilih
Cost weekly	Pengeluaran mingguan pada Code Review
Feedback	Hitungan komentar ulasan yang secara otomatis diselesaikan karena pengembang mengatasi masalah
Repository breakdown	Hitungan per-repo PR yang ditinjau dan komentar yang diselesaikan

Tabel repositori di pengaturan admin juga menampilkan biaya rata-rata per ulasan untuk setiap repo.

​

Harga

Code Review ditagih berdasarkan penggunaan token. Setiap ulasan rata-rata $15-25 dalam biaya, diskalakan dengan ukuran PR, kompleksitas basis kode, dan berapa banyak masalah yang memerlukan verifikasi. Penggunaan Code Review ditagih secara terpisah melalui penggunaan ekstra dan tidak dihitung terhadap penggunaan yang disertakan dalam paket Anda.

Pemicu ulasan yang Anda pilih mempengaruhi biaya total:

• Once after PR creation: berjalan sekali per PR
• After every push: berjalan pada setiap push, mengalikan biaya dengan jumlah push
• Manual: tidak ada ulasan sampai seseorang mengomentari @claude review pada PR

Dalam mode apa pun, mengomentari @claude review memilih PR ke dalam ulasan yang dipicu push, jadi biaya tambahan terjadi per push setelah komentar tersebut. Untuk menjalankan ulasan tunggal tanpa berlangganan ke push masa depan, komentari @claude review once sebagai gantinya.

Biaya muncul pada tagihan Anthropic Anda terlepas dari apakah organisasi Anda menggunakan AWS Bedrock atau Google Vertex AI untuk fitur Claude Code lainnya. Untuk menetapkan batas pengeluaran bulanan untuk Code Review, buka claude.ai/admin-settings/usage dan konfigurasikan batas untuk layanan Claude Code Review.

Pantau pengeluaran melalui bagan biaya mingguan di analitik atau kolom biaya rata-rata per-repo di pengaturan admin.

​

Pemecahan masalah

Jalankan ulasan adalah upaya terbaik. Jalankan yang gagal tidak pernah memblokir PR Anda, tetapi juga tidak mencoba ulang dengan sendirinya. Bagian ini mencakup cara pulih dari jalankan yang gagal dan tempat mencari ketika jalankan pemeriksaan melaporkan masalah yang tidak dapat Anda temukan.

​

Picu ulang ulasan yang gagal atau habis waktu

Ketika infrastruktur ulasan mengalami kesalahan internal atau melampaui batas waktu, jalankan pemeriksaan selesai dengan judul Code review encountered an error atau Code review timed out. Kesimpulannya masih netral, jadi tidak ada yang memblokir penggabungan Anda, tetapi tidak ada temuan yang diposting.

Untuk menjalankan ulasan lagi, komentari @claude review once pada PR. Ini memulai ulasan segar tanpa berlangganan PR ke push masa depan. Jika PR sudah berlangganan ulasan yang dipicu push, push komit baru juga memulai ulasan baru.

Tombol Re-run di tab Checks GitHub tidak memicu ulang Code Review. Gunakan perintah komentar atau push baru sebagai gantinya.

​

Temukan masalah yang tidak ditampilkan sebagai komentar sebaris

Jika judul jalankan pemeriksaan mengatakan masalah ditemukan tetapi Anda tidak melihat komentar ulasan sebaris pada diff, cari di lokasi lain tempat temuan ditampilkan:

• Check run Details: klik Details di sebelah jalankan pemeriksaan Claude Code Review di tab Checks. Tabel keparahan mencantumkan setiap temuan dengan file, baris, dan ringkasannya terlepas dari apakah komentar sebaris diterima.
• Files changed annotations: buka tab Files changed pada PR. Temuan dirender sebagai anotasi yang terpasang langsung ke baris diff, terpisah dari komentar ulasan.
• Review body: jika Anda push ke PR saat ulasan sedang berjalan, beberapa temuan mungkin mereferensikan baris yang tidak lagi ada di diff saat ini. Ini muncul di bawah judul Additional findings dalam teks badan ulasan daripada sebagai komentar sebaris.

​

Sumber daya terkait

Code Review dirancang untuk bekerja bersama dengan sisa Claude Code. Jika Anda ingin menjalankan ulasan secara lokal sebelum membuka PR, memerlukan penyiapan yang di-host sendiri, atau ingin mendalami cara CLAUDE.md membentuk perilaku Claude di seluruh alat, halaman-halaman ini adalah perhentian berikutnya yang baik:

• Plugins: telusuri pasar plugin, termasuk plugin code-review untuk menjalankan ulasan sesuai permintaan secara lokal sebelum push
• GitHub Actions: jalankan Claude dalam alur kerja GitHub Actions Anda sendiri untuk otomasi khusus di luar ulasan kode
• GitLab CI/CD: integrasi Claude yang di-host sendiri untuk pipeline GitLab
• Memory: cara kerja file CLAUDE.md di seluruh Claude Code
• Analytics: lacak penggunaan Claude Code di luar ulasan kode