REA 逆向分析工具安装指南：任意平台三步拿到 rea 命令，接入 AI 智能体
项目地址: https://gitcode.com/GitHub_Trending/rea2/rea REA（Reverse Engineer Anything）是一款开源逆向分析工具：一条 CLI 既能分析 App 行为、JavaScript/Electron 应用，也能处理原生二进制，还可以作为 MCP 服务器把这些能力直接交给 AI 智能体。这篇安装指南带你走最短路径——让 rea 命令在你的终端里可用，并完成 MCP 接入，全程不需要你懂逆向工程。
五分钟跑通：npm 全局安装拿到 rea 命令
跨平台里耗时最短的路径是 npm 全局安装，它也是 Windows 上唯一走得通的路线。把包装进 npm 全局：
npm install --global rea-agents
预期看到 npm 打印安装完成的汇总（形如 added N packages in Xs），rea 可执行文件随后放进 npm 全局 bin 目录，任意目录下输入 rea 都能调起。验证：
rea --version
✅ 打印出版本号（形如 6.8.0），这条路就通了。下面所有内容都建立在 rea 可用的前提上，先拿到结果，细节按需回看。
先确认 Node 版本，再选安装路线
唯一的前置依赖是 Node.js。受支持的范围是 22.x（≥22.19）、24.x（≥24.11）和 26+；23 与 25 两个大版本不在列表里，预发布版也不行：
node -v
输出形如 v24.11.0 即可继续。版本不合时，用 nvm 切一个再重跑：
nvm install 24 && nvm use 24
版本过关后，对照这张表选你的路线：
| 平台 / 目的 | 推荐路线 | 说明 |
|---|---|---|
| Windows | npm 全局安装 | 安装脚本只支持 macOS 和 64 位 Linux，这里只能走 npm |
| macOS | 安装脚本 | 脚本自己解析版本、决定落点，装完顺势带你进 setup |
| 64 位 Linux | 安装脚本 | 二进制固定在 ~/.local/bin/rea，与 npm 前缀无关 |
| 任意平台，只想试一条命令 | npx 免安装 | 不写任何全局文件，跑完即走 |
路线一：npm 全局安装（Windows 用户看这里）
前置条件：Node 版本符合要求，npm 全局 bin 目录在 PATH 中。
版本锁定：包名里不写版本号就装最新；要钉死版本，先查当前发布的最新稳定号，再把 @版本号 写进包名——这是唯一的锁定方式，回滚旧版本同样靠它：
npm view rea-agents dist-tags.latest
npm install --global rea-agents@6.8.0
安装落点：npm 全局 bin 目录。装完敲 rea 却提示命令不存在时，跑 npm config get prefix，确认它对应的 bin 目录在 PATH 里。
验证：rea --version 输出的版本号与你指定的版本一致即成功。
路线二：安装脚本（macOS 与 64 位 Linux）
脚本随仓库发布，先把仓库克隆下来：
git clone https://gitcode.com/GitHub_Trending/rea2/rea
cd rea
安装脚本只读预演
正式装之前先跑一次 dry-run，它负责把「装哪个版本、执行什么 npm 命令、二进制落到哪」交代清楚，全程不改系统：
bash install.sh --dry-run
预期看到以 REA install plan 开头的计划，最后一行是 Dry run complete; no changes made.，即系统未被改动。
确认无误后正式执行：
bash install.sh
装完脚本会自动进入 rea setup（检测到可用终端时）。几个常用开关：
--no-setup：装完不进入 setup，稍后自己配--version 6.8.0 --no-prompt：锁定版本且全程不提问，放进 CI 时用这套--no-prompt单独使用也会跳过 setup
安装落点：Linux 上固定在 ~/.local/bin/rea，不用管 npm 全局前缀；macOS 上落进 npm 全局 bin 目录。
验证：
rea --version
✅ 输出的版本号与脚本计划里的一致即成功。完整参数清单见 安装文档。
路线三：npx 免安装试用
不想落任何东西？npx 会临时拉取包来执行命令，不碰你的全局配置，跑完不留安装痕迹。比如对一个 JS 应用做静态分析，结果以 JSON 直接输出：
npx -y rea-agents@latest analyze-javascript-application /path/to/app --json
把 /path/to/app 换成你的应用目录即可；-y 的作用是预先放行包下载，省掉交互确认。要固定版本，把 @latest 换成具体版本号。预期输出一段结构化 JSON 分析结果，等价于完整走了一次单发分析。
接入智能体：doctor 体检与 setup 配置
装好不等于接好。先做一次严格只读的体检，确认本地运行时和工具链状态：
rea doctor --json
输出是结构化诊断，缺哪一项会直接点名，全程不写任何文件。
真正完成 MCP 接入靠 setup：
rea setup
流程分三步：
- 列出十余种受支持的客户端（Claude Code、Codex、Cursor、Gemini CLI 等）供你多选；
- 展示每一步将改动的精确路径与写入内容，你批准后才会落盘，原有配置自动备份；
- 按完成提示重启对应智能体即可开工。
⚠️ Hopper 是独立选项：它不会随其他选择一起装，必须对它单独给出明确批准，setup 才会执行安装。各客户端配置的落点细节见 CLI 说明。
日常维护记三条命令，均不需要交互：
rea doctor --json # 只读体检，随时可跑
rea update # 升级到新版本
rea uninstall # 移除 REA 自己的注册
排障速查：四个高频安装问题
1. npm 装完了，终端里却敲不出 rea
- 现象：任意目录输入
rea提示 command not found - 根因：安装时漏写
--global，可执行文件只进了当前项目的node_modules/.bin - 处置：补上
--global重装，之后在任意目录都可用
2. 安装时直接报 Node.js 不受支持
- 现象：脚本报错或 npm 校验失败，提示当前 Node 版本不匹配
- 根因：只支持 22.x（≥22.19）、24.x（≥24.11）与 26+，23/25 和预发布版都不行
- 处置：
node -v确认版本，nvm install 24 && nvm use 24切换后重跑
3. Linux 上 rea 装好了，新终端却找不到
- 现象：新终端提示
rea: command not found - 根因：脚本把
rea装进了~/.local/bin，该目录默认不在 PATH 里 - 处置：在 shell 启动文件里加
export PATH="$HOME/.local/bin:$PATH"，重开终端
4. 回退旧版本后，行为对不上
- 现象：重装了指定版本，智能体里的表现却像旧配置
- 根因：MCP 注册固定在当初执行 setup 的版本上，光重装包不会改注册
- 处置：
npm install --global rea-agents@旧版本号重装后，再跑一次rea setup对齐注册
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
