pentest-ai-agents

环境要求

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

安装与启动步骤

1. 1准备 Claude Code

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

2. 2一键脚本安装

   官方推荐的一条命令。脚本会克隆仓库到临时目录，把代理文件复制到 ~/.claude/agents/ 后退出；幂等，可重复执行以更新。

   curl -fsSL https://raw.githubusercontent.com/0xSteph/pentest-ai-agents/main/install.sh | bash

   复制

3. 3插件方式安装

   在 Claude Code 内通过插件市场安装，无需克隆仓库，后续经市场更新；会注册全部代理与斜杠命令。与脚本方式二选一。

   /plugin marketplace add 0xSteph/pentest-ai-agents
   /plugin install pentest-ai-agents@pentest-ai-agents

   复制

4. 4克隆后本地安装

   想先查看源码时用这种方式：先克隆仓库，再执行安装脚本，--global 表示全局安装到用户级代理目录。

   git clone https://github.com/0xSteph/pentest-ai-agents.git
   cd pentest-ai-agents && ./install.sh --global

   复制

5. 5按需选择安装参数

   仅安装到当前项目用 --project；让咨询类代理改用 Haiku 以降低花费用 --global --lite；查看全部选项用 --help。

   ./install.sh --project
   ./install.sh --global --lite
   ./install.sh --help

   复制

6. 6安装底层工具(可选)

   需要本机具备 nmap、nuclei、ffuf 等命令行工具时，可让安装脚本一并安装。需在克隆后的仓库目录中执行。

   ./install.sh --tools

   复制

7. 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. 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 映射的分阶段计划即成功。

常见问题

注意事项

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