安全无小事,特别是在AI时代,代码量越来越大,人工审查越来越困难,Anthropic 内部给一个工具开发了个新功能,我建议你在Claude Code使用这个命令/security-review
开启安全审查。
今天,我想和大家分享一个不可忽视的新功能:/security-review
命令,你的AI代码安全审查必须刻不容缓。
为什么安全审查变得前所未有的重要?
在AI辅助编程的时代,我们的代码产出速度呈指数级增长,但人工安全审查的速度却没有跟上。动态SQL生成通过字符串连接极易受到SQL注入攻击,而SQL注入攻击通过利用应用程序漏洞注入恶意代码来改变SQL查询。这些传统的安全威胁在快速迭代的开发环境中变得更加隐蔽和危险。

现在,Anthropic为我们提供了一个智能化解决方案——Claude Code Security Reviewer,一个基于AI的安全审查GitHub Action工具。
核心功能解析
主要特性
AI驱动的分析引擎:利用Claude的高级推理能力,进行深度语义理解的安全漏洞检测,远超传统的模式匹配方法。
差异感知扫描:对于PR请求,仅分析变更的文件,提高效率的同时确保覆盖范围。
PR自动评论:自动在拉取请求上添加安全发现的评论,实现无缝集成。
上下文理解:超越简单的模式匹配,深度理解代码语义和业务逻辑。
语言无关性:支持任何编程语言,真正做到全栈覆盖。
智能过滤:先进的过滤机制减少噪音,专注于真正的安全漏洞。
快速上手指南
创建 .github/workflows/security.yml
文件:
name Security Review
permissions
pull-requests write # 用于在PR上留下评论
contents read
on
pull_request
jobs
security
runs-on ubuntu-latest
steps
uses actions/checkout@v4
with
ref $ github.event.pull_request.head.sha || github.sha
fetch-depth2
uses anthropics/claude-code-security-review@main
with
comment-prtrue
claude-api-key $ secrets.CLAUDE_API_KEY

配置选项详解
输入参数配置
参数 | 描述 | 默认值 | 必需 |
---|---|---|---|
claude-api-key | Anthropic Claude API密钥 | None | 是 |
comment-pr | 是否在PR上评论发现的问题 | true | 否 |
upload-results | 是否将结果作为工件上传 | true | 否 |
exclude-directories | 要排除扫描的目录列表(逗号分隔) | None | 否 |
claudecode-timeout | ClaudeCode分析的超时时间(分钟) | 20 | 否 |
run-every-commit | 在每个提交上运行ClaudeCode(跳过缓存检查) | false | 否 |
false-positive-filtering-instructions | 自定义误报过滤指令文件路径 | None | 否 |
custom-security-scan-instructions | 自定义安全扫描指令文件路径 | None | 否 |
输出结果
输出 | 描述 |
---|---|
findings-count | 安全发现总数 |
new-findings-count | 新发现数量(针对PR) |
results-file | 结果JSON文件路径 |
/security-review命令
除了GitHub Actions集成,Claude Code GitHub Actions可以集成到你的开发工作流中,新的/security-review
命令让你能够在提交代码前进行临时安全分析。
核心检查项目
该命令使用专门的安全聚焦提示,检查常见的漏洞模式:
-
SQL注入风险:识别动态SQL构建和不安全的数据库查询
-
跨站脚本(XSS)漏洞:检测未经过滤的用户输入输出
-
身份验证和授权缺陷:分析访问控制逻辑
-
不安全数据处理:发现敏感信息泄露风险
-
依赖漏洞:识别第三方库的安全问题
实战应用场景
场景一:本地开发阶段
claude-code /security-review

在你的项目目录中运行此命令,Claude会全面扫描你的代码库,提供详细的安全分析报告。

场景二:特定文件审查
claude-code /security-review --files src/auth/login.js
针对特定文件进行深度安全审查,快速定位潜在问题。

自动化PR安全审查:团队协作的安全保障
GitHub Action集成将安全审查提升到了新高度:
工作流程
-
自动触发:新的拉取请求创建时自动启动
-
代码变更审查:仅分析变更的代码,提高效率
-
智能规则应用:可自定义规则过滤误报和已知问题
-
内联评论:直接在PR中发布安全建议,包含修复推荐
AI驱动的自动代码审查:每当创建或更新拉取请求时,AI(Claude)会自动发布审查评论。这种集成确保了整个团队的一致性安全审查流程,没有代码能在没有基线安全审查的情况下进入生产环境。
Anthropic团队的实战验证
Anthropic自己也在使用这些功能来保护他们发布到生产环境的代码安全性,包括Claude Code本身。自从设置了GitHub Action,这已经在他们的代码中捕获了安全漏洞并防止了这些漏洞被发布。

真实案例分享
案例一:远程代码执行漏洞 某团队构建了一个新功能,依赖启动本地HTTP服务器接受本地连接。GitHub Action识别出一个可通过DNS重绑定利用的远程代码执行漏洞,在PR合并前就被修复了。
案例二:SSRF攻击漏洞 一名工程师构建了一个代理系统来实现内部凭据的安全管理。GitHub Action自动标记出该代理容易受到SSRF攻击,问题得到了及时修复。
开始使用:实用指南
对于/security-review命令
-
确保Claude Code更新到最新版本
-
在项目目录中运行
/security-review
-
查看自定义命令的文档以个性化配置
对于GitHub Action
-
按照上述配置创建workflow文件
-
在GitHub仓库设置中添加
CLAUDE_API_KEY
密钥 -
创建测试PR验证配置是否正常工作
最佳实践建议
-
逐步部署:先在少数关键项目中测试,验证效果后再扩展
-
自定义规则:根据项目特点配置过滤规则,减少误报
-
团队培训:确保团队成员理解安全审查报告的含义
-
持续优化:根据实际使用经验调整配置参数
总结
Claude Code的/security-review
命令和GitHub Actions集成,让安全审查变成了开发流程的自然组成部分,既不会拖慢开发节奏,又能显著提升代码安全性。
特别值得一提的是,这个功能的AI驱动特性使其能够理解代码的语义和上下文,而不仅仅是简单的模式匹配。这意味着它能发现那些传统工具容易忽略的复杂安全问题。
安全无小事,特别是在AI时代。让Claude Code成为你代码安全的第一道防线,从现在开始,就使用/security-review
命令为你的项目构建坚固的安全屏障吧!
项目地址:https://github.com/anthropics/claude-code-security-review
官方介绍:https://www.anthropic.com/news/automate-security-reviews-with-claude-code