Skip to Content
aicentos

OpenCodeReview

Dùng aicentos trong OpenCodeReview (OCR) —— kết nối review code qua provider tùy chỉnh

Cập nhật lần cuối:

OpenCodeReview (tên lệnh ocr) là CLI review code AI mã nguồn mở của Alibaba: đọc Git diff rồi gọi mô hình lớn đưa ra ý kiến review. Nó tích hợp sẵn provider OpenAI tương thích, cũng hỗ trợ gateway OpenAI tương thích tùy chỉnh, có thể chuyển yêu cầu sang aicentos.

Chuẩn bị

Tạo một Key chuyên dụng trong Console của aicentos (khuyến nghị đặt tên ocr-ci để dễ theo dõi mức sử dụng). OCR chỉ hỗ trợ hai giao thức OpenAI / Anthropic, ở đây đi đường Chat Completions của OpenAI. Review code phụ thuộc vào khả năng function calling của mô hình, hãy chọn mô hình hỗ trợ gọi công cụ.

Cấu hình cần điền

TrườngGiá trị
provideropenai (tích hợp sẵn, ghi đè URL của nó) hoặc provider tùy chỉnh
protocolopenai (Chat Completions)
URLhttps://aicentos.com/v1
API KeyKey tạo trong Console
Mô hìnhtên mô hình trong "Model Square" của Console, cần hỗ trợ function calling

Các bước thiết lập

  • Cài CLI (cần Node.js, hoặc dùng Homebrew trên macOS):

    npm install -g open-code-review
  • Dùng lệnh phi tương tác để ghi cấu hình, cuối cùng nằm ở ~/.opencodereview/config.json:

    ocr config set provider                   openai
    ocr config set model                      claude-sonnet-5
    ocr config set providers.openai.url       https://aicentos.com/v1
    ocr config set providers.openai.api_key   your_api_key_here
  • Nếu thích hướng dẫn đồ hoạ, chạy trực tiếp ocr config provider và ocr config model, trong TUI chọn provider, điền Key, chọn mô hình, đi xong sẽ tự chạy một lần kiểm tra kết nối.

Kiểm tra

Trước tiên xác minh riêng endpoint:

ocr llm test

Thông qua rồi, thực hiện một lần review thực tế trong bất kỳ Git repo nào:

ocr review

Lưu ý

  • URL chỉ điền đến /v1, đừng bổ sung thành /chat/completions đầy đủ.
  • Bộ phân giải cấu hình cần đủ URL, Key, mô hình ba thứ; chỉ export biến môi trường là chưa đủ, phần thiếu vẫn phải ghi vào config.json, nếu không sẽ trả về 401.
  • Cũng có thể dùng biến môi trường ghi đè tạm thời, độ ưu tiên cao nhất: OCR_LLM_URL / OCR_LLM_TOKEN / OCR_LLM_MODEL.
  • Trường của provider tích hợp sẵn là providers.<name>.url, provider tùy chỉnh ở custom_providers.<name>.url, đừng viết lẫn hai map này.
  • Khi không đủ số dư tài khoản sẽ biểu hiện là 401 / 403, trước tiên vào trang Ví xác nhận số dư.
  • Repo chính thức: https://github.com/alibaba/open-code-review