Skip to Content
aicentos

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 能力,請選擇支援工具呼叫的模型。

需要填寫的設定

欄位值
provideropenai(內建,覆蓋其 URL)或自訂 provider
protocolopenai(Chat Completions)
URLhttps://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