REA 安装与上手完整指南：从装好到让 AI 智能体直接开工
项目地址: https://gitcode.com/GitHub_Trending/rea2/rea REA（Reverse Engineer Anything）是面向 AI 智能体的逆向工程工具：一条 rea 命令 + 一个 MCP server，把应用行为、Electron/JavaScript 应用、原生二进制都变成智能体可以直接引用的分析证据。本文覆盖从装好 rea 到 rea setup 打通智能体的完整链路，并给出各场景的路线选择和三个最常见的翻车现场。
先看三个最常见的翻车现场
装 REA 的人十有八九会踩下面其中一条，提前知道比装完再排查快得多。
现场一：Linux 上敲 rea 报 command not found。 一键脚本在 Linux 上把可执行文件固定放到 ~/.local/bin，而绝大多数机器的 PATH 里没有这个目录。修复：往 shell 启动文件里加一行 PATH 再重开终端：
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
现场二：npm install rea-agents 执行完了，rea 却还是找不到。 漏了 --global 是可执行文件只落进当前项目的 node_modules/.bin，不会进 PATH——不是没装上，是装错了作用域。
现场三：脚本第一句就报 Node.js x.x.x is unsupported 然后退出。 Node 版本不达标时安装器只会报错，不会替你升级 Node，先换 Node 再重跑。
装前体检：操作系统与 Node.js 版本硬门槛
REA 的安装器对运行环境只做两件事：核对平台、核对 Node.js 版本，任何一项不过直接退出，不做任何"尽力而为"的降级。
- 平台：macOS 与 64 位 Linux 走一键脚本；Windows 走 npm 全局安装。一键脚本遇到 Windows 会直接拒绝安装。
- Node.js 版本：只接受 22.x（≥22.23.4）、24.x（≥24.22.1）、26.12.1+ 三个区间，其他版本一律报 unsupported。
node -v
它会打印当前 Node 版本，你对一下上面的区间即可。不达标就先用 nvm、fnm 或官网安装包切到受支持版本，然后重跑安装流程。
个人开发机怎么装：macOS / Linux 一键脚本
curl -fsSL https://raw.githubusercontent.com/morluto/rea/main/install.sh | bash
它会做四步：核对 Node 版本与平台 → 打印安装计划（版本、运行时、npm 命令、rea 落点）→ 执行一次全局 npm 安装并自读 rea --version 校验 → 在交互终端下自动进入 setup 引导。成功时你会看到 REA <version> is installed. 以及版本自校验通过的输出。Linux 上 rea 固定落在 ~/.local/bin/rea，macOS 跟随 npm 全局前缀，用 npm prefix --global 可查到具体位置。
🧭 常用参数通过 bash -s -- 传入：--version <精确版本号> 锁定版本用于回滚，--dry-run 只打印计划不动文件，--no-setup 装完不进引导，--verbose 输出详细日志。
个人开发机怎么装：Windows npm 全局安装
Windows 上没有一键脚本这条路，直接用 npm 全局安装：
npm install --global rea-agents
装完敲 rea --help 确认命令可用。⚠️ 再提醒一次上面现场二的那个坑：不带 --global 的安装只会把可执行文件写进项目级 node_modules/.bin，PATH 里不会出现 rea。
CI 与无交互环境怎么装
CI 里既没有交互终端，也不该等人点确认。两条路线二选一：
curl -fsSL https://raw.githubusercontent.com/morluto/rea/main/install.sh | bash -s -- --no-prompt --no-setup
它会跳过 setup 引导，装完打印一句提示让你稍后手动执行 rea setup。
或者干脆不装，用 npx 按需拉起最新版：
npx -y rea-agents@latest
💡 最轻路线：如果你只需要给智能体一份"怎么用 REA"的工作流说明书，不注册 MCP 也不装引擎，跑 npx skills add morluto/rea --skill reverse-engineer-anything 即可，只装智能体指令与参考资料。
团队统一版本怎么装
npm install --global rea-agents@6.7.0
显式指定版本号，装完用 rea --version 确认输出一致。⚠️ 注意智能体的 MCP 注册锁在"真正执行 setup 的那个版本"上：先锁版本、装完再跑 setup，注册才会跟在这个版本上；如果后来回滚了版本，记得把 setup 再跑一遍，让注册跟着迁过去。
装完之后跑 setup：智能体才真正调得动
装完你手里只有一个 CLI，智能体还调不动 REA——必须再跑一次初始化：
npx rea-agents setup
setup 干两件事：一是把 REA 的 MCP 注册写进你选中的客户端（Claude Code、Codex、Cursor、Gemini CLI 等二十余种，已有注册默认选中，新检测到的保持未选）；二是处理 Hopper（一款商业反汇编器，REA 用它分析原生二进制），它是独立选项，单独批准才会安装，也可以改为复用你现有的 Hopper 或 Ghidra 安装。
写任何文件之前，setup 会先摆一份精确计划：每个要改的智能体配置路径、涉及的外部软件、网络来源全部列出来。任何一步都可以取消，拒绝即不做任何改动；动过的旧配置自动备份为 .rea.backup，新内容原子替换并校验结果。
下面这张图就是 setup 接通后 REA 实际工作的样子：它在 Hopper 里启动分析桥，自动反汇编 Mach-O 二进制的各段并给出入口点定位。
跑完，重启你配置过的那个智能体，链路才算真正通了。
一条命令验证链路
rea --version && rea doctor
rea --version 证明二进制本身能跑；rea doctor 是严格只读的体检，扫描所有已注册的智能体配置、skill 与分析引擎，只读不改。注意它的总 healthy 可能因为缺某个可选引擎报 false，而你实际要用的工作流照样能跑；想看机器可读报告就加 --json。
报错速查：报错原文 → 为什么 → 一条命令解决
| 报错原文 | 为什么 | 一条命令解决 |
|---|---|---|
rea: command not found | Linux 默认装到 ~/.local/bin，不在 PATH 里 | echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc 后重开终端 |
Node.js x.x.x is unsupported | 当前 Node 不在 22.x（≥22.23.4）、24.x（≥24.22.1）、26.12.1+ 区间，安装器不代升级 | 用 nvm/fnm 切到受支持版本后重跑安装 |
| 智能体调不到 REA | 装的是 CLI，没跑过 setup 注册 MCP | npx rea-agents setup 并重启智能体 |
路线速查卡
| 你的场景 | 用这条命令 | 关键点 |
|---|---|---|
| 个人开发机（macOS / Linux） | 一键脚本（见上文） | 交互式，装完自动进 setup |
| 个人开发机（Windows） | npm install --global rea-agents | 必须带 --global |
| CI / 无终端 / 定时任务 | 脚本加 --no-prompt --no-setup，或 npx 按需拉起 | 全程零交互 |
| 团队锁版本 / 回滚 | npm install --global rea-agents@6.7.0 | 锁完记得重跑 setup 迁移注册 |
| 只要智能体工作流 | npx skills add morluto/rea --skill reverse-engineer-anything | 不注册 MCP、不装引擎 |
下一步做什么
装好、setup 好、rea doctor 通过之后，别再停在"装好了"：挑一个手头真实的目标——一个 Electron 应用、一个可疑的安装包、一个原生二进制——把它扔给已配置好的智能体，开第一单分析。各客户端配置路径与 Hopper 细节见 docs/installation.md，doctor、update、uninstall 的日常用法见 docs/cli.md。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
