claude-bughunter banner
claude-bughunter
버그 헌팅 및 외부 레드팀 작업을 위한 독립형 Claude 스킬 번들입니다 · 83 skills · 15 슬래시 명령어(slash commands) · 24개 핵심 취약점 클래스에 걸친 681 disclosed-report patterns(현재 433개가 개별 인용 및 감사 가능) · 엔터프라이즈 아이덴티티 및 인프라 공격 매트릭스 · 참여 폴더 스캐폴딩(engagement-folder scaffolding) · Burp MCP 통합 · 승인된 레드팀 및 버그 헌팅 임무, 그리고 공개 교육 플랫폼(DVWA, OWASP Juice Shop, Hacker101, testphp.vulnweb.com)을 통해 검증되었습니다.
**Sachin Sharma**이 제작했습니다 — 버그 헌팅 및 GenAI 보안 연구.
<p align="center">
<br/>
<a href="https://www.apismart.ai/">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="assets/sponsors/apismart-dark.png">
<img alt="ApiSmart" src="https://raw.githubusercontent.com/elementalsouls/Claude-BugHunter/HEAD/assets/sponsors/apismart-light.png" height="30">
</picture>
</a>
<a href="https://threatwatch360.com">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="assets/sponsors/tw360-dark.svg">
<img alt="ThreatWatch360" src="https://raw.githubusercontent.com/elementalsouls/Claude-BugHunter/HEAD/assets/sponsors/tw360-light.svg" height="30">
</picture>
</a>
</p>
이것은 무엇인가요?
claude-bughunter는 Claude Code skills system을 위한 드롭인(drop-in) 스킬 번들입니다. 한 번 설치하면 Claude Code는 단순한 챗봇 역할을 멈추고, 시니어 버그 헌팅 연구원이나 레드팀 운영자처럼 행동하기 시작합니다: 기술, 체인 템플릿, VRT 매핑, 플랫폼 CVE 체인, 그리고 위생(hygiene)에 대한 지식을 갖추게 되며, 범위 내에서 유지됩니다.
네 가지 레이어가 쌓입니다:
- 사고(Think) —
bb-methodology + redteam-mindset: 5단계 비선형 워크플로우, 비판적 사고 프레임워크, 그리고 레드팀 오퍼레이터 규율.
- 웹앱 탐지(Hunt webapps) — 681개의 공개된 HackerOne 리포트에서 선별한 58개의
hunt-* 스킬: 클래스별 탐지 패턴, 페이로드, 우회 테이블, 그리고 체인 템플릿.
- 경계 침투(Hit the perimeter) — 엔터프라이즈 플랫폼 체인 (M365/Entra, Okta, vCenter, SSL-VPN 어플라이언스, SharePoint, 클라우드 IAM): 현재 2024–2026 CVE 체인 + 자격 증명 상승 후(post-credential escalation).
- 전달(Ship it) —
triage-validation + 보고서 작성 + evidence-hygiene: 7개 질문 게이트(7-Question Gate), VRT 기반 심각도(VRT-aware severity), OOS 반박(OOS rebuttals), PII 마스킹(PII redaction), 그리고 레드팀 산출물.
주제별로 자동 트리거됨 — 테스트하려는 내용을 일반 영어로 설명하고 관련 스킬을 로드합니다. 이름으로 호출하지 않습니다.
빠른 시작 (Quickstart)
옵션 A — Claude Code 플러그인으로 설치 (권장). Claude Code 내부에서:
/plugin marketplace add elementalsouls/Claude-BugHunter
/plugin install claude-bughunter@elementalsouls
83개 스킬과 15개 명령어 모두 claude-bughunter: 네임스페이스 아래에 로드되며, 플러그인 버전을 업데이트할 때마다 업데이트됩니다 — ~/.claude/ 폴더에 파일이 복사되지 않습니다.
옵션 B — 복사 설치 (플러그인 시스템 없음 / 클론 고정):
git clone https://github.com/elementalsouls/Claude-BugHunter.git
cd Claude-BugHunter
bash scripts/install.sh
...
두 옵션 모두 스킬과 명령어를 ~/.claude/ (macOS/Linux) 또는 %USERPROFILE%\.claude\ (Windows)에 복사하고 hunt 참여 스캐폴더를 연결합니다.
각 설치 경로가 제공하는 것:
| 경로 | 83개 스킬 + 15개 슬래시 명령어 | cbh CLI | hunt 스캐폴더 |
|---|
| A — 플러그인 | ✅ claude-bughunter: 아래 네임스페이스됨 | ➕ 별도의 pipx install | ❌ 클론 전용 |
| B — 복사 설치 | ✅ ~/.claude/에 복사됨 | ✅ 클론에서 제공 | ✅ 클론에서 제공 |
이 플러그인은 스킬(skills)과 슬래시 명령어에 도달하는 가장 빠른 경로입니다. 터미널 네이티브인 cbh 러너는 독립적으로 설치됩니다 — pipx install git+https://github.com/elementalsouls/Claude-BugHunter — 따라서 플러그인 사용자는 전체 클론 없이 이를 추가할 수 있습니다 (cbh CLI 참조). hunt 참여 스캐폴더는 클론과 함께 제공됩니다 (옵션 B).
이것으로 충분합니다. Claude Code를 열고 테스트하려는 내용을 일반 영어로 설명하면 됩니다 — 올바른 스킬은 이름 호출 없이 자동으로 로드됩니다:
> Testing acme.com — an in-scope HackerOne target. Run recon and rank the surface.
⟳ loading skills: web2-recon, offensive-osint, bb-methodology …
...
→ 전체 설치 가이드 · 사용 가이드 · 검색 가능한 스킬 카탈로그.
위의 블록은 예시 트랜스크립트입니다. 자신만의 세션에 대한 실제 데모를 녹화하려면: asciinema rec demo.cast → asciinema.org에 업로드하고 배지를 여기에 첨부하세요.
여러 에이전트 하네스에서 실행
One install, agent harnesses — Claude Code, OpenCode, Codex CLI, Hermes Agent, Google AntiGravity
이 스킬들은 일반적인 Agent Skills입니다 — Claude Code · OpenCode · OpenAI Codex CLI · Hermes Agent · Google AntiGravity 모두가 로드하는 동일한 SKILL.md 형식을 따릅니다. 단 하나의 명령어로 모든 곳에 설치할 수 있습니다:
bash scripts/install.sh --all --burp-mcp
...
| 하네스 | 대상 스킬 디렉토리 | 플래그 |
|---|
| Claude Code (기준선) | ~/.claude/skills/ | (기본값) |
| ... | | |
--all (-All)은 설치된 하네스를 감지하고 스킬을 각 하네스의 경로(~/.claude/skills, ~/.agents/skills, ~/.hermes/skills, ~/.gemini/config/skills)에 복사합니다. --burp-mcp (-BurpMcp)는 Burp MCP 서버를 각각의 하네스에 연결합니다. 전체 지식(knowledge) 레이어는 다섯 곳 모두로 포팅되지만, 슬래시 명령어와 /hunt 엔진은 설계상 Claude-Code 전용으로 유지됩니다. | | |
→ 다중 하네스 가이드
스타 히스토리
<a href="https://github.com/elementalsouls/Claude-BugHunter/stargazers">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="assets/star-history-dark.svg" />
<source media="(prefers-color-scheme: light)" srcset="assets/star-history-light.svg" />
<img alt="Star history chart for Claude-BugHunter" src="https://raw.githubusercontent.com/elementalsouls/Claude-BugHunter/HEAD/assets/star-history-light.svg" width="840" />
</picture>
</a>
<sub>차트는 자체 호스팅됩니다 — python3 scripts/gen_star_history.py로 재생성할 수 있습니다 (gh auth login 필요). .github/workflows/star-history.yml을 통해 매일 자동으로 새로 고침됩니다.</sub>
범위(Scope) — 이 번들이 무엇에 사용되는지, 그리고 무엇이 아닌지에 대한 설명
이 번들은 내부 엔드포인트를 먼저 침해하지 않고 인터넷에서 도달 가능한 모든 것, 즉 **외부 공격 표면(external attack surface)**을 다룹니다.
포함 범위 (In scope)
- 버그 바운티 헌팅(Bug bounty hunting) — 웹 앱, API, SaaS, GraphQL, OAuth, JWT, 파일 업로드, IDOR, SSRF, RCE 체인
- 웹 애플리케이션 침투 테스트(Web application pentesting) — OWASP 매핑된 버그 클래스에 대한 전체 헌팅 커버리지 + 규율 규칙
- 외부 레드팀 참여(External red-team engagements) — 인터넷에 노출된 엔터프라이즈 자산에 대한 초기 접근: M365 / Entra ID, Okta-as-IdP, 온프레미스 SharePoint (ToolShell + 레거시 SOAP), VMware vCenter / Workspace ONE, SSL VPN 어플라이언스 (Cisco / Fortinet / Citrix / Palo Alto / Pulse / SonicWall / F5), Android APK 레드팀, 공급망 정찰(supply-chain recon)
- 클라우드 오설정 및 자격 증명 상승 후 공격(Cloud misconfig + post-credential escalation) — 공개 S3, IMDS 체인, STS AssumeRole, 크로스 계정 혼란 대리인(cross-account confused-deputy)
- 정찰 및 OSINT — 서브도메인 열거(subdomain enum), ID 패브릭 매핑(identity-fabric mapping), 인증서 투명성, JS 분석, 시크릿 스캐닝
- 보고(Reporting) — H1, Bugcrowd (VRT 인식), Intigriti, Immunefi 및 고객 대상 레드팀 산출물 형식
제외 범위 (Out of scope) (의도적 제외 사항 — 누락이 아닌 설계 결정)
- 내부 Active Directory 공격 — BloodHoundHound, Kerberoasting, ASREProast, DCSync, Pass-the-Hash, AD CS 남용(abuse), ntlmrelayx, Responder, PetitPotam 등. 운영 위험 프로필이 다르므로 다른 도구와 판단력이 필요합니다. 이번 번들에 포함되지 않은 미래 기능입니다.
- C2 프레임워크 — Cobalt Strike, Sliver, Mythic, Havoc, BRC4 트레이드크래프트(tradecraft). 외부 전용 참여 모델(external-only engagement model) 범위 밖입니다.
- 공격 후/지속성/측면 이동 — Mimikatz/comsvcs LSASS 메모리 덤핑, 골든 티켓(golden tickets)/실버 티켓(silver tickets), 이름 지정 파이프 위장(named-pipe impersonation), 지속성 확보(레지스트리, 예약된 작업, WMI 이벤트, COM 하이재킹), 토큰 탈취. 이들은 경계가 이미 뚫린 후에 시작되는 영역으로, 다른 번들의 영역입니다.
- 우회 기법 (Evasion) — AMSI 우회(bypass), ETW 패치(patching), AV/EDR 우회(bypass). 위 C2 트레이드크래프트와 관련됩니다.
- iOS 침투 테스트 / 하드웨어 / RF / ICS — 설계상 범위 밖입니다.
- 바이너리 익스플로잇 / 커널 권한 상승 (kernel pwn) / 브라우저 내부 구조 — 다른 기술 영역(skill universe)이 필요합니다.
만약 Kerberos를 통한 도메인 장악 체인(domain-takeover chains)이나 측면 이동을 포함하는 내부 레드팀을 운영하고 있다면, 이 번들은 해당 단계에서 도움이 되지 않을 것입니다. 그리고 저희는 참여 중간에 알게 되도록 하기보다는 사전에 말씀드리는 것이 낫다고 생각합니다. 외부 표면에서 내부 RT 도구(Impacket, NetExec, CrackMapExec, Rubeus, Certify, BloodHound)로의 인계 과정은 의도적으로 저희 범위 밖에 있습니다. 내부 AD 및 공격 후 단계에 대한 커버리지는 향후 업데이트에서 제공될 수 있습니다.
포함된 내용 (What's inside)
**83개의 기술(skills)**이 주제별로 자동 로드되며, 이름으로 호출할 필요가 없습니다. 외부 공격 표면 전반에 걸친 커버리지를 제공합니다:
| 카테고리 | # | 예시 |
|---|
| Hunt — 웹 앱 취약점 클래스 | 58 | XSS, SQLi, SSRF, IDOR, LFI, SSTI, XXE, CSRF, CORS, open-redirect, SharePoint, ASP.NET/NTLM |
| ... | | |
전체 검색 가능한 카탈로그 → docs/skills.md. 또한 15개의 슬래시 명령어(/hunt, /recon, /report, …)와 타겟의 공격 표면을 매핑하고 각 발견 사항을 처리하는 기술로 라우팅하는 결정론적 참여 엔진(engagement engine) (engine/)도 함께 제공됩니다.
작동 방식 (How it works)
코드 레벨에서 범위가 강제되며, 제출되기 전에 **7가지 질문 게이트(7-Question Gate)**를 거치는 6단계의 비선형 워크플로우입니다 — recon → map & rank → hunt → validate → report. 구동 방식은 두 가지입니다:
- 일반 영어 (Plain English): 테스트할 내용과 관련된 기술 스킬 로드를 자동으로 설명합니다.
/hunt 스캐폴드 및 cbh CLI: 참여 폴더 구조, 상태 관리(state), 오케스트레이션(orchestration)을 제공합니다.
→ Usage guide & worked example · 6-phase architecture & skill-to-phase map · cbh CLI
권한 부여 (Authorization)
이 스킬들은 사용자가 소유했거나 또는 **평가할 서면 승인(written authorization)**을 받은 자산에 사용하도록 의도되었습니다 (버그 바운티 범위 내 자산, 모의 침투 테스트 계약서(pentest engagement letters), CTF 챌린지, 자체 인프라).
이 스킬들에는 검증 게이트가 포함되어 있습니다. 사용자가 Claude에게 검증되지 않은 타사 대상(third-party targets)을 지정하면 자동으로 트리거됩니다 — triage-validation의 7가지 질문 게이트는 자산이 범위 내에 있는지 여부(Q3)와 프로그램에서 수용하는 영향 목록에 포함되어 있는지 여부(Q2)를 명시적으로 질문합니다. bugcrowd-reporting 스킬은 연구원 측의 위생 관리(researcher-side hygiene) (Bugcrowdninja 별칭, 계정 상태 복구, 친근한 테스터 자세 등)를 포함하여 대상의 사기 방지 팀에 합법적이고 승인된 테스트임을 알립니다.
이 번들에서 명시적으로 제외하는 항목은 다음과 같습니다: 무단 대상으로 0-day 취약점을 악용하는 행위, 침투 후 도구(post-exploitation tooling), 악성코드 개발, 대량 표적화 인프라. 전체 자세한 내용은 SECURITY.md를 참조하십시오.
⚠️ 주의사항 — Anthropic의 런타임 사이버 보호 장치.
Anthropic 모델은 기본적으로 "취약점 악용 또는 공격 보안 도구 개발"을 차단하는 실시간 보호 장치를 적용합니다. 따라서 승인된, 범위 내 작업이라 하더라도 이 번들(bundle)이 원인이 아닌 거부 응답에 직면할 수 있습니다. 만약 승인된 공격 보안 활동(모의 침투 테스트/버그 바운티/레드팀)을 수행하는 경우, 합법적인 이중 용도 작업을 위해 보호 장치를 조정받으려면 Anthropic의 **무료 애플리케이션 기반 사이버 검증 프로그램 (Cyber Verification Program, CVP)**에 등록하십시오. (대량 데이터 유출 및 랜섬웨어 개발은 여전히 금지되며 조정되지 않습니다.) 자세한 내용은: Anthropic — 실시간 사이버 보호 장치.
세션 중간에 모델이 변경된 이유
거부(refusal)와는 별개이며 놓치기 쉽습니다. Opus 5에서는 높은 위험도의 특정 사이버 요청 세트—Anthropic은 익스플로잇 생성, 바이너리 기반 취약점 스캐닝, 및 침투 테스트를 언급합니다—가 거부되는 대신 Opus 4.8으로 대체됩니다(fall back). 알림을 받으며 응답에는 답변한 모델이 표시되지만, 스크롤하기 쉬운 긴 에이전트(agentic) 실행 과정에서는 Opus 5가 조용히 성능이 저하된 것처럼 보일 수 있습니다. Claude가 Opus 5와의 대화에서 모델을 변경한 이유를 참조하십시오.
