Tinjauan Kode 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 Tinjauan Kode, mengonfigurasi pemicu tinjauan, menyesuaikan apa yang ditandai, dan mengatasi masalah penyiapan umum.
Catatan: Tinjauan Kode dalam pratinjau penelitian dan tersedia di paket Tim dan Perusahaan. Tidak tersedia untuk organisasi dengan retensi data nol yang diaktifkan. Penggunaan Tinjauan Kode ditagih secara terpisah melalui penggunaan tambahan dan tidak dihitung terhadap penggunaan yang disertakan dalam paket Anda.
Cara Kerja Tinjauan Kode
Setelah organisasi mengaktifkan Tinjauan Kode, dapat dipicu secara otomatis saat permintaan tarik dibuka, pada setiap push, atau hanya saat seseorang secara manual meminta tinjauan. Saat tinjauan 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. Tinjauan tidak menyetujui atau memblokir PR Anda, jadi alur kerja tinjauan yang ada tetap utuh.
Tinjauan 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 Tinjauan Kode
Secara default, Tinjauan Kode 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 Tinjauan Kode
Langkah-langkah di bawah mencakup penyiapan untuk repositori di github.com. Jika repositori Anda berada di instans GitHub Enterprise Server (GHES) yang dihosting sendiri, lihat Claude Code dengan GitHub Enterprise Server untuk panduan penyiapan lengkap.
Pemilik dan Pemilik Utama paket Tim dan Perusahaan dapat mengaktifkan Tinjauan Kode 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 Tinjauan Kode.
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 Tinjauan Kode. Jika Anda tidak melihat repositori, konfirmasi bahwa Anda memberikan akses Aplikasi GitHub Claude ke dalamnya selama instalasi.
Tetapkan pemicu tinjauan untuk setiap repositori menggunakan dropdown Perilaku Tinjauan (lihat bagian berikutnya untuk detail tentang setiap opsi).
Untuk memverifikasi penyiapan, buka PR pengujian. Jika Anda memilih pemicu otomatis, jalankan pemeriksaan bernama Tinjauan Kode Claude harus muncul dalam beberapa menit. Jika Anda memilih Manual, beri komentar "@claude review" di PR untuk memulai tinjauan pertama.
Pilih pemicu tinjauan
Setelah penyiapan, bagian Tinjauan Kode menampilkan repositori Anda dalam tabel. Untuk setiap repositori, pilih kapan tinjauan berjalan:
Sekali setelah pembuatan PR: Tinjauan berjalan sekali saat PR dibuka atau ditandai siap untuk tinjauan.
Setelah setiap push: Tinjauan 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 tinjauan paling banyak dan biaya paling banyak.
Manual: Tinjauan 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 tinjauan untuk setiap repo berdasarkan aktivitas terbaru.
Pemicu tinjauan secara manual
Beri komentar "@claude review" pada permintaan tarik untuk memulai tinjauan dan memilih PR tersebut ke dalam tinjauan yang dipicu push ke depannya. Ini berfungsi terlepas dari pemicu yang dikonfigurasi repositori.
Agar komentar memicu tinjauan:
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 tinjauan sudah berjalan, permintaan antri sampai tinjauan yang sedang berlangsung selesai.
Sesuaikan tinjauan
Code Review membaca dua file dari repositori Anda untuk memandu apa yang ditandai. Keduanya bersifat 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 tersebut.
REVIEW.md
Tambahkan file REVIEW.md ke akar repositori Anda untuk aturan khusus tinjauan. 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, "setiap rute API baru harus memiliki tes integrasi")
Hal-hal yang harus dilewati Claude (misalnya, "jangan berkomentar tentang 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 tinjauan 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 tinjauan yang Anda pilih mempengaruhi total biaya:
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 tinjauan.
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 tinjauan yang diselesaikan secara otomatis 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:
Konfirmasikan 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 pengaturan lagi.
Jika masalah berlanjut, hubungi tim Dukungan kami dengan nama organisasi dan nama organisasi GitHub Anda sehingga kami dapat menyelidiki.
Code Review tidak dimulai pada PR baru
Jika tidak ada check run yang muncul setelah membuka PR:
Konfirmasikan bahwa repositori terdaftar dan diaktifkan di pengaturan admin Anda.
Periksa pengaturan pemicu tinjauan. Jika diatur ke Manual, Anda perlu mengomentari "@claude review" pada PR untuk memulai tinjauan.
Pastikan PR bukan draft. Code Review tidak berjalan pada PR draft.
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 memperbaiki ini, 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)
GitHub Enterprise Server (GHES) yang self-hosted didukung melalui alur pengaturan terpisah. Lihat Claude Code dengan GitHub Enterprise Server untuk instruksi lengkap.
Masalah pengaturan GHES umum:
Kesalahan "Public cannot be private" selama pengaturan: Nama host GHES Anda harus diselesaikan ke alamat IP yang dapat dirutekan secara publik. Code Review menjangkau server Anda melalui internet, jadi alamat jaringan internal atau pribadi tidak akan berfungsi. Perbarui DNS atau konfigurasi jaringan Anda sehingga nama host diselesaikan ke IP publik, lalu coba lagi.
GitHub Enterprise Cloud dengan Data Residency adalah produk yang berbeda. Penyewa Data Residency (nama host yang cocok dengan
*.ghe.com) tidak didukung oleh Code Review. Hanya GitHub Enterprise Server yang self-hosted dan repositori github.com standar yang didukung.
Pertanyaan yang sering diajukan
Apakah Code Review tersedia sebagai kemampuan saat membuat peran kustom?
Tidak, Code Review saat ini tidak tersedia untuk ditambahkan ke peran kustom.
Sumber daya terkait
Plugin — Jelajahi marketplace plugin, termasuk plugin code-review untuk menjalankan review on-demand secara lokal sebelum push.
GitHub Actions — Jalankan Claude di workflow GitHub Actions Anda sendiri untuk otomasi kustom di luar Code Review.
GitLab CI/CD — Integrasi Claude yang di-host sendiri untuk pipeline GitLab.