Bỏ qua tới nội dung
Ông T.vn

OpenCodeReview: tự động rà lỗi code chính xác — hướng dẫn cài đặt và dùng

13 phút đọcCập nhật

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 →

OpenCodeReview: tự động rà lỗi 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.

CLI

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.

★ 50kGoApache-2.0
Xem repo trên GitHub

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 scan phù 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.json củ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 skill open-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

  1. Kiểm tra môi trườngĐảm bảo Git và Node.js đáp ứng phiên bản yêu cầu
  2. Cài CLICài gói OpenCodeReview toàn cục bằng npm
  3. Cấu hình LLMChọn provider, model và nhập thông tin xác thực nếu cần
  4. Review thửChạy review trên thay đổi trong một project Git
  5. 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:

Terminal
git --version
node --version
npm --version

Nế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:

Terminal
npm install -g @alibaba-group/open-code-review

Tù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:

Terminal
ocr config provider
ocr config model

Lệ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:

Terminal
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:

Terminal
ocr review --from main --to feature-branch

Thay 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ể:

Terminal
ocr review --commit abc123

Thay 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:

Terminal
ocr scan
ocr scan --path internal/agent

Lệ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ó:

Terminal
ocr session list

Nếu một review theo branch hoặc commit bị gián đoạn, tiếp tục bằng:

Terminal
ocr review --from main --to feature-branch --resume <session-id>

Với full-file scan, dùng:

Terminal
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:

Terminal
ocr review --format json --output result.json

Cá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.

Terminal
ocr delegate preview
ocr delegate rule src/main.go src/handler.go

ocr 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:

Terminal
ocr review --from main --to feature-branch

Kế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:

Terminal
ocr scan --path internal/agent

Cô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:

Terminal
ocr review

Nếu muốn gửi kết quả cho một coding agent để hỗ trợ sửa lỗi, lưu JSON:

Terminal
ocr review --format json --output result.json

Dev 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:

Terminal
ocr review --commit abc123

Nế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:

Terminal
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.

4.5/5 · Ông T chấm

Chưa có độc giả chấm

Bài này có ích với bạn không?

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.

Chuyển nhanh tới mục

  1. I.OpenCodeReview làm được gì
  2. II.Cần chuẩn bị gì
  3. III.Cài đặt từng bước
    1. A.Kiểm tra Git và Node.js
    2. B.Cài OpenCodeReview qua npm
    3. C.Cấu hình provider và model
    4. D.Review thay đổi trong workspace
    5. E.Quét toàn bộ file hoặc thư mục
    6. F.Lưu và tiếp tục kết quả
    7. G.Dùng Delegation Mode
  4. IV.Kiểm tra đã chạy được chưa
  5. V.Dùng vào việc thật
    1. A.Chủ shop có đội dev thuê ngoài
    2. B.Nhân viên văn phòng phụ trách quy trình nội bộ
    3. C.Dev kiểm tra pull request trước khi gửi review
    4. D.Đội kỹ thuật kiểm tra commit hoặc chạy lại phiên lỗi
  6. VI.Lỗi hay gặp và cách xử lý
    1. A.Lệnh ocr không được nhận diện
    2. B.Git không đáp ứng phiên bản yêu cầu
    3. C.Review không kết nối được model
    4. D.Không thấy kết quả khi chạy review
    5. E.Review bị dừng giữa chừng
  7. VII.Có nên dùng không

Repo & Skill · 13/11/2026 · 11 phút đọc

Garden Skills: bộ skill thiết kế web, tạo ảnh, làm video cho AI — hướng dẫn cài đặt và dùng

Garden Skills là bộ sưu tập Agent Skills (kỹ năng cho AI) của tác giả ConardLi, dùng được với Claude Code, Cursor, Codex và các AI coding agent khác. Mỗi skill dạy agent làm tốt một việc như thiết kế trang web, tạo ảnh, làm video bằng code, biến tài liệu thành bài viết đẹp. Cài không khó, nhưng README có nhiều cách cài nên bạn cần chọn một cách hợp với công cụ đang dùng.

Repo & Skill · 13/11/2026 · 15 phút đọc

thesysdev/openui: xây giao diện AI dạng streaming — hướng dẫn cài đặt và dùng

OpenUI là framework full-stack, độc lập framework, giúp mô hình AI sinh giao diện có cấu trúc và hiển thị dần khi dữ liệu streaming về. Bạn có thể dựng nhanh một ứng dụng chat bằng CLI hoặc cài từng gói cho React, Vue, Svelte, Angular và LangChain. Việc bắt đầu khá đơn giản nếu máy có đúng phiên bản Node; README chưa ghi đầy đủ lệnh chạy ứng dụng sau khi scaffold.

Repo & Skill · 13/11/2026 · 11 phút đọc

Ruflo: điều phối nhóm agent AI cho Claude Code và Codex — hướng dẫn cài đặt và dùng

Ruflo (trước đây là Claude Flow) là một agent harness: lớp công cụ bao quanh Claude Code và Codex, bổ sung nhiều agent chuyên biệt, bộ nhớ qua các phiên và khả năng chia việc cho nhóm agent. Cài bằng một lệnh `npx ruflo@latest init` trong thư mục dự án, cần Node 20 trở lên. Cài khá dễ, nhưng hệ thống rất rộng nên bạn nên bắt đầu từ một tác vụ nhỏ.