用途:OpenAI Codex Security 通过 AI 在代码库中发现、验证并修复安全漏洞,支持多种编程语言,可集成到开发工作流与 CI/CD 流水线。
安装与要求:需 Node.js 22.13.0+(22.x)、24.x 或 26.x,以及 Python 3.10 或更高版本,并拥有 OpenAI 账号与 Codex Security 访问权限。安装命令:npm install @openai/codex-security;全局 CLI 用法:npm install -g @openai/codex-security。
认证方式:本地开发可运行 npx @openai/codex-security login 交互登录,凭据存入 Codex 凭据后端并支持系统钥匙串;CI/CD 可设置环境变量 OPENAI_API_KEY 或 CODEX_API_KEY,环境变量优先生效且不会持久存储。
主要能力:命令行扫描当前或指定目录,如 npx @openai/codex-security scan . 或指定路径;可配置模型与努力级别,如 scan . --model gpt-5.6-terra --effort high;支持输出格式与文件,如 --output-format json、--output-file security-report.json;提供登录、登出与身份检查命令 login、logout、whoami。TypeScript SDK 可编程调用,通过 CodexSecurity 实例的 run 方法扫描并获取 vulnerabilities 列表,含严重级别、标题、文件、行号、描述、修复建议与代码片段等字段,可自定义模型、effort、apiKey、include 与 exclude 等。
集成与场景:可用于 GitHub Actions、GitLab CI、Jenkins 等流水线,也可配置 pre-commit 钩子;支持渐进式扫描和按严重级别过滤结果。可通过 CODEX_SECURITY_STATE_DIR 设置扫描历史目录。
限制:具体收费与定价暂未提供;模型名称、参数与功能以实际版本为准。常见问题涵盖认证失败、Node.js 版本不兼容、大代码库内存不足与误报等,可通过排除目录、降低 effort、调整内存或过滤结果缓解。