认识OpenQodex:免费开源的AI代码审查工具,在你git push之前拦截Bug

原创2026-10-26 13:28:401,732 阅读

认识OpenQodex:免费开源的AI代码审查工具,在你git push之前拦截Bug

OpenQodex 是一款免费开源的 AI 代码审查工具,它运行在你自己的机器上,在你执行 git push 之前,先用 22 个内置扫描器加一个独立的 AI 审查进程(Claude Code 或 Codex,使用你自己的登录账号,无需额外 API Key)拦截 Bug、安全漏洞和依赖风险。它不收集任何数据、没有遥测,代码不会发给任何第三方服务。

OpenQodex AI代码审查工具横幅:一行命令 npx openqodex init 完成安装

OpenQodex 是什么?一句话说清

OpenQodex 的口号很简单:Code review before the push(推送前审查)。

它的"change"(变更)指的是:你还没有 push 的提交 + 所有未提交的内容。审查流程分两步:

  1. 扫描器阶段:根据你改动的文件类型,自动挑选合适的扫描器运行,比如 gitleaks(查密钥泄露)、semgrep(查安全问题)、shellcheck(查 Shell 脚本)、hadolint(查 Dockerfile)、squawk(查数据库迁移)等,一共 22 个内置扫描器,详见 docs/scanners.md
  2. AI 审查阶段:启动一个独立的 Claude Code 或 Codex 进程来审查代码。默认情况下,写代码的 Agent 不会审查自己写的代码——这是 OpenQodex 和"让 AI 自查"最大的区别

OpenQodex 项目头像图标

最后它会给你一份"收据"(receipt):一个结论(passed / blocked)、每条发现的编号与严重级别、以及 report.html 报告的路径。你在浏览器里打开报告,就能看到每个问题对应的具体代码行、原因和修复建议,然后告诉 Agent "修第 1 条和第 3 条"即可。

为什么要在 push 之前审查?

大多数 Bug 的发现时机都太晚了:

  • push 之后:代码已经进了仓库,发现问题要再发一次提交,还可能污染主干
  • CI 阶段:等 CI 跑完再修,时间成本更高
  • 上线之后:那就是事故了

OpenQodex 把审查卡在最前面。init 安装时会给你的仓库加一个 git pre-push hook:每次 push 都会检查这次推送的提交是否已经通过审查。默认只警告;在 .openqodex/config.yaml 里设置 review.block_on_severity 后,严重级别达标的发现会直接阻止推送。

它还支持四种主流编码 Agent:Claude Code、Codex CLI、Cursor、Cline,都能触发审查(前两者还能充当审查者,后两者会调用已安装的 Claude Code 或 Codex 来审查)。

三步上手:一条命令完成安装

环境要求:Node 22+、git、macOS 或 Linux(Windows 用户请用 WSL);完整审查需要已安装并登录 Claude Code 或 Codex。

第 1 步:安装

在你的终端运行:

npx openqodex init

init 会自动检测你机器上的编码 Agent,列出将要写入的文件并询问一次,然后在后台下载你的仓库需要的扫描器,最后直接对你当前的变更跑一次首审查。

第 2 步:发起审查

对你的 Agent 说一句话:"review my change with openqodex";或者在自己的终端运行 ~/.openqodex/bin/openqodex review。一次小型变更的审查大约两分钟(官方基准测试实测)。

第 3 步:看报告、挑要修的

Agent 会展示收据并问:"Fix all, or tell me which?"(全修,还是告诉我修哪几条?)。报告保存在仓库的 .openqodex/reviews/ 目录下,包含 report.html、report.md、report.json 和 report.sarif 四种格式,report.html 是纯静态页面,不含任何脚本。

完整步骤见 docs/quickstart.md,全部命令参考 docs/cli.md。

效果如何?先用 15 个埋好的 Bug 试试

想快速看效果,运行:

npx openqodex demo /tmp/openqodex-demo

demo 会现场构建一个小型电商 API 仓库(Flask + Dockerfile + Terraform + Kubernetes 清单 + Postgres 迁移),并故意埋入 15 个真实类型的 Bug:Stripe 密钥泄露、SQL 注入、rm -rf 未加引号、Terraform 对全网开放 SSH 端口、特权容器、分页跳页错误等,然后跑一遍扫描打印发现。

埋点清单见 examples/README.md,其中有两个 Bug 任何扫描器都看不见,只能靠 AI 审查者读代码发现——这正是"扫描器 + AI 双保险"的价值。

官方基准测试(在故意埋入 Bug 的变更集上):Claude Code 作为审查者时,问题召回率达 84.3%,精确率可达 100%,干净代码零误报,单次审查成本约 $0.087(用的是你自己的 Claude Code 额度)。完整数据见 docs/benchmark-results.md。

免费又放心:代码不离开你的机器

很多开发者担心 AI 审查会把代码交给陌生服务。OpenQodex 的立场写在 docs/privacy.md 里,可以概括为三条:

  • 零收集:没有账号、没有服务器、没有遥测,不收集任何使用数据或崩溃报告;连 semgrep 的 metrics 都被强制关闭
  • 零上传:内置扫描器在你本机运行,不发送任何代码;osv-scanner 只向 osv.dev 发送 lockfile 里的依赖名称和版本,不发送源码
  • 审查者用你自己的登录:代码只会发给你 Claude Code / Codex 账号所连接的模型服务,OpenQodex 本身不添加任何模型、不要求任何 Key

如果你想给团队在 GitHub 上跑,它的 GitHub Action 会在 PR 上执行扫描(配置了 Anthropic Key 则执行完整审查),用法见 docs/github-action.md。

进阶玩法

  • 审查别人的分支或 PR:openqodex review feature/login、openqodex review '#42',不会碰你的工作区
  • 全仓库审查:openqodex review --all,报告还会给出"爆炸半径"(blast radius)
  • 添加自定义扫描器:在 .openqodex/config.yaml 里填一个 GitHub 仓库地址和运行命令,npx openqodex trust 审批后即可加入每次审查,指南见 docs/custom-scanners.md
  • 代码图谱:openqodex graph 可以回答"谁调用了这个函数"之类的问题,审查时用于追踪调用链,见 docs/graph.md
  • 离线模式:--offline 跳过需要网络的扫描器,审查者仍可用

项目源码按 monorepo 组织,核心 CLI 在 packages/cli/,扫描器适配在 packages/scanners/,审查流水线在 packages/review/,全部文档随 npm 包分发,离线可用 npx openqodex guide <topic> 查看。

小结

OpenQodex 把"推送前审查"变成了三件事:一条 npx openqodex init 完成安装,一句话发起审查,一条收据告诉你哪些 Bug 要修。免费、开源(Apache-2.0)、无遥测、跑在你自己的登录上——如果你在用 Claude Code 或 Codex 写代码,这是目前把 AI 代码审查挡在 git push 之前的完整方案。

登录后查看全文
openqodex