Open Code Review新手使用教程:53.5k Star阿里开源AI代码审查神器,npm一条命令安装,行级揪出NPE/XSS/SQL注入(附下载)
目录
哎,说到代码评审,你是不是也经历过这些崩溃时刻?团队里没人愿意当”坏人”挑毛病,MR 挂了三天没人看;自己写的代码自己看不出问题,上线前心跳加速;网上找的 lint 规则一堆误报,刷完日志全是噪音,真正的 NPE 反而被淹没了。
好消息是,阿里巴巴把这个痛点给开源了——Open Code Review(简称 OCR),阿里内部服务了 2 万+ 活跃用户、累计跑了超过 100 万次代码评审的大厂内部工具,现在一条 npm 命令就能装到自己电脑上。今天这篇教程就带你从零开始,一步步跑通你的第一次 AI 代码评审。
Open Code Review 是什么来头?
一句话:一个跑在命令行里的 AI 代码审查员。
它不是纯靠大模型”看心情”给意见,而是用了个挺聪明的混合架构——确定性流水线(规则引擎)+ LLM Agent(大模型)。简单说就是:能用规则精确判断的(空指针、SQL 注入、XSS),绝不大模型瞎猜;需要理解业务逻辑的,才交给大模型发挥。这样既快又省 token,还降低了误报。

GitHub 仓库主页:53.5k Star、4.4k Fork,Apache-2.0 协议,Go 语言编写
几个硬指标先摆出来:
- 53.5k Star,开源一周多就冲上 GitHub Trending
- 内置多语言规则集:NPE(空指针)、线程安全、XSS、SQL 注入这些高频坑全覆盖
- 行级精准评论:直接告诉你第几行有问题、怎么改,不是笼统一句”这里可能有风险”
- OpenAI / Anthropic 双协议兼容:官方模型、国内中转、本地模型都能接
- 阿里内部 1505 个标注问题交叉验证过,是实战打磨出来的,不是玩具

官方网站 open-codereview.ai,文档、快速开始、集成指南都在这
第一步:安装(真的只有一条命令)
先确认一个前置条件:Git ≥ 2.41。因为 OCR 要靠 Git 生成 diff、搜索代码,版本太老不行。终端里敲:
git --version
版本够了,直接装(需要 Node.js 环境,一般前端同学电脑上都有):
npm install -g @alibaba-group/open-code-review
装完验证一下:
ocr version
能打印出版本号就成了。这时候你得到一个全局命令 ocr,后面所有操作都围着它转。

仓库 README 里就写着安装和快速开始,官方文档非常全
第二步:配置大模型(审代码的大脑)
安装完别急着跑,得先告诉 OCR 用哪个大模型当”评审员”。两种配置方式任选:
方式一:交互式向导(推荐新手)
ocr config provider # 选内置供应商,或加自定义供应商
ocr config model # 给当前供应商挑一个模型
向导会一步步引导你:选供应商 → 填 API Key → 选模型,配完自动测试连通性,红了就是 key 错了,绿了就能干活。
方式二:命令直接测连通
ocr llm test
支持 OpenAI 和 Anthropic 两家协议,所以国内的各种中转服务、new-api 这类自建网关、甚至本地跑的模型,只要兼容这两个协议都能填进去。不想折腾的话,就用你手里已有的任何一家 API Key。
另外还有个偷懒选项——委托模式(Delegation Mode):不单独配 OCR 的模型,直接借用你宿主 Agent(比如 Claude Code)已经登录好的模型和额度,对已经订阅了 Claude 的同学特别省事。
第三步:跑你的第一次代码评审
配置完毕,进入任意一个 Git 仓库目录,敲:
cd 你的项目目录
ocr review
就这么简单。OCR 会自动读取当前工作区的改动(包括没 commit 的),跑规则流水线 + 大模型分析,然后把问题按文件 + 行号输出,每条都附带修复建议。
几个实用玩法:
# 只审查某个 commit
ocr review --commit HEAD
# 审查分支差异(提 MR 前的标准动作)
ocr review --base main
# 只看指定文件/目录
ocr review src/api/
# 输出结构化清单,方便程序处理
ocr review --audience agent
这里有个细节很关键:置信度分级。评审结果按 High / Medium / Low 三级过滤,低置信度的意见直接丢弃,只把真正有价值的问题摆到你面前——这就是它比裸用大模型”肉眼看代码”靠谱的地方。
第四步:集成到你的 coding Agent(进阶)
如果你平时用 Claude Code、Codex、Cursor、Kimi Code 这类 AI 编程助手,OCR 还能直接”住进去”,在你聊天的过程中随时喊它出来审查。
以 Claude Code 为例,装个插件就行:
/plugin marketplace add alibaba/open-code-review
/plugin install open-code-review
装完之后在对话里输入 /open-code-review:review 就能触发审查。它的几个设计挺贴心:
- 上下文隔离:评审在独立线程里跑,不会把你正在聊的需求上下文冲掉
- 需求感知:会自动提取你当前的需求背景塞进评审上下文,连”实现和需求对不对得上”都能查
- 自动修复:看到值得采纳的建议,可以直接让 Agent 发起修复,改完还能循环复测,直到零问题

官方中文 README,安装、配置、各平台集成方式全都有
FAQ:新手最常踩的几个坑
Q1:ocr 命令找不到?
多半是 npm 全局 bin 目录没进 PATH。跑 npm bin -g 看看路径,加进 ~/.bashrc 重启终端即可。另外在 Agent Skill 里用它,前提是 CLI 已经全局装好,否则技能会直接中断报错。
Q2:审查太慢或者 token 烧太多?
先缩小范围——指定 commit、分支或目录,别一上来就全仓库扫。OCR 的场景化提示词已经针对审查任务做过 token 优化,范围控制好,一次评审开销很小。
Q3:能不能只查安全问题?
可以,评审规则支持路径过滤和定向规则,NPE、XSS、SQL 注入这些内置规则都能单独启用或关闭,详见官方的 Review Rules 文档。
Q4:公司内网能用吗?
能。它支持 MCP Server 扩展、自定义供应商端点,把 LLM 指到你们内部网关就行,代码不用出内网。
写在最后
说实话,大厂内部工具开源的不少,但”装完五分钟内能跑起来、且真的能揪出问题”的不多。Open Code Review 属于后者:规则引擎打底保证准确率,大模型补足语义理解,行级评论直接给出修复建议,用起来确实省心。以后提 MR 之前先让 ocr review 过一遍,至少那种低级空指针上线背锅的事,可以跟它说拜拜了。
📥 软件下载
项目开源地址(Apache-2.0 协议,可商用):
https://github.com/alibaba/open-code-review
npm 安装包国内直链下载(npmmirror 镜像,实测可用,v1.13.11,2.7MB):
https://registry.npmmirror.com/@alibaba-group/open-code-review/-/open-code-review-1.13.11.tgz
下载后安装:
npm install -g alibaba-group-open-code-review-1.13.11.tgz
小提醒:今日夸克网盘分享链接暂未生成(网盘授权过期,正在重新登录),可先用上面的官方镜像直链下载,内容完全一致。官方文档:https://open-codereview.ai/
关注公众号:「实用软技」,在公众号窗口里回复关键字”软件”即可免费获取
