close

Claude-BugHunter

Mã nguồn mở bởi elementalsouls

Claude-BugHunter là bộ skill cho Claude Code dùng trong săn lỗi bảo mật (bug bounty) và kiểm thử bảo mật từ bên ngoài. Bộ này gồm hơn 80 skill, 15 lệnh gạch chéo và các mẫu lỗ hổng rút từ báo cáo đã công khai trên HackerOne, giúp Claude làm việc theo quy trình của người săn lỗi chuyên nghiệp trên hệ thống bạn được phép kiểm tra.

Claude-BugHunter dùng để làm gì?

  • Tự nạp đúng skill khi bạn mô tả việc cần kiểm bằng câu bình thường, không phải gọi tên skill
  • Trinh sát bề mặt lộ ra Internet, xếp hạng chỗ nên kiểm trước như trang đăng nhập, cổng API
  • Kiểm các nhóm lỗi web thường gặp như XSS, SQLi, SSRF, IDOR, lộ dữ liệu, vượt đăng nhập
  • Lọc lỗi báo nhầm bằng cổng kiểm 7 câu hỏi trước khi viết báo cáo
  • Nhắc che mật khẩu, cookie và dữ liệu cá nhân trong ảnh chụp bằng chứng
  • Soạn báo cáo theo mẫu của HackerOne, Bugcrowd, Intigriti, Immunefi hoặc báo cáo kiểm thử cho khách hàng

Cần biết trước khi dùng

  • Lưu ýKhông tìm thấy docker-compose hay Dockerfile ở thư mục gốc: chưa thể gắn nút Deploy tự động.
  • Lưu ýTino chưa kiểm thử dự án này.

Kiểm tra tự động ngày 21/11/2026 từ dữ liệu GitHub, OSV.dev và docker-compose. Đây không phải chứng nhận bảo mật; Tino không phát triển hay bảo trì repo này.

Claude-BugHunter là gì?

Khi hỏi một AI thông thường rằng website có lỗi không, câu trả lời thường là lời khuyên chung. Claude-BugHunter đưa vào Claude Code một bộ kiến thức có cấu trúc theo bốn lớp: tư duy và phương pháp (bb-methodology, redteam-mindset), 58 skill hunt-* cho từng nhóm lỗi web, chuỗi tấn công vào các nền tảng doanh nghiệp lộ ra Internet (Microsoft 365 và Entra ID, Okta, vCenter, thiết bị SSL VPN, SharePoint, IAM trên cloud), và lớp kiểm chứng, báo cáo (triage-validation, evidence-hygiene).

Các skill được nạp tự động theo chủ đề. Bạn mô tả đang kiểm cái gì, Claude tự gọi skill phù hợp. README mô tả quy trình gồm trinh sát, lập bản đồ và xếp hạng bề mặt, săn lỗi, kiểm chứng rồi báo cáo, với phạm vi được giữ bằng code và cổng kiểm 7 câu hỏi trước khi gửi bất kỳ báo cáo nào. Câu 3 của cổng kiểm hỏi tài sản có nằm trong phạm vi được phép hay không.

Con số 681 trong README là số mẫu lỗi rút từ báo cáo đã công khai trên HackerOne; CHANGELOG ghi 433 báo cáo được trích dẫn riêng từng cái và có script đối chiếu. Đây là số tác giả tự công bố.

Phạm vi được giới hạn có chủ đích: bộ này chỉ phục vụ bề mặt bên ngoài. README ghi rõ không gồm tấn công Active Directory nội bộ, framework C2, hậu khai thác, duy trì truy cập, né tránh phần mềm diệt virus, mã độc, khai thác nhị phân. SECURITY.md cũng loại trừ việc dùng 0-day với mục tiêu không được phép và quét hàng loạt.

README có mục riêng về cơ chế an toàn của Anthropic: model của Anthropic mặc định chặn yêu cầu khai thác lỗ hổng hoặc phát triển công cụ tấn công, kể cả khi bạn có giấy phép. Tác giả hướng dẫn người làm kiểm thử hợp pháp đăng ký Cyber Verification Program (miễn phí, xét duyệt hồ sơ) và yêu cầu không viết lại yêu cầu tấn công cho giống phòng thủ để qua mặt bộ phân loại. Với việc rà mã nguồn của chính mình, chỉ cần nói rõ đó là rà soát phòng thủ.

Các skill dùng định dạng SKILL.md chung nên chạy được trên OpenCode, OpenAI Codex CLI, Hermes Agent và Google Antigravity. Lệnh gạch chéo, plugin marketplace và bộ dựng /hunt chỉ có trên Claude Code. Dự án do Sachin Sharma (elementalsouls) phát triển; mã theo giấy phép MIT, nội dung skill và tài liệu theo CC BY 4.0.

Nên dùng khi

  • Bạn tham gia chương trình bug bounty và muốn Claude làm theo quy trình có kiểm chứng thay vì đoán
  • Bạn tự kiểm tra website, API hoặc hệ thống của chính mình trước khi kẻ xấu tìm ra lỗi
  • Bạn làm kiểm thử bảo mật có hợp đồng và cần mẫu báo cáo, cách che dữ liệu nhạy cảm trong bằng chứng
  • Bạn học bảo mật web trên trang luyện tập như OWASP Juice Shop, Hacker101, testphp.vulnweb.com

Không nên dùng khi

  • Mục tiêu không thuộc quyền của bạn và bạn không có giấy phép kiểm thử: SECURITY.md chỉ cho phép dùng trên tài sản của bạn, chương trình bug bounty có phạm vi rõ, hợp đồng kiểm thử hoặc CTF
  • Bạn cần kiểm mạng nội bộ, Active Directory, hậu khai thác hay né tránh phần mềm diệt virus: README ghi rõ các phần này nằm ngoài phạm vi
  • Bạn không có Claude Code gói trả phí (Pro, Team, Max) hoặc API key có tín dụng: USAGE.md ghi Claude.ai gói miễn phí không có Claude Code
  • Bạn mong AI tự vá lỗi hoặc thay hoàn toàn đội kiểm thử: bộ này hỗ trợ tìm, kiểm chứng và báo cáo, không sửa hệ thống
  • Bạn chưa chấp nhận việc yêu cầu kiểm thử chuyên sâu có thể bị cơ chế an toàn của Anthropic từ chối: README khuyên đăng ký Cyber Verification Program thay vì tìm cách lách

Tính năng chính

  • 83 skill theo README (dòng mô tả repo ghi 82), 15 lệnh gạch chéo như /hunt, /recon, /report
  • 58 skill hunt-* cho các nhóm lỗi web, 10 skill tấn công nền tảng doanh nghiệp, 6 skill kiểm chứng và báo cáo, 5 skill trinh sát
  • 681 mẫu lỗi rút từ báo cáo công khai trên HackerOne, 433 báo cáo được trích dẫn riêng
  • Cổng kiểm 7 câu hỏi và skill evidence-hygiene che dữ liệu nhạy cảm
  • Bộ dựng thư mục dự án hunt và công cụ dòng lệnh cbh (Python 3.9 trở lên)
  • Tích hợp tuỳ chọn Burp Suite và Burp MCP, máy chủ MCP HackerOne đi kèm plugin
  • Cài một lệnh cho Claude Code, OpenCode, Codex CLI, Hermes Agent, Google Antigravity
  • Giấy phép MIT cho mã, CC BY 4.0 cho nội dung skill

Cách cài đặt Claude-BugHunter

  1. Cài dưới dạng plugin trong Claude Code Gõ trong Claude Code. Skill và lệnh được nạp với tiền tố claude-bughunter: và cập nhật theo phiên bản plugin. Khi cài, plugin hỏi tên người dùng và token API HackerOne; có thể để trống nếu không cần đọc chương trình riêng tư và báo cáo của bạn.
    /plugin marketplace add elementalsouls/Claude-BugHunter
    /plugin install claude-bughunter@elementalsouls
  2. Cách khác: tải repo về máy Dùng khi muốn chép skill thẳng vào thư mục của Claude Code và có bộ dựng thư mục hunt.
    git clone https://github.com/elementalsouls/Claude-BugHunter.git
    cd Claude-BugHunter
  3. Chạy trình cài trên macOS hoặc Linux Chép skill và lệnh vào ~/.claude/, cài bộ dựng hunt.
    bash scripts/install.sh
  4. Chạy trình cài trên Windows (PowerShell) Chép vào thư mục .claude trong %USERPROFILE% và thêm lệnh hunt vào $PROFILE.
    pwsh ./scripts/install.ps1
  5. Cài cho mọi agent đang có trên máy Tự nhận diện Claude Code, OpenCode, Codex CLI, Hermes Agent, Google Antigravity và chép skill vào thư mục của từng agent; --burp-mcp nối thêm Burp MCP nếu bạn có.
    bash scripts/install.sh --all --burp-mcp
  6. Cài riêng công cụ dòng lệnh cbh Dành cho người cài bằng plugin nhưng vẫn muốn dùng cbh mà không tải cả repo.
    pipx install git+https://github.com/elementalsouls/Claude-BugHunter

Lệnh chép từ README của dự án. Đọc kỹ trước khi chạy và đối chiếu với README mới nhất, vì lệnh có thể đổi theo phiên bản.

Cấu hình quan trọng

MụcÝ nghĩa
HACKERONE_API_USERNAMETên người dùng API HackerOne, tuỳ chọn. Chỉ cần khi muốn máy chủ MCP HackerOne đọc chương trình riêng tư và báo cáo của chính bạn.
HACKERONE_API_TOKENToken API HackerOne, tuỳ chọn, đi cùng tên người dùng ở trên. Claude Code lưu token này trong vùng lưu trữ an toàn khi khai báo qua tuỳ chọn plugin.
HUNT_BASEThư mục gốc chứa các thư mục dự án do lệnh hunt tạo, mặc định là ~/Targets theo USAGE.md.

Cách tích hợp và sử dụng

  1. Luyện trên trang thực hành trướcUSAGE.md khuyên người mới không thử ngay trên chương trình bug bounty thật mà bắt đầu với OWASP Juice Shop, testphp.vulnweb.com hoặc Hacker101.
  2. Tạo thư mục dự ánBản cài từ repo có lệnh hunt kèm tên mục tiêu, tạo thư mục có file CLAUDE.md chứa ngữ cảnh phạm vi. Mở Claude Code trong thư mục đó.
  3. Mô tả việc cần kiểm bằng câu thườngVí dụ: đây là mục tiêu trong phạm vi chương trình, hãy trinh sát và xếp hạng bề mặt. Claude tự nạp các skill trinh sát, sau đó gợi ý bước kiểm tiếp theo cho từng chỗ.
  4. Kiểm chứng trước khi báo cáoCho Claude chạy qua cổng kiểm 7 câu hỏi để loại lỗi báo nhầm, xác nhận tác động thật và phạm vi, rồi dùng skill báo cáo theo nền tảng bạn nộp.

Cập nhật và sao lưu

Cài bằng plugin thì cập nhật khi tác giả tăng phiên bản plugin, qua trình quản lý plugin của Claude Code. Cài từ repo thì git pull rồi chạy lại trình cài; trình cài ghi danh sách tệp nên gỡ bằng tuỳ chọn --uninstall không xoá skill mà bundle khác đang dùng.

Dữ liệu cần giữ là các thư mục dự án do hunt tạo (mặc định ~/Targets), trong đó có ghi chép, bằng chứng và báo cáo. Bằng chứng có thể chứa dữ liệu nhạy cảm của mục tiêu, nên lưu và xoá theo thoả thuận với chương trình hoặc khách hàng.

Câu hỏi thường gặp

Dùng Claude-BugHunter có phải là lách cơ chế an toàn của Anthropic không?

Không. README nói rõ model của Anthropic mặc định chặn yêu cầu khai thác lỗ hổng và tác giả cấm viết lại yêu cầu để qua mặt. Người làm kiểm thử hợp pháp được hướng dẫn đăng ký Cyber Verification Program. Rà mã nguồn của chính mình thì chỉ cần nói rõ đó là rà soát phòng thủ.

Tôi có được dùng bộ này để kiểm website của người khác không?

Chỉ khi có giấy phép bằng văn bản hoặc tài sản đó nằm trong phạm vi của một chương trình bug bounty. SECURITY.md giới hạn việc dùng cho tài sản của bạn, chương trình bug bounty, hợp đồng kiểm thử, CTF và môi trường luyện tập.

Có cần tài khoản HackerOne không?

Không bắt buộc. Tên người dùng và token chỉ để máy chủ MCP HackerOne đọc chương trình riêng tư và báo cáo của bạn. Các skill, lệnh và công cụ công khai như tìm báo cáo trùng, xem phạm vi chương trình vẫn chạy khi để trống.

Không có Burp Suite thì có dùng được không?

Được. INSTALL.md ghi Burp chỉ là lớp tuỳ chọn. Không có Burp thì công cụ cbh chạy ở chế độ chỉ dùng curl.

Ứng dụng liên quan

Miễn trừ trách nhiệm

Tino không phát triển, không sở hữu và không liên kết với Claude-BugHunter hay nhóm phát triển elementalsouls. Tên, logo và nhãn hiệu thuộc về chủ sở hữu tương ứng; việc nhắc tới chỉ để mô tả, không có nghĩa là dự án xác nhận hay hợp tác với Tino.

Claude-BugHunter được phân phối theo giấy phép MIT của nhóm phát triển. Tino không bảo đảm về tính năng, bảo mật hay mức độ phù hợp của phần mềm; bạn tự chịu trách nhiệm khi cài đặt, cấu hình và sử dụng.

Lệnh cài và thông tin trên trang lấy từ tài liệu công khai của dự án tại thời điểm cập nhật và có thể đã thay đổi. Đọc tài liệu chính thức và sao lưu dữ liệu trước khi chạy trên máy chủ thật.