# OpenCodeReview

Nguồn: https://docs.aicentos.com/vi/clients/opencodereview

Language: vi

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

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ường   | Giá trị                                                                   |
| -------- | ------------------------------------------------------------------------- |
| provider | `openai` (tích hợp sẵn, ghi đè URL của nó) hoặc provider tùy chỉnh        |
| protocol | `openai` (Chat Completions)                                               |
| URL      | `https://aicentos.com/v1`                                                 |
| API Key  | Key tạo trong Console                                                     |
| Mô hình  | tê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):

  ```bash
  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`:

  ```bash
  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:

```bash
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:

```bash
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í](https://aicentos.com/wallet) xác nhận số dư.
* Repo chính thức: `https://github.com/alibaba/open-code-review`