OpenCodeReview: tự động rà lỗi code chính xác — hướng dẫn cài đặt và dùng
Bài này là một góc nhìn khác về alibaba/open-code-review — repo từng đổi tên nên mình viết lại với cách tiếp cận khác. Bài hướng dẫn chính: alibaba/open-code-review: review code chính xác — hướng dẫn cài đặt và dùng →

Tóm tắt nhanh
OpenCodeReview là CLI AI của Alibaba để review thay đổi trong Git hoặc quét toàn bộ file, kết hợp pipeline xác định với LLM Agent. Công cụ hỗ trợ nhận xét đến từng dòng, nhiều luật phát hiện lỗi và các nhà cung cấp OpenAI, Anthropic. Cài qua npm khá đơn giản, nhưng bạn cần Git và cấu hình LLM nếu dùng chế độ OCR quản lý.
OpenCodeReview là công cụ CLI dùng AI để review code trong dự án Git. Công cụ đọc diff, chọn đúng file cần kiểm tra, gửi ngữ cảnh phù hợp cho LLM rồi tạo nhận xét có vị trí cụ thể đến từng dòng. Bạn cũng có thể quét toàn bộ file khi dự án chưa có diff phù hợp.
Repo này phù hợp với dev cá nhân, nhóm phát triển phần mềm, người phụ trách kiểm thử code và đội vận hành CI/CD. Điểm đáng giá là OpenCodeReview không chỉ đưa diff cho một chatbot rồi chờ nhận xét. Nó kết hợp các bước xác định như chọn file, gom nhóm file, áp dụng luật và định vị comment với khả năng suy luận của agent. Nhờ vậy, kết quả hướng tới độ chính xác cao và ít cảnh báo gây nhiễu hơn.
Repo hiện có khoảng 50.193 sao và 3.726 fork. Đây là dự án viết bằng Go, phát hành theo giấy phép Apache-2.0 và vẫn còn được cập nhật.
alibaba/open-code-review
CLI AI review code theo diff hoặc toàn bộ file, phát hiện lỗi bảo mật và tạo nhận xét chính xác đến từng dòng.
I.OpenCodeReview làm được gì
Review thay đổi trong Git: Công cụ có thể xem các thay đổi đã stage, chưa stage và file chưa được theo dõi trong workspace. Bạn cũng có thể chỉ định khoảng giữa hai branch hoặc review một commit cụ thể.
Quét toàn bộ file: Lệnh
ocr scanphù hợp khi bạn muốn audit một repository, thư mục hoặc một nhóm file mà không phụ thuộc vào lịch sử Git hay diff hiện tại. Đây là cách hữu ích khi tiếp nhận code cũ hoặc kiểm tra một module chưa có thay đổi mới.Nhận xét chính xác đến dòng: Kết quả được tạo dưới dạng comment có vị trí cụ thể. Điều này giúp dev mở đúng file, đúng dòng và xử lý vấn đề nhanh hơn thay vì phải tự dò lại cả diff.
Agent có thể đọc thêm ngữ cảnh: Agent không chỉ xem phần dòng vừa sửa. Nó có thể đọc nội dung đầy đủ của file, tìm kiếm trong codebase và kiểm tra các file thay đổi khác. Nhờ đó, review có cơ sở hơn khi lỗi phụ thuộc vào hàm hoặc module bên ngoài diff.
Luật review tích hợp: Mô tả dự án cho biết công cụ có các ruleset đa ngôn ngữ cho những nhóm lỗi như Null Pointer Exception, thread-safety, XSS và SQL injection. Các luật được ghép với đặc điểm của từng file để giảm thông tin không liên quan đưa vào model.
Kiến trúc kết hợp pipeline và agent: Những việc cần chính xác như chọn file, gom file liên quan, định vị comment và phản chiếu lại nội dung được xử lý bằng các module có tính xác định. Agent tập trung vào việc suy luận, chọn ngữ cảnh và giải thích vấn đề.
Hỗ trợ nhiều cách chạy review: Bạn có thể để OpenCodeReview tự gọi LLM qua cấu hình riêng, hoặc dùng Delegation Mode để coding agent hiện có thực hiện review bằng model và thông tin đăng nhập của nó.
Tiếp tục phiên bị gián đoạn: Với review theo branch, commit hoặc full-file scan, bạn có thể xem danh sách session và tiếp tục một phiên đã dừng.
Xuất kết quả JSON: Kết quả review có thể lưu vào file JSON. Cách này phù hợp khi một AI coding agent hoặc quy trình tự động cần đọc và xử lý kết quả.
Có đường tích hợp cho agent và CI/CD: Tài liệu dự án có các hướng tích hợp cho Claude Code, Codex, Cursor, Kimi Code, OpenCode, QCA Forward, agent tương thích skill và nhiều hệ thống CI/CD.
II.Cần chuẩn bị gì
Git từ phiên bản 2.41 trở lên. OpenCodeReview dùng Git để tạo diff, tìm kiếm code và thực hiện các thao tác với repository.
Node.js từ phiên bản 14 trở lên nếu cài CLI qua npm. Thông tin này được khai báo trong
package.jsoncủa repo.Một LLM đã cấu hình nếu bạn dùng các lệnh
ocr review, command review của plugin hoặc skillopen-code-review. Công cụ hỗ trợ provider dựng sẵn hoặc provider tùy chỉnh, và mô tả dự án cho biết có tương thích với OpenAI và Anthropic.API key hoặc thông tin xác thực phù hợp với provider khi OpenCodeReview là bên gọi model. Yêu cầu xác thực cụ thể phụ thuộc provider bạn chọn.
Không cần cấu hình LLM riêng trong OCR khi dùng Delegation Mode. Ở chế độ này, coding agent chủ trì việc gọi model bằng model và thông tin xác thực mà agent đó đã cấu hình.
README không nêu yêu cầu GPU, loại CPU hay hệ điều hành cụ thể. Vì vậy, không nên tự suy ra rằng công cụ bắt buộc có GPU hoặc chỉ chạy trên một hệ điều hành nhất định.
III.Cài đặt từng bước
- Kiểm tra môi trườngĐảm bảo Git và Node.js đáp ứng phiên bản yêu cầu
- Cài CLICài gói OpenCodeReview toàn cục bằng npm
- Cấu hình LLMChọn provider, model và nhập thông tin xác thực nếu cần
- Review thửChạy review trên thay đổi trong một project Git
- Chọn cách chạy phù hợpDùng scan, branch range, commit, JSON hoặc Delegation Mode
A.Kiểm tra Git và Node.js
Mở Terminal hoặc PowerShell. Bạn có thể mở ngay tại thư mục dự án bằng cách chọn thư mục đó rồi mở terminal, hoặc dùng lệnh cd để chuyển vào thư mục sau khi mở terminal.
README yêu cầu Git từ 2.41 trở lên. Repo cũng khai báo Node.js từ 14 trở lên trong package.json. README không đưa lệnh kiểm tra phiên bản cụ thể, nên bạn có thể kiểm tra bằng các lệnh phổ thông sau:
git --version
node --version
npm --versionNếu Git quá cũ, hãy nâng cấp Git trước. Nếu lệnh node hoặc npm không được nhận diện, bạn chưa cài Node.js hoặc terminal chưa nhận được đường dẫn cài đặt mới.
B.Cài OpenCodeReview qua npm
Cài gói CLI trên toàn hệ thống bằng lệnh có trong README:
npm install -g @alibaba-group/open-code-reviewTùy chọn -g giúp lệnh được cài toàn cục, để bạn có thể gọi ocr từ các repository khác nhau. Sau khi cài xong, lệnh ocr sẽ sẵn sàng sử dụng.
Nếu npm báo lỗi quyền truy cập, không nên tùy tiện chạy lệnh với quyền cao hoặc đổi thư mục hệ thống khi chưa hiểu nguyên nhân. Hãy kiểm tra cách npm được cài trên máy và quyền của thư mục cài package. README có đề cập các cách cài khác như install script, binary từ GitHub Release và build từ source; phần hướng dẫn chi tiết nằm trong tài liệu Installation của dự án.
C.Cấu hình provider và model
Di chuyển vào project Git mà bạn muốn review. Nếu bạn chưa có project riêng, hãy mở terminal tại project đó; README dùng tên minh họa your-project, không phải một đường dẫn cố định.
Nếu để OpenCodeReview tự gọi model, chạy hai lệnh sau:
ocr config provider
ocr config modelLệnh đầu tiên cho bạn chọn provider dựng sẵn hoặc thêm provider tùy chỉnh. Lệnh thứ hai chọn model cho provider đang hoạt động. Giao diện tương tác sẽ hướng dẫn chọn provider, nhập API key và cấu hình model, sau đó tự kiểm tra kết nối.
Cần phân biệt hai trường hợp. ocr review, command /open-code-review:review và skill open-code-review dùng cấu hình provider riêng của OpenCodeReview. Chúng không dùng thông tin đăng nhập gói Claude Code Team hoặc Pro của bạn. Ngược lại, /open-code-review:delegate-review và skill open-code-review-delegate để host agent gọi model, nên không cần cấu hình LLM hoặc credential riêng trong OCR.
D.Review thay đổi trong workspace
Sau khi đã vào project, chạy:
cd your-project
ocr reviewỞ workspace mode, công cụ review toàn bộ thay đổi đã stage, chưa stage và file chưa được theo dõi. Đây là cách nhanh nhất để thử lần đầu sau khi bạn sửa code.
Nếu bạn muốn review thay đổi của một feature branch kể từ lúc branch đó tách khỏi main, dùng merge-base mode:
ocr review --from main --to feature-branchThay main và feature-branch bằng tên branch thực tế trong repository của bạn. Nếu branch không tồn tại hoặc bạn đang đứng nhầm repository, Git sẽ không cung cấp được phạm vi thay đổi hợp lệ.
Để review một commit cụ thể:
ocr review --commit abc123Thay abc123 bằng mã commit bạn muốn kiểm tra.
E.Quét toàn bộ file hoặc thư mục
Khi không muốn review diff mà muốn audit code hiện có, dùng:
ocr scan
ocr scan --path internal/agentLệnh đầu tiên quét toàn bộ repository. Lệnh thứ hai quét thư mục hoặc file được chỉ định. README nhấn mạnh full-file scan không cần lịch sử Git, nên cách này phù hợp khi bạn đang xem code được nhận bàn giao hoặc một thư mục không có diff có ý nghĩa.
F.Lưu và tiếp tục kết quả
Để xem các session đã có:
ocr session listNếu một review theo branch hoặc commit bị gián đoạn, tiếp tục bằng:
ocr review --from main --to feature-branch --resume <session-id>Với full-file scan, dùng:
ocr scan --resume <session-id><session-id> là mã session được hiển thị khi bạn liệt kê session. Không nhập nguyên dấu ngoặc nhọn; hãy thay bằng mã thật.
Bạn cũng có thể lưu kết quả dưới dạng JSON:
ocr review --format json --output result.jsonCách này thích hợp khi muốn chuyển kết quả cho AI coding agent hoặc một bước khác trong pipeline. Hãy kiểm tra quyền ghi của thư mục hiện tại nếu file result.json không được tạo.
G.Dùng Delegation Mode
Nếu coding agent của bạn đã có model và credential, có thể để agent thực hiện review. OCR vẫn xử lý việc chọn file và giải quyết ruleset, nhưng không cần cấu hình LLM riêng trong OCR.
ocr delegate preview
ocr delegate rule src/main.go src/handler.goocr delegate preview cho xem thông tin chuẩn bị cho delegation. ocr delegate rule cho phép xem luật áp dụng cho các file được chỉ định. README không cung cấp trong phần trích dẫn một lệnh đầy đủ để bắt đầu toàn bộ delegation review, vì vậy bạn nên xem tài liệu Delegation và phần tích hợp coding agent trước khi đưa vào quy trình chính thức.
API key được nhập trong bước cấu hình provider và có thể phát sinh chi phí theo model hoặc provider. Chỉ cấp credential cần thiết, không đưa key vào source code, diff hoặc file kết quả chia sẻ công khai.
IV.Kiểm tra đã chạy được chưa
Có thể xem là cài thành công khi lệnh ocr được nhận diện sau bước cài npm. Khi chạy ocr config provider, giao diện cấu hình phải mở được để bạn chọn provider hoặc thêm provider tùy chỉnh. Sau khi nhập cấu hình, công cụ tự kiểm tra kết nối.
Bài kiểm tra thực tế là vào một project Git có thay đổi rồi chạy ocr review. Kết quả mong đợi là một phiên review có các nhận xét có cấu trúc và vị trí đến từng dòng. Nếu project không có diff phù hợp, hãy thử ocr scan để quét toàn bộ repository hoặc chỉ định một thư mục bằng --path.
Bạn cũng có thể chạy review theo branch hoặc commit để kiểm tra phạm vi đầu vào. Nếu cần xác nhận kết quả có thể dùng trong tự động hóa, chạy với --format json --output result.json và kiểm tra file kết quả được tạo.
V.Dùng vào việc thật
A.Chủ shop có đội dev thuê ngoài
Chủ shop không cần tự đọc từng dòng code, nhưng có thể yêu cầu đội dev đưa thay đổi vào một branch rồi chạy review trước khi triển khai. Dev chuyển vào project và chạy:
ocr review --from main --to feature-branchKết quả giúp đội phát hiện các vấn đề như truy vấn có nguy cơ SQL injection, lỗi XSS hoặc lỗi đồng thời trước khi merge. Người phụ trách không nên xem AI là bước nghiệm thu duy nhất, nhưng có thể dùng danh sách comment để yêu cầu dev giải thích và sửa từng điểm.
B.Nhân viên văn phòng phụ trách quy trình nội bộ
Một nhân viên không chuyên sâu về lập trình có thể dùng ocr scan khi công ty nhận bàn giao một thư mục code cũ. Ví dụ, họ nhờ dev cài sẵn CLI, sau đó quét phần xử lý tài khoản:
ocr scan --path internal/agentCông cụ đọc toàn bộ thư mục được chỉ định thay vì chỉ nhìn các file vừa sửa. Kết quả giúp nhóm biết những điểm cần nhờ kỹ thuật kiểm tra lại, đặc biệt trong các khu vực có dữ liệu người dùng hoặc xử lý nhiều luồng.
C.Dev kiểm tra pull request trước khi gửi review
Một dev vừa hoàn thành feature có thể review các thay đổi trong workspace:
ocr reviewNếu muốn gửi kết quả cho một coding agent để hỗ trợ sửa lỗi, lưu JSON:
ocr review --format json --output result.jsonDev có thể mở từng file theo line-level comment, sửa lỗi, rồi chạy lại review. Cách làm này giảm thời gian đọc cảnh báo chung chung vì mỗi comment đã gắn với vị trí cụ thể.
D.Đội kỹ thuật kiểm tra commit hoặc chạy lại phiên lỗi
Khi cần rà một commit riêng lẻ, đội kỹ thuật dùng:
ocr review --commit abc123Nếu phiên review lớn bị gián đoạn, họ không cần bắt đầu lại từ đầu. Họ xem session và tiếp tục:
ocr session list
ocr review --from main --to feature-branch --resume <session-id>Điều này phù hợp với changeset lớn hoặc quy trình chạy trong môi trường có thời gian thực thi giới hạn.
Một lần review tốt không chỉ tìm lỗi; nó giúp cả đội nhìn đúng vào phần code cần sửa.
Ông T
VI.Lỗi hay gặp và cách xử lý
A.Lệnh ocr không được nhận diện
Nguyên nhân thường là package chưa cài thành công hoặc thư mục binary toàn cục của npm chưa nằm trong PATH. Hãy chạy lại lệnh cài trong README và kiểm tra npm, sau đó mở terminal mới để nhận PATH mới. Nếu vẫn lỗi, xem hướng dẫn Installation của dự án thay vì tự đoán đường dẫn binary.
B.Git không đáp ứng phiên bản yêu cầu
OpenCodeReview yêu cầu Git từ 2.41 vì công cụ dùng Git cho diff, tìm kiếm và thao tác repository. Kiểm tra bằng git --version, sau đó nâng cấp Git nếu phiên bản thấp hơn. Lỗi này có thể làm các thao tác chọn phạm vi thay đổi hoạt động không đúng.
C.Review không kết nối được model
Nếu dùng ocr review, hãy chạy lại ocr config provider và ocr config model. Kiểm tra provider, model và API key; giao diện cấu hình có bước tự kiểm tra kết nối. Nếu dùng Delegation Mode, hãy nhớ rằng model và credential phải được cấu hình ở host agent, không phải trong OCR.
D.Không thấy kết quả khi chạy review
Bạn có thể đang đứng ngoài repository, branch không tồn tại hoặc workspace không có thay đổi mà mode đang dùng cần. Kiểm tra lại thư mục hiện tại, tên branch và commit. Nếu không có diff nhưng muốn audit code, dùng ocr scan hoặc ocr scan --path.
E.Review bị dừng giữa chừng
Đừng vội chạy lại toàn bộ nếu phiên cũ vẫn có thể tiếp tục. Dùng ocr session list để lấy session ID, sau đó thêm --resume vào lệnh review branch, commit hoặc scan tương ứng. Với thay đổi lớn, tiếp tục session giúp tránh lặp lại phần đã xử lý và tránh phát sinh thêm chi phí model không cần thiết.
VII.Có nên dùng không
OpenCodeReview đáng cân nhắc nếu bạn cần review tự động theo quy trình rõ ràng, muốn comment chính xác đến dòng và cần kiểm tra cả diff lẫn toàn bộ file. Kiến trúc hybrid là điểm mạnh: phần chọn file, gom ngữ cảnh, áp dụng rule và định vị comment có ràng buộc kỹ thuật; agent tập trung vào suy luận. README cũng nêu benchmark cho thấy công cụ ưu tiên precision, dùng khoảng một phần chín số token so với agent đa dụng trong cùng điều kiện benchmark, đồng thời hoàn thành review nhanh hơn. Tuy nhiên, recall thấp hơn agent đa dụng là một đánh đổi có chủ đích.
Công cụ phù hợp với đội đã dùng Git, có thể cấu hình LLM và muốn đưa review vào local workflow hoặc CI/CD. Nó cũng hữu ích khi cần audit code cũ mà không có diff.
Giới hạn là README không nêu yêu cầu phần cứng và hệ điều hành chi tiết, không có số liệu chi phí model, và kết quả vẫn phụ thuộc provider, model cùng cấu hình xác thực. AI review không thay thế kiểm thử, review của kỹ sư và quy trình bảo mật. Nếu bạn chỉ cần một chatbot giải thích vài dòng code, công cụ này có thể nhiều bước hơn cần thiết. Nếu bạn cần độ bao phủ tối đa thay vì ít cảnh báo sai, hãy cân nhắc agent đa dụng hoặc kết hợp thêm công cụ phân tích tĩnh chuyên biệt.
Câu hỏi thường gặp
OpenCodeReview có miễn phí không?
Repo phát hành theo giấy phép Apache-2.0. Tuy nhiên, README không nói chi phí dùng API của từng provider hoặc model, nên tổng chi phí vận hành chưa được xác định từ tư liệu này.
Có cần GPU để chạy không?
README không nêu yêu cầu GPU hay phần cứng cụ thể. Vì vậy chưa có thông tin để khẳng định công cụ cần GPU hoặc cấu hình máy nào.
Có chạy được trên Windows không?
Tư liệu được cung cấp không nêu danh sách hệ điều hành được hỗ trợ. Repo có `install.ps1` và `install.sh`, nhưng chỉ riêng tên file chưa đủ để kết luận đầy đủ về mức hỗ trợ Windows.
Có cần API key không?
Nếu dùng chế độ OCR tự gọi model cho `ocr review`, bạn cần cấu hình provider, model và thông tin xác thực phù hợp. Nếu dùng Delegation Mode, model và credential do host coding agent quản lý nên không cần cấu hình LLM riêng trong OCR.
OpenCodeReview khác gì agent đa dụng như Claude Code?
OpenCodeReview dùng kiến trúc hybrid, trong đó các bước chọn file, gom file, áp dụng rule và định vị comment có ràng buộc xác định. README cho biết benchmark của dự án ưu tiên precision và dùng khoảng một phần chín số token so với agent đa dụng trong cùng điều kiện, nhưng recall thấp hơn.
Có thể review toàn bộ repository không cần diff không?
Có. Lệnh `ocr scan` quét toàn bộ repository, còn `ocr scan --path` quét một thư mục hoặc file cụ thể và không cần lịch sử Git.
Có thể dùng kết quả trong CI hoặc chuyển cho AI agent không?
Có thể lưu kết quả review bằng `ocr review --format json --output result.json`, phù hợp cho AI host agent hoặc quy trình tự động. Tài liệu dự án cũng có phần tích hợp CI/CD, nhưng chi tiết cấu hình không nằm trong README được cung cấp.


