1. 项目定位与用途
red-run 是一个面向 Claude Code 的进攻性安全评估工具包，旨在将 AI 助手转化为结构化的渗透测试平台。它通过智能编排器、持久化队友、MCP 服务器和可扩展技能库，系统性地引导安全评估全流程，包括侦察、初始访问、横向移动、权限提升和后访问阶段。项目核心价值在于提供一种可重复、状态持久化的 AI 辅助评估方法，使安全专业人员能够高效、规范地执行复杂评估任务。
项目档案应用项目
red-run 安全评估工具包：Claude Code 渗透测试平台，含 CTF/红队模式、安装与使用指南
blacklanternsecurity/red-run：red-run 是一个专为 Claude Code 设计的进攻性安全评估工具包，通过智能编排、持久化队友和语义技能路由，将 AI 助手系统性地应本页整理它解决什么问题、适用场景、安装方式和使用方法。
AI 总结
red-run 是一个专为 Claude Code 设计的进攻性安全评估工具包，通过智能编排、持久化队友和语义技能路由，将 AI 助手系统性地应用于侦察、初始访问、横向移动、权限提升等安全评估全流程，显著提升评估效率与结构化程度。
中文项目介绍
red-run 是一个面向 Claude Code 的进攻性安全评估工具包，旨在将 AI 助手转化为结构化的渗透测试平台。它通过智能编排器、持久化队友、MCP 服务器和可扩展技能库，系统性地引导安全评估全流程，包括侦察、初始访问、横向移动、权限提升和后访问阶段。
项目核心解决如何将 AI 代理有效应用于复杂安全评估的问题：通过 SQLite 数据库 engagement/state.db 持久化参与状态，确保跨上下文压缩的连续性；通过语义搜索（RAG）自动检索和路由技能；通过持久化域队友累积上下文，避免重复工作；并提供多种操作模式以适应不同场景约束。
适用场景涵盖 CTF 竞赛和实验室环境（/red-run-ctf 全自动模式）、传统红队演练（/red-run-legacy 子代理模式）、计划中的 DLP 受限环境（/red-run-notouch 模式，操作员手动执行）以及安全评估培训（/red-run-train 模式，逐步引导学习）。所有模式共享同一状态数据库，支持模式间切换。
技术特征上，red-run 采用平台层与策略层分离的双层架构：平台层提供队友、技能、MCP 服务器、状态管理和仪表板等稳定组件；策略层通过可插拔编排器决策。teammate 分为枚举（发现）和操作（执行）两类，以及基础设施（state-mgr）和按需类型，通过消息通信。提示分层设计确保域限定。技能库当前索引 67+ 技术方法论，支持语义检索。可选集成 Sliver C2，并通过 tmux 窗格提供实时监控与交互。
详细信息与使用说明
2. 解决的问题
red-run 解决了传统安全评估中 AI 助手难以有效处理多阶段、上下文依赖复杂任务的问题。具体包括：1) 状态跨上下文压缩持久化，确保评估连续性；2) 技能自动检索与路由，通过语义搜索（RAG）匹配合适技术；3) 任务委托给持久化域队友，累积上下文避免重复工作；4) 提供多种操作模式（全自动 CTF、遗留子代理、DLP 安全、培训引导）以适应不同需求和约束。这些机制共同实现了 AI 在安全评估中的结构化、可追踪应用。
3. 适用场景
red-run 设计用于多种安全评估场景：CTF 竞赛和实验室环境（/red-run-ctf 模式，采用全自动 agent 团队）；传统红队演练（/red-run-legacy 模式，基于临时子代理）；数据丢失防护（DLP）受限环境（/red-run-notouch 模式，计划中，操作员在独立 tmux 窗格手动执行并报告 sanitized 输出）；安全评估方法论培训（/red-run-train 模式，计划中，提供逐步引导和解释）。所有场景共享同一 engagement/state.db 状态数据库，支持评估状态跨模式保存和恢复，便于灵活切换评估策略。
4. 安装方式
安装 red-run 需满足前置条件：Linux 虚拟机配备常用渗透测试工具（如 nmap、ffuf、sqlmap、hashcat、impacket 等）、Claude Code、uv 包管理器、Docker（可选，用于 C2 集成如 Sliver）。执行 ./install.sh 进行符号链接安装（开发环境，编辑即时生效）或 ./install.sh --copy 进行复制安装（独立机器）。随后运行 bash preflight.sh 验证攻击工具包依赖。可选运行 bash config.sh 配置 C2 后端（如 Sliver），生成 engagement/config.yaml 并修补 .mcp.json。最后 ./run.sh 启动 shell-server 或 C2 服务。卸载使用 ./uninstall.sh。详细步骤见安装文档。
5. 使用方式
操作员通过输入 /red-run-ctf 或 /red-run-legacy 等命令触发对应编排器。编排器展示当前评估面、攻击链分析和可用路径，操作员选择下一步测试目标。队友在独立 tmux 窗格中执行技能，操作员可实时监控、按 Escape 中断或直接输入重定向任务。teammate 通过消息与 state-mgr 队友通信记录发现，并累积上下文跨任务。所有编排器共享 engagement/state.db 状态文件，支持评估状态跨模式保存和恢复，实现无缝工作流切换。
6. 实现特点
red-run 采用平台层与策略层分离的双层架构。平台层提供持久化队友、技能库、MCP 服务器、状态管理和仪表板等稳定组件；策略层通过可插拔编排器（CTF/客户端/红队/训练模式）决策技能路由与任务分配。teammate 模型分枚举（发现）与操作（执行）两类，以及基础设施（state-mgr）和按需类型，通过消息通信。提示分层：项目层（CLAUDE.md）定规则，teammate 层限域，skill 层供方法论，动态层传上下文。技能基于语义搜索（RAG）从 ChromaDB 索引自动检索，当前包含 67+ 技术方法论。支持可选 Sliver C2 集成，提供更丰富的命令与控制能力。
思维导图
red-run
Orchestrators
/red-run-ctf (Active)
/red-run-legacy (Legacy)
/red-run-notouch (Planned)
/red-run-train (Planned)
Teammates
Infrastructure
Enumeration
Operations
On-demand
MCP Servers
nmap
shell
browser
state
skill-router
Skills
ad (e.g., credential-dumping)
credential (password-spraying)
network
evasion
ctf
... (67+ total)
State Management
SQLite: engagement/state.db
10 tables
state-mgr sole writer
Skill Router
Semantic search (RAG)
ChromaDB index
C2 Integration
Sliver (optional)
Custom MCP servers
常见问题
red-run 的主要用途是什么？
red-run 旨在将 Claude Code 转化为一个结构化的渗透测试平台，通过编排器、持久化队友和技能库，系统性地执行安全评估的各个阶段（侦察、初始访问、横向移动、权限提升、后访问），适用于 CTF、红队演练等场景，提供可重复、状态持久化的 AI 辅助评估方法。
如何安装和配置 red-run？
安装需 Linux VM 配备渗透测试工具（nmap、ffuf 等）、Claude Code、uv 和 Docker；运行 ./install.sh 进行符号链接或复制安装；执行 bash preflight.sh 验证依赖；可选 bash config.sh 配置 C2（如 Sliver）；最后 ./run.sh 启动服务。详细步骤见安装文档。
red-run 有哪些运行模式？
red-run 提供多种编排器：/red-run-ctf 用于 CTF 和实验室（全自动 agent 团队）；/red-run-legacy 为遗留子代理模式（临时代理）；/red-run-notouch（计划中）用于 DLP 安全模式（操作员手动执行）；/red-run-train（计划中）用于培训引导。所有模式共享同一状态数据库。
red-run 如何管理评估状态？
red-run 使用 SQLite 数据库 engagement/state.db 持久化参与状态，包括目标、凭证、访问、漏洞和路径等。state-mgr 队友作为唯一写入者集中管理状态，确保跨上下文压缩和跨编排器的状态一致性，支持评估过程的可追踪和可恢复。
如何扩展 red-run 的技能库？
red-run 的技能库位于 skills/ 目录，按类别（如 ad、credential、network）组织。开发者可参考 docs/writing-skills.md 贡献指南创建新技能，每个技能包含 SKILL.md 文件描述方法论。技能通过语义搜索（RAG）自动索引和路由，当前已包含 67+ 技术方法论。