REA 逆向分析工具安装指南：如何装好 rea 并把它接入 AI 智能体

REA 逆向分析工具安装指南：如何装好 rea 并把它接入 AI 智能体

【免费下载链接】reaReverse engineer anything with agents, from app behavior down to native binaries.项目地址: https://gitcode.com/GitHub_Trending/rea2/rea

这是一份面向新手的 REA（rea-agents）逆向分析工具安装与 AI 智能体接入指南。全文按“体检 → 安装 → 接入 → 首次分析 → 排错 → 附录”的顺序展开，你只需要跟着自己的平台走对应的命令，就能让 Claude Code、Codex 这类 AI 智能体具备二进制与应用分析能力。

REA 能帮你做什么：从应用行为到原生二进制

REA 是一个开源的逆向分析 CLI 加 MCP 服务器：你用一条rea命令发起分析，它把结论连同证据一起交给 AI 智能体，由智能体基于证据回答你，而不是凭空猜测。它覆盖的场景包括 JavaScript/Electron 应用的静态分析、用 Hopper/Ghidra/IDA 等引擎分析原生二进制，以及 Android、固件、Web 产物等更深的目标。换句话说，你负责提出问题和喂目标文件，重复的取证工作交给它。

开工前的环境体检：平台、Node 版本与交互方式自查

🩺 动手之前先花一分钟做三项自查。REA 安装过程会反复用到这三项信息，提前确认可以避免装到一半才报错。

• 平台：你的系统是 macOS，或是 64 位 Linux。安装脚本只在这两个平台运行；Windows 走 npm 路线。
• Node.js 版本：必须是 22.x（≥22.23.4）、24.x（≥24.22.1）或 26.12.1 及以上（更新的大版本也可以）。23、25 和各类预发布版都不支持。
• 交互环境：本地带终端的机器可以走完整交互流程；CI、脚本或容器这类无交互环境，要么加--no-prompt --no-setup，要么干脆不装、用npx按需拉起。

用一条命令核对前两项：

uname -s && node -v

之所以这样写：uname -s和node -v正是安装脚本内部判断平台与 Node 版本时读取的两个值，你这里看到的结果就是脚本将看到的结果。Darwin对应 macOS，Linux对应 Linux；Node 版本号对照上面的区间即可。

按平台挑一条安装路线

🧭 三条路线互不冲突，选和你平台匹配的那条执行即可。

macOS / Linux：REA macOS 与 Linux 安装（克隆仓库 + 安装脚本）

git clone https://gitcode.com/GitHub_Trending/rea2/rea bash rea/install.sh --dry-run bash rea/install.sh

之所以这样写：先克隆仓库再在本地跑install.sh，参数可以直接跟在脚本后面传，不用经过管道。第一条--dry-run只打印安装计划（装哪个版本、用哪条 npm 命令、rea落在哪个路径）而不写任何文件，探完路再执行第三条真装。装完后，Linux 上rea固定在~/.local/bin/rea，macOS 上跟随你的 npm 全局前缀。脚本会先核对 Node 版本与平台，不达标会直接告诉缺什么，然后打印安装计划；终端可用时它会自动进入 setup 引导，终端不可用时会提示你稍后手动执行rea setup。

Windows：rea Windows 安装（npm 全局安装）

Windows 上没有安装脚本，唯一通道是 npm 全局安装：

npm install --global rea-agents rea --version

之所以这样写：rea-agents 这个包同时注册了rea和rea-agents两个命令入口，装完直接敲rea --version输出版本号，就能确认命令已就位。注意--global不能省，本地安装的命令只会落在node_modules/.bin里，PATH 中找不到。

CI 与无交互环境：rea CI 安装（npx 按需拉起）

流水线里最省事的做法是不安装、按次运行：

npx -y rea-agents@latest analyze-javascript-application /absolute/path/to/app --json

之所以这样写：npx -y会自动拉取最新已发布版本且跳过确认提示，适合无人值守执行；分析结果以 JSON 直接写到 stdout，方便被后续步骤消费。如果你的 CI 仍希望装一个全局版本，就把 macOS/Linux 路线的脚本加上--no-prompt --no-setup再执行，它会跳过一切交互，但 Node 等外部依赖仍需你自己在镜像里备好。

把 REA 接入 AI 工作流：rea 接入 Claude Code、Codex 等客户端

装完只有一个 CLI，智能体还调不动它，需要再跑一次 setup 把 MCP 接入注册进你的客户端：

npx rea-agents setup

之所以这样写：npx rea-agents在你没有全局安装时也能完成接入，已全局安装的话直接敲rea setup效果相同。setup 的流程是：先以多选列出支持的客户端（Claude Code、Codex、Cursor 等二十余种），已存在的 REA 注册默认选中；然后给你一份精确计划——每个要改的配置路径、涉及的外部软件、网络来源都列清楚，你批准之后它才动手。动文件之前，旧配置会先备份为.rea.backup，之后原子替换并回读校验；任何一步取消，配置保持零改动。Hopper 是独立选项，需要单独批准才会安装，你也可以选择复用已有的 Hopper 或 Ghidra。

接完之后用只读诊断验证一遍：

rea doctor --json

之所以这样写：rea doctor --json是严格只读的健康检查，只查配置与环境、绝不修改任何文件，输出是机器可读的 JSON，适合在接入后立刻核对各客户端与引擎的注册状态。最后，重启你配置过的那个智能体，新注册才会在会话中生效。

第一次分析：跟着跑一遍

🧪 用一个小目标验证整条链路。最通用的入口是rea analyze，对目录或.asar文件它会自动选中 JavaScript 分析路线：

rea analyze /absolute/path/to/app --json

之所以这样写：--json让结果成为一份可直接被脚本或智能体消费的 JSON 文档。预期输出是一份包含应用图与 Evidence（证据）的完整文档；对真实应用来说它可能非常大，因此官方建议把结果落到文件再投影视图，而不是直接刷屏：

rea analyze-javascript-application /absolute/path/to/app --json > app-evidence.json

然后把大文件投成摘要视图查看，官方文档里一个 334 MB 的 Evidence 文件投出来的 summary 视图只有约 10 KB。看到合法的 JSON 视图输出，说明从安装到分析全链路已经通了。

出状况时的排查路径

出问题时，先对照下面五种最常见的情况，每条都按现象、原因、解法拆开说。

1. 终端提示rea: command not found

• 现象：安装成功，但敲rea说找不到命令。
• 原因：rea的可执行文件不在当前 shell 的 PATH 里。Linux 上它固定在~/.local/bin，macOS 上在你的 npm 全局前缀的 bin 目录，这两处默认都不一定在 PATH 中。
• 解法：把对应目录加进 PATH，然后重开终端再试。

2. 安装脚本提示Node.js <版本> is unsupported

• 现象：安装一开始就失败，明确报出当前 Node 版本不受支持。
• 原因：你用的是 23、25、预发布版，或低于下限的老版本（22.x 需 ≥22.23.4，24.x 需 ≥24.22.1，或 26.12.1 及以上）。
• 解法：用 nvm 或 fnm 切到受支持的版本再重跑安装。安装器不会替你升级 Node，它只负责报缺什么。

3. npm 装完却“没有 rea 命令”

• 现象：执行了npm install rea-agents，但 PATH 里找不到rea。
• 原因：漏了--global。本地安装只会把命令放进项目内的node_modules/.bin。
• 解法：加--global重装；或者不装全局，改用npx -y rea-agents@latest按需运行。

4. bash 在脚本末尾报语法错误，脚本拒绝执行

• 现象：跑install.sh时 bash 报语法错误，整段脚本什么都没执行。
• 原因：这是脚本自带的截断防护。脚本首尾用花括号把全文包成一个复合命令，下载被截断时 bash 会在 EOF 处报语法错误并直接停住，避免执行半份脚本。
• 解法：重新拉取一份完整脚本再执行。能正常跑完就说明文件是完整的，这条报错本身就是保护在起作用。

5. 回滚或升级 REA 版本后，智能体调不动它

• 现象：换了版本，CLI 自己能跑，但客户端里的 REA 工具不响应或报身份错误。
• 原因：setup 写入的 MCP 注册锁定在执行 setup 那一刻的 REA 版本，换版本后注册指向的启动器与新安装对不上。
• 解法：重跑rea setup，让注册跟着当前版本迁移，再重启智能体。

附录：命令、参数与资料

安装脚本参数（install.sh）

注意：--no-prompt只是不问你问题，并不代表脚本有权替你装外部依赖，Node.js 该准备的还是得自己备好。

常用命令

场景速查

进一步资料

• 完整安装与 setup 细节：installation.md
• CLI 与 Evidence 契约：cli.md
• 各客户端配置路径详解：client-configuration.md
• JavaScript 应用工作流与视图：javascript-application-workflows.md

【免费下载链接】reaReverse engineer anything with agents, from app behavior down to native binaries.项目地址: https://gitcode.com/GitHub_Trending/rea2/rea