RedTeam Agent 红队模拟代理
把 Claude Code、OpenCode、Codex 变成按侦察→测试→利用→报告流程运行的渗透测试代理。
- Star 数
- ★ 159
- 最近更新
- 3 个月前
- 主语言
- Python
- FA 评分
- 39/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 兼容但需适配Claude CodeCodex · OpenAI API · Claude API（部分支持）
- 费用
- 软件免费，模型调用费用自付
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 安全工程师在授权的 CTF 靶机或实验环境中，用 /autoengage 跑通从侦察到报告的全流程，夜间无人值守执行。
- 不适合
- 需要原生 Windows/PowerShell 运行环境的团队
- 未经书面授权就想扫描真实生产系统的人
- 不愿配置 LLM 提供商和 Docker 工具链的用户
- 源码审查
- 39/100 · 缺口较多
这个 Agent 能做什么，适合哪些场景？
RedTeam Agent 是一个面向授权实验室和 Web 应用渗透测试的自主红队模拟工具，以 Claude Code、OpenCode 和 Codex 三种 CLI 作为运行入口。它由 8 个专职子代理（operator、recon-specialist、source-analyzer、vulnerability-analyst、exploit-developer、fuzzer、osint-analyst、report-writer）组成，按 RECON → COLLECT → TEST → EXPLOIT → REPORT 五阶段推进。测试阶段由 SQLite 支撑的 case 队列驱动（cases.db），mitmproxy、Katana、recon 和 spec 作为生产者写入，dispatcher.sh 按 stage+type 串行派发给消费代理。所有渗透工具都跑在 Docker 容器中（Kali 工具箱、mitmproxy、Katana、OpenCode 可选的 Metasploit RPC），并附带 31 个攻击方法论技能和 79 份参考文件。每次交战产物写入 engagements/<timestamp-target>/，包括 findings.md、report.md、log.md、intel.md、intel-secrets.json、auth.json 以及 surfaces.jsonl 覆盖追踪；支持中断后用 /resume 继续。可选的本地 Orchestrator GUI 提供项目、实时运行、时间线和产物视图。
接收一个目标 URL 后，代理通过 /engage 或 /autoengage 启动五阶段流程：RECON 阶段 recon-specialist 与 source-analyzer 并行收集网络与源码信息并写入 intel.md；COLLECT 阶段把发现的端点导入 SQLite 队列并启动 Katana 爬虫；TEST 阶段由 dispatcher.sh 按 stage 与 case 类型（api、form、graphql、upload、websocket、javascript、page、stylesheet、data、unknown、api-spec 等 15 种）把用例串行派发给 vuln-analyst、source-analyzer、fuzzer 或 exploit-developer，每轮只做一次抓取加一次子代理任务；EXPLOIT 阶段 osint-analyst 依据 intel.md 补充 CVE、泄露、DNS 历史与社交情报，exploit-developer 做利用链和影响分析，operator 通过 intel_changed_check.sh 触发 OSINT 重新关联；REPORT 阶段 report-writer 汇总覆盖率统计与情报摘要生成报告。代理同时把发现、日志、认证材料与高风险面覆盖情况写入 engagements 目录下的多份文件，并用 mitmproxy 代理捕获认证流量。
- 安全工程师在授权的 CTF 靶机或实验环境中，用 /autoengage 跑通从侦察到报告的全流程，夜间无人值守执行。
- 红队成员在拿到 Web 应用测试授权后，用 /engage 先审阅首阶段结果，再逐步放开自动化。
- 需要把 OWASP Top 10、API Security 与 AD/Kerberos 攻击方法固化为可复用流程的团队，通过 31 个技能和 79 份参考文件统一打法。
- 已有 Claude Code 或 OpenCode 工作流的开发者，把一个工作区直接变成带 Docker 化 Kali 工具的渗透测试环境。
- 需要跨多次中断接着打的长期评估，用 /resume 从队列和产物恢复进度。
- 希望用本地 Web UI 查看多个工作区运行状态、时间线与产物的人员，启动 orchestrator/run.sh。
如何安装或部署这个 Agent？
前置条件：Docker（含 Docker Compose）；如不使用 Docker 一体化运行时，至少安装 Claude Code、OpenCode 或 Codex 之一，并准备 curl、jq、sqlite3。原生 Windows/PowerShell 不受支持。
Docker 一体化运行时（推荐）：
bash <(curl -fsSL https://raw.githubusercontent.com/NeoTheCapt/RedteamAgent/v0.1.1/install.sh) docker
# 或：
./install.sh docker ~/redteam-docker按 CLI 安装：
bash <(curl -fsSL https://raw.githubusercontent.com/NeoTheCapt/RedteamAgent/v0.1.1/install.sh) opencode
./install.sh claude ~/my-project
./install.sh codex ~/my-project首次安装后需在 .opencode/opencode.json 中配置模型提供商（支持 Anthropic、OpenAI、Google、Ollama）。安装帮助：
./install.sh -h如何使用这个 Agent？
Docker 运行方式：
cd ~/redteam-docker
./run.sh
/engage http://your-ctf-target:8080
/autoengage http://your-ctf-target:8080OpenCode / Claude Code 运行方式：
cd ~/redteam-agent
opencode
/engage http://your-ctf-target:8080Codex 以自然语言调用命令（不支持斜杠命令）：
engage http://your-ctf-target:8080
autoengage http://your-ctf-target:8080其他常用命令：/resume 继续中断的交战，/status 查看队列与进度，/proxy start 启动 mitmproxy 拦截并登录，/auth cookie "session=abc123" 配置认证，/report 生成报告，/stop 停止后台容器。本地 GUI：
./orchestrator/run.sh
# 默认地址 http://127.0.0.1:18000
./orchestrator/stop.sh这个 Agent 有哪些优点和局限？
- 同一套 OpenCode 源文件在安装时生成 Claude Code 与 Codex 版本（install.sh claude/codex），避免三份提示词漂移。
- TEST 阶段用 SQLite case 队列 + dispatcher.sh 做零 token 的按类型派发，每轮串行一次抓取加一次任务，状态可恢复。
- 渗透工具全部 Docker 化（Kali、mitmproxy、Katana、可选 Metasploit RPC），不污染本机环境。
- 自带的无人值守加固包括自动恢复停滞、权限停滞防护、发现去重与报告自动补全，适合长时间运行。
- 附带 31 个攻击方法论技能与 79 份参考文件（OWASP Top 10:2025、API Security 2023、AD/Kerberos），无需从零编写打法。
- 许可证未标注（unknown），商业或再分发前需要自行确认授权条款。
- 原生 Windows/PowerShell 不受支持，macOS/Linux 之外的团队无法直接使用。
- 必须自带并付费调用 LLM 提供商（Anthropic/OpenAI/Google 等），运行成本取决于模型用量。
- 依赖 Docker、CLI 和配置文件的组合，安装与模型配置步骤比单一命令行工具繁琐。
- 认证、代理和队列环节出问题时需要读日志排查（如 Katana 容器日志、ProviderModelNotFoundError 配置错误）。
这个 Agent 与同类方案有什么区别？
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| RedTeam Agent 红队模拟代理 当前 | 39 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 159 | 3 个月前 | Python | Claude Code |
| RedAmon：自主 AI 红队框架 | 48 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 3.3k | 1 天前 | Python | OpenAI API · Claude API |
| Decepticon 自主红队代理 | 65 · 存在缺口 | 命令行工具免费版 + 付费版 | ★ 6.6k | 2 天前 | Python | OpenAI API · Claude API |
| T3MP3ST 安全测试编排台 | 55 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 6.9k | 2 个月前 | TypeScript | Codex · Claude Code · OpenAI API · Claude API |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
README 显示工具在 Docker 容器内运行、有 scope 检查 hook（Claude 阻断、OpenCode 仅警告），并明确提示 intel-secrets.json/auth.json 属敏感输出、不应随意分享，这是加分项。但 /autoengage 被描述为“零交互、每阶段自动推进、自动使用发现的凭据”，且 OpenCode 侧 scope 仅警告不阻断，属于对授权边界与用户确认的弱化；依赖安全、外部副作用、回滚均无实质证据（无依赖锁定/审计说明、无回滚或清理机制描述），故各项仅给 1。
README 提供故障排查表（Docker 构建、Katana、队列为 0、ProviderModelNotFoundError 等），说明有失败信息意识；但依赖可用性仅靠“重试构建”这类口头说明，无版本锁定或镜像摘要；文档内部存在不一致（仓库名 RedteamAgent 与目录名 RedteamOpencode、安装路径 ~/redteam-agent 与 ~/redteam-docker 混用），故自洽性仅 1。
面向授权实验室/CTF 与 Web 渗透场景，支持 Claude Code/OpenCode/Codex 三种 CLI 与 Docker 一体化运行时，场景与受众描述较清晰（给 2）。但能力边界仅以“仅限授权测试”一句带过，缺少对禁止目标、速率限制、误伤防护的明确界定；触发精度依赖斜杠命令与自然语言混用（Codex 不支持斜杠命令），环境适配明确排除原生 Windows/PowerShell，故其余项给 1。
信息架构清晰（三层目录划分、单源架构、CLI 兼容表），安装说明详尽（多 CLI、Docker、GUI、dry-run），给 2。但许可证一节只有“仅限授权测试”的使用声明，没有实际开源许可证，按元数据 unknown 记 0；版本仅以 v0.1.1 出现在安装 URL 中，无 CHANGELOG；命名稳定性因仓库名/目录名/安装路径不一致而扣分；维护责任未说明（发布者未经验证），示例以命令表为主、缺少 FAQ 深度，均给 1。
输出物定义明确（findings.md、report.md、log.md、intel.md、cases.db 等），并有报告自动合成与去重机制，输出可用性给 2。但边际价值依赖大量外部组件（Docker、Kali 工具链、LLM CLI、可选 Metasploit），成本与收益缺乏量化说明，且“79 参考文件/31 技能/8 代理”等规模宣称无独立佐证，故边际价值与成本收益给 1。
README 对架构、阶段、命令、配置项的描述较具体，部分可追溯到文件路径（如 config.py:17、dispatcher.sh），有一定可追溯性；但关键能力宣称（自主性、覆盖率、自动恢复）均无测试或日志证据，且仅单一 README 来源，无法交叉印证；事实与推断（如“适合长时间无人值守”）混写，未做区分，故三项均给 1。
- /autoengage 被描述为零交互、自动使用发现的凭据并自动推进所有阶段，OpenCode 侧 scope 检查仅警告不阻断，存在越界测试与误伤风险，务必在隔离授权环境中使用。
- 仓库未提供实际开源许可证，仅有一句“仅限授权测试”声明，法律使用条款不明确。
- 发布者身份未经验证，维护责任与更新路径不清晰；仓库名、目录名与安装路径不一致，可能造成安装混淆。
- 依赖安全无锁定或审计说明，Docker/Kali 工具链与 LLM CLI 的供应链风险未评估；无回滚或清理机制描述。
- README 中的规模与自主性宣称缺乏测试或日志佐证，本评估为静态源码审阅，未执行任何运行验证。
常见问题
能否直接对公司生产系统跑 /autoengage？
用哪个 CLI 最省事？
代码和情报会被上传到哪里？
中途被打断怎么办？
支持切换模型吗？
.opencode/opencode.json 的 model 字段即可切换 Anthropic、OpenAI、Google 或 Ollama；GUI 的项目配置里有 Model 标签页可注入 REDTEAM_OPENCODE_MODEL 等环境变量。