Langsung ke konten utama

Documentation Index

Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Code Review sedang dalam pratinjau penelitian, tersedia untuk langganan Team 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

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, dengan ringkasan dalam badan ulasan. 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:
PenandaKeparahanArti
🔴PentingBug yang harus diperbaiki sebelum penggabungan
🟡NitMasalah kecil, layak diperbaiki tetapi tidak memblokir
🟣Sudah ada sebelumnyaBug 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.

​
Menilai dan membalas temuan

Setiap komentar ulasan dari Claude tiba dengan 👍 dan 👎 sudah terpasang sehingga kedua tombol muncul di UI GitHub untuk penilaian satu klik. Klik 👍 jika temuan berguna atau 👎 jika salah atau bising. Anthropic mengumpulkan hitungan reaksi setelah PR digabungkan dan menggunakannya untuk menyetel pengulas. Reaksi tidak memicu ulasan kembali atau mengubah apa pun pada PR. Membalas komentar sebaris tidak mendorong Claude untuk merespons atau memperbarui PR. Untuk bertindak atas temuan, perbaiki kode dan push. Jika PR berlangganan ulasan yang dipicu push, jalankan berikutnya menyelesaikan utas ketika masalah diperbaiki. Untuk meminta ulasan segar tanpa push, komentari @claude review once sebagai komentar PR tingkat atas.

​
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:
KeparahanFile:BarisMasalah
🔴 Pentingsrc/auth/session.ts:142Penyegaran token berjalan dengan logout, meninggalkan sesi basi aktif
🟡 Nitsrc/auth/session.ts:88parseExpiry 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.
PerintahApa yang dilakukannya
@claude reviewMemulai ulasan dan berlangganan PR ke ulasan yang dipicu push ke depannya
@claude review onceMemulai 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 berbeda dalam seberapa kuat mereka mempengaruhi ulasan:
  • CLAUDE.md: instruksi proyek bersama yang digunakan Claude Code untuk semua tugas, bukan hanya ulasan. Code Review membacanya sebagai konteks proyek dan menandai pelanggaran yang baru diperkenalkan sebagai nit.
  • REVIEW.md: instruksi khusus ulasan, disuntikkan langsung ke setiap agen dalam saluran ulasan sebagai prioritas tertinggi. Gunakan untuk mengubah apa yang ditandai, pada tingkat keparahan apa, dan bagaimana temuan dilaporkan.

​
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

REVIEW.md adalah file di akar repositori Anda yang mengganti cara Code Review berperilaku di repo Anda. Isinya disuntikkan ke dalam prompt sistem setiap agen dalam saluran ulasan sebagai blok instruksi prioritas tertinggi, mengambil alih dari panduan ulasan default. Karena ditempel verbatim, REVIEW.md adalah instruksi biasa: sintaks @ import tidak diperluas, dan file yang direferensikan tidak dibaca ke dalam prompt. Letakkan aturan yang ingin Anda terapkan langsung di file.

​
Apa yang dapat Anda sesuaikan

REVIEW.md adalah markdown bentuk bebas, jadi apa pun yang dapat Anda ekspresikan sebagai instruksi ulasan berada dalam cakupan. Pola di bawah ini memiliki dampak paling besar dalam praktik. Keparahan: tentukan ulang apa yang 🔴 Penting berarti untuk repo Anda. Kalibrasi default menargetkan kode produksi; repo dokumen, repo konfigurasi, atau prototipe mungkin menginginkan definisi yang jauh lebih sempit. Nyatakan secara eksplisit kelas temuan mana yang Penting dan mana yang paling banyak Nit. Anda juga dapat meningkatkan ke arah lain, misalnya memperlakukan pelanggaran CLAUDE.md apa pun sebagai Penting daripada nit default. Volume nit: batasi berapa banyak komentar 🟡 Nit yang diposting ulasan tunggal. Prosa dan file konfigurasi dapat dipoles selamanya. Batas seperti “laporkan paling banyak lima nit, sebutkan sisanya sebagai hitungan dalam ringkasan” membuat ulasan dapat ditindaklanjuti. Aturan lewati: daftar jalur, pola cabang, dan kategori temuan di mana Claude tidak boleh memposting temuan. Kandidat umum adalah kode yang dihasilkan, lockfile, dependensi yang dijual, dan cabang yang dibuat mesin, bersama dengan apa pun yang CI Anda sudah terapkan seperti linting atau pemeriksaan ejaan. Untuk jalur yang memerlukan beberapa ulasan tetapi bukan pengawasan penuh, tetapkan standar yang lebih tinggi alih-alih melewati sepenuhnya: “di scripts/, hanya laporkan jika hampir pasti dan parah.” Pemeriksaan khusus repo: tambahkan aturan yang ingin Anda tandai pada setiap PR, seperti “rute API baru harus memiliki tes integrasi.” Karena REVIEW.md disuntikkan sebagai prioritas tertinggi, ini mendarat lebih andal daripada aturan yang sama dalam CLAUDE.md yang panjang. Bilah verifikasi: memerlukan bukti sebelum kelas temuan diposting. Misalnya, “klaim perilaku memerlukan kutipan file:line dalam sumber, bukan inferensi dari penamaan” mengurangi positif palsu yang akan menghabiskan penulis putaran perjalanan. Konvergensi ulasan kembali: beri tahu Claude cara berperilaku ketika PR sudah ditinjau. Aturan seperti “setelah ulasan pertama, tekan nit baru dan posting temuan Penting saja” menghentikan perbaikan satu baris dari mencapai putaran ketujuh hanya berdasarkan gaya. Bentuk ringkasan: minta badan ulasan untuk dibuka dengan tally satu baris seperti 2 faktual, 4 gaya, dan untuk memimpin dengan “tidak ada masalah faktual” ketika itu kasusnya. Penulis ingin mengetahui bentuk pekerjaan sebelum detail.

​
Contoh

REVIEW.md ini mengkalibrasi ulang keparahan untuk layanan backend, membatasi nit, melewati file yang dihasilkan, dan menambahkan pemeriksaan khusus repo. 
# Instruksi ulasan

## Apa yang Penting berarti di sini

Cadangkan Penting untuk temuan yang akan merusak perilaku, membocorkan data,
atau memblokir rollback: logika yang tidak benar, kueri basis data yang tidak terbatas, PII
dalam log atau pesan kesalahan, dan migrasi yang tidak kompatibel
ke belakang. Gaya, penamaan, dan saran refactoring adalah Nit paling
banyak.

## Batasi nit

Laporkan paling banyak lima Nit per ulasan. Jika Anda menemukan lebih banyak, katakan "plus N
item serupa" dalam ringkasan alih-alih mempostingnya sebaris. Jika
semuanya yang Anda temukan adalah Nit, pimpin ringkasan dengan "Tidak ada masalah pemblokiran."

## Jangan laporkan

- Apa pun yang CI sudah terapkan: lint, pemformatan, kesalahan tipe
- File yang dihasilkan di bawah `src/gen/` dan file `*.lock` apa pun
- Kode khusus pengujian yang sengaja melanggar aturan produksi

## Selalu periksa

- Rute API baru memiliki tes integrasi
- Baris log tidak menyertakan alamat email, ID pengguna, atau badan permintaan
- Kueri basis data dibatasi ke penyewa pemanggil

​
Jaga agar tetap fokus

Panjang memiliki biaya: REVIEW.md yang panjang mengencerkan aturan yang paling penting. Jaga agar tetap pada instruksi yang mengubah perilaku ulasan, dan tinggalkan konteks proyek umum di CLAUDE.md.

​
Lihat penggunaan

Buka claude.ai/analytics/code-review untuk melihat aktivitas Code Review di seluruh organisasi Anda. Dasbor menampilkan:
BagianApa yang ditampilkan
PRs reviewedHitungan harian permintaan tarik yang ditinjau selama rentang waktu yang dipilih
Cost weeklyPengeluaran mingguan pada Code Review
FeedbackHitungan komentar ulasan yang secara otomatis diselesaikan karena pengembang mengatasi masalah
Repository breakdownHitungan per-repo PR yang ditinjau dan komentar yang diselesaikan
Tabel repositori di pengaturan admin juga menampilkan biaya rata-rata per ulasan untuk setiap repo. Angka biaya dasbor adalah perkiraan untuk memantau aktivitas; untuk pengeluaran yang akurat pada tagihan, lihat tagihan Anthropic Anda.

​
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 Amazon 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.

​
Ulasan tidak berjalan dan PR menampilkan pesan batas pengeluaran

Ketika batas pengeluaran bulanan organisasi Anda tercapai, Code Review memposting komentar tunggal pada PR yang menjelaskan bahwa ulasan dilewati. Ulasan dilanjutkan secara otomatis pada awal periode penagihan berikutnya, atau segera ketika admin menaikkan batas di claude.ai/admin-settings/usage.

​
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