OpenCodeReview
在 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):
npm install -g open-code-review -
用非互動命令寫入設定,最終落在
~/.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 -
如果偏好圖形引導,直接執行
ocr config provider與ocr config model,在 TUI 裡選 provider、填 Key、挑模型,走完會自動跑一次連通性檢查。
測試
先單獨驗證端點:
ocr llm test通過後,在任意 Git 儲存庫裡執行一次真實審查:
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://github.com/alibaba/open-code-review