开发工具#安全扫描#代码审查

Codex Security CLI:把漏洞发现、验证与修复串成一条管线

OpenAI 开源的 Codex Security CLI 串起漏洞发现、验证与补丁生成,可导出 SARIF 并接入 CI,适合在流水线里自动分诊安全问题。

项目资料

GitHub Ecosystem
仓库地址github.com/openai/codex-security
许可证
Apache-2.0
主语言
TypeScript
星标
13,539
核查时间
2026-11-15

以上快照资料以核查当日为准,可能随版本或运营策略变化。

给仓库做安全检查,传统 SAST 工具往往交回一长串等着人工分诊的告警。Codex Security 是 OpenAI 于 2026 年 7 月底开源的应用安全 CLI 与 TypeScript SDK(Apache-2.0,TypeScript 编写):一条 cs scan . 命令跑完发现、验证、修复的流程,扫描结束后还能让模型验证候选漏洞、生成补丁并复核已落地的修复。截至 2026-11-15,仓库约 13.5k 星,最新的 v0.10.0 发布于 11 月 12 日。

GitHub 仓库页卡片:openai/codex-security,OpenAI 的 Codex Security CLI 与 TypeScript SDK

核心功能

  • 三种扫描范围:cs scan . 扫全仓库,--path src --path tests 圈定目录,--diff origin/main 只查基线版本到 HEAD 的提交改动;--mode deep 在标准扫描之上重复执行并去重合并结果。--max-time 15 可以给一次标准扫描设 15 分钟的参考调查预算。开源后的实现显示,一次扫描按威胁建模、发现、验证、影响分析、报告、加固等阶段推进,产出 scan-manifest.json、findings.json、coverage.json 等结构化文件。
  • 扫描可续跑:v0.10.0 起 codex-security scans resume SCAN_ID 能从检查点继续被中断的标准扫描,用量和预算照旧;批量与组件扫描新增 --max-total-cost,让一组仓库共享一个预估预算,进行中的请求可能超出估算。
  • 验证与补丁:扫描完成后可以继续让模型验证候选发现是否真实可利用、生成补丁,并复核已有修复。按项目自述,补丁验证在受控环境中进行;v0.10.0 起若托管补丁落到了其他提交上,会报告 revision_changed 并保留执行凭证。这一机制的细节以项目文档为准,我们未独立复测。
  • 结果落地:发现可导出 SARIF、JSON、CSV,或同步到 Linear、Jira 与 GitHub;也支持导入 Semgrep、Snyk、ArmorCode 等第三方扫描器的报告,在本地工作台分诊。
  • 策略与威胁模型:cs policy 会起草 SECURITY.md 和威胁模型草稿,存在仓库外等人工审阅;扫描本身会读取根目录与组件级的 SECURITY.md 作为上下文。
  • 多种模型后端:除 OpenAI 外支持 Amazon Bedrock、OpenRouter、Fireworks AI 等,Bedrock 直接用 AWS 凭证,不需要 OpenAI 登录。
  • SDK 与 CI:@openai/codex-security TypeScript SDK 可嵌入自有流程;官方 GitHub Action 示例按周计划扫描仓库,单次扫描设 5 美元参考限额,默认只报告不挂构建。

典型使用场景

  • 安全工程师的分诊台:把扫描器积压的告警先交给模型验证一轮,按自己仓库的评级标准定级,再决定人工复查顺序。
  • CI 里的增量检查:拉取请求用 --diff origin/main 只扫改动,配合每周计划任务做全量扫描;批量扫描还能用 --max-total-cost 给一组仓库共享一个预算。
  • 开源维护者:OpenAI 在 Hacker News 上确认,维护者可通过 Codex for OSS 表单申请条件性访问,减少自己承担的模型开销。

快速上手

安装命令来自项目 README,要求 Node.js 22.13.0 以上(22.x)或 24.x、26.x,以及 Python 3.10+:

npm install --global @openai/codex-security
cs login

cs scan .

扫描结束后终端会给出一个 REPORT 路径,指向 Markdown 报告,内含源码证据与覆盖范围说明;cs scans show 可以找回最近一次完成的扫描。npm 有冲突时用 npx @openai/codex-security 代替 cs;CI 里设置 OPENAI_API_KEY 或 CODEX_API_KEY 即可无交互运行。

小结

Codex Security 适合想在 CI 和日常开发里引入 AI 漏洞审查、且能接受把代码送到云端模型的后端团队。诚实地说,成本和门槛都要算清楚:Hacker News 上有用户报告单次扫描消耗了 Pro 计划每周用量的一半,也有一次失败扫描被计费约 13 美元;模型护栏偶尔会拒答它自己刚找到的漏洞;部分能力要 Trusted Access for Cyber 或 Daybreak 计划才开放;本地模型不受支持,代码必须出本地。它不提供传统 SAST 那种规则级 SAST 报告,OpenAI 自己也解释过原因。Apache-2.0,TypeScript 编写,v0.10.0 发布于 2026-11-12,仓库活跃(最后推送 2026-11-14)。想给智能体配安全技能的可以看本站的 reverse-skill,纯工具集合则可对照 hackingtool。