Kursus
Sebuah pull request (PR) bisa terlihat sangat masuk akal namun tetap mengandung bug yang mengubah hasil metrik bisnis. Bayangkan Anda menambahkan skrip weekly_revenue.py untuk menghitung pendapatan dari sebuah tabel orders. Kodenya rapi, ujiannya lolos, dan PR hanya 40 baris. PR Anda memicu Claude untuk meninjau kode, dan ia melihat bahwa agregasi baru menggunakan join yang tidak tepat ke tabel customer, secara diam-diam menggandakan order dan melebih-lebihkan pendapatan mingguan.
Itu adalah kasus penggunaan yang saya pedulikan dengan Claude Code Review. Ia menjalankan beberapa agen peninjau terhadap sebuah PR, memeriksa repo, memverifikasi temuan terhadap perilaku kode sebenarnya, dan melaporkan masalah sebagai komentar inline GitHub. Fokus utamanya adalah korektness, keamanan, kasus tepi, dan regresi alih-alih preferensi pemformatan atau pengetahuan kontekstual yang mendalam.
Dalam panduan ini, saya akan menelusuri ulasan data Python kecil yang sama di 3 tempat: /code-review lokal, GitHub Code Review, dan /code-review ultra berbasis cloud (yang mungkin Anda kenal dengan nama awalnya, /ultrareview). Saya juga akan meluangkan waktu untuk memutuskan apakah temuan Claude benar-benar tepat.
Jika Anda baru menggunakan Claude Code, mulailah dengan tutorial Claude Code kami, yang membahas instalasi dan alur kerja dasar sebelum masuk ke peninjauan. Sumber bagus lainnya adalah panduan praktik terbaik Claude Code.
Ringkasnya
-
Claude Code Review adalah peninjau, bukan gerbang merge. Pemeriksaan GitHub-nya bersifat netral, jadi manusia atau proses CI lain tetap yang memutuskan apakah PR akan di-merge.
-
Gunakan
/code-reviewsebelum membuka PR. Ini meninjau branch lokal dan perubahan yang belum di-commit tanpa memerlukan GitHub App. -
Gunakan GitHub Code Review saat organisasi Anda ingin ulasan terlampir langsung ke PR. Saat ini merupakan fitur pratinjau riset untuk Team dan Enterprise dan rata-rata berbiaya $15-$25 per ulasan.
-
Gunakan
/code-review ultrauntuk pemeriksaan pra-merge yang lebih mendalam. Ini mengirim ulasan ke sandbox jarak jauh dengan beberapa agen yang secara independen mereproduksi dan memverifikasi bug yang dilaporkan. Akun Pro dan Max menerima 3 kali run gratis sebagai alokasi satu kali, setelah itu ulasan ditagihkan melalui kredit penggunaan. -
Logika bisnis tetap tanggung jawab Anda. Claude dapat mengidentifikasi join yang mencurigakan dan filter yang hilang, tetapi Anda yang harus tahu apakah skema tersebut mewakili grain bisnis yang tepat.
Apa Itu Claude Code Review?
Claude Code Review adalah sistem ulasan kode multi-agen yang memeriksa PR dalam konteks repo dan melaporkan potensi bug, masalah keamanan, serta regresi. GitHub Code Review menjalankan agen-agen tersebut terhadap PR GitHub, sementara /code-review lokal memberi Anda ulasan atas diff saat ini langsung dari Claude Code.
Kata pentingnya di sini adalah konteks. Ulasan diff konvensional meminta seseorang memeriksa baris yang berubah. Agen ulasan Claude memeriksa perubahan tersebut dalam konteks repo. Alur kerja GitHub memiliki beberapa agen khusus yang bekerja paralel, diikuti verifikasi, deduplikasi, dan pemeringkatan keparahan.
Sebagai contoh, perubahan 10 baris pada transformasi pandas dapat bergantung pada skema yang dibuat oleh model dbt hulu, grain dari tabel Snowflake, dan asumsi yang tertanam dalam dashboard hilir.
Claude tidak menyetujui atau memblokir PR. GitHub Code Review melaporkan kesimpulan pemeriksaan yang netral, sehingga aturan perlindungan branch Anda yang ada tetap tidak berubah kecuali Anda membangun logika CI sendiri berdasarkan output pemeriksaan.
Tiga permukaan ulasan
Saat ini ada 3 cara utama untuk meninjau kode dengan Claude Code.
|
Permukaan ulasan |
Lokasi berjalan |
Penggunaan terbaik |
Ketersediaan saat ini |
|
|
Sesi Claude Code Anda |
Umpan balik cepat saat mengembangkan |
Tersedia di paket berbayar mana pun |
|
GitHub Code Review |
Infrastruktur Anthropic |
Ulasan PR otomatis dengan komentar inline |
Pratinjau riset untuk Team dan Enterprise (tidak tersedia dengan Zero Data Retention) |
|
|
Sandbox cloud jarak jauh |
Ulasan pra-merge yang lebih mendalam |
Pratinjau riset, memerlukan autentikasi claude.ai |
Perintah /code-review lokal memeriksa commit pada branch Anda. Anda juga bisa memberinya file, branch, nomor PR, atau rentang Git ref tertentu.
GitHub Code Review dirancang berdasarkan PR itu sendiri. Bergantung pada konfigurasi repo, ia bisa meninjau sekali setelah PR dibuat, setelah setiap push, atau hanya saat seseorang meminta ulasan dengan @claude review.
/code-review ultra adalah opsi yang lebih berat. Anthropic menyebut fitur ini ultrareview, dan /ultrareview berfungsi sebagai alias ketika fitur tersedia untuk akun Anda. Ini menjalankan armada agen peninjau di sandbox jarak jauh, dengan setiap bug yang dilaporkan direproduksi dan diverifikasi sebelum muncul dalam temuan. Saat ini merupakan pratinjau riset, dan ulasan tipikal memakan waktu sekitar 5 hingga 10 menit.
Apa yang ditandai Claude vs. yang dilewati
Claude Code Review berfokus pada korektness terlebih dahulu. Dokumentasi Anthropic secara khusus membedakan bug yang berdampak pada produksi dari preferensi pemformatan dan cakupan tes yang hilang.
Temuan menggunakan 3 tingkat keparahan:
|
Keparahan |
Arti |
Contoh pipeline data |
|
🔴 Penting |
Bug yang harus diperbaiki sebelum merge |
Melakukan join orders pada grain yang salah dan menggandakan pendapatan |
|
🟡 Nit |
Masalah kecil yang layak diperbaiki, namun tidak memblokir PR |
Nama variabel yang membingungkan, seperti df2 |
|
🟣 Sudah ada |
Bug yang sudah ada sebelum PR saat ini |
Helper yang sudah ada dan mengekspos pengenal pelanggan |
Pembedaan itu berguna karena data scientist sering memiliki pendapat yang sangat berbeda tentang apa yang pantas mendapatkan waktu ulasan. Saran penamaan tentang revenue_df versus weekly_revenue tidak selevel dengan menggandakan pendapatan karena sebuah join many-to-many terselip ke dalam sebuah transformasi.
Bagaimana Menyiapkan Code Review di Claude Code?
Menyiapkan Claude Code Review memerlukan langkah berbeda bergantung pada apakah Anda ingin ulasan lokal atau ulasan kode PR GitHub. /code-review lokal tidak memerlukan GitHub App dan dapat dilakukan sebelum Anda membuka PR.
GitHub Code Review memerlukan Owner atau Primary Owner organisasi untuk mengonfigurasi Claude GitHub App dan memilih repo. Saat melakukan ulasan PR, Anda akan membuat file khusus bernama REVIEW.md yang memuat aturan khusus ulasan.
CLAUDE.md vs. REVIEW.md
CLAUDE.md dan REVIEW.md memiliki tujuan berbeda, dan mencampurnya adalah cara mudah menciptakan ulasan yang berisik.
CLAUDE.md berisi instruksi proyek umum yang digunakan Claude di berbagai tugas. Ulasan kode juga membaca instruksi tersebut, dan pelanggaran yang baru diperkenalkan akan dilaporkan sebagai nit. REVIEW.md, di sisi lain, khusus untuk perilaku ulasan dan memberi tahu agen ulasan apa yang tim Anda ingin ditandai, dilewati, atau diperlakukan sebagai Penting.
Untuk repo data Python, saya akan menjaga CLAUDE.md fokus pada hal-hal seperti struktur repo, cara menjalankan pytest, apakah transformasi menggunakan pandas atau polars, dan di mana model SQL berada.
Saya akan menaruh aturan ulasan di REVIEW.md. Beberapa contoh aturan potensial:
- “Periksa setiap transformasi baru apakah memiliki tes yang sesuai.”
- “Jangan pernah mencatat kredensial."
- “Lewati file yang dihasilkan.”
Sebuah REVIEW.md kecil mungkin terlihat seperti ini:
# Review instructions
## Important findings
Report as Important:
- Incorrect joins or filters that can change dataset grain
- Missing tenant or customer scoping
- Secrets or credentials written to logs
- Silent changes to revenue or customer metrics
## Do not report
- Formatting already enforced by Ruff
- Generated files
- *.lock files
## Always check
- New transformations have tests
- Joins use the intended keys
- Datetime operations specify timezone assumptions
- Missing values are handled explicitly
Saya menyarankan agar REVIEW.md Anda tetap fokus karena instruksi yang panjang dapat mengencerkan aturan penting. Implementasi saat ini juga membaca file sebagai instruksi biasa, jadi Anda harus menaruh aturan langsung di dalamnya alih-alih menggunakan pintasan @.
Ngomong-ngomong, saat Anda mengembangkan secara lokal, /code-review tidak membaca REVIEW.md. Ia mengikuti CLAUDE.md, sementara pipeline GitHub Code Review menggunakan REVIEW.md untuk instruksi khusus ulasan.
Jika Anda menginginkan aturan ulasan yang sama secara lokal dan di GitHub, taruh aturan umum di CLAUDE.md dan ulangi aturan khusus ulasan di REVIEW.md seperlunya.
Untuk pembahasan lebih dalam, saya menyarankan membaca panduan menulis file CLAUDE.md yang terbaik kami.
GitHub App dan mode pemicu
GitHub Code Review dikonfigurasi oleh Owner atau Primary Owner organisasi melalui pengaturan admin Claude. Admin perlu memasang Claude GitHub App, memberinya akses repo, memilih repo untuk ditinjau, lalu menetapkan perilaku ulasan untuk setiap repo.
Ada 3 mode pemicu berbeda:
|
Pemicu |
Perilaku |
Dampak biaya |
|
Sekali setelah PR dibuat |
Meninjau saat PR dibuka atau siap |
Satu ulasan per PR |
|
Setelah setiap push |
Meninjau setiap push baru |
Frekuensi dan biaya ulasan tertinggi |
|
Manual |
Berjalan hanya ketika diminta |
Anda mengontrol kapan ulasan mengonsumsi penggunaan |
Satu pengecualian untuk ketiganya: Claude tidak pernah secara otomatis meninjau pull request dari fork. Seseorang harus mengomentari @claude review pada PR tersebut.
Per pembaruan Juli 2026, perintah manual juga berubah:
-
@claude reviewmemulai satu ulasan dan tidak men-subscribe PR ke push di masa depan. -
@claude review alwaysmemulai ulasan dan men-subscribe PR untuk ulasan yang dipicu push di masa depan. -
@claude review onceberperilaku sama seperti perintah tanpa tambahan.
Jika Anda mempelajari Claude Code Review lebih awal pada 2026, tutorial lama mungkin menyebut bahwa @claude review men-subscribe PR ke ulasan di masa depan, tetapi perilaku itu berubah pada Juli 2026 dan tetap berlaku hingga September 2026.
Pengguna Pro dan Max yang tidak memiliki akses ke GitHub Code Review organisasi dapat melewati App sepenuhnya dan menggunakan /code-review secara lokal, dengan /code-review ultra untuk ulasan yang lebih mendalam.
Bagaimana Meninjau Diff Secara Lokal Dengan /code-review?
Perintah /code-review lokal meninjau branch Anda saat ini sebelum Anda membuka PR. Saya selalu memulai dari sini karena ini menangkap masalah saat saya masih bekerja dan dapat mencegah CI gagal.
Kasus yang ditinjau
Mari bayangkan kita memiliki repo e-commerce dengan tabel orders yang berisi order_id, customer_id, order_date, status, dan revenue, dan kita membuat weekly_revenue.py untuk menghitung pendapatan mingguan:
orders = load_orders()
customers = load_customers()
# Derive the reporting week from the order date
orders["week"] = orders["order_date"].dt.to_period("W").dt.start_time
weekly_revenue = (
orders
.merge(customers, on="customer_id", how="inner")
.groupby("week", as_index=False)["revenue"]
.sum()
)
Sekilas, tidak ada yang terlihat aneh. merge() eksplisit, pengelompokan mudah dibaca, dan revenue diagregasi setelah join.
Masalahnya adalah tabel customers berisi beberapa catatan historis untuk sebagian pelanggan. Seorang pelanggan dengan 2 catatan sekarang menghasilkan 2 baris setelah join, menggandakan pendapatan yang melekat pada pelanggan tersebut. Ini persis jenis bug yang mudah terlewat saat Anda membaca transformasi secara lokal tanpa memeriksa grain tabel.
Tentukan cakupan diff
Dari sesi Claude Code Anda, jalankan /code-review.
Perintah ini meninjau commit branch saat ini yang berada di depan branch hulu, bersama dengan perubahan yang belum di-commit. Anda juga dapat menargetkan file, branch, PR, atau rentang tertentu, seperti main...feature/weekly-revenue.
Contohnya:
/code-review weekly_revenue.py
atau:
/code-review main...feature/weekly-revenue
Anda juga dapat memberikan level effort, seperti /code-review high. Pada low dan medium, ulasan hanya melaporkan temuan yang paling diyakini, sementara high hingga max memperluas cakupan dengan potensi lebih banyak positif palsu.
Gunakan flag untuk mengarahkan ulasan
Setelah Anda nyaman dengan alur kerja, dua flag akan berguna:
-
--fixmenerapkan temuan ke working tree Anda setelah ulasan selesai. -
--commentmempostingnya sebagai komentar inline.
Claude menjalankan ulasan sebagai subagen latar belakang, sehingga Anda dapat terus bekerja saat ia memproses perubahan. Temuan akan kembali ke sesi Anda saat ulasan selesai.
Ulasan mungkin melaporkan sesuatu seperti berikut:
🔴 Important
weekly_revenue.py:9
The merge on customer_id can duplicate order rows because
customers contains multiple records per customer. This can
inflate revenue when a customer has more than one matching
customer record.
Verify that customer_id is unique in customers or join against
the intended current-record subset before aggregating revenue.
Ulasan menemukan mode kegagalan yang konkret dan memberi saya sesuatu yang dapat saya verifikasi terhadap skema aktual, alih-alih meminta saya mempercayai penilaian Claude.
Baca temuan
Saya tetap akan melakukan pemeriksaan manual sebelum menjalankan /code-review --fix. Pertama, cari kode yang membangun customers, periksa kendala keunikannya, dan lihat tes di sekitar weekly_revenue.py.
Jika customers.customer_id benar-benar unik, temuan Claude adalah positif palsu. Jika tabel berisi satu baris per pelanggan per effective date, temuan itu nyata, dan transformasi perlu diubah.
Inti utamanya adalah peninjau Claude melihat perilaku kode, sementara saya tetap bertanggung jawab mengetahui apa yang direpresentasikan data.
Anda dapat meminta Claude menyelidiki setelah ulasan:
Investigate the customer_id join finding.
Check how the customers table is built and determine whether
customer_id is unique at the point of this merge. Do not modify
the code yet.
Langkah kedua itu sering lebih berguna daripada meminta Claude secara membabi buta memperbaiki komentar. Ini mengubah ulasan menjadi penyelidikan singkat daripada latihan pembuatan kode.
Bagaimana Menjalankan Claude Code Review pada PR GitHub?
GitHub Code Review menempatkan temuan Claude langsung pada PR, sehingga peninjau dapat melihat masalah di samping kode yang diubah.
Urutan itu penting karena ulasan terlampir ke PR yang sudah ada:
-
Push branch
weekly-revenueke GitHub melaluigit push. -
Buka pull request. Claude hanya dapat meninjau PR yang terbuka, jadi tidak ada yang terjadi sebelum titik ini.
-
Jika repo disetel ke pemicu otomatis, ulasan dimulai otomatis. Jika disetel ke Manual, posting
@claude reviewsebagai komentar PR tingkat atas untuk memulai satu ulasan.
Ada tiga persyaratan yang sering menjebak orang. Perintah harus berupa komentar PR tingkat atas alih-alih balasan pada komentar ulasan inline, dan Anda memerlukan izin write, maintain, atau admin pada repo. Perintah juga harus mengawali komentar, dengan once atau always pada baris yang sama jika ditambahkan.
Memicu ulasan
Pilihan yang sebenarnya berdampak biaya adalah antara dua perintah manual, bukan antara manual dan otomatis.
@claude review menjalankan satu ulasan dan membiarkan PR tidak berlangganan. @claude review always menjalankan ulasan dan men-subscribe ke PR, sehingga setiap push berikutnya memulai ulasan baru.
Ini adalah perilaku setelah Juli 2026 dan per September 2026. Sebelum pembaruan itu, perintah @claude review tanpa tambahan men-subscribe PR ke ulasan di masa depan, jadi jika Anda mengikuti tutorial lama, periksa ini terlebih dulu.
Ulasan sering memakan waktu sekitar 20 menit, meskipun Anthropic mengatakan biaya dan durasi bergantung pada ukuran dan kompleksitas PR. Setiap ulasan juga ditagihkan secara terpisah melalui kredit penggunaan alih-alih mengonsumsi penggunaan yang termasuk dalam paket Team atau Enterprise. Jika Anda ingin mengetahui lebih lanjut tentang struktur biaya, saya menyarankan membaca panduan batas penggunaan Claude Code kami.
Baca komentar inline dan check run
Saat ulasan selesai, Claude memposting komentar inline pada baris yang relevan. Check run GitHub juga menyertakan ringkasan keparahan, yang berguna ketika PR memiliki banyak temuan di weekly_revenue.py, model SQL, dan file pengujian.
Sebagai contoh:
|
Keparahan |
File |
Temuan |
|
🔴 Penting |
weekly_revenue.py:9 |
Join dapat menggandakan baris order |
|
🟡 Nit |
weekly_revenue.py:12 |
Nama variabel tidak menggambarkan level agregasi |
|
🟣 Sudah ada |
utils/dates.py:42 |
Asumsi zona waktu yang sudah ada |
Komentar inline adalah tempat saya akan menyelidiki masalah sebenarnya. Check run adalah tempat saya mendapatkan gambaran keseluruhan ulasan.
Sekadar catatan, mengklik 👍 atau 👎 tidak memicu ulasan lain, dan membalas komentar inline tidak membuat Claude merespons. Untuk mendapatkan ulasan lain, perbaiki kode dan push, atau posting @claude review sebagai komentar PR tingkat atas yang baru.
Ulasan juga tidak memblokir merge dengan sendirinya. Pemeriksaan memberikan kesimpulan netral, meskipun output pemeriksaan menyertakan informasi keparahan yang dapat dibaca mesin yang dapat dikonsumsi tim melalui gh dan jq jika ingin membangun gerbang merge sendiri.
Bagaimana Menangani Triage Komentar Ulasan Claude?
Tujuan utamanya adalah menjaga manusia tetap dalam lingkaran selama siklus ulasan. Artinya setiap ulasan Claude memerlukan keputusan apakah setiap temuan adalah bug nyata, peningkatan non-bloker, atau positif palsu. Ini karena peninjau kode dapat memeriksa perilaku implementasi tanpa mengetahui setiap asumsi bisnis di balik dataset atau metrik.
Saya menggunakan keputusan 3 arah sederhana:
|
Keputusan |
Kapan |
Contoh |
|
Perbaiki |
Temuan nyata dan mengubah output |
Join customer menggandakan baris order |
|
Lewati |
Nyata tetapi tidak layak memblokir |
Nit tentang mengganti nama |
|
Tolak |
Nyata tetapi tidak layak memblokir |
|
Kategori terakhir itu penting. Peninjau yang melaporkan 30 temuan tidak serta merta lebih baik daripada yang melaporkan 5. Komentar positif palsu tentang merge pandas bisa memakan waktu lebih banyak daripada perubahan kode aslinya.
Perbaiki, lewati, atau tolak
Jika bug duplikasi baris pelanggan itu nyata, saya mungkin meminta Claude memeriksa model hulu lalu membuat perbaikan berikut:
The customer_id finding is valid. Inspect the existing customer
model and update weekly_revenue.py to join only the current
customer record. Add a regression test for a customer with
multiple historical records, then run the relevant tests.
Claude kemudian dapat memeriksa repo, mengubah kode Python, menambahkan tes, dan menjalankan rangkaian tes.
Jika Anda ingin bekerja dari komentar ulasan GitHub, Claude Code juga dapat berinteraksi dengan repo melalui GitHub CLI (gh). Pembedanya penting: saya akan memilih secara selektif perbaikan spesifik yang menurut Anda valid, alih-alih memberinya seluruh ulasan untuk "memperbaiki semuanya."
Ini menjaga developer tetap dalam lingkar ulasan:
- Claude menemukan masalah yang mungkin.
- Saya memverifikasi masalah terhadap kode dan asumsi data.
- Claude melakukan perbaikan yang diminta.
- Tes dijalankan.
- Claude meninjau diff yang dihasilkan lagi.
Siklus itu jauh lebih aman daripada memperlakukan output ulasan pertama sebagai antrean refactoring otomatis.
Untuk apa PR data masih memerlukan manusia?
Mode kegagalan yang tidak bisa ditutupi Claude adalah kode yang berjalan benar namun tetap melakukan hal yang salah. Tiga versinya sering muncul berulang:
-
Asumsi yang berada di luar diff. Claude membaca repo Anda, bukan data warehouse, layanan konfigurasi, atau kontrak yang dimiliki tim lain. Sebuah join dapat menggunakan kunci yang benar dan tetap mengubah grain hasil, karena jumlah baris per kunci adalah properti tabel hulu, bukan kode di depan Anda.
-
Definisi yang hanya dimiliki tim Anda. Apakah pendapatan harus dihitung di level order, pelanggan, atau minggu adalah keputusan bisnis. Claude bisa memberi tahu Anda
groupby()akan dengan senang hati menjumlahkan baris apa pun yang diberikan. Ia tidak bisa memberi tahu Anda angka mana yang disetujui tim keuangan. -
Asumsi waktu dan tipe. Apakah
2026-08-27berarti hari UTC, hari kerja lokal, atau tanggal pelaporan yang ditetapkan oleh model hulu? Koersi diam-diam memiliki bentuk yang sama: operasi lintas kolom object, integer nullable, datetime sadar zona waktu, dan string bisa mengembalikan sesuatu yang masuk akal sambil diam-diam mengubah perilaku perbandingan.
Kebocoran data adalah contoh paling tajam dari kategori pertama. Transformasi fitur dapat melakukan join set pelatihan ke tabel yang berisi informasi yang hanya ada setelah tanggal prediksi. Join valid, jumlah baris sesuai harapan, dan model menjadi terkorupsi.
Jadi saya memperlakukan Claude sebagai peninjau perilaku implementasi, bukan pemilik definisi.
Kapan Menggunakan Code Review vs Ultrareview?
Gunakan /code-review untuk umpan balik lokal cepat dan /code-review ultra untuk pemeriksaan pra-merge yang lebih mendalam. Keduanya meninjau kode, tetapi /code-review dirancang untuk iterasi, sementara ulasan ultra menjalankan beberapa agen jarak jauh dan secara independen memverifikasi bug yang dilaporkan.
|
|
|
|
|
Lokasi |
Sesi Claude Code lokal |
Sandbox cloud jarak jauh |
|
Gaya ulasan |
Alur kerja ulasan lokal tunggal |
Ulasan multi-agen dengan verifikasi independen |
|
Durasi tipikal |
Detik hingga beberapa menit |
Sekitar 5 hingga 10 menit |
|
Biaya |
Penggunaan normal Claude Code |
3 run gratis Pro/Max, lalu $5 hingga $25 dalam kredit penggunaan |
|
Tahap terbaik |
Saat mengembangkan |
Sebelum menggabungkan perubahan substansial |
|
GitHub PR |
Dapat menargetkan PR |
Dapat meninjau PR berdasarkan nomor |
|
Autentikasi |
Autentikasi Claude Code |
Memerlukan akun claude.ai |
Anthropic saat ini menggambarkan ulasan ultra sebagai pratinjau riset. Pelanggan Pro dan Max menerima 3 run gratis sebagai alokasi satu kali yang tidak diperbarui, setelah itu ulasan biasanya berbiaya $5 hingga $25, bergantung pada ukuran perubahan. Pengguna Team dan Enterprise tidak menerima run gratis tersebut, dan fitur ini tidak tersedia di Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, serta untuk organisasi dengan Zero Data Retention diaktifkan.
Perbedaan pentingnya adalah verifikasi. /code-review ultra mengirim status repo ke sandbox jarak jauh dan menjalankan armada agen peninjau, dengan bug yang dilaporkan direproduksi secara independen sebelum dikembalikan sebagai temuan.
Saya tidak akan menjalankannya pada setiap commit. Jika saya mengubah nama variabel di notebook Python atau menyesuaikan pemformatan model dbt, /code-review lokal sudah cukup. Jika saya mengubah logika pembuatan fitur untuk model produksi, menulis ulang transformasi pendapatan, atau memodifikasi agregasi tingkat pelanggan, pemeriksaan tambahan lebih masuk akal.
Ada juga detail penamaan yang patut diperhatikan. Perintah yang didokumentasikan adalah /code-review ultra, dan /ultrareview adalah alias yang berfungsi ketika ultrareview tersedia untuk akun Anda. Tutorial lama sering menyajikan /ultrareview sebagai perintah utama, namun dokumentasi Anthropic kini memperlakukan ulasan cloud mendalam sebagai bagian dari keluarga perintah /code-review, dan /code-review ultra akan kembali ke ulasan lokal jika fitur cloud tidak tersedia.
Jalankan ulasan ultra pada PR yang sama
Dari repo, jalankan:
/code-review ultra
Untuk meninjau PR GitHub secara langsung:
/code-review ultra <pr#>
Tanpa argumen, /code-review ultra membandingkan branch saat ini dengan branch default dan menyertakan perubahan yang belum di-commit dan yang sudah di-staged. Ulasan branch dibatasi sekitar 500 file berubah dan 8.000 baris berubah secara default, meskipun Anthropic mencatat angka ini dapat berubah. Jika diff Anda terlalu besar, push branch dan tinjau sebagai PR saja.
Dengan nomor PR, lingkungan jarak jauh mengkloning PR dari GitHub, dan tidak ada yang diunggah dari mesin Anda.
Sebelum memulai, Claude menampilkan cakupan ulasan, sisa run gratis, dan perkiraan biaya. Setelah konfirmasi, ulasan berjalan di latar belakang, sehingga Anda dapat terus menggunakan Claude Code sementara agen jarak jauh bekerja.
Untuk contoh weekly_revenue.py, saya akan membandingkan temuan, bukan berasumsi ulasan yang lebih dalam pasti benar.
Jika /code-review menandai join customer dan ulasan ultra secara independen mereproduksi duplikasi pendapatan yang sama, keyakinan saya pada temuan itu meningkat. Jika ulasan ultra mengabaikannya karena tabel hulu menjamin keunikan, saya akan memeriksa bukti dari kedua ulasan dan definisi model sebenarnya sebelum mengubah kode.
Itu adalah sifat berguna dari beberapa peninjau: ketidaksepakatan memberi Anda sesuatu untuk diselidiki.

Ada juga pertimbangan biaya. GitHub Code Review saat ini rata-rata $15 hingga $25 per ulasan, sementara ulasan ultra biasanya berbiaya $5 hingga $25 setelah run gratis Pro dan Max. Biaya GitHub Code Review terpisah dari penggunaan yang termasuk dalam paket, dan Anthropic menyediakan kontrol pengeluaran untuk organisasi.
Jika Anda bekerja sendiri, /code-review lokal ditambah sesekali /code-review ultra adalah alur kerja awal yang masuk akal. Jika Anda berada di paket Team atau Enterprise dan ingin setiap PR memiliki ulasan otomatis, GitHub Code Review lebih masuk akal.
Alur Kerja Claude Code Review yang Praktis
Alur kerja yang berguna bukanlah "jalankan Claude sebelum setiap merge." Ini adalah rangkaian di mana setiap ulasan terjadi pada titik berbeda dalam pengembangan, karena masing-masing memiliki biaya berbeda dan menangkap kelas masalah yang berbeda.
Berikut proses yang akan saya gunakan untuk perubahan produksi:
Write code
↓
Run tests and data checks
↓
/code-review
↓
Fix verified findings
↓
Open GitHub PR
↓
GitHub Code Review
↓
Human triage
↓
/code-review ultra for higher-risk changes
↓
Final tests
↓
Human merge
Ulasan lokal menangkap masalah saat masih murah untuk diperbaiki. Ulasan GitHub memberi tim yang lebih luas catatan bersama atas temuan, sementara ulasan ultra menawarkan pendapat kedua berbiaya lebih tinggi sebelum merge yang berdampak.

Pemeriksaan tambahan untuk data scientist
Untuk pekerjaan data, saya akan menambahkan 4 pemeriksaan di sekitar Claude alih-alih mengharapkan model melakukan seluruh ulasan:
- Periksa jumlah baris dan grain dataset sebelum dan sesudah join penting
- Jalankan unit test atau integration test pada transformasi dan logika fitur.
- Periksa kebocoran saat membangun fitur machine learning.
- Validasi metrik bisnis terhadap kueri atau dashboard yang terbukti benar.
Claude dapat berpartisipasi dalam keempat aktivitas, tetapi hasil yang diharapkan harus berasal dari kode, tes, atau data alih-alih penjelasan Claude.
Penutup
Claude Code Review bekerja paling baik ketika saya memperlakukannya seperti insinyur lain dalam thread ulasan, bukan seperti stempel persetujuan otomatis.
Perintah /code-review lokal memberi Anda ulasan cepat sebelum PR ada. GitHub Code Review membawa temuan multi-agen ke dalam PR untuk organisasi Team dan Enterprise, sementara /code-review ultra memberi Anda ulasan jarak jauh yang lebih mendalam saat perubahan layak mendapat pemeriksaan tambahan.
Saya akan mulai dari hal kecil. Masukkan /code-review ke dalam alur kerja branch normal Anda, tulis REVIEW.md singkat untuk ulasan GitHub Anda, dan coba /code-review ultra pada perubahan di mana merge yang buruk benar-benar berbiaya bagi Anda.
Untuk konsep model yang mendasari, kursus Introduction to Claude Models kami memberikan konteks yang lebih luas, sementara GitHub Foundations dan Intermediate GitHub Concepts membahas alur kerja Git dan GitHub yang menjadi landasan Code Review. Untuk inspirasi lebih lanjut tentang cara melakukan triage repo GitHub dengan Claude, saya juga menyarankan membaca tutorial konektor Claude Code kami.
FAQ Ulasan Kode Claude
Apakah Claude Code Review menggantikan peninjau kode manusia?
Tidak. Claude Code Review melaporkan temuan tetapi tidak menyetujui atau memblokir pull request, dan check run GitHub-nya memiliki kesimpulan netral. Manusia tetap harus memutuskan apakah temuan tersebut benar, khususnya untuk logika data yang melibatkan grain, kebocoran, definisi bisnis, dan asumsi berbasis waktu.
Apa perbedaan antara /code-review dan GitHub Code Review?
/code-review berjalan secara lokal dari Claude Code dan meninjau branch, commit, dan perubahan working tree Anda tanpa memerlukan GitHub Code Review App. GitHub Code Review berjalan terhadap pull request GitHub dan memposting temuan sebagai komentar inline, namun saat ini merupakan fitur pratinjau riset untuk Team dan Enterprise.
Apa perbedaan antara /code-review dan /ultrareview?
/code-review dimaksudkan untuk umpan balik cepat selama pengembangan, sedangkan /code-review ultra mengirim ulasan ke sandbox jarak jauh tempat beberapa agen secara independen menyelidiki dan memverifikasi bug. Anthropic saat ini menggambarkan ulasan ultra (juga dapat diakses melalui alias /ultrareview) sebagai pratinjau riset, dengan run tipikal memakan waktu sekitar 5 hingga 10 menit.
Apakah @claude review secara otomatis meninjau setiap push di masa depan?
Tidak lagi. Sejak perubahan perilaku Juli 2026 dan per September 2026, @claude review meminta satu ulasan, sementara @claude review always meminta satu ulasan dan men-subscribe PR ke ulasan yang dipicu push di masa depan. @claude review once berperilaku sama seperti perintah tanpa tambahan.
Kapan saya harus menggunakan REVIEW.md?
Jika repository Anda menggunakan GitHub Code Review dan Anda memiliki aturan khusus ulasan. Aturan tentang join, definisi metrik, file yang dihasilkan, rahasia, tes, dan pemeriksaan kualitas data lebih cocok dimasukkan ke REVIEW.md daripada instruksi proyek umum, meskipun /code-review lokal saat ini mengikuti CLAUDE.md alih-alih REVIEW.md.
Saya seorang data scientist dengan pengalaman dalam analisis spasial, machine learning, dan pipeline data. Saya pernah bekerja dengan GCP, Hadoop, Hive, Snowflake, Airflow, dan proses data science/engineering lainnya.

