用 AI 审查代码,最怕的往往不是它“看不懂”,而是它看得不完整、说得不准确。
改动文件一多,通用 Agent 可能只挑几处重点;代码行号发生变化,评论可能贴错位置;同一份代码换一种提示词,结论又会明显波动。最后,开发者省下的审查时间,可能又花在了确认误报上。
阿里最近开源的 OpenCodeReview,正是冲着这些问题来的。
它的前身是阿里集团内部的 AI 代码审查助手。根据项目官方介绍,这套工具在过去两年服务过数万名开发者,识别了数百万个代码缺陷。如今它以 Apache-2.0 许可证开放,安装后只要配置一个可用的大模型端点,就能在本地仓库、提交范围或 CI 流水线中运行。
截至 2026 年 7 月 25 日,该项目在 GitHub 已获得约 1.25 万颗 Star。热度之外,更值得关注的是它对 AI 编程工具的一种判断:代码审查不能只靠模型“自由发挥”,关键流程必须由工程系统兜底。
它不是另一个“帮我 Review 一下”的提示词
OpenCodeReview 是一款 AI 驱动的代码审查 CLI。它会读取 Git diff,把变更文件交给具备工具调用能力的 Agent,并生成可以定位到具体代码行的结构化审查意见。
审查过程中,Agent 不只盯着几行 diff。它还可以读取完整文件、搜索代码库、查看其他变更文件,从仓库级上下文判断一个改动是否真的存在问题。
除了审查当前变更的 ocr review,它还提供 ocr scan,可以扫描整个仓库、目录或指定文件。面对接手遗留项目、安全审计、技术尽调等没有明确 diff 的场景,这个能力会更实用。
项目内置了针对空指针、线程安全、XSS、SQL 注入等问题优化的规则集,也允许团队按文件路径和业务特点继续定制规则。
真正的关键:确定性工程 × Agent
OpenCodeReview 最有意思的地方,不是用了哪个大模型,而是把审查任务拆成了两类。
第一类是“不能靠猜”的环节,由确定性工程负责:
●精确筛选应该审查的文件,过滤无意义内容;
●把彼此相关的文件组合成审查单元;
●根据文件特征匹配适用的审查规则;
●用独立模块校准评论位置,并对意见进行再次反思。
第二类是需要理解和推理的环节,交给 Agent:
●判断一段变更可能造成什么业务后果;
●按需搜索代码、读取完整文件和关联实现;
●结合上下文区分真实缺陷与表面异常。

这种分工很像成熟研发团队的工作方式:流程、范围和质量门槛由制度保证,复杂判断由经验丰富的工程师完成。
它也解释了为什么 OpenCodeReview 强调“稳定”而不是单纯追求“聪明”。模型能力再强,如果文件遗漏、规则失配、评论贴错行,最终体验仍然不可靠。
为什么它可能比通用 Agent 更省
官方公布了一组真实代码审查基准:测试样本来自 50 个热门开源仓库、200 个真实 Pull Request,覆盖 10 种编程语言,由 80 多位资深工程师交叉标注,共整理出 1505 个缺陷。
项目方称,在使用相同底层模型时,OpenCodeReview 相比通用 Agent 取得了更高的 Precision 和 F1,同时 Token 消耗约为后者的九分之一,审查速度也更快。
这里要特别注意:它的 Recall 更低。
这不是一个可以忽略的小字,而是明确的产品取舍。OpenCodeReview 更倾向于少说但说准,减少开发者处理误报的时间;代价是某些真实问题可能没有被发现。
因此,它更适合作为高频、低噪的自动化审查层,而不是替代人工评审、测试、安全扫描和架构治理。尤其在支付、权限、数据安全等关键代码中,不能因为 AI 没有提出问题,就把“没有发现”当成“绝对安全”。
三分钟跑起来
使用前需要 Git 2.41 或更高版本。最直接的安装方式是:
终端 · 命令
$ npm install -g @alibaba-group/open-code-review
然后通过交互界面配置模型供应商与具体模型:
终端 · 命令
$ ocr config provider
$ ocr config model
进入项目目录后,执行:
终端 · 命令
$ # 审查暂存、未暂存和未跟踪的本地变更
$ ocr review
$ # 对比两个分支
$ ocr review --from main --to feature-branch
$ # 审查单个提交
$ ocr review --commit abc123
$ # 扫描整个仓库或指定目录
$ ocr scan
$ ocr scan --path internal/agent
如果不想单独为 OpenCodeReview 配置模型,还可以使用委托模式:由 OpenCodeReview 负责文件选择和规则解析,让 Codex、Claude Code、Cursor 等编程 Agent 使用自身模型完成评审。
项目还提供 GitHub Actions、GitLab CI、Gerrit 等集成方式,并支持会话恢复、浏览器查看审查过程、OpenTelemetry 可观测性和 MCP 扩展。对团队而言,这意味着它既能作为开发者提交前的本地检查,也能进入统一的工程流水线。
哪些团队最值得试
如果你的代码库较大、提交经常跨越多个模块,或者团队已经在使用 AI 编程工具,却长期被误报、漏文件和评论位置漂移困扰,OpenCodeReview 很值得做一次小范围验证。
建议不要一开始就把它设置为强制合并门禁。更稳妥的做法是先选几个真实仓库并行运行两到四周,重点观察三项指标:
一、它提出的问题中,有多少是真正需要修改的;
二、它遗漏的问题,是否集中在特定语言、框架或业务规则;
三、每次审查的耗时、Token 成本和人工确认成本是否可接受。
随后再把团队特有的禁用 API、异常处理、并发安全、数据权限等规范沉淀成规则,逐步接入 CI。
写在最后
OpenCodeReview 最值得借鉴的,并不是“阿里也做了一个 AI Code Review”,而是它给出了一个更工程化的答案:
让确定性系统决定看什么、怎么组织、评论放在哪里;让 Agent 负责理解代码、寻找上下文和判断风险。
这条路线可能也是 AI 编程工具走向生产环境的关键。真正可靠的 Agent,从来不是拥有无限自由,而是在正确的地方自由、在关键的地方受控。
参考资料:
OpenCodeReview GitHub 仓库:
https://github.com/alibaba/open-code-review
OpenCodeReview 官方文档:
https://open-codereview.ai/docs
夜雨聆风