Claude-BugHunter 是一个给 Claude Code 装上的漏洞狩猎技能包:83 个技能、15 条斜杠命令,把 681 份已公开的 HackerOne 漏洞报告里验证过的打法,整理成按主题自动加载的操作手册——从侦察、排面、挖掘、验证到写报告,一条链走完。代码 MIT 许可证、内容 CC BY 4.0,GitHub 实时 11,405 星(本站核对:2026-11-19),2026 年 11 月 18–19 日 GitHub Trending 日榜第一。本文安装步骤以官方 README 与安装文档为准;本站验证:星数、双许可证与版本 v2.1 已核对,scripts/install.sh 与 .claude-plugin/marketplace.json、plugin.json 已核对存在;未在 Claude Code 内实机安装(需要 Claude Code 环境与授权测试目标),下文如实标注。

能干什么

  • 按主题自动加载,不用背技能名:用中文或英文说一句“测一下 acme.com,一个在赏金范围内的目标,先侦察再排面”,相关的侦察、方法论技能自己加载,不用逐个点名调用。
  • 58 个 hunt-* 技能覆盖常见漏洞类别:XSS、SQL 注入、SSRF、IDOR、文件上传、SSRF、SSTI、XXE、CSRF、CORS、开放重定向、GraphQL、OAuth、JWT 等,每类带检测模式、payload、绕过表与成链模板——模式来自真实报告,不是抽象的 OWASP 条文。
  • 企业边界链也在内:M365 / Entra ID、Okta、vCenter、SSL-VPN 设备(Cisco / Fortinet / Citrix / Palo Alto 等)、SharePoint、云 IAM 提权,带 2024–2026 年的 CVE 链与凭证到手后的提权模型。
  • 提交前有验证门:triage-validation 的 7-Question Gate 在提交前逐项卡——在不在范围、影不影响、能不能复现;报告技能按平台区分写法(HackerOne、Bugcrowd、Intigriti、Immunefi 各有模板与严重度规则)。
  • 证据卫生有人管:evidence-hygiene 管截图脱敏(Cookie 与受害人个人信息先清掉再交),/hunt 脚手架与 cbh CLI 管一次测试的目录、状态与编排,证据与提交 ID 不再散落各处。
  • 不只 Claude Code:技能是标准 Agent Skills 格式,OpenCode、Codex CLI、Hermes Agent、Google AntiGravity 也能读;HackerOne MCP 可查重复报告与项目范围,登录后还能读自己的私有项目与报告。

优缺点

优点:打法来自 681 份已公开报告里三方真正付过钱的链路,知道“什么组合能成、什么会被降级”;7-Question Gate 把“先验证再提交”的纪律写进了流程,少走弯路;多宿主支持,一套技能五处可用;报告模板分平台,严重度按各平台规则(VRT)对齐,不用自己猜。

缺点与边界:只覆盖外部攻击面——内网 AD 攻击、C2 框架、后渗透与持久化、免杀明确不在范围,README 自己先说了,别 mid-engagement 才发现;Anthropic 的实时网络安全防护默认会拦“漏洞利用与进攻性安全工具开发”类请求,授权工作要去申请免费的 Cyber Verification Program(CVP);Opus 5 上少数高风险请求会静默降级到 Opus 4.8,回答标注的模型名要留意;重型外部工具要另装(subfinder、httpx、nuclei、Burp Suite + MCP);HackerOne 私有项目要另配 API 凭证。

下载与安装(官方文档口径)

  1. 插件方式(官方推荐):在 Claude Code 里依次跑 /plugin marketplace add elementalsouls/Claude-BugHunter 与 /plugin install claude-bughunter@elementalsouls。83 个技能与 15 条命令以 claude-bughunter: 命名空间加载,升级插件版本即更新,不往 ~/.claude/ 里拷文件。
  2. 复制安装(不用插件系统、或想钉住某个版本):git clone https://github.com/elementalsouls/Claude-BugHunter.git,再跑 bash scripts/install.sh(macOS / Linux)或 pwsh ./scripts/install.ps1(Windows),技能与命令拷进 ~/.claude/,并接好 hunt 测试脚手架。
  3. 多宿主一起装:复制安装时加 --all,脚本会探测已装的宿主并把技能拷到各处(Claude Code、OpenCode、Codex CLI、Hermes、AntiGravity);--burp-mcp 顺手把 Burp MCP 接进各宿主。注意:斜杠命令与 /hunt 引擎是 Claude Code 专属,别的宿主只拿到技能知识层。
  4. cbh CLI 单独装:插件用户不想要整仓克隆,可跑 pipx install git+https://github.com/elementalsouls/Claude-BugHunter 只装终端版 runner。
  5. HackerOne 账号可选:安装时会问 HackerOne API 用户名与 Token,只影响“读自己的私有项目与报告”;两项留空,全部技能、命令与 MCP 公开工具(查重、看范围)照常可用。
  6. 先备好外部工具链:侦察阶段要调 subfinder、httpx、nuclei 这类工具,Burp 联动要另装 Burp Suite 与 MCP 扩展;装技能之前先确认这些在不在 PATH 上,缺了它侦察步骤会直接报缺工具。

调用与使用

  1. 开场先把授权帧说清:/hunt 会在第一回合就声明本次测试的授权与范围——授权背景属于会话内容,要显式说出来,不要只放在心里。
  2. 一句话开工:Testing acme.com — an in-scope HackerOne target. Run recon and rank the surface. 技能按主题加载,先子域名枚举、再活主机探测、技术栈指纹,最后排出优先级:GraphQL 内省开着的接口排第一,OAuth 排第二。
  3. 按 6 阶段走:侦察 → 排面定级 → 挖掘 → 验证 → 报告,流程是非线性的——验证不过就回头再挖,不要硬交。
  4. 提交前过 7-Question Gate:范围对不对、影响在不在接收清单、能不能稳定复现、证据齐不齐,逐项确认再写报告;报告按目标平台选模板,严重度按该平台的 VRT 来。
  5. 收尾做证据卫生:截图先脱敏再交,Cookie 与个人信息不进报告;测试目录(/hunt 脚手架建的)留好,复现与复核都靠它。

调教成自己的

  • 先写死 scope.md 再开工:把授权范围、禁测清单、接收的影响列表写进测试目录的 scope 文件——技能会在验证门里反复对照它,范围不清是返工的第一来源。
  • 按常测的类别留技能:技能按主题自动加载,调教点不在删技能,而在“先定 1–2 个主攻类别”——比如这周只攻 GraphQL 与 OAuth,让智能体先把这两类的链路模板吃透。
  • 把报告模板改成自己的格式:按平台模板出一份报告后,把“影响描述、复现步骤、修复建议”三段改成你固定要的口径,下次直接复用。
  • 企业链只开自己用的平台:M365、Okta、vCenter、SSL-VPN 各是一套打法,先在测试目录里记清目标企业实际在用的那一两个,别十个全开。

玩法:独立开发者上线前的安全自查

模拟一位做 SaaS 的独立开发者:产品快上线了,怕一上线就被薅羊毛或撞上低级漏洞,但请不起外部渗透测试。他的打法:

  1. 先把自查范围写死:自己的域名、自己的 API、自己的登录与支付链路——只测自己拥有的资产,这一步写进 scope.md。
  2. 让 Claude Code 用 BugHunter 按 6 阶段跑一遍:侦察排面先看暴露面(哪些接口、哪些管理后台露在外面),再按优先级逐个类别挖。
  3. 挖到的先过 7-Question Gate:能稳定复现、确实影响业务的才进修复清单,修完再跑一遍验证。
  4. 高危修完再上线:报告模板里的“修复建议”段直接当开发任务拆,修完打勾;低危的记进待办,不拦上线。
  5. 每次大版本发布前重跑一次:技能与 CVE 矩阵会更新,插件升级后排面可能变,回归自查是固定动作。

避坑指南

  • 授权红线是第一条:README 原话——只测自己拥有或有书面授权的资产(赏金范围内的目标、渗透测试授权书、CTF 题目、自己的基础设施)。没授权不测,技能里的验证门也会在你指向未验证的第三方目标时自动触发。
  • 被 Claude 拒绝不一定是工具坏了:Anthropic 的实时防护默认拦进攻性安全类请求;做授权的进攻性工作(渗透测试、赏金、红队)要去申请免费的 Cyber Verification Program(CVP),不要靠改写措辞绕过分类器。
  • 留意模型静默降级:Opus 5 上少数高风险请求会降级到 Opus 4.8 回答,回答里会标注实际模型;长会话里容易滑过去,觉得“Opus 5 变差了”其实是换了模型。设置里可以关掉自动切换。
  • 内网 AD 别指望它:BloodHound、Kerberoasting、横向移动这些明确 out of scope;要做内网红队得另配 Impacket、NetExec、BloodHound 那套工具,别在外网技能包里找。
  • Burp 联动要另装:Burp Suite 与 MCP 扩展不在技能包里,--burp-mcp 只是接线;没装 Burp 就别开这个开关。
  • 证据先脱敏再交:截图里的 Cookie、Token 与受害人个人信息先清掉;报告一旦交出去就收不回。
  • 别把“模式”当“漏洞”:技能给的是检测模式与链路模板,交报告之前必须自己复现验证——没复现的发现只是猜测,交上去会被降级或打回。

档案

  • 仓库:github.com/elementalsouls/Claude-BugHunter;双许可证——代码(Python 脚本、Shell 脚本)MIT,内容(技能方法论、词表、规则)CC BY 4.0(商用可复用,须署名 Sachin Sharma / Claude-BugHunter 并链回仓库);上游技能归属见仓库 NOTICE。
  • 星数 11,405(2026-11-19 实时核对);2026 年 11 月 18–19 日 GitHub Trending 日榜第一;最新版 v2.1(2026-06-05 发布)。
  • 本站验证:星数、双许可证与版本已核对;scripts/install.sh、.claude-plugin/marketplace.json 与 plugin.json 已核对存在;插件安装、/hunt 实跑与 CVP 申请流程未在本机验证,步骤以官方 README、INSTALL.md 与 USAGE.md 为准。

常见问题

它和 nuclei 单独用有什么区别?nuclei 是扫描器,跑模板找已知问题;BugHunter 是方法论层——侦察排面、成链模板、验证门、按平台写报告,重点在“知道该找什么、找到之后怎么确认、怎么写才会被接受”。

没有 HackerOne 账号能用吗?能。账号只影响读私有项目与自己的报告;全部技能、命令与公开工具(查重、看范围)都不需要账号。

能测内网吗?不能。内网 AD 攻击、C2、后渗透明确不在范围;这个包只做外部攻击面。

会被 Claude 拒绝吗?有可能。Anthropic 的实时防护默认拦进攻性安全类请求;做授权工作请申请免费的 CVP,不要靠改措辞绕过。

中文能用吗?技能方法论是英文的,但用中文描述测试目标也能触发加载;报告模板是英文的,交之前按目标平台要求改成对应语言即可。

搞不定配置怎么办?先按官方 INSTALL.md 核对外部工具链(subfinder、httpx、nuclei、Burp)是不是装好了;实在跑不通,可以看本站的部署与配置跑通服务,把跑通这一步交出去。

站内往下读:AI编程栏目、Cline:装在 VS Code 里、每一步都先经你批准的开源编程智能体、OpenHands:能接整件开发任务的开源智能体。