Open Code Review: Hướng dẫn cài đặt và dùng AI code review mã nguồn mở của Alibaba

Tóm tắt nhanh (Key Takeaways)
Open Code Review, hay OpenCodeReview, là công cụ AI code review mã nguồn mở do Alibaba phát triển dưới dạng CLI ocr. Điểm đáng chú ý nhất của dự án không phải chỉ là “đưa diff cho LLM”, mà là kiến trúc lai: phần mềm truyền thống chịu trách nhiệm chọn file, ghép ngữ cảnh, áp dụng rule và định vị comment; LLM Agent tập trung vào suy luận và tìm lỗi. Công cụ có thể review code chưa commit, so sánh branch, kiểm tra một commit hoặc scan toàn bộ source code. Cách bắt đầu nhanh nhất là cài bằng npm, cấu hình LLM bằng giao diện tương tác rồi chạy ocr review. Open Code Review cũng hỗ trợ nhiều provider, endpoint tương thích OpenAI/Anthropic, local model qua Ollama, CI/CD và chế độ delegation để tận dụng LLM của coding agent đang dùng.

Open Code Review là một AI-powered code review CLI, được Alibaba mở mã nguồn sau quá trình phát triển từ công cụ review code AI nội bộ. Theo mô tả của dự án, phiên bản nội bộ đã phục vụ hàng chục nghìn developer và phát hiện hàng triệu lỗi code trong khoảng hai năm trước khi được đưa ra cộng đồng. Công cụ được phát hành theo giấy phép Apache-2.0.

Khác với cách đơn giản là lấy git diff, nhét toàn bộ vào prompt rồi yêu cầu một chatbot “review code”, Open Code Review kết hợp deterministic engineering với LLM Agent. Phần deterministic quyết định file nào cần review, nhóm những file liên quan, chọn rule phù hợp và xử lý vị trí comment. Agent đảm nhiệm những phần cần suy luận linh hoạt: đọc nội dung file đầy đủ, tìm kiếm trong codebase, kiểm tra các file liên quan và gọi tool để thu thập thêm context.

Điều này cũng có nghĩa Open Code Review không phải một SaaS code review bắt buộc phải gửi repository lên một dashboard riêng. Thành phần chính là CLI chạy trong môi trường development hoặc CI của bạn; LLM phía sau có thể là dịch vụ cloud hoặc endpoint riêng, tùy cách cấu hình. Tài liệu chính thức nằm tại open-codereview.ai.

Vì sao Open Code Review đáng chú ý?

Giá trị lớn nhất của Open Code Review nằm ở việc thu hẹp phạm vi mà LLM phải tự quyết định. Với một general-purpose coding agent, model có thể tự chọn file cần đọc, tự quyết định thứ tự review và tự suy luận vị trí comment. Điều này linh hoạt nhưng dễ dẫn đến bỏ sót file, comment sai dòng hoặc kết quả thay đổi nhiều khi prompt thay đổi. Open Code Review đưa các bước có thể xác định bằng logic về cho phần mềm truyền thống, còn model tập trung vào phân tích code.

Alibaba cũng công bố AACR-Bench để đánh giá cách tiếp cận này. Benchmark của dự án sử dụng 200 Pull Request thực từ 50 repository mã nguồn mở, trải trên 10 ngôn ngữ và có 1.505 lỗi ground truth được cross-validation bởi hơn 80 senior engineer. Theo kết quả do chính dự án công bố, khi sử dụng cùng model nền, Open Code Review đạt Precision và F1 cao hơn Claude Code trong bài test này, tiêu thụ khoảng 1/9 lượng token và hoàn thành nhanh hơn; đổi lại Recall thấp hơn. Vì đây là benchmark của tác giả dự án, nên nên xem kết quả như một tín hiệu thiết kế đáng tham khảo thay vì một kết luận độc lập tuyệt đối.

Một ưu điểm thực tế khác là Open Code Review không giới hạn ở diff. ocr review phù hợp cho thay đổi đang phát triển, branch hoặc commit, trong khi ocr scan đọc toàn bộ file để audit một repository, thư mục hoặc codebase mà không cần một Git diff có ý nghĩa.

Cách cài đặt Open Code Review

Yêu cầu nền tảng quan trọng là Git 2.41 trở lên. Nếu chọn cách cài bằng npm, quickstart của dự án yêu cầu Node.js 18 trở lên. Người dùng delegation mode không cần API key riêng cho Open Code Review; với chế độ review mặc định, bạn cần quyền truy cập một LLM provider.

Cách đơn giản và được tài liệu khuyến nghị là npm:

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

Kiểm tra sau khi cài:

ocr version

Sau bước này, lệnh ocr có thể được gọi toàn cục từ terminal. Với bản cài npm, dự án còn có cơ chế kiểm tra cập nhật tự động; người dùng có thể tắt bằng biến môi trường OCR_NO_UPDATE nếu cần môi trường build có phiên bản cố định.

Trên macOS hoặc Linux, bạn cũng có thể dùng Homebrew:

brew install open-code-review

Hoặc dùng installation script, đặc biệt tiện cho CI runner:

curl -fsSL https://open-codereview.ai/install.sh | sh

Tài liệu hiện còn hỗ trợ MacPorts, binary dựng sẵn cho macOS, Linux và Windows, cũng như phương án build/install phù hợp với từng môi trường. Điều này hữu ích khi bạn không muốn đưa Node.js vào image CI chỉ để chạy code review.

Cấu hình LLM cho lần chạy đầu tiên

Sau khi cài CLI, cách dễ nhất là sử dụng trình cấu hình tương tác:

ocr config provider
ocr config model

ocr config provider cho phép chọn provider, nhập API key và model. Sau khi lưu, Open Code Review có thể kiểm tra kết nối đến endpoint. Bạn cũng có thể chủ động test lại bằng:

ocr llm test

Cấu hình được lưu tại ~/.opencodereview/config.json. Ngoài giao diện tương tác, CLI hỗ trợ ocr config set <key> <value>, phù hợp với server và CI nơi không có TUI.

Danh sách provider tích hợp hiện bao gồm Anthropic, OpenAI, AWS Bedrock, Gemini, DashScope, DeepSeek, Kimi, xAI cùng nhiều dịch vụ khác. Quan trọng hơn, Open Code Review hỗ trợ custom provider theo các protocol tương thích OpenAI, OpenAI Responses hoặc Anthropic. Vì vậy bạn có thể đặt một LiteLLM gateway, API gateway nội bộ hoặc endpoint riêng ở giữa tool và model.

Local LLM cũng khả thi. Chẳng hạn, một Ollama server có thể được khai báo như OpenAI-compatible endpoint:

ocr config set provider ollama
ocr config set custom_providers.ollama.url http://127.0.0.1:11434/v1
ocr config set custom_providers.ollama.protocol openai
ocr config set custom_providers.ollama.model qwen3:32b
ocr config set custom_providers.ollama.api_key ollama

Model local cần hỗ trợ native tool calling vì Agent của Open Code Review sử dụng tool trong quá trình thu thập context và review.

Cách sử dụng ocr review và ocr scan

Workflow cơ bản nhất là mở terminal tại repository đang làm việc:

cd your-project
ocr review

Ở workspace mode, Open Code Review review các thay đổi staged, unstaged và untracked. Đây là cách phù hợp để chạy AI code review trước khi commit hoặc push lên remote.

Để review toàn bộ thay đổi của feature branch kể từ điểm tách khỏi main:

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

Để kiểm tra riêng một commit:

ocr review --commit abc123

Với một codebase cũ hoặc repository bạn vừa tiếp quản, ocr scan thường hữu ích hơn diff review:

# Scan toàn repository
ocr scan

# Chỉ audit một thư mục
ocr scan --path internal/agent

Nếu review bị gián đoạn, Open Code Review lưu session để có thể xem danh sách và tiếp tục:

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

Khi cần đưa kết quả sang agent khác, script hoặc hệ thống CI, bạn có thể xuất JSON:

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

Một mẹo hữu ích với repository lớn là chạy preview trước khi tiêu tốn token. Kiến trúc của Open Code Review cung cấp chế độ preview để kiểm tra file-selection và filtering trước khi thực sự gọi model, giúp bạn phát hiện rule hoặc phạm vi review chưa đúng.

Dùng Open Code Review trong coding agent và CI/CD

Open Code Review còn có delegation mode dành cho các coding agent đã có LLM subscription như Claude Code, Codex, Cursor hoặc các agent tương thích. Trong chế độ này, OCR lo phần engineering scaffold như file selection, rule resolution và exclusion; host agent thực hiện phần suy luận bằng model của chính nó. Vì OCR không trực tiếp gọi LLM ở chế độ này, bạn không phải cấu hình thêm API key cho OCR.

Ở phía CI/CD, dự án cung cấp hướng tích hợp cho GitHub Actions, GitLab CI, GitFlic CI và Gerrit. Pattern chung là cài ocr trên runner, lấy LLM credential từ secret, chạy review trên range của Pull Request hoặc Merge Request rồi đưa findings trở lại quy trình review. Ví dụ GitHub Actions chính thức có thể đăng các finding có thông tin dòng dưới dạng inline review comment, trong khi finding không gắn với dòng cụ thể được gom vào phần summary.

Với team, nên bắt đầu bằng local review trước khi bật CI bắt buộc. Hãy chạy OCR trên vài Pull Request thực tế, điều chỉnh provider, model, review rule và mức effort, sau đó mới đưa nó thành quality gate. Open Code Review cho phép effort ở các mức low, medium và high; số vòng review tăng dần, đồng nghĩa khả năng tìm thêm vấn đề có thể tăng nhưng thời gian và token cũng tăng.

Open Code Review phù hợp với ai?

Open Code Review đặc biệt đáng thử nếu team đã dùng LLM trong development nhưng muốn code review AI có quy trình dễ kiểm soát hơn một prompt tự do. Nó phù hợp cho developer muốn review trước commit, maintainer cần kiểm tra Pull Request, team DevOps muốn tự động hóa review trong CI và nhóm cần audit một codebase lớn bằng ocr scan. Khả năng kết nối cả cloud model, gateway riêng và local LLM cũng giúp kiến trúc triển khai linh hoạt hơn.

Điểm cần nhớ là đây vẫn là công cụ hỗ trợ review, không phải sự thay thế tuyệt đối cho reviewer con người, static analysis, test suite hay security scanner. Ngay benchmark của chính dự án cũng cho thấy thiết kế ưu tiên Precision và giảm nhiễu có sự đánh đổi về Recall. Cách dùng hợp lý nhất là đặt Open Code Review thành một lớp kiểm tra sớm: để AI tìm những vấn đề đáng chú ý trước, còn quyết định merge cuối cùng vẫn dựa trên test, tooling và judgment của engineering team.