Code Review menganalisis permintaan tarik GitHub Anda dan memposting temuan sebagai komentar sebaris pada baris kode tempat ditemukan masalah. Sekelompok agen khusus memeriksa perubahan kode dalam konteks basis kode lengkap Anda, mencari kesalahan logika, kerentanan keamanan, kasus tepi yang rusak, dan regresi.
Artikel ini mencakup cara mengaktifkan Code Review, mengonfigurasi pemicu ulasan, menyesuaikan apa yang ditandai, dan mengatasi masalah penyiapan umum.
Catatan: Code Review dalam pratinjau penelitian dan tersedia di paket Tim dan Enterprise. Tidak tersedia untuk organisasi dengan retensi data nol yang diaktifkan. Penggunaan Code Review ditagih secara terpisah melalui penggunaan tambahan dan tidak dihitung terhadap penggunaan yang disertakan dalam paket Anda.
Cara kerja Code Review
Setelah organisasi mengaktifkan Code Review, dapat dipicu secara otomatis saat permintaan tarik dibuka, pada setiap push, atau hanya saat seseorang secara manual meminta ulasan. Saat ulasan berjalan, beberapa agen menganalisis diff dan kode sekitarnya secara paralel. Setiap agen mencari kelas masalah yang berbeda, kemudian langkah verifikasi memeriksa hasil terhadap perilaku kode aktual untuk menyaring positif palsu.
Temuan 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 di PR. Ulasan tidak menyetujui atau memblokir PR Anda, jadi alur kerja ulasan yang ada tetap utuh.
Ulasan diskalakan dalam biaya dengan ukuran dan kompleksitas PR, selesai rata-rata dalam 20 menit.
Tingkat keparahan
Setiap temuan diberi tag dengan tingkat keparahan:
Penanda | Keparahan | Makna |
🔴 | Normal | 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 melihat mengapa Claude menandai masalah dan bagaimana memverifikasi masalah.
Apa yang diperiksa Code Review
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
Pemilik dan Pemilik Utama paket Tim dan Enterprise dapat mengaktifkan Code Review sekali untuk organisasi dan memilih repositori mana yang akan disertakan. Selain peran pemilik dalam organisasi Claude Anda, Anda memerlukan izin untuk memasang Aplikasi GitHub di organisasi GitHub Anda.
Buka Pengaturan Organisasi > Claude Code dan temukan bagian Code Review.
Klik "Konfigurasi" untuk memulai alur instalasi Aplikasi GitHub.
Ikuti petunjuk untuk memasang Aplikasi GitHub Claude ke organisasi GitHub Anda. Aplikasi meminta izin baca dan tulis untuk konten, masalah, dan permintaan tarik.
Pilih repositori mana yang akan diaktifkan untuk Code Review. Jika Anda tidak melihat repositori, konfirmasi bahwa Anda memberikan akses Aplikasi GitHub Claude ke dalamnya selama instalasi.
Tetapkan pemicu ulasan untuk setiap repositori menggunakan dropdown Perilaku Ulasan (lihat bagian berikutnya untuk detail tentang setiap opsi).
Untuk memverifikasi penyiapan, buka PR pengujian. Jika Anda memilih pemicu otomatis, jalankan pemeriksaan bernama Claude Code Review harus muncul dalam beberapa menit. Jika Anda memilih Manual, beri komentar "@claude review" di PR untuk memulai ulasan pertama.
Pilih pemicu ulasan
Setelah penyiapan, bagian Code Review menampilkan repositori Anda dalam tabel. Untuk setiap repositori, pilih kapan ulasan berjalan:
Sekali setelah pembuatan PR: Ulasan berjalan sekali saat PR dibuka atau ditandai siap untuk ditinjau.
Setelah setiap push: Ulasan berjalan pada setiap push ke cabang PR, menangkap masalah baru saat PR berkembang. Claude secara otomatis menyelesaikan utas saat Anda memperbaiki masalah yang sebelumnya ditandai. Ini menjalankan ulasan paling banyak dan biaya paling banyak.
Manual: Ulasan dimulai hanya saat seseorang mengomentari "@claude review" di PR. Berguna untuk repo lalu lintas tinggi di mana Anda ingin memilih PR mana yang akan ditinjau.
Tabel repositori juga menampilkan biaya rata-rata per ulasan untuk setiap repo berdasarkan aktivitas terbaru.
Pemicu ulasan secara manual
Beri komentar "@claude review" di permintaan tarik untuk memulai ulasan dan memilih PR tersebut ke dalam ulasan yang dipicu push ke depan. Ini berfungsi terlepas dari pemicu yang dikonfigurasi repositori.
Agar komentar memicu ulasan:
Posting sebagai komentar PR tingkat atas, bukan komentar sebaris pada baris diff.
Letakkan "@claude review" di awal komentar.
Anda harus memiliki akses pemilik, anggota, atau kolaborator ke repositori.
PR harus terbuka dan bukan draf.
Jika ulasan sudah berjalan, permintaan antri sampai ulasan yang sedang berlangsung selesai.
Sesuaikan ulasan
Code Review membaca dua file dari repositori Anda untuk memandu apa yang ditandai. Keduanya aditif di atas pemeriksaan kebenaran default.
CLAUDE.md
Code Review membaca file CLAUDE.md repositori Anda dan memperlakukan pelanggaran yang baru diperkenalkan sebagai temuan tingkat nit. Jika PR Anda mengubah kode dengan cara yang membuat pernyataan CLAUDE.md ketinggalan zaman, Claude menandai bahwa dokumen juga perlu diperbarui.
Claude membaca file CLAUDE.md di setiap tingkat hierarki direktori Anda, jadi aturan di CLAUDE.md subdirektori hanya berlaku untuk file di bawah jalur itu.
REVIEW.md
Tambahkan file REVIEW.md ke akar repositori Anda untuk aturan khusus ulasan. Gunakan untuk mengkodekan:
Panduan gaya perusahaan atau tim
Konvensi khusus bahasa atau kerangka kerja yang tidak tercakup oleh linter
Hal-hal yang harus selalu ditandai Claude (misalnya, "rute API baru apa pun harus memiliki tes integrasi")
Hal-hal yang harus dilewati Claude (misalnya, "jangan berkomentar pada kode yang dihasilkan")
Claude secara otomatis menemukan REVIEW.md di akar repositori. Tidak ada konfigurasi yang diperlukan.
Harga dan penggunaan
Code Review ditagih berdasarkan penggunaan token. Setiap ulasan rata-rata biaya $15–25, diskalakan dengan ukuran PR, kompleksitas basis kode, dan berapa banyak masalah yang memerlukan verifikasi.
Penggunaan Code Review ditagih secara terpisah melalui penggunaan tambahan dan tidak dihitung terhadap penggunaan yang disertakan dalam paket Anda. Pemicu ulasan yang Anda pilih mempengaruhi biaya total:
Sekali setelah pembuatan PR berjalan sekali per PR.
Setelah setiap push berjalan pada setiap push, mengalikan biaya dengan jumlah push.
Manual tidak menimbulkan biaya sampai seseorang mengomentari "@claude review." Setelah komentar itu, push tambahan ke PR secara otomatis memicu ulasan.
Biaya muncul di 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, buka Pengaturan Organisasi > Penggunaan dan konfigurasikan batas untuk layanan Claude Code Review.
Pantau pengeluaran melalui bagan biaya mingguan di dasbor analitik atau kolom biaya rata-rata per-repo di pengaturan admin.
Lihat penggunaan
Buka dasbor analitik Code Review untuk melihat aktivitas di seluruh organisasi Anda. Dasbor menampilkan:
PR ditinjau: Hitungan harian permintaan tarik yang ditinjau selama rentang waktu yang dipilih.
Biaya mingguan: Pengeluaran mingguan untuk Code Review.
Umpan balik: Hitungan komentar ulasan yang secara otomatis diselesaikan karena seseorang mengatasi masalah.
Rincian repositori: Hitungan per-repo PR yang ditinjau dan komentar yang diselesaikan.
Pemecahan masalah
Repositori tidak muncul setelah memasang Aplikasi GitHub
Jika Anda telah memasang Aplikasi GitHub Claude tetapi repositori Anda tidak muncul di panel admin:
Konfirmasi bahwa Aplikasi GitHub Claude memiliki akses ke repositori yang Anda harapkan. Buka pengaturan organisasi GitHub Anda, temukan Aplikasi GitHub Claude di bawah Aplikasi GitHub yang Dipasang, dan periksa apakah memiliki akses ke semua repositori atau hanya yang dipilih.
Jika organisasi Anda menggunakan GitHub Enterprise Cloud dengan Enterprise Managed Users (EMU), pastikan Aplikasi OAuth GitHub Claude diotorisasi di tingkat enterprise. Perusahaan EMU dapat membatasi aplikasi OAuth mana yang disetujui, dan aplikasi Claude harus secara eksplisit diizinkan.
Coba putuskan dan sambungkan kembali integrasi GitHub. Buka Pengaturan Organisasi > Claude Code, hapus konfigurasi repositori, dan jalankan penyiapan lagi.
Jika masalah berlanjut, hubungi tim Dukungan kami dengan nama organisasi dan nama organisasi GitHub Anda sehingga kami dapat menyelidiki.
Code Review tidak dimulai di PR baru
Jika tidak ada jalankan pemeriksaan yang muncul setelah membuka PR:
Konfirmasi bahwa repositori terdaftar dan diaktifkan di pengaturan admin Anda.
Periksa pengaturan pemicu ulasan. Jika diatur ke Manual, Anda perlu mengomentari "@claude review" di PR untuk memulai ulasan.
Pastikan PR bukan draf. Code Review tidak berjalan di PR draf.
Verifikasi bahwa Aplikasi GitHub Claude masih memiliki akses ke repositori di pengaturan organisasi GitHub Anda.
GitHub Enterprise Cloud dengan pembatasan IP
Jika organisasi GitHub Enterprise Cloud Anda membatasi akses berdasarkan alamat IP, Aplikasi GitHub Claude mungkin tidak dapat mengakses repositori Anda. Untuk memperbaikinya, aktifkan pewarisan daftar izin IP untuk Aplikasi GitHub yang dipasang di pengaturan enterprise GitHub Anda. Aplikasi GitHub Claude mendaftarkan rentang IP-nya, jadi mengaktifkan pengaturan ini memungkinkan akses tanpa konfigurasi manual. Untuk menambahkan rentang ke daftar izin Anda secara manual sebagai gantinya, atau untuk mengonfigurasi firewall lainnya, lihat alamat IP API Anthropic.
GitHub Enterprise Server (self-hosted)
Code Review saat ini memerlukan repositori yang dihosting di github.com, jadi GitHub Enterprise Server yang self-hosted belum didukung.
Pertanyaan yang sering diajukan
Apakah Code Review tersedia sebagai kemampuan saat membuat peran khusus?
Tidak, Code Review saat ini tidak tersedia untuk ditambahkan ke peran khusus.
Sumber daya terkait
Plugin — Jelajahi pasar plugin, termasuk plugin tinjauan kode untuk menjalankan ulasan sesuai permintaan secara lokal sebelum mendorong.
Tindakan GitHub — Jalankan Claude dalam alur kerja Tindakan GitHub Anda sendiri untuk otomasi khusus di luar Code Review.
GitLab CI/CD — Integrasi Claude yang di-host sendiri untuk pipeline GitLab.