自主AI渗透测试智能体,可编排多智能体侦察、漏洞利用、后渗透及报告生成,并具备持久化交战状态。
终端中的 AI 渗透测试智能体。
多智能体架构 • 交战状态跟踪 • 20+ LLM 提供商
PentestCode 是终端中的自主渗透测试智能体。 将其指向目标,它便会运行工具、读取输出、更新对网络的认知,并决定下一步行动——就像一名操作员那样。它是 OpenCode(MIT)的硬分叉,剥离了代码编辑的重心,并针对攻击性安全进行了重构。
Beta — 它在真实交战和 CTF 中表现可靠,但请预期会有粗糙之处。当出现问题时,请提交 issue;这正是它变得更好的原因。
一条指令输入,完整攻击链输出:
you: "pentest 10.10.10.5, goal is domain admin"
| 阶段 | 智能体执行的操作 |
|---|---|
| 扫描 | nmap -sS -p- 发现 7 个开放端口,并将 XML 直接解析到交战状态中 |
| 识别 | 端口 88 + 389 → 域控制器。并行展开三个枚举器(SMB、LDAP、HTTP) |
| 枚举 | 空 SMB 会话 → 可写共享。LDAP → 用户列表。Gobuster → Web 目录 |
| 攻击 | AS-REP roast → 可破解哈希 → 第一个有效凭据 |
| 喷洒 | 将该凭据喷洒到每个已知主机上的 SMB、WinRM、LDAP 和 RDP |
| 利用 | WinRM 立足点 → 后利用智能体转储 SAM / LSA / DPAPI |
| 结果 | 域管理员哈希到手——每一步都连同其证据链被记录 |
它在人们容易偷懒的地方保持有条不紊:它会将每个凭据喷洒到每台主机上的每个服务,并且不会忘记检查事项。它学到的一切都会落入结构化状态,你可以在运行中途用 /status、/vulns 或 /creds 查询。
npm install -g pentestcode-ai
# via curl
curl -fsSL https://raw.githubusercontent.com/s0ld13rr/pentestcode/main/install.sh | bash
一个单一的自包含二进制文件——无需安装 Bun、Node 或运行时。支持 Linux 和 macOS,x64 和 arm64。
Arch Linux (AUR):
paru -S pentestcode-bin
固定版本:
PENTESTCODE_VERSION=0.1.7 curl -fsSL https://raw.githubusercontent.com/s0ld13rr/pentestcode/main/install.sh | bash
自定义目录:
PENTESTCODE_INSTALL=/usr/local/bin curl -fsSL https://raw.githubusercontent.com/s0ld13rr/pentestcode/main/install.sh | bash
来自源:
bun install
bun run build --single --skip-embed-web-ui
# binary at packages/opencode/dist/pentestcode-<os>-<arch>/bin/pentestcode
pentestcode auth login # connect your LLM provider
pentestcode # interactive session
pentestcode --prompt "scan 10.10.10.0/24 and enumerate all services" # one-shot
通过 ai-sdk 支持 20 多家提供商——Anthropic、OpenAI、Google、Azure、AWS Bedrock、Ollama 等。
PentestCode 与粘贴到聊天窗口中的渗透测试提示词有两点不同:一个智能体团队和它们共享的记忆。
该设计遵循 HPTSA 研究中的策略师-协调者模型——相比单一智能体提升了 4.3 倍:
┌─────────────┐
│ pentest │ strategist / coordinator
│ (lead) │ plans, dispatches, tracks state
└──────┬──────┘
┌───────┬───────┼───────┬───────┐
▼ ▼ ▼ ▼ ▼
┌──────┐┌──────┐┌──────┐┌──────┐┌──────┐
│recon ││scan- ││explo-││iden- ││post- │
│ ││ner ││iter ││tity ││explo │ ... + 7 more
└──────┘└──────┘└──────┘└──────┘└──────┘
主控 agent(pentest)将任务拆分为多个子任务,并并行派发专业子 agent——每个子 agent 都有自己的系统提示词、工具权限和领域知识。共 13 个 agent: recon、scanner、enumerator、exploiter、identity(AD/Kerberos)、infrastructure(SNMP/IPMI/数据库)、webapp(OWASP Top 10)、post-exploit、exploit-dev、critic(误报检查器)、reporter,以及用于上下文压缩和会话管理的隐藏 agent。
当 scanner 发现一个端口时,enumerator 会立即看到它——因为每个 agent 都读写同一个结构化的交战状态:
状态在会话结束后依然保留:关闭终端,明天再回来,agent 会从停止的地方继续。与此同时,一个人类可读的 findings.md 会记录每个漏洞、凭据和访问获取,并带有时间戳——用 tail -f 实时查看交战进展。
除 bash 外,还有 18 个内置渗透测试工具。解析器工具是强制性的:运行 nmap 后,agent 必须将输出通过 nmap_parse 管道处理,而不是手动 grep XML,这样每个发现才能进入交战状态。
| 工具 | 功能 |
|---|---|
nmap_parse | 解析 nmap XML → 自动填充主机/服务 |
nuclei_parse | 解析 Nuclei JSON → 创建带严重性的漏洞 |
cme_parse | 解析 NetExec 输出 → 更新凭据/访问/主机 |
gobuster_parse | 解析目录爆破输出 → 分类发现 |
bloodhound_parse | 解析 SharpHound JSON → 填充 AD 模型 |
sqlmap_parse | 解析 sqlmap 输出 → 提取注入点 |
xss_detect | 分析响应中的反射型/存储型 XSS |
jwt_analyze | 解码 JWT,检查 alg:none/弱 HMAC/过期 |
cred_spray | 规划跨所有已发现服务的凭据喷洒 |
scope_check | CIDR/通配符范围验证 |
attack_path_suggest | 在关系图中进行基于成本的路径查找 |
tunnel_manage | 规划 SSH/chisel/ligolo 隧道,跟踪活动会话 |
phase_control | 带质量门禁的阶段管理 |
report_gen | 生成 markdown/JSON 渗透测试报告 |
state_update | 记录发现(30+ 种变更类型,批处理模式) |
state_query | 查询交战状态(20+ 种查询类型) |
19 个精选知识包,按需加载,因此仅在相关时消耗上下文:
技能是纯 markdown。将 SKILL.md 放入技能目录即可添加自己的技能——无需更改代码。
使用斜杠命令驱动实时会话:
| 命令 | 功能 |
|---|---|
/status | 交战仪表盘 — 主机、漏洞、凭据、阶段 |
/targets | 主机与服务表 |
/vulns | 按严重性列出的发现 |
/creds | 已发现的凭据 |
/scope | 查看/编辑目标范围 |
/phase | 阶段管理 |
/mode | 切换 auto / free / guided |
/pause | 发现时暂停(never / always / checkpoint) |
/report | 生成渗透测试报告 |
并设置 agent 获得的自主空间:
模式可与暂停行为组合——auto + pause always 为你提供自主执行,并在每个发现处暂停以供审查。
一个工具包覆盖整个攻击性安全领域:
配置位于 .pentestcode/pentestcode.jsonc:
{
"provider": {
"anthropic": {
"model": "claude-sonnet-4-20250514"
}
}
}
提供商:Anthropic、OpenAI、Google、Azure、AWS Bedrock、Ollama、Together、Groq、Fireworks、DeepSeek、Mistral,以及通过 ai-sdk 接入的更多提供商。
来自真实使用场景的缺陷报告是你所能提供的最有价值的东西。在 CTF 靶机、HTB 机器或经授权的渗透测试中运行 PentestCode,当出现问题时——它陷入循环、遗漏明显路径、无法处理工具输出或浪费 token——请提交 issue,并包含:
findings.md 和/或相关的会话输出功能请求和 PR 同样欢迎。代码库基于 Effect 库的 TypeScript——架构说明见 CLAUDE.md。
本工具仅供经授权的安全测试、教育和研究用途。作者对任何未经授权或非法使用本软件的行为不承担任何责任。用户须自行负责在测试任何系统之前确保已获得适当授权。滥用本工具可能违反适用的法律法规。
MIT——见 LICENSE。
OpenCode 的硬分叉 • 为攻防安全而构建 • 自托管且开源