OpenAI 开源 Codex Security：免费查代码漏洞，还能让 AI 直接写补丁

Codex Security 是 OpenAI 开源的代码安全分析工具，提供命令行工具和 TypeScript SDK，能帮你自动寻找代码里的安全漏洞、做真实性二次验证，甚至直接写好修复补丁。

它本身是个完全免费的本地工具，但背后的安全分析依赖大模型。默认配置下，它会调用 gpt-5.6-sol 并开启最高推理强度。也就是说，虽然客户端代码开源免费，但你运行扫描时需要配置 OpenAI API 密钥，或者登录自己的账号来支付推理算力。

它能做什么

传统的代码审计工具通常只负责扫出一堆警告，把真假漏洞混在一起丢给工程师。Codex Security 想做的是把审计、验证和修复闭环走完。

在扫描范围上，它非常灵活。你可以用 scan 命令对整个代码仓库做全盘深度扫描，也可以用 --path 指定某个业务目录，或者在 CI 流程里用 --diff 参数只检查本次 Git 提交带来的增量改动。

扫出可疑漏洞后，工具不会立刻下定论，而是能执行二次验证，通过模拟调用和上下文推演来确认这到底是不是真正的安全隐患。确认漏洞后，它还能通过 patch 命令直接生成可以直接应用的修复代码。

除了找漏洞，它还能帮你生成或更新仓库里的 SECURITY.md 安全策略文档，并在扫描结束后导出完整的威胁建模报告。扫描结果可以导出为标准的 SARIF、JSON 或 CSV 格式，方便直接对接 GitHub 代码扫描报警或 Linear 等工单系统。

怎么跑起来

跑这个工具需要本地装有 Node.js 22.13 以上版本，以及 Python 3.10 以上环境，Python 3.10 环境下还需要安装 tomli 库。

最快的上手方式是直接通过 npm 全局安装 @openai/codex-security，安装后会生成 cs 和 codex-security 两个命令行命令。不想全局安装的话，也可以直接用 npx 执行。

安装完成后运行 cs login 登录你的账号，或者直接在环境变量里设置 OPENAI_API_KEY。进入项目根目录后，执行 cs scan 就会开始分析代码。如果你想限制扫描时间，还可以加上时间上限参数避免消耗过多 token。

如果不想绑定 OpenAI 官方 API，它也留了后路。配置支持接入 Amazon Bedrock、OpenRouter、Fireworks AI 等第三方模型后端。如果用 Bedrock，直接通过本地 AWS 凭证鉴权即可，连 OpenAI 账号都不需要。

对于持续集成环境，OpenAI 提供了官方的 GitHub Action。由于 AI 执行安全分析时需要运行沙箱，官方工作流里配置了 Bubblewrap 和 AppArmor 隔离环境，保证扫描过程本身不会对构建机产生安全隐患。

为什么重要

我们认为，Codex Security 很有可能成为很多团队安全流水线的新标配。过去自动化静态分析工具最让人头疼的是误报率居高不下，安全团队每天都要花大量时间人工筛查假警报；而 Codex Security 引入了大模型的推理能力来做二次验证，甚至顺手把补丁都写了，大幅缩短了从发现问题到修复上线的链路。

但它也有显而易见的门槛。扫描直接按 token 计费，全盘深度扫描开到高推理强度，对于中大型代码库来说成本不会太低。对于普通团队，更现实的做法是在日常开发中用 --diff 挂在 GitHub Action 里跑增量检查，把成本控制在每次代码提交的改动范围内，值得有安全合规需求的项目尽早接入试试。