# OpenCodeReview

來源: https://docs.aicentos.com/zh-TW/clients/opencodereview

Language: zh-TW

> 在 OpenCodeReview（OCR）中使用 aicentos —— 透過自訂 provider 接入程式碼審查

OpenCodeReview（命令名 `ocr`）是阿里巴巴開源的 AI 程式碼審查 CLI：讀取 Git diff 後呼叫大模型給出審查意見。它內建了 OpenAI 相容 provider，也支援自訂 OpenAI 相容閘道，可以把請求轉到 aicentos。

## 準備工作

在 aicentos 控制台建立一個專用 Key（建議命名 `ocr-ci`，方便追蹤用量）。OCR 只支援 OpenAI / Anthropic 兩種協定，這裡走 OpenAI 的 Chat Completions 路徑。程式碼審查依賴模型的 **function calling** 能力，請選擇支援工具呼叫的模型。

## 需要填寫的設定

| 欄位       | 值                                    |
| -------- | ------------------------------------ |
| provider | `openai`（內建，覆蓋其 URL）或自訂 provider     |
| protocol | `openai`（Chat Completions）           |
| URL      | `https://aicentos.com/v1`            |
| API Key  | 控制台建立的 Key                           |
| 模型       | 控制台「模型廣場」中的模型名稱，需支援 function calling |

## 設定步驟

* 安裝 CLI（需要 Node.js，或 macOS 上用 Homebrew）：

  ```bash
  npm install -g open-code-review
  ```

* 用非互動命令寫入設定，最終落在 `~/.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
  ```

* 如果偏好圖形引導，直接執行 `ocr config provider` 與 `ocr config model`，在 TUI 裡選 provider、填 Key、挑模型，走完會自動跑一次連通性檢查。

## 測試

先單獨驗證端點：

```bash
ocr llm test
```

通過後，在任意 Git 儲存庫裡執行一次真實審查：

```bash
ocr review
```

## 注意事項

* URL 只填到 `/v1`，不要補成完整的 `/chat/completions`。
* 設定 resolver 需要 **URL、Key、模型** 三者齊備；只 `export` 環境變數不夠，缺失的部分仍要寫進 config.json，否則回傳 401。
* 也可以用環境變數臨時覆蓋，優先級最高：`OCR_LLM_URL` / `OCR_LLM_TOKEN` / `OCR_LLM_MODEL`。
* 內建 provider 的欄位是 `providers.<name>.url`，自訂 provider 在 `custom_providers.<name>.url`，兩個 map 不要寫混。
* 帳戶餘額不足時表現為 401 / 403，先到[錢包頁](https://aicentos.com/wallet)確認餘額。
* 官方儲存庫：`https://github.com/alibaba/open-code-review`