适合谁
- 使用 Claude Code、Cursor、Codex 等 AI 代理快速构建应用、关注安全的开发者
- 希望在本地离线扫描代码、不上传源码的个人与小型团队
- 需要将 CWE 级发现映射到合规框架代码可见控制的团队
C
75FMRS · B
一个工程纪律突出的本地安全扫描器：SHA 锁定引擎、零扫描时出站、零遥测、密钥脱敏、三态诚实证据模型，并对自身能力边界（收窄的原生规则、AI 起草的合规映射、启发式提示注入检测）做了罕见的坦率披露。适合 AI 编码代理驱动的日常安全闭环；不能替代深度审计、运行时测试或合规认证。MIT 许可，单人（Synvoya）维护，欢迎独立安全社区审查。
CodeInspectus 是由 Synvoya 维护的本地优先、注重隐私的 MCP 安全扫描器与 CLI。任何 AI 编码代理（Claude Code、Cursor、Codex、Windsurf、Cline、Aider）都可以调用它扫描 AI 生成/“氛围编程”代码中的真实漏洞，将结果映射到合规框架的代码级控制覆盖，并驱动“扫描→修复→复扫”闭环——完全在本地运行，无需账号，扫描时零网络出站。它编排 Opengrep（SAST/OWASP Top 10）、Gitleaks（密钥泄露）、Trivy（依赖 CVE、IaC、SBOM）三个开源引擎，外加自研的 AI 代码专项检查（Supabase RLS/反向授权、提示注入汇点、模型工具参数到达 shell、客户端可写 user_metadata 授权、危险 HTML 渲染、Firebase 公共写、GitHub Actions 工作流风险等），共 88 条精选检测规则，统一为以 CWE 为键的规范化结果。引擎二进制均经 SHA 锁定与签名验证，无遥测；合规映射仅为代码级覆盖，不构成认证。
工具能力
codeinspectus_scan
对指定路径执行完整本地扫描（三引擎 + 原生检查），返回以 CWE 为键的发现、检测到的技术栈、原生规则包与 Pub 依赖覆盖、修复建议及运行时控制的三态仓库证据。
codeinspectus_rescan
修复后复扫并与先前扫描对比，输出已解决/仍存在/新引入的结果，附带最新技术与规则包覆盖信息。
codeinspectus_compliance_report
按合规框架生成代码级控制覆盖报告（非认证）。
codeinspectus_explain_finding
对单个发现提供深入解释与完整修复方案。
codeinspectus_generate_sbom
使用 Trivy 加原生 Pub 清单/回退生成 CycloneDX/SPDX SBOM（默认写入受管目录，或指定路径）。
codeinspectus_list_rules
列出活跃检测器、原生规则包清单与规则归属、引擎版本、检测数据库来源与新鲜度，以及结构化的安装/修复状态。
安装接入
前置条件：Node.js ≥22（推荐 Node 24 LTS）；安装 Opengrep 或 Trivy 二进制时需在 PATH 中有 cosign（验证失败即拒绝安装；Gitleaks 按校验和验证，无需 cosign）。在客户端注册一次（如 Claude Code：claude mcp add- codeinspectus '{"command":"npx","args":["-y","codeinspectus"]}'；Cursor 添加到 mcp.；VS Code：code --add-mcp；Codex：codex mcp add 或编辑 config.toml 并建议 tool_timeout_sec = 600）。然后运行 npx codeinspectus repair-engines 安装/修复经哈希验证的引擎与数据库。之后扫描零网络 I/O。可用 npx codeinspectus verify-engines 随时复核二进制。
claude_desktop_config.json
{"mcpServers":{"codeinspectus":{"command":"npx","args":["-y","codeinspectus"]}}}
选型与风险
不适合谁
- 寻求完整合规认证或运行时安全证明的团队（工具明确不做认证）
- 需要跨文件/全程序数据流或运行时移动端测试的深度审计场景
- 无法满足 Node.js ≥22 或不愿安装 cosign 与引擎二进制的受限环境
- Essential Eight 合规评估（仅约 1/8 项缓解措施有代码证据）
所需权限
- 读取项目源码与仓库文件（只读，从不编辑或删除源码）
- 在 ~/.codeinspectus 下存储引擎数据与扫描历史
- 可选写入一个 SBOM 文件（受管目录或用户指定路径）
- 以本地子进程方式调用经 SHA 验证的 Opengrep/Gitleaks/Trivy 二进制
- 读取 git 状态以报告 git 安全建议；git 操作需用户批准，工具自身从不执行
风险与副作用
- 提示注入检测为启发式且不成熟，相关发现标记为中等置信度“潜在……”
- 修复由 AI 代理执行，需人工审查补丁；工具只报告不修改代码
- 原生规则覆盖范围刻意收窄（多为文件内分析），不应推断比已执行规则包更广的覆盖
- 合规映射为 AI 起草、维护者复核，社区验证数为 0/96，不可视为审计结论
- 引擎二进制供应链风险通过 SHA 锁定缓解，但 setup/repair 时仍需网络下载（应验证来源）
常见排障
- 扫描返回 engine_setup 非 ready：让代理解释状态（repair_required / db_refresh_recommended / unsupported_platform），经批准后运行 npx codeinspectus repair-engines
- CVE 复扫跟踪未启用：对 0.3.2 前安装的 Trivy DB，运行一次 repair-engines 重新经验证路径获取数据库
- 客户端（尤其 Codex）超时：将 tool_timeout_sec 设为 600，因大型仓库扫描可能超过默认 60 秒
- 原生规则包未运行：检查 pack_coverage 与 detected_technologies——各包需要精确的框架/依赖证据（如 Flutter、openai-php/client、async-openai 等）
- 验证二进制完整性：npx codeinspectus verify-engines；缺失或失配的二进制会被拒绝执行
使用场景
在发布前扫描 AI 生成/“氛围编程”应用中的真实漏洞
由编码代理驱动的“扫描→修复→复扫”安全闭环
生成 OWASP、NIST CSF、ISO 27001、SOC 2 等框架的代码级控制覆盖报告
生成本地 SBOM（CycloneDX/SPDX），含 Dart/Flutter pubspec.lock 依赖清单
CI/本地基线与历史扫描对比、密封证据包与 GitHub/Jira/Linear 工单载荷导出
支持客户端
Claude Code完整支持
Cursor完整支持
VS Code完整支持
Codex完整支持
Windsurf完整支持
Cline完整支持
Aider完整支持