Reverse Engineer Anything(REA)安装教程:一步步装好
REA 是一个 MCP 服务器,能让你的 AI 编程助手分析没有源代码的应用和二进制程序。本教程按顺序把完整安装过程走一遍,并说明每一步为什么要做。想要按你的助手和系统生成专属清单,请用 安装向导。
简短版
如果你已经装好了受支持的 Node.js,并且只分析 JavaScript 或 Electron 应用,下面一条命令就够了,然后重启助手:
npx rea-agents setup第 1 步:检查 Node.js
REA 6.8.0 需要 Node.js 22.x(22.23.4 及以上)、24.x(24.22.1 及以上)或 26.12.1 及以上。不支持 Node.js 23、25 和预发布版本。
node -v从 nodejs.org 或你的版本管理工具安装受支持的版本,打开一个新终端,再运行一次 node -v。
REA 使用该 Node.js 自带的 npm,不会替你升级 Node.js。
提示:Linux 上,REA 还需要 PATH 中有兼容 procps 的 ps 命令(安装 procps 或 procps-ng 即可)。详情
第 2 步:运行 setup
一条命令就能把 REA 连接到你选的助手:
npx rea-agents setup它会在每个所选助手的 MCP 配置里加一个 rea 条目;除非你关闭,还会安装 REA 的工作流 skill。
原有设置和其他服务器都会保留,修改前会先备份,你批准之前不会写入任何内容。按 Ctrl-C 不会做任何修改。
完整说明:Review setup changes(英文)。
想跳过选择、直接配置指定的助手,就传入它们在 REA 里的 id,--client 可以写多个:
npx rea-agents setup --client cursor --client codex常见助手的 REA id:
| 助手 | --client 的值 | 教程 |
|---|---|---|
| Claude Code | claude_code | 在 Claude Code 中安装 REA |
| Cursor | cursor | 在 Cursor 中安装 REA |
| Codex | codex | 在 Codex 中安装 REA |
| Claude Desktop | claude_desktop | 在 Claude Desktop 中安装 REA |
| Gemini CLI | gemini_cli | 在 Gemini CLI 中安装 REA |
| VS Code | vscode | — |
| Windsurf | windsurf | — |
更喜欢全局安装(比如要写成脚本,或不想每个助手会话都多一个 npm 启动进程)?先装一次包,用 --dry-run 预览计划,再正式执行:
npm install --global rea-agentsrea setup --client cursor --dry-runrea setup --client cursor第 3 步:添加分析引擎(需要时才装)
接下来要装什么,取决于你要分析什么:
| 分析对象 | REA 需要 |
|---|---|
| JavaScript / Electron 应用 | 不需要额外工具,有 Node.js 和 npm 就够了。 |
| .NET 程序集 | 不需要额外工具(静态分析)。 |
| 安卓 APK | 完整的 JDK 17 及以上和 jadx-headless-mcp 0.7.1 JAR;解码资源文件还需要 Apktool。 |
| 原生程序 | 一个分析引擎:Ghidra(免费)、Hopper 或 IDA(商业)。 |
Ghidra(免费)
下载 Ghidra 12.1.x,并安装 64 位的完整 JDK 21 或更高版本。REA 只连接已有的安装,不会代为安装。
然后在之后要运行 setup 的同一个终端里设置以下变量,setup 才能找到并保存核实过的路径:
export GHIDRA_INSTALL_DIR="/absolute/path/to/ghidra_12.1.4_PUBLIC"
export JAVA_HOME="/absolute/path/to/jdk-21"REA 会按你的 Ghidra 声明的 JDK 版本范围检查。官方验证组合为 Ghidra 12.1.4 + JDK 21。
JDK 必须和 CPU 架构一致:在 Apple 芯片的 Mac 上,通过 Rosetta 运行的 x86_64 JDK 无法通过检查。
更多内容见 REA 的 Ghidra 指南。
在 Windows 上改用 PowerShell 的写法:
$env:GHIDRA_INSTALL_DIR = "C:\path\to\ghidra_12.1.4_PUBLIC"
$env:JAVA_HOME = "C:\path\to\jdk-21"注意:Ghidra 在 Windows 上属于实验性支持,且只能只读分析。Windows 支持范围
Hopper(商业软件)
如果已经装了 Hopper,setup 会直接使用。如果没装,setup 可以提出安装官方 Hopper 安装包,但会先单独征求你的同意。
合法使用:Hopper 是商业软件,有自己的许可协议。免费试用版有厂商设定的限制;请只使用合法取得的授权。
macOS 12 及以上,以及 x86_64 架构的 Linux。见 REA 的 Hopper 指南。
IDA(商业软件)
请自行安装 IDA,然后按照 REA 的 IDA 指南 完成连接。
合法使用:IDA 是商业软件。REA 不提供任何授权或密钥;请只使用合法取得的授权。
安卓 APK:jadx-headless-mcp
分析 APK 需要完整的 JDK 17 或更高版本(含编译器模块),以及 jadx-headless-mcp 0.7.1 这个 JAR 文件(无界面版的 JADX)。REA 不会代为安装。
下载这个 JAR,用 REA 固定的 SHA-256 校验,然后在之后要运行 setup 的终端里把 REA_JADX_MCP_JAR 指向它。如果 PATH 里的 java 不是你想用的 JDK,再设置 JAVA_HOME。以下命令来自 REA 的 Android 指南(英文):
mkdir -p "$HOME/.local/share/rea/android" && cd "$HOME/.local/share/rea/android"
curl -fL -o jadx-headless-mcp-0.7.1-all.jar https://github.com/1013503897/jadx-headless-mcp/releases/download/v0.7.1/jadx-headless-mcp-0.7.1-all.jar
echo '6e5eacf500b64292bfb73c49797c1958f6ee44646e43e868039ae7feb573ff75 jadx-headless-mcp-0.7.1-all.jar' | shasum -a 256 -c -
export REA_JADX_MCP_JAR="$PWD/jadx-headless-mcp-0.7.1-all.jar"如果还要解码资源文件(清单、字符串、多语言),再安装 Apktool 3.0.2 或更高版本;更早的 3.0.x 版本有安全公告。REA 会使用 PATH 里的 apktool,或 REA_APKTOOL_COMMAND 指定的启动程序。见 REA 的 Apktool 指南(英文)。
第 4 步:重启 AI 助手
重启 setup 完成信息里列出的每个助手。正在运行的助手不会自动加载新的服务器。
第 5 步:用 rea doctor 验证
rea doctor 只读取配置,不做修改。不加参数时它会检查找到的所有助手和引擎,所以建议只检查你用到的部分:
| 要检查的 | 命令 |
|---|---|
| 某个助手的注册 | npx rea-agents doctor --client cursor --json |
| 某个分析引擎 | npx rea-agents doctor --provider ghidra --json |
| 已安装的工作流 skill | npx rea-agents doctor --skill --json |
指定范围的报告里会有 scope.mode: "explicit";healthy: true 表示你要求的检查全部通过。
如果某项检查失败,按输出里的修复建议处理。doctor 只检查文件和前置条件,不检查助手的实时连接,所以修复后要重启助手。
更多内容见 Check readiness for your task(英文)。
分析 JavaScript 或 Electron 应用时,也可以跳过 doctor,直接在终端做一次静态分析:
npx -y rea-agents@latest analyze-javascript-application /absolute/path/to/app --json第 6 步:试试第一个提问
把类似下面的话粘贴到你的助手里,并把路径换成你自己的。安全检查、兼容对接、学习等更多模板见 安装向导。
我拥有这个软件,或已获授权对其进行分析。请用 REA 分析位于 /absolute/path/to/app 的 Electron/JavaScript 应用,梳理它的主要模块、IPC 通道,以及我接下来描述的功能背后的代码路径。每个结论都要注明文件、位置和哈希,并列出你无法确认的内容。合法使用:只分析你拥有或已获授权分析的软件。REA 能做什么、不能做什么
更新或卸载 REA
setup 会把助手固定在运行 setup 时的版本,所以更新时要用最新版重新运行一次 setup,再重启助手:
npx rea-agents@latest setup全局安装的,用 rea update 更新命令行工具,它会打印刷新助手配置的 setup 命令。删除 REA 的注册信息和 skill 文件:
npx rea-agents uninstallnpx rea-agents uninstall --purge-data