openai/codex-security

项目介绍

Codex Security 是 OpenAI 的应用安全工具集，用于在源码中查找、调查和修复漏洞。它以终端 CLI（cs）、TypeScript SDK、GitHub Action 和 Codex 内的智能体工作流四种形式提供。扫描范围可以是整个仓库、指定路径或一段 Git 变更；深度扫描会重复标准扫描并去重结果。除检出问题外，它还能验证候选发现、生成补丁、核对已有修复、起草 SECURITY.md 策略并保存威胁模型。发现结果可导出为 SARIF、JSON 或 CSV，也可推送到 Linear、Jira 和 GitHub。

快速使用

CLI 要求 Node.js 22.x 中的 22.13.0 及以上版本，或 Node.js 24.x/26.x，另需 Python 3.10+（3.10 需安装 tomli）。全局安装并登录：

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

在待审查仓库目录中执行首次扫描：

cs scan .

扫描结束后，打开终端 REPORT 路径指向的 Markdown 文件；在同一仓库运行 cs scans show 可重新查看最近一次完成的扫描。用 --path src 缩小范围，用 --diff origin/main 对比基线版本，或用 --mode deep 发起更深入的分析。若全局命令与现有命令冲突，改用 codex-security 代替 cs，或用 npx @openai/codex-security 运行。

在 CI 中需在扫描进程环境里设置 OPENAI_API_KEY 或 CODEX_API_KEY；无图形界面的机器有单独的设备/SSH 登录流程，见 CLI 文档。完整选项见快速开始和 CLI 参考。

编程调用

SDK 把同一套引擎暴露给 TypeScript 代码：

import { CodexSecurity } from "@openai/codex-security";

const security = new CodexSecurity();
try {
  const result = await security.run("/path/to/repository");
  console.log(result.reportPath);
} finally {
  await security.close();
}

SDK 指南介绍了深度扫描配置、验证、严重性分级、负责人建议和结果处理。

使用约束

扫描由模型驱动，会消耗 API 用量或 ChatGPT 套餐额度。README 中的 GitHub Actions 示例按每次扫描约 5 美元估算限额，但进行中的请求可能超出该额度。部分网络安全请求和受保护的发现需要加入 Trusted Access for Cyber；Daybreak 账号另有独立开关。扫描会读取根目录和各组件现有的 SECURITY.md，更新策略时应保留其中的漏洞上报说明。除 OpenAI 外还支持 Amazon Bedrock、OpenRouter、Fireworks AI 和 Cheaper Inference，各自需要相应的凭证和模型选择。项目采用 Apache-2.0 许可证。

HotRepo 点评

2026-11-11，该项目在 GitHub 全语言日榜上最高排到第 9 名，当天新增 20 星，总数约 1.14 万。2026-07-28 的 Hacker News 发布帖获得 598 分和 229 条评论，讨论内容比星数更有参考价值：有用户报告扫描运行近一小时后因仓库 HEAD 在扫描期间变化而中断，同时耗掉 Pro 套餐一周额度的一半；有用户在触及速率限制前已花费约 13 美元，且没有明显办法恢复那次的部分输出；还有一次运行被网络安全标记拦截并引导至 Trusted Access for Cyber，最终没有产出结果。有评论认为，智能体拒绝工作时应当退还 token 用量（source:15）。一位维护者在帖中承认项目刚开源、仍有大量待改进之处，并邀请用户反馈。对准备评估该工具的团队来说，实际问题在于扫描成本控制、部分运行能否续跑，以及该护栏与准入计划是否契合自身的威胁建模流程。