openai GitHub avatar

codex-security

TypeScript
代码安全审计工具openai最近推送 2026年11月18日
AI 开发工具Apache-2.014.0k1,094186 issues7 天 +2,591

AI 分析 · 由大模型根据 README 与仓库数据生成 · 2026年11月17日

用 AI 扫描代码库、验证漏洞并生成修复补丁的 CLI 与 TypeScript SDK。

OpenAI 推出的代码安全工具,提供命令行工具 cs 和 TypeScript SDK,用于发现、调查和修复代码中的安全漏洞。既可以在 Codex 会话中调用安全流程,也可以在终端扫描仓库,或通过 SDK、GitHub Action 接入自动化流程。

推荐指数

4.0

功能覆盖扫描、验证、修复和报告导出,适合想把 AI 安全审查接入开发流程的团队,但依赖 OpenAI 账号与 API Key。

近 7 天

+2,591

新增 Star

总 Star 排名

#508

雷达追踪的 3,931 个 AI 仓库中

创建于

2026

2026年7月14日

核心亮点

  • 1多种扫描范围

    支持整库、指定路径、排除目录、Git diff 变更和深度扫描。

  • 2验证与修复

    可验证候选漏洞、生成补丁,并检查已有修复是否有效。

  • 3报告与导出

    输出 Markdown 报告,支持 SARIF、JSON、CSV 导出。

  • 4流程集成

    提供 TypeScript SDK 和 GitHub Action,可接入 CI 和容器。

  • 5策略与威胁模型

    可起草 SECURITY.md,并保存、导出威胁模型。

适用场景

  • 本地安全自查

    例如:在仓库目录运行 cs scan .,查看生成的 Markdown 报告。

  • CI 自动扫描

    例如:在流水线中设置 OPENAI_API_KEY,用 GitHub Action 或 SDK 扫描每次提交。

  • 变更审查

    例如:用 cs scan . --diff origin/main 只扫描本次分支改动。

  • 漏洞跟踪

    例如:把扫描结果导出为 SARIF,或同步到 Linear、Jira、GitHub。

它是怎么工作的

  1. 第 1 步

    登录鉴权

    通过 cs login 或环境变量中的 API Key 完成认证。

  2. 第 2 步

    选择扫描范围

    指定仓库、路径、排除目录或 Git diff,并选择标准或深度模式。

  3. 第 3 步

    AI 分析代码

    扫描代码并产出候选漏洞、证据和覆盖范围说明。

  4. 第 4 步

    验证与修复

    验证发现、评估严重程度,并生成或检查补丁。

  5. 第 5 步

    保存与导出

    保存报告和发现,导出 SARIF、JSON、CSV 或推送到外部系统。

快速上手

  1. 1

    安装 CLI

    需要 Node.js 22.13+ 或 24/26,以及 Python 3.10+。

    npm install --global @openai/codex-security
  2. 2

    登录

    完成账号认证。

    cs login
  3. 3

    首次扫描

    在仓库目录运行,完成后打开终端给出的 REPORT 路径。

    cs scan .
  4. 4

    查看历史扫描

    在同一仓库中查看最近一次完成的扫描。

    cs scans show

适合谁

  • 需要把安全扫描接入 CI 的团队
  • 使用 TypeScript 做自动化的开发者
  • 希望用 AI 辅助漏洞验证和修复的工程师

不太适合

  • 无法使用 OpenAI 账号或 API Key 的用户
  • 只需要传统静态扫描规则、不想要 AI 分析的项目

成熟度

  • 活跃度2026 年 7 月创建,11 月仍有更新,star 约 1.38 万。
  • 文档README 覆盖 CLI、SDK、策略生成和导出,并链接多份详细文档。
  • 社区star 和 fork 较多,但 issue 有 186 个,社区沉淀时间较短。
  • 上手难度安装步骤简单,但需要登录鉴权,并依赖 Node 和 Python 环境。

同类项目怎么选

  • Semgrep基于规则匹配的静态分析,不依赖大模型,也不生成 AI 修复补丁。
  • CodeQLGitHub 的语义代码查询引擎,侧重规则查询,而非 AI 调查与修复。
  • Snyk Code商业化的 AI 代码扫描服务,本项目是开源 CLI 与 SDK。

使用前注意

  • · 需要 OpenAI 账号或 API Key,部分安全请求和受保护发现需要额外访问权限。
  • · 运行环境要求 Node.js 22.13+ 或 24/26,以及 Python 3.10+。
  • · 扫描会消耗模型调用,存在成本,可用 --max-time 等参数限制。
  • · 采用 Apache-2.0 许可,使用前建议确认数据与代码上传策略。

主题标签

ai-securityapplication-securityclicode-scanningcodexcodex-securitycybersecuritydevsecopsnodejsnpmopenaisdksecuritytypescriptvulnerability-scanning