Thiết lập Kiểm tra Mã cho Mã Claude (Set up Code Review for Claude Code)

Code Review phân tích các yêu cầu pull trên GitHub của bạn và đăng các phát hiện dưới dạng nhận xét nội tuyến trên các dòng mã nơi nó tìm thấy vấn đề. Một đội ngũ các tác nhân chuyên biệt sẽ xem xét các thay đổi mã trong bối cảnh toàn bộ cơ sở mã của bạn, tìm kiếm lỗi logic, lỗ hổng bảo mật, các trường hợp biên bị hỏng và các hồi quy.

Bài viết này đề cập đến cách bật Code Review, cấu hình các kích hoạt đánh giá, tùy chỉnh những gì được đánh dấu, và khắc phục các sự cố thiết lập phổ biến.

Khi một tổ chức bật Chế độ Xem Xét Mã, nó có thể được kích hoạt tự động khi một yêu cầu kéo được mở, vào mỗi lần đẩy, hoặc chỉ khi ai đó yêu cầu xem xét thủ công. Khi một lần xem xét diễn ra, nhiều đại lý sẽ phân tích sự khác biệt và mã xung quanh song song. Mỗi đại lý tìm kiếm một loại vấn đề khác nhau, sau đó một bước xác minh kiểm tra kết quả so với hành vi thực tế của mã để loại bỏ các kết quả dương tính giả.

Các phát hiện được loại bỏ trùng lặp, xếp hạng theo mức độ nghiêm trọng, và được đăng dưới dạng nhận xét trực tiếp trên các dòng cụ thể nơi phát hiện vấn đề. Nếu không tìm thấy vấn đề nào, Claude sẽ đăng một nhận xét xác nhận ngắn trên PR. Các đánh giá không phê duyệt hoặc chặn PR của bạn, vì vậy các quy trình đánh giá hiện có vẫn giữ nguyên.

Đánh giá tỷ lệ theo chi phí tùy thuộc vào kích thước và độ phức tạp của PR, hoàn thành trung bình trong 20 phút.

Mỗi phát hiện được gắn với một mức độ nghiêm trọng:

Các phát hiện bao gồm một phần lý luận mở rộng có thể gập lại mà bạn có thể mở ra để xem lý do tại sao Claude đánh dấu vấn đề và cách nó xác minh vấn đề.

Theo mặc định, Code Review tập trung vào độ chính xác: các lỗi có thể gây hỏng sản phẩm, không phải là sở thích về định dạng hay thiếu phạm vi kiểm thử. Bạn có thể mở rộng những gì nó kiểm tra bằng cách thêm các tệp hướng dẫn vào kho lưu trữ của mình.

Các bước dưới đây bao gồm việc thiết lập cho các kho lưu trữ trên github.com. Nếu các kho lưu trữ của bạn nằm trên một máy chủ GitHub Enterprise Server (GHES) tự lưu trữ, hãy xemClaude Code với GitHub Enterprise Servercho hướng dẫn cài đặt đầy đủ.

Chủ sở hữu và Chủ sở hữu chính của các gói Team và Enterprise có thể bật Đánh giá Mã một lần cho tổ chức và chọn các kho lưu trữ để bao gồm. Ngoài vai trò chủ sở hữu trong tổ chức Claude của bạn, bạn sẽ cần quyền để cài đặt ứng dụng GitHub trong tổ chức GitHub của mình.

Để xác minh cài đặt, mở một PR thử nghiệm. Nếu bạn chọn một kích hoạt tự động, một lần kiểm tra có tênĐánh giá mã Claudesẽ xuất hiện trong vòng vài phút. Nếu bạn chọn Thủ công, hãy bình luận “@claude review” trên PR để bắt đầu lần đánh giá đầu tiên.

Sau khi cài đặt, cáiXem xét mãPhần này hiển thị các kho lưu trữ của bạn trong một bảng. Đối với mỗi kho lưu trữ, chọn thời điểm chạy các đánh giá:

Bảng các kho lưu trữ cũng hiển thị chi phí trung bình cho mỗi lần đánh giá của từng kho dựa trên hoạt động gần đây.

Bình luận “@claude review” trên một pull request để bắt đầu đánh giá và chọn pull request đó tham gia vào các đánh giá được kích hoạt khi đẩy về trong tương lai. Điều này hoạt động bất kể trigger được cấu hình trong kho lưu trữ.

Để bình luận kích hoạt một đánh giá:

Nếu một đánh giá đang được thực hiện, yêu cầu sẽ được xếp hàng chờ cho đến khi đánh giá đang tiến hành hoàn tất.

Code Review đọc hai tệp từ kho lưu trữ của bạn để hướng dẫn những gì nó cảnh báo. Cả hai đều là thêm vào trên các kiểm tra đúng mặc định.

Code Review đọc các tệp CLAUDE.md trong kho lưu trữ của bạn và coi các vi phạm mới phát sinh là các phát hiện mức nit. Nếu PR của bạn thay đổi mã theo cách làm cho một tuyên bố trong CLAUDE.md trở nên lỗi thời, Claude sẽ cảnh báo rằng tài liệu cũng cần được cập nhật.

Claude đọc các tệp CLAUDE.md ở mọi cấp độ của cấu trúc thư mục của bạn, vì vậy các quy tắc trong CLAUDE.md của một thư mục con chỉ áp dụng cho các tệp dưới đường dẫn đó.

Thêm một tệp REVIEW.md vào thư mục gốc của kho lưu trữ của bạn cho các quy tắc riêng về đánh giá. Sử dụng nó để mã hóa:

Claude tự động phát hiện REVIEW.md tại thư mục gốc của kho lưu trữ. Không cần cấu hình.

Đánh giá mã được tính phí dựa trên mức sử dụng token. Mỗi lần đánh giá trung bình có chi phí từ $15–25, tùy thuộc vào kích thước PR, độ phức tạp của cơ sở mã, và số lượng vấn đề cần được xác minh.

Việc sử dụng Code Review được tính phí riêng thông qua tín dụng sử dụng và không tính vào lượng sử dụng bao gồm trong gói của bạn. Trình kích hoạt kiểm tra mà bạn chọn ảnh hưởng đến tổng chi phí:

Chi phí xuất hiện trên hóa đơn Anthropic của bạn bất kể tổ chức của bạn sử dụng AWS Bedrock hay Google Vertex AI cho các tính năng Claude Code khác.

Để thiết lập giới hạn chi tiêu hàng tháng, hãy vàoCài đặt tổ chức > Sử dụngvà cấu hình giới hạn cho dịch vụ Đánh giá Mã Claude.

Theo dõi chi tiêu thông qua biểu đồ chi phí hàng tuần trong bảng điều khiển phân tích hoặc cột chi phí trung bình theo kho lưu trữ trong cài đặt quản trị.

Đi đếnBảng điều khiển phân tích kiểm tra mãđể xem hoạt động trên toàn bộ tổ chức của bạn. Bảng điều khiển hiển thị:

Nếu bạn đã cài đặt Ứng dụng Claude GitHub nhưng các kho lưu trữ của bạn không xuất hiện trong bảng quản trị:

Nếu không có kiểm tra nào chạy sau khi mở PR:

Nếu tổ chức GitHub Enterprise Cloud của bạn giới hạn quyền truy cập theo địa chỉ IP, ứng dụng Claude GitHub có thể không thể truy cập các kho lưu trữ của bạn. Để khắc phục điều này,bật kế thừa danh sách cho phép IP cho các Ứng dụng GitHub đã cài đặttrong cài đặt GitHub doanh nghiệp của bạn. Ứng dụng Claude GitHub đăng ký các dải IP của nó, vì vậy việc bật cài đặt này cho phép truy cập mà không cần cấu hình thủ công. Đểthêm các phạm vi vào danh sách cho phép của bạn thủ côngthay vào đó, hoặc để cấu hình các tường lửa khác, xemĐịa chỉ IP của API Anthropic.

Máy chủ GitHub Enterprise (GHES) tự lưu trữ được hỗ trợ thông qua một quy trình cài đặt riêng. XemClaude Code với GitHub Enterprise Serverđể có hướng dẫn đầy đủ.

Các vấn đề thường gặp khi thiết lập GHES:

Không, Code Review không khả dụng để thêm vàovai trò tùy chỉnhvào thời điểm này.