5 分钟装好开源的 AI 代码评审神器：OCR 安装实战

每次提 MR 前，都希望有人先帮你把代码过一遍？阿里开源的 Open Code Review（OCR） 就是这样一个工具——它能调用 LLM 在本地完成高精度代码评审。本文手把手带你完成从安装到跑通第一次评审的全过程。

一、动手前，备好这三样

官方硬性前置条件只有三条： 3

• Git ≥ 2.41
• Node.js ≥ 18（仅 NPM 安装方式需要）
• 一个 LLM API Key（委托模式下可省略）

二、安装：五条路，按需自取

官方共支持 5 种安装方式。 4

方式 1：NPM（最推荐）

npm install -g @alibaba-group/open-code-review

锁定版本加 @<version> 后缀。 5

NPM 方式的最大福利是自动更新：每次运行 ocr，wrapper 会在后台静默检查新版本并自动升级，不打断当前评审；两次检查间有 18 分钟冷却，可用 OCR_UPDATE_INTERVAL（分钟）调整，export OCR_NO_UPDATE=1 可彻底关闭。 6

方式 2：Homebrew（macOS / Linux）

brew install open-code-review

升级用 brew upgrade open-code-review，formula 从源码构建二进制。 7

方式 3：一键脚本（CI / 无界面环境首选）

curl -fsSL https://open-codereview.ai/install.sh | sh

脚本自动识别 darwin/linux 与 amd64/arm64，其他平台会直接报错并提示改用 PowerShell 脚本。 8 9

三个可调环境变量： 10

国内用户划重点：GitHub 下载慢时可设镜像加速——

export OCR_GITHUB_MIRROR='gh-proxy.com'   # 裸域名：不带 https://，不带结尾斜杠
export OCR_VERSION='v1.2.3'               # 可选：固定版本，跳过 GitHub API 版本解析

注意它只支持路径前缀型镜像（https://<镜像>/github.com/.../download/... 形式），域名替换型镜像不适用。官方同时给出安全提醒：镜像模式下二进制与 sha256sum.txt 均来自第三方，完整性保证失效，不信任镜像时请对照 releases 页校验。 11 12

方式 4：Windows 走 PowerShell

irm https://open-codereview.ai/install.ps1 | iex

需要 PowerShell 5.1+，默认装到 %LOCALAPPDATA%\Programs\ocr，同样识别上述三个环境变量（用 $env: 设置）。 13 14

方式 5：静态二进制 / 源码构建

不想装 Node.js？直接从 releases 页下载对应平台单文件，例如 Linux x86_64： 15

curl -Lo ocr https://github.com/alibaba/open-code-review/releases/latest/download/opencodereview-linux-amd64
chmod +x ocr && sudo mv ocr /usr/local/bin/ocr

# 校验完整性
curl -LO https://github.com/alibaba/open-code-review/releases/latest/download/sha256sum.txt
shasum -a 256 -c sha256sum.txt --ignore-missing

想改源码，需 Go ≥ 1.26.10 + Git + Make，make build 产出 dist/opencodereview。 16

三、验证安装

ocr version        # 版本 + git commit + 构建日期
ocr --help         # 顶层用法
ocr review --help  # review 命令全部参数

command not found？用 which ocr && echo $PATH 检查安装目录是否在 $PATH 上。 17

四、装好只是开始：跑通第一次评审

配置 LLM：交互式 TUI 一条命令搞定——选 provider、填 key、挑模型，保存后自动跑连通性测试。 18

ocr config provider

CI 无 TUI 环境用 ocr config set 直写 ~/.opencodereview/config.json： 19

ocr config set provider                    anthropic
ocr config set model                       claude-opus-4-6
ocr config set providers.anthropic.api_key sk-ant-xxxxxxxxxx

测连通性：ocr llm test；报 no valid LLM endpoint configured 回查配置，401/403 是 token 问题。 20

首次评审：进入任意 Git 仓库—— 21

cd your-repo
ocr review                              # 工作区模式：staged + unstaged + untracked
ocr review --from main --to feature     # 分支区间（merge-base）
ocr review --commit abc123              # 单个 commit
ocr review --preview                    # 只预览评审文件，不调 LLM

五、写在最后

OCR 的状态全部收敛在 ~/.opencodereview/（配置、规则、会话记录、更新检查文件），绝不写入该目录之外；删目录 + 删二进制即完成干净卸载。 22

加分项：开启 shell 补全，source <(ocr completion bash) 或 ocr completion zsh > "${fpath[1]}/_ocr"。 23

装好了就跑一次 ocr review——让 AI 先替你扛第一波 code review 的压力。