pentest-ai-agents

让 Claude Code 变身你的渗透测试助手，自动化安全研究全流程。

pentest-ai-agents 是一个将 Claude Code 转变为进攻性安全研究助手的开源项目。它通过一系列专门化的 AI 子代理，帮助安全测试人员在获得授权的前提下，高效完成渗透测试的各个阶段。该项目解决了安全测试中重复性工作多、信息收集与分析耗时、报告撰写繁琐等痛点。其核心能力包括：规划渗透测试项目、分析侦察数据、研究漏洞利用方法、构建检测规则、审计 STIG 安全基线以及自动生成专业报告。项目基于 Shell 脚本，深度集成 Claude Code，并融合了 MITRE ATT&CK 等安全框架，适用于漏洞赏金、CTF 竞赛、红队演练等场景。

开源 unknown 智能体

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 2261

维护状态维护中

是否开源是

定价模式 unknown

项目数据

分类智能体

开发团队0xSteph

所属国家

官网地址https://pentestai.xyz

GitHubhttps://github.com/0xSteph/pentest-ai-agents

定价模式unknown

价格说明定价信息待确认

访问状态

是否开源是

开源协议MIT

主要语言Shell

技术栈/模型ai-agents,ai-security,bug-bounty,claude-code,ctf,cybersecurity,ethical-hacking,infosec,kali-linux,mitre-attack,offensive-security,oscp,penetration-testing,pentest,pentesting,red-team,security-automation,security-tools

GitHub 星标★ 2261

30天Star增速

HF 下载量

上线时间2026-03-28 00:00:00

最近更新2026-09-23 00:00:00

维护状态维护中

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数3

使用教程

难度：入门约 10 分钟部署方式：命令行工具 8 步

环境要求

已在本机安装并可运行 Claude Code（首次使用可参考仓库 INSTALL.md）
可访问 GitHub 与 raw.githubusercontent.com 的网络环境
使用一键脚本时需要 shell 环境与 curl
可选：使用容器运行工具时需已安装 Docker

安装与启动步骤

1准备 Claude Code

本项目是 Claude Code 的子代理集合，本身不含服务器和 Python 依赖，前提是本机已装好并登录 Claude Code；首次配置见仓库 INSTALL.md。
2一键脚本安装

官方推荐的一条命令。脚本会克隆仓库到临时目录，把代理文件复制到 ~/.claude/agents/ 后退出；幂等，可重复执行以更新。
```
curl -fsSL https://raw.githubusercontent.com/0xSteph/pentest-ai-agents/main/install.sh | bash
```
3插件方式安装

在 Claude Code 内通过插件市场安装，无需克隆仓库，后续经市场更新；会注册全部代理与斜杠命令。与脚本方式二选一。
```
/plugin marketplace add 0xSteph/pentest-ai-agents
/plugin install pentest-ai-agents@pentest-ai-agents
```
4克隆后本地安装

想先查看源码时用这种方式：先克隆仓库，再执行安装脚本，--global 表示全局安装到用户级代理目录。
```
git clone https://github.com/0xSteph/pentest-ai-agents.git
cd pentest-ai-agents && ./install.sh --global
```
5按需选择安装参数

仅安装到当前项目用 --project；让咨询类代理改用 Haiku 以降低花费用 --global --lite；查看全部选项用 --help。
```
./install.sh --project
./install.sh --global --lite
./install.sh --help
```
6安装底层工具(可选)

需要本机具备 nmap、nuclei、ffuf 等命令行工具时，可让安装脚本一并安装。需在克隆后的仓库目录中执行。
```
./install.sh --tools
```
7容器内跑工具(可选)

为保持宿主机干净并避免端点防护告警，建议在 Kali 容器内运行实际安全工具，宿主机上的代理只做方法论与分析。
```
docker pull kalilinux/kali-rolling
docker run -it --name pentest-lab kalilinux/kali-rolling /bin/bash
apt update && apt install -y nmap nikto sqlmap metasploit-framework bloodhound
```
8验证并使用

打开 Claude Code，用自然语言描述任务，Claude 会自动路由到合适的专家子代理，产出带 MITRE ATT&CK 映射的分阶段计划。
```
Plan an internal network pentest for a 500-endpoint AD environment with a 2-week window.
```

如何确认成功

打开 Claude Code，描述一个渗透任务，Claude 自动路由到对应子代理并输出带 MITRE ATT&CK 映射的分阶段计划即成功。

常见问题

Q：需要自己搭服务器或装 Python 依赖吗？

A：不需要。README 明确说明无服务器、无 Python 依赖，安装脚本只做一件事：把代理文件复制到 ~/.claude/agents/。

Q：插件安装和安装脚本可以同时使用吗？

A：不必。README 建议二选一：要么用安装脚本，要么用插件市场安装，两者只需选其中一种。

Q：重复运行安装脚本会出问题吗？

A：不会。脚本是幂等的，可以安全地重复运行，也正因如此可以用它来更新到最新版本的代理。

Q：不想在宿主机安装一堆安全工具怎么办？

A：改用 Docker：拉取 kalilinux/kali-rolling 镜像启动容器，在容器内 apt 安装 nmap、nikto、sqlmap 等工具，宿主机只跑代理做分析。

Q：如何降低使用成本？

A：安装时加 --lite 参数（如 ./install.sh --global --lite），让咨询类代理改用 Haiku 模型以降低花费。

注意事项

本项目仅用于获得明确授权的安全测试，未授权使用可能违法，请遵守仓库 Legal 章节说明。
安装脚本会把代理复制到 ~/.claude/agents/；只想对单个项目生效时用 --project 参数。
--tools 会额外安装 nmap、nuclei、ffuf 等底层 CLI 工具，按需选择，避免污染本机环境。
插件方式与脚本方式不要同时使用，避免重复注册代理。

核心亮点

提供多个专业子代理，覆盖从项目规划到报告生成的全流程，开箱即用。
深度集成 Claude Code，利用其强大的代码理解和生成能力，提升安全分析效率。
结合 MITRE ATT&CK 等框架，使测试过程更规范、结果更专业。

不足之处

依赖 Claude Code 和 Anthropic API，需要付费订阅或 API 额度，有使用成本。
文档/社区待观察，项目处于成长阶段，最佳实践和社区支持可能尚不完善。

适用场景

授权渗透测试项目的前期规划与信息收集阶段，快速生成测试方案。
漏洞研究过程中，辅助分析侦察数据、搜索和评估漏洞利用代码。
安全报告撰写，自动整理测试发现并生成符合规范的文档。

替代项目

PentestGPT、AutoGPT、MetaGPT

项目介绍

pentest-ai-agents 是行业应用领域的开源项目，由 0xSteph 开发，是 2026 年新上线的项目。

在全站 13,014 个收录项目中，它的 GitHub 星标数（2,261）位列前 30%，在行业应用分类的 544 个项目里位列前 12%。

近 45 天，它的 GitHub 星标从 2,096 增加到 2,261，净增 165。

项目仍在小幅维护中，最近一次代码更新于 2026-09-23。从国内网络环境看，可直接访问。

它主要面向的使用场景是：授权渗透测试项目的前期规划与信息收集阶段，快速生成测试方案。同类可对比的替代方案包括 PentestGPT、AutoGPT、MetaGPT。

上一篇：NeuroSploit

下一篇：garmin-health-data