【Claude-BugHunter】让 AI 编码助手像红队猎人一样工作

项目简介

这是一个面向漏洞赏金、Web 应用测试和外部红队工作的自包含 AI 技能包。它试图把通用 AI 编码助手扩展成更熟悉攻击面梳理、漏洞狩猎、验证报告与证据规范的“安全研究助手”。

主要功能

  • 83 个自动加载技能:按主题自动触发,不需要手动按名称调用技能。
  • 15 个斜杠命令:覆盖任务执行、攻击面梳理、报告等流程。
  • 基于公开报告沉淀的漏洞模式:项目称整理了 681 条已公开报告模式,其中 433 条可被单独引用和审计,覆盖 24 个核心漏洞类别。
  • 四层工作结构:
  • 思考层:方法论与红队思维模式,强调非线性工作流和关键问题验证。
  • Web 应用狩猎层:覆盖 XSS、SQLi、SSRF、IDOR、SSRF、LFI、SSTI、XXE、CSRF、CORS、OAuth、JWT、文件上传等常见 Web 攻击面。
  • 企业边界攻击层:面向外部可访问的企业系统,包括 M365 / Entra ID、Okta、SharePoint、VMware vCenter、SSL VPN、云 IAM、APK 等方向。
  • 交付层:包含验证、报告写作、证据卫生、隐私遮蔽、严重性判断和任务成果整理。
  • 授权与范围控制:设计目标强调测试自有资产或已获授权资产,不面向内部 AD、C2、后渗透、规避、移动端硬件、二进制漏洞利用等场景。
  • 多智能体环境支持:技能采用 Agent Skills 格式,除 Claude Code 外,也支持 OpenCode、OpenAI Codex CLI、Hermes Agent、Google AntiGravity 等环境加载。
  • Burp MCP 与 HackerOne MCP:项目提供 Burp MCP 集成,并可选接入 HackerOne MCP;没有 HackerOne API 凭据时,多数公共功能仍可使用。
  • 任务目录脚手架:提供 /hunt 与 cbh CLI 相关能力,用于组织任务文件夹、状态跟踪和阶段性执行。

安装与快速使用

项目提供了插件安装和脚本安装两种方式。

方式 A:作为 Claude Code 插件安装

在 Claude Code 中执行:

/plugin marketplace add elementalsouls/Claude-BugHunter
/plugin install claude-bughunter@elementalsouls

这种方式会加载 83 个技能和 15 个命令,并通过插件版本更新保持同步。
安装时可能提示输入 HackerOne API 用户名和 Token,但它们不是必需的;留空即可使用大部分公开功能。

方式 B:复制安装

git clone https://github.com/elementalsouls/Claude-BugHunter.git
cd Claude-BugHunter

macOS / Linux:

bash scripts/install.sh

Windows PowerShell:

pwsh ./scripts/install.ps1

复制安装会把技能和命令放到用户目录下,适合不使用插件系统或需要固定版本的用户。

单独安装 cbh CLI

pipx install git+https://github.com/elementalsouls/Claude-BugHunter

多环境安装

bash scripts/install.sh --all --burp-mcp

Windows:

pwsh ./scripts/install.ps1 -All -BurpMcp

--all 会检测已安装的代理环境,并把技能复制到对应目录。需要注意,完整技能知识层可移植到多个环境,但部分斜杠命令和 /hunt 能力仍以 Claude Code 为主要运行环境。

使用示例

项目给出的交互示例是使用自然语言描述测试目标:

> Testing acme.com — an in-scope HackerOne target. Run recon and rank the surface.

随后系统会加载相关技能,并围绕子域名枚举、活跃主机、技术栈识别、GraphQL 和 OAuth 等攻击面给出下一步建议。这个示例体现了它的核心使用方式:用户描述目标,技能按场景自动加载。

适合哪些场景

该技能包更适合外部攻击面测试,典型场景包括:

  • 漏洞赏金猎人:针对 Web 应用、API、SaaS、GraphQL、OAuth、JWT、文件上传、IDOR、SSRF、RCE 等方向进行挖掘。
  • 外部渗透测试人员:围绕互联网可访问资产开展攻击面梳理、漏洞验证和报告交付。
  • 授权红队人员:面向企业外部边界进行初始访问评估,例如企业身份系统、VPN 设备、SharePoint、vCenter、云权限链等。
  • 安全研究人员:希望把常见漏洞检测模式、披露报告经验和红队方法论固化到 AI 工作流中。
  • 开发者自查:在明确说明是对自有代码进行防御性审查时,可以用于缺陷检查和修复建议。

它的定位很明确:不是完整后渗透平台,也不覆盖内部 Active Directory、横向移动、持久化、C2、规避检测、移动端硬件、二进制漏洞利用等场景。

总结

总体来看,这个项目的价值在于把漏洞狩猎和企业外部攻击面测试所需的知识、流程、报告规范打包成可自动加载的技能集合。它强调授权测试、范围控制、证据卫生与报告交付,适合已有合规边界的 Web 安全、漏洞赏金和外部红队用户。

它的优势是覆盖面较广、结构清晰、安装路径完整,并兼容多个 Agent Skills 环境。需要注意的是,项目明确排除了内部网络攻击、C2、后渗透等场景,因此更适合作为外部攻击面与授权测试工作流中的辅助技能包。若需要更多细节,建议访问其主页获取更详细信息。

more