用途：面向代码库的 AI 安全扫描工具，通过命令行或 TypeScript SDK 发现、验证并支持自动修复安全漏洞。
主要能力：扫描目录或指定文件；按严重级别（critical、high 等）过滤漏洞并输出标题、文件、行号、描述与类型；提供可修复漏洞数量统计。支持模型与扫描强度选择（low/medium/high，默认 medium），可选 --model 指定模型；支持 --auth chatgpt 或 --auth api-key 选择凭据。
使用方式：需 Node.js 22.13.0+、24.x 或 26.x，以及 Python 3.10+，并具备 Codex Security 访问权限。安装：npm install @openai/codex-security（全局加 -g）。登录：npx @openai/codex-security login；CI 中可设置 OPENAI_API_KEY 或 CODEX_API_KEY。基本扫描：npx @openai/codex-security scan .；指定模型与强度：npx @openai/codex-security scan . --model gpt-5.6-terra --effort high。SDK 用法：import { CodexSecurity } from "@openai/codex-security"，new CodexSecurity({model, effort, auth}) 后调用 security.run(".")，读取 result.reportPath、result.vulnerabilities、result.filesScanned 等，结束后 await security.close()。
适用场景：本地开发扫描、预提交钩子、GitHub Actions/GitLab CI/CircleCI 流水线、与 Jest 等测试框架结合做安全断言，以及扫描并复扫验证的自动化修复流程。
限制与注意：扫描历史默认存于系统状态目录，不可写时需设置 CODEX_SECURITY_STATE_DIR。凭据若无法持久化可 logout/login 或改用环境变量。大代码库可降低 effort 或仅扫描子目录以控制耗时。文档提及自动修复能力，但示例中的 fix 调用标注为假设性 API，实际用法暂未提供；具体收费、价格与平台支持资料未提供。