Claude Code Review: nhiều agent review PR GitHub và tự kiểm chứng phát hiện
Tóm tắt
Code Review cho nhiều agent đọc PR song song, kiểm chứng phát hiện rồi comment inline theo mức nghiêm trọng, không approve hay chặn merge. Tuỳ chỉnh bằng REVIEW.md đọc từ nhánh gốc; không có phát hiện không có nghĩa code an toàn.
Khi AI viết code nhanh gấp nhiều lần, nút thắt chuyển sang review: PR nhiều hơn, to hơn, và reviewer mệt hơn. Code Review là dịch vụ có quản lý của Claude Code: mỗi PR trên GitHub được nhiều agent đọc song song, các phát hiện được kiểm chứng lại với code trước khi đăng, rồi xuất hiện thành comment ngay trên dòng liên quan, xếp theo mức nghiêm trọng. Review không bao giờ approve hay chặn merge; quyết định vẫn thuộc về team.
Bốn bước của một lượt review
- Tìm: nhiều agent đọc diff và code xung quanh song song.
- Kiểm chứng: đối chiếu từng phát hiện với code để loại báo động giả.
- Xếp hạng: gộp trùng, sắp theo mức nghiêm trọng.
- Đăng: comment inline, phần tóm tắt và một check run tên Claude Code Review (không bao giờ kết luận "failure").
Mặc định review tập trung vào tính đúng: bug làm hỏng production, không phải style hay thiếu test. Review đọc code chứ không build hay chạy code.
Ba mức review
| Mức | Đặc điểm | Hợp với |
|---|---|---|
| Quick | Nhẹ, nhanh, rẻ nhất | Codebase thường lệ |
| Standard (mặc định) | Cân bằng độ sâu, tốc độ, chi phí | Phần lớn repo |
| Deep | Kỹ nhất, lâu và đắt nhất | Thanh toán, auth, hạ tầng quan trọng |
Owner chọn mức cho cả tổ chức và có thể đặt riêng cho từng repo.
Khi nào review chạy?
- Mỗi repo chọn một trong ba: khi PR mở, sau mỗi lần push, hoặc chỉ khi được yêu cầu.
- Người có quyền ghi comment
@claude reviewđể yêu cầu review bất cứ lúc nào. - Không tự chạy trên PR nháp và PR từ fork.
Tuỳ chỉnh bằng REVIEW.md
Thêm REVIEW.md (cùng với CLAUDE.md) vào repo để chỉnh thứ cần soi, ví dụ:
# REVIEW.md
- Mọi endpoint mới phải kiểm tra quyền qua middleware requireRole()
- Truy vấn SQL phải dùng tham số, không nối chuỗi
- Bỏ qua thư mục src/generated/
Điểm an toàn quan trọng: REVIEW.md được đọc từ nhánh gốc hoặc nhánh mặc định, không bao giờ từ thay đổi trong chính PR. Một PR không thể tự sửa luật review để "lách".
Điều kiện sử dụng
- Gói Team và Enterprise, repo trên GitHub (kể cả GitHub Enterprise Server). Owner cài Claude GitHub App và bật tính năng.
- Không có cho tổ chức bật Zero Data Retention, cấu hình HIPAA hoặc khoá mã hoá do khách hàng quản lý.
- Review chạy trên hạ tầng Anthropic, chỉ đọc repo, không push commit.
So sánh các cách review bằng Claude
| Cách | Khởi động | Ai dùng được |
|---|---|---|
| Code Review | Hoạt động PR hoặc @claude review | Team/Enterprise trên GitHub |
/code-review | Bạn chạy trên nhánh local | Mọi gói |
| Ultrareview | Bạn khởi động từ Claude Code, chạy trên sandbox cloud | Cần tài khoản claude.ai |
| GitHub Actions/GitLab CI | Sự kiện pipeline của bạn | Có API key hoặc credential cloud |
Rủi ro và lưu ý
- Tài liệu nói rõ: review bằng AI có thể bỏ sót bug và lỗ hổng. Không có phát hiện nào không có nghĩa là code an toàn.
- Review sau mỗi push trên repo bận rộn có thể tốn đáng kể; đặt hạn mức chi tiêu tháng.
- Comment AI không thay reviewer người cho quyết định thiết kế và bối cảnh nghiệp vụ.
Áp dụng thế nào?
- Dev: Chạy
/code-reviewlocal trước khi mở PR; sửa xong mới để Code Review chạy trên PR. - Tech Lead: Deep cho repo quan trọng, Quick cho repo nội bộ; viết
REVIEW.mdtừ các bug production đã gặp. - PM: Theo dõi số phát hiện nghiêm trọng được sửa mỗi sprint như chỉ số chất lượng, kèm chi phí review.
Nguồn & tham khảo
- Code Review — Claude Code Docs