Codex Security CLI:把漏洞发现、验证与修复串成一条管线
OpenAI 开源的 Codex Security CLI 串起漏洞发现、验证与补丁生成,可导出 SARIF 并接入 CI,适合在流水线里自动分诊安全问题。
项目资料
GitHub Ecosystem- 许可证
- 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 日。

核心功能
- 三种扫描范围:
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-securityTypeScript 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。