Skip to main content
Code Review adalah layanan terkelola yang diaktifkan oleh Owner di organisasi Claude Anda untuk sekumpulan repositori GitHub. Setelah diaktifkan, Claude meninjau pull request di repositori tersebut dan memposting temuannya sebagai komentar inline, ringkasan di badan review, dan check run bernama Claude Code Review. Review tidak pernah menyetujui atau memblokir pull request Anda, dan check run tidak pernah berakhir dengan status gagal. Owner mengontrol kapan review dijalankan dan seberapa menyeluruh review tersebut untuk setiap repositori.
Jika paket Anda tidak menyertakan Code Review, Anda tetap dapat meminta Claude meninjau branch Anda dari sesi Claude Code: lihat Review secara lokal dengan /code-review.

​
Tingkat keparahan

Claude memposting setiap temuan sebagai komentar inline pada baris yang bersangkutan dan menandainya dengan salah satu dari tiga tingkat keparahan: Ketika review mencatat alasannya, temuan tersebut memiliki bagian Why this was flagged yang diciutkan. Perluas bagian tersebut untuk membaca mengapa Claude menandai masalah tersebut dan bagaimana Claude memverifikasi masalahnya. Untuk mengubah apa yang ditandai Claude di repositori Anda atau cara Claude menentukan peringkat tingkat keparahan, lihat Menyesuaikan Code Review.

​
Menanggapi temuan

Anda dapat melakukan merge tanpa menanggapi temuan, kecuali aturan repositori Anda sendiri mengharuskannya. Jika proteksi branch-nya mewajibkan penyelesaian percakapan, selesaikan thread setiap temuan sebelum Anda melakukan merge. Untuk menghapus temuan, selesaikan thread-nya atau push perbaikan.
  • Abaikan tanpa perubahan kode: selesaikan thread tersebut sendiri di GitHub. Membalas saja tidak mengabaikan temuan.
  • Perbaiki masalahnya: ubah kode dan push. Review berikutnya pada pull request tersebut akan menyelesaikan thread sebelumnya jika menilai masalahnya sudah diperbaiki, baik review itu berjalan otomatis saat Anda push maupun saat Anda memintanya.
  • Jelaskan atau nyatakan ketidaksetujuan: balas komentar tersebut. Claude tidak langsung merespons, dan balasan tidak memulai review. Review berikutnya pada pull request tersebut membaca balasan pada temuan sebelumnya, dan dapat menyelesaikan thread atau memposting satu balasan tindak lanjut. Jika jenis temuan yang sama terus muncul kembali, minta maintainer untuk menambahkan aturan ke REVIEW.md.
Untuk mendapatkan review berikutnya tanpa melakukan push, komentari @claude review sebagai komentar pull request tingkat atas.

​
Output check run

Tautan Details pada check run Claude Code Review membuka temuan dalam satu tabel yang diurutkan berdasarkan keparahan, termasuk temuan yang komentar inline-nya tidak diterima GitHub: Temuan yang memiliki baris tetapi tidak diposting sebagai komentar inline muncul sebagai anotasi di tab Files changed, pada baris terkait. Temuan Important ditampilkan dengan warna merah, nit dengan warna kuning, dan bug pre-existing dengan warna abu-abu. Check run berakhir dengan status neutral, atau skipped ketika review otomatis tidak berjalan karena push tidak mengubah file apa pun. Check run tidak pernah berakhir dengan status gagal, sehingga review yang selesai tidak menggagalkan check yang diwajibkan. Jika Anda tidak melihat temuan, atau review tidak berjalan, lihat Pemecahan masalah Code Review.

​
Membaca hasil dari skrip

Untuk membatasi merge atau memposting ringkasan dari CI Anda sendiri, parse baris terakhir teks Details dengan gh dan jq. Baris tersebut adalah komentar yang dapat dibaca mesin.
1

Temukan ID check run

Dari shell Anda, tampilkan daftar check run milik commit tersebut dan ambil id dari run Claude Code Review. Ganti OWNER dan REPO dengan pemilik dan nama repositori Anda, serta <commit-sha> dengan head commit pull request:
2

Baca jumlah per tingkat keparahan

Baca jumlah dari check run tersebut, ganti CHECK_RUN_ID dengan ID-nya:
Perintah ini mencetak objek JSON dengan jumlah per tingkat keparahan dan kuncinya dalam urutan abjad, misalnya {"nit": 1, "normal": 2, "pre_existing": 0}. Jumlah tersebut mencakup temuan dari review sebelumnya pada pull request yang thread-nya masih terbuka.
3

Bertindak berdasarkan hasil

Buat skrip Anda menangani kasus-kasus berikut:
  • normal lebih dari nol: gagalkan job jika Anda ingin membatasi merge. Kunci normal menyimpan jumlah temuan Important, sehingga Claude menemukan setidaknya satu bug yang layak diperbaiki sebelum merge.
  • Baris tersebut tidak ada: perlakukan sebagai tidak ada putusan, bukan sebagai nol temuan. Check run untuk review yang gagal, kehabisan waktu, dibatalkan, atau digantikan oleh review yang lebih baru tidak memiliki baris tersebut, dan beberapa review yang selesai juga tidak memilikinya.

​
Meminta review

Jika pull request Anda berupa draft atau berasal dari fork, review otomatis akan melewatinya, jadi minta review dengan perintah komentar. Untuk mendapatkan review pada pull request Anda, lakukan salah satu hal berikut:
  • Buka atau tandai siap: di repositori yang diatur ke Once after PR creation atau After every push, review dimulai saat Anda membuka atau membuka kembali pull request, atau menandai draft sebagai siap untuk review.
  • Komentari sebuah perintah: posting @claude review pada pull request.
  • Push commit: push memulai review di repositori yang diatur ke After every push, atau pada pull request yang Anda langgankan dengan @claude review always.
  • Klik Re-run: setelah review gagal atau kehabisan waktu pada pull request yang tidak berasal dari fork, jalankan lagi dari check run.
  • Tunggu retry otomatis: review yang sesinya terputus akan dicoba ulang sekali secara otomatis. Ringkasan check run memberi tahu kapan hal itu terjadi.

​
Perintah komentar

Posting salah satu perintah berikut sebagai komentar pada pull request: Agar salah satu perintah ini memulai review, semua kondisi berikut harus terpenuhi:
  • Posting sebagai komentar pull request tingkat atas yang baru, bukan komentar inline pada baris diff dan bukan badan review. Mengedit komentar sebelumnya tidak dihitung.
  • Letakkan perintah di awal komentar, dengan always pada baris yang sama dengan bagian perintah lainnya. Huruf besar/kecil tidak berpengaruh.
  • Anda memerlukan izin write, maintain, atau admin pada repositori. Claude memeriksa hal ini dengan GitHub untuk setiap orang yang berkomentar, dan komentar dari bot tidak memulai review.
  • Pull request harus dalam keadaan terbuka.
Ketika perintah diterima, check run Claude Code Review muncul pada pull request dengan judul Code review queued…. Judul berubah menjadi Code review in progress… saat review dimulai. Claude mungkin juga bereaksi terhadap komentar Anda dengan 👀, tetapi reaksi itu dapat muncul meskipun tidak ada review yang dimulai, jadi periksa check run-nya. Jika review sudah berjalan pada commit terbaru pull request, permintaan baru tidak akan memulai review kedua.
Sebelum pembaruan Juli 2026, @claude review melanggankan PR ke review yang dipicu push. Jika Anda mengandalkan perilaku tersebut, komentari @claude review always sebagai gantinya.

​
Cakupan review berikutnya

Review berikutnya yang dimulai dengan sendirinya, seperti setelah push, berfokus pada apa yang berubah sejak review terakhir dan memposting lebih sedikit nit dan temuan pre-existing. Ringkasannya menghitung apa yang tidak disertakan, dalam baris yang diakhiri dengan “found and not posted” atau “outside the scope of this re-review and not posted.” Untuk mendapatkan review yang tidak menghilangkan satu pun dari temuan tersebut, komentari @claude review. Review ini mencakup seluruh pull request lagi.

​
Review draft dan pull request dari fork

Review otomatis melewati keduanya, jadi minta review dengan perintah komentar:
  • Draft pull request: perintah komentar berjalan pada draft, sehingga Anda dapat meminta review sebelum menandai pull request sebagai siap. Push ke draft tidak memulai review, bahkan setelah @claude review always. Langganan mulai berlaku setelah Anda menandai pull request sebagai siap.
  • Pull request dari fork: Claude tidak meninjau pull request dari fork secara otomatis, terlepas dari pengaturan Review runs repositori. Untuk memulainya, komentari @claude review pada pull request. Kondisi untuk perintah komentar tetap berlaku, dan akses write yang Anda perlukan adalah ke repositori dasar, bukan fork.
Pada pull request dari fork, @claude review always juga berfungsi, tetapi tidak melanggankan pull request ke review pada push berikutnya. Mengklik Re-run pada check run tidak memulai review di sana.

​
Menggunakan Code Review bersama Claude Code GitHub Action

Jika repositori juga menjalankan Claude Code GitHub Action dalam mode interaktif dengan frasa pemicu default @claude, komentar @claude review juga akan memulai Action tersebut. Untuk memisahkan keduanya, atur input trigger_phrase milik Action ke frasa yang berbeda.