开发工具#安全扫描#智能体路由

Claude-BugHunter:83 个技能组成的漏洞挖掘包

Claude-BugHunter 是给 Claude Code 的漏洞挖掘技能包:83 个技能覆盖 24 类漏洞,带授权范围校验与报告模板。

项目资料

GitHub Ecosystem
仓库地址github.com/elementalsouls/Claude-BugHunter
许可证
MIT
主语言
Python
星标
14,246
核查时间
2026-11-21

以上快照资料以核查当日为准,可能随版本或运营策略变化。

GitHub 为 elementalsouls/Claude-BugHunter 生成的仓库卡片:左侧是仓库名与简介,右侧是作者头像,底部是贡献者、issue、star 与 fork 计数

做授权测试的人不缺工具,缺的是每次都从同一套方法论起步的纪律:先看范围,再列表面,再按漏洞类挑假设,最后过一遍验证门。Claude-BugHunter 把这套流程写成 83 个 Claude Code 技能,外加一个不依赖模型的确定性侦察引擎。仓库 elementalsouls/Claude-BugHunter 建库于 2026-05-05,截至 2026-11-21 有 14,246 星、1,699 个分叉,采用 MIT 许可。

GitHub 为 elementalsouls/Claude-BugHunter 生成的仓库卡片,列出仓库名、一句话简介与 14k 星标

要点

  • 规模与构成:skills/ 目录下 83 个技能、commands/ 下 15 个斜杠命令。README 的归类是 58 个 hunt-* 漏洞类技能、10 个企业平台攻击技能、6 个报告与验证技能、5 个侦察与 OSINT 技能、4 个方法论技能;仓库简介仍写 82 个,以目录和 README 为准。
  • 默认不靠模型自觉:engine/ 用 Python 做确定性侦察、端点与参数分类,再把每个「端点、参数、漏洞类」映射到具体技能并附一条可运行的 curl;调用模型的部分要显式加 --hunt。
  • 范围判定写在代码里:engine/scope.py 是默认拒绝、拒绝优先的允许列表,侦察与验证两个阶段都会检查;引擎派出的 agent 默认只读,会改变状态的测试需要显式 --allow-intrusive。
项目值(2026-11-21 核对)
星标 / 分叉14,246 / 1,699
贡献者 / 未关闭条目19 / 9
许可MIT;LICENSE-CONTENT 对技能文本、词表、文档另用 CC BY 4.0
主要语言Python
建库 / 最近推送2026-05-05 / 2026-11-20
技能 / 斜杠命令83 / 15
版本只有 v2.0(2026-05-25)与 v2.1(2026-06-05)两个 tag,之后走 main

核心功能

Claude-BugHunter 的功能分三层:技能负责知道该看什么,引擎负责把攻击面铺开并排序,验证门负责把没把握的结论挡在提交之前。

  • 按描述自动加载:技能靠 SKILL.md 头部的 description 匹配,你在会话里描述正在测什么,对应的技能就会被拉进来,不需要记名字。这是 Claude Code 技能系统本身的行为,包本身没有额外调度层。
  • 按漏洞类拆分:58 个 hunt-* 技能各管一类,从 XSS、SQLi、SSRF、IDOR、请求走私,到 OAuth、SAML、JWT、Spring Boot、SharePoint、CI/CD。每类带检测模式、payload、绕过表和链模板;docs/skills.md 还标了每类引用的公开报告数,hunt-xss 174 条、hunt-misc 225 条,而 hunt-llm-ai、hunt-rag-vector、hunt-nextjs、hunt-ldap 等 10 个技能标的是 0。
  • 七问验证门:triage-validation 要求逐条回答:能否用真实 HTTP 请求复现、影响是否在项目接受清单内、资产是否在范围、是否需要攻击者拿不到的特权、是否已知行为、影响能否证明而非「理论上可能」、是否落在永不提交清单上。任何一条答否就丢弃。evidence-hygiene 则要求在截图前处理 Cookie 与其他用户 PII。
  • 确定性编排:engine/recon.py 从 JS bundle 里挖端点、扫硬编码密钥(AWS、GCP、Anthropic、OpenAI、Slack、GitHub、Stripe 等,输出时打码),参数同时取 gau 的历史数据与 katana 的实时爬取;state.json、evidence/、arsenal.md、report.md 让一次 engagement 可以中断后续跑。
  • 多目标与并发:/autopilot 接受一个 targets.txt,一行一个域名;引擎的 --parallel 默认 3 个并发 agent。但 /autopilot 的说明提醒,多目标最好一个目标开一个会话,否则 A 的结论会污染 B,同一会话里换目标要先跑 /pickup 重载上下文。
  • Burp 与 HackerOne 都可选:cbh --burp 把 CLI 的流量导进 Burp 代理;会话式用法要在 Burp Pro 的 BApp Store 装 MCP Server(需要 Java,默认监听 127.0.0.1:9876)。HackerOne 的 API 账号只影响私有项目与自己的报告,留空也能查公开项目范围和重复报告。

授权边界

这个包是方法论与报告模板的集合,不是能直接对任意目标开火的工具,作者也把边界写进了 SECURITY.md。它只面向你拥有、或拿到书面授权的资产:赏金项目范围内资产、签了授权书的渗透项目、CTF、自建靶场。明确排除的是 0day 武器化、后渗透与持久化、C2、免杀、大规模无授权扫描;内部 Active Directory、横向移动、Kerberos 攻击被列为「未来另一个包」,不在这里。

更实际的一层限制来自模型侧。README 直接写明,Anthropic 的运行时防护会拦截「漏洞利用或攻击性安全工具开发」类请求,在 Opus 5 上,exploit generation、binary-based vulnerability scanning、penetration testing 三类请求会回退到 Opus 4.8 而不是被拒绝,界面上有提示,但长会话里很容易划过去,看起来像模型突然变差。作者给的办法是申请免费的 Cyber Verification Program 调整防护,而不是把请求改写得更像防御工作。装完技能包并不等于模型会照做,这一点比功能列表更值得先知道。

典型使用场景

  • 赏金项目开局:hunt <program> 建一个 engagement 目录,在里面开 Claude Code,先让它读程序范围,再跑侦察与表面排序。目录结构和 CLAUDE.md 由脚手架生成,省掉每次手工建文件夹。
  • 第一次练手:USAGE 明确建议先打 OWASP Juice Shop、Acunetix 的 testphp.vulnweb.com 或 Hacker101,而不是拿真实赏金项目试手;这三个都不需要授权流程。
  • 企业外部红队:M365/Entra、Okta、vCenter、SSL VPN 设备、SharePoint 的技能里放的是 2024–2026 年的 CVE 链和拿到凭据之后的升级路径。这部分是它与纯 Web 漏洞包最大的差别。
  • 写报告:VRT 映射、HackerOne、Bugcrowd、Intigriti、Immunefi 的模板,以及面对「不在范围」判定时的反驳段落,都在 report-writing 与 bugcrowd-reporting 里。

社区反应与质疑

这个项目的声量主要不在讨论区。2026-05-20 的 Show HN 标题还是「574 Report Patterns」,到 2026-11-21 只有 1 分、1 条评论(内容是一句「Nice!」);Reddit 上也搜不到成型的讨论帖。14k 星更像是 GitHub 站内推荐与聚合站转发的产物,而不是社区辩论的结果。对安全工具来说这不稀奇,但也意味着外部验证很少,读的人得自己判断。

真实反馈集中在 issue 区,而且恰好落在最关键的编排与范围判定上。2026-11-19 提交的 PR #182 指出,main 上把 out-of-scope 规则写成 host:port、带 scheme 的 URL、带路径的主机、末尾带点或逗号、IPv6 CIDR 时,规则匹配不到任何主机,系统不报错地跳过拒绝规则,主机就落进更宽的 in-scope 规则里被测试。2026-11-20 的 issue #196 指出 cbh triage 的第三问只要文本里出现「scope」就答「是」,连「possibly out of scope」也算通过,第七问也没识别 clickjacking。两处都还没合并进主线。

行业侧的压力方向相反。据 Analytics Insight 2026-10-07 的报道,Google 在 2026-10-01 暂停了 OSS VRP 的产品漏洞提交,理由是自动提交激增、且绝大多数无效;curl 在 2026 年 1 月底结束了 HackerOne 悬赏,此前一周收到 7 份提交、没有一份是真的。对「AI 帮忙写报告」这类工具,这是最直接的反问:生成速度不是瓶颈,可信度才是,而可信度要靠验证门和范围纪律,不是靠更多技能。

作者本人在 engine/README.md 里给了最不客气的评估:在可基准测试的任务上,技能带来的能力增益约为 0,每个 agent 还要多花 12–15k token 去加载,所以杠杆在「安全、确定性、按技能路由、人留在环里」的引擎,而不在知识本身。这句话既是自嘲,也是这个项目最值得读的设计说明。

快速上手

插件安装是 README 推荐的方式,技能与命令都以 claude-bughunter: 前缀加载,不会往 ~/.claude/ 里拷文件:

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

想固定到某个提交、或者要用 hunt 脚手架和 cbh CLI,就走克隆加脚本安装:

git clone https://github.com/elementalsouls/Claude-BugHunter.git
cd Claude-BugHunter
bash scripts/install.sh          # Windows 用 pwsh ./scripts/install.ps1
pipx install git+https://github.com/elementalsouls/Claude-BugHunter   # 可选:cbh CLI

装之前先看运行前提,三种模式要的东西不一样:

模式需要什么适合
纯 curlPython 3.9+快速侦察、脚本化运行
Burp 代理(cbh --burp)Burp Suite Pro 或 Community需要把请求留在 Burp 历史里回放
Burp MCPBurp Pro、BApp Store 的 MCP Server、Java在会话里让模型直接驱动 Repeater

另外还需要 Claude Code 的付费计划(Pro、Team、Max)或带额度的 API key,免费版 Claude.ai 不含 Claude Code。装完在会话里描述你要测的资产即可,技能会自动加载;想先验证环境,用 hunt 不带参数应当打印用法。

小结

Claude-BugHunter 适合已经在做授权测试、想把「先定范围、再列表面、按类挑假设、过验证门」这套纪律固化下来的人,也适合带新人时给一套可照着走的流程。它不适合想找「一键打目标」按钮的人:这个包不替你判断,也没有绕过授权的能力,装完之后仍然是你决定测什么、测到哪一步停。

许可是 MIT,技能文本与文档另按 CC BY 4.0 发布;Python 编写,2026-11-21 为 14,246 星。它和站内写过的 reverse-skill 是近亲——都给编码智能体装安全技能、都先过授权门——差别在规模与编排:reverse-skill 是 44 条路由规则的小包,这个包把 83 个技能、攻击面排序和 engagement 状态一起带了进来。如果需求是防御侧,Codex Security CLI 那条「扫描、验证、出补丁」的管线更对症。

要留意的短板有四条。范围判定出过静默失效的问题(PR #182 尚未合并),验证门的确定性版本对否定语义不敏感(issue #196),这两条都直接关系到「会不会测到范围外」。技能深度的分布不均,docs/skills.md 里 10 个技能引用的公开报告数为 0,其中就有 LLM 与 RAG 这两类新面。发布节奏也停了:v2.1 之后只有 main 上的提交,没有新 tag,想固定版本得自己挑 commit。最后是安装第三方技能本身的供应链风险——仓库在 SECURITY.md 里引用 Snyk 2026 年的 ToxicSkills 研究,提醒公开技能里存在提示注入,自己的 lint 只做结构与密钥检查,不检测恶意技能,所以装之前值得把 SKILL.md 和脚本翻一遍。