REA 逆向工具安装指南：10 分钟装好 CLI，把分析能力接进 AI 智能体

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

拿到一个陌生的 Electron 应用，不知道它加载了哪些 JavaScript、调用了哪些原生模块？这是 REA 逆向工具要解决的问题：一条 CLI 加一个本地 MCP server（智能体调用外部工具的协议），分析从应用行为覆盖到原生二进制。装完终端里多一条 rea 命令，再花几分钟跑一次配置引导，Claude Code、Cursor 这类智能体就能直接调用它的逆向分析能力。

上图是 rea 驱动 Hopper 做原生分析的实际会话：左侧反汇编与程序段信息，右侧地址、导航与编码状态，分析结果以结构化形式交给智能体。

先想清楚：三种用法，对应三条安装路线

这节先做决策再动手，确定你该走哪条路线，装完不返工。

• 用法一：只在命令行跑分析。结论：全局安装，拿到可长期复用的rea命令。
• 用法二：让 AI 智能体调用分析能力。结论：全局安装，再跑一次 setup，把本地 MCP 服务登记进智能体配置。
• 用法三：CI 或脚本里自动化执行。结论：用npx -y rea-agents@latest按需拉起，不依赖全局安装，命令行可复现。

按系统选安装路线

按你的系统选路线。每个平台只交代三件事：安装命令、验证方式、可执行文件落点。

Windows：npm 全局安装

Windows 只有 npm 这一条路，仓库的 curl 安装脚本只支持 macOS 与 64 位 Linux：

npm install --global rea-agents rea --help

第一条安装，第二条验证rea是否进了 PATH。落点是 npm 全局前缀的 bin 目录，可用npm prefix --global查看。npm 若弹出"是否下载并运行"，那次同意只覆盖包下载；setup 之后动智能体配置或装 Hopper 时会另起批准，互不牵连。

macOS：curl 脚本或 npm 任选

curl -fsSL https://raw.githubusercontent.com/morluto/rea/main/install.sh | bash

脚本先检查 Node 版本与平台，再打印安装计划（哪个版本、哪个运行时、哪条 npm 命令、rea 落在哪），确认后开始装。终端可用时自动进入 setup，不可用则打印提示让你稍后手动跑。落点跟随 npm 全局前缀，装完找不到rea先确认该 bin 目录在 PATH；偏好 npm 路线就直接npm install --global rea-agents。

Linux：curl 脚本，落点固定

64 位 Linux 推荐走脚本，建议先带--dry-run探路，只打印计划、不动系统：

curl -fsSL https://raw.githubusercontent.com/morluto/rea/main/install.sh | bash -s -- --dry-run

确认计划没问题，去掉参数再跑一次正式安装。二进制固定在~/.local/bin/rea（npm 前缀固定在~/.local），后续 PATH 排障都围绕这个目录；验证仍是一条rea --help。

运行时要求与常用参数集中在这里，一次看完：

• 受支持的 Node.js：22.x（≥22.23.4）、24.x（≥24.22.1）、26.12.1+；23、25 与预发布版不支持。安装器不替你升级 Node 或 npm，版本不达标直接报错。
• --version <精确版本号>：锁定版本，必须是不带 build 元数据的完整 semver（语义化版本号），回滚靠它。
• --dry-run：只打印安装计划，不写任何东西。
• --no-setup/--no-prompt：装完不自动进 setup，CI 无交互环境用；两者都不授予安装外部依赖的权限。
• --verbose：打开详细日志，排查安装问题。
• npm 侧锁版本：npm install --global rea-agents@<版本号>。
• 审批行为记牢：npm 的包下载批准与 REA 的 setup 批准是两回事；智能体的 MCP 注册锁定在真正执行 setup 的版本上，回滚后要重跑 setup。

接入 AI 智能体：配置引导，每一步先审批

装完你手上只有 CLI，要接上智能体还得跑一次配置引导：

npx rea-agents setup

全程四步，每一步都在你批准之后才动文件：

1. 多选要配置的智能体，Claude Code、Codex、Cursor、Gemini CLI 等 24 种可选，已有的 REA 注册默认选中；
2. 生成精确修改计划：每个配置路径、涉及的外部软件与网络来源都列出来，你批准后才写文件；
3. Hopper 是独立选项，单独批准才会安装；也可以只登记已有的 Ghidra 路径；
4. 按完成提示重启对应智能体。

备份机制可以放心：写入前自动把旧配置备份为.rea.backup，替换是原子的并会校验写入结果；如果旧快照与当前配置不一致，会另存一份哈希命名的.rea.backup.<sha256>.recovery恢复副本，而不是覆盖已有快照。

不想动任何文件、只想体检，用这条只读诊断命令，输出完整健康检查与工具目录状态，不产生写入：

rea doctor --json

还有一条更轻的路：只想给智能体一份"怎么用"的说明、不装分析引擎：

npx skills add morluto/rea --skill reverse-engineer-anything

它只装使用说明与引用文件，不做 MCP 注册。各客户端配置路径细节见客户端配置文档，安装与审批全流程见安装文档，日常命令用法见CLI 命令参考。

装不上？四类高频故障：现象 → 原因 → 处理

⚠️ 装完之后卡住，基本逃不出下面四种。

故障一

现象：终端报rea: command not found。

原因：curl 路线在 Linux 上把二进制放进~/.local/bin，该目录通常不在默认 PATH；macOS 则是 npm 前缀 bin 目录没进 PATH。

处理：echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc（zsh 用户改写~/.zshrc），重开终端；macOS 先确认npm prefix --global对应的 bin 目录已在 PATH。

故障二

现象：安装器报 Node.js 版本不支持。

原因：当前 Node 不在 22.23.4+ / 24.22.1+ / 26.12.1+ 区间，常见的是 23、25 或过老版本。

处理：node -v确认实际版本，用 nvm（nvm install 24 && nvm use 24）或 fnm 切到受支持版本，重跑安装。

故障三

现象：npm install rea-agents跑完却找不到 rea。

原因：漏了--global，可执行文件只落在当前项目的node_modules/.bin，PATH 看不到它。

处理：补跑npm install --global rea-agents；临时用就npx -y rea-agents@latest按需拉起。

故障四

现象：回滚版本后，智能体的分析行为和新版本对不上。

原因：MCP 注册锁定在当初执行 setup 的版本上，回滚只换了包，注册没跟着变。

处理：用回滚后的版本重跑一次 setup，让注册指向当前版本，再重启智能体。

装完自查：照清单逐项过

✅ 全部步骤走完后逐项打勾，任何一项不通过就回到对应章节补。

• rea --help与rea --version正常输出，版本与预期一致
• 跑通第一条分析命令，如rea analyze-javascript-application /path/to/app --json，返回带证据的结构化 JSON
• rea doctor --json无阻断性错误，你任务所需的引擎状态明确
• 目标智能体配置里已出现 REA 注册（setup 完成消息会列出修改的路径）
• 对应智能体已重启，新会话能调用分析工具
• 配置目录里存在.rea.backup备份，说明备份机制已生效

别停在自查这一步：直接派一个真实目标给智能体，例如让 Claude Code 分析本机某个 Electron 应用的 JavaScript、列出它调用了哪些原生模块。装、接、首任务一条链路跑完，工具就算真正落地了。

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