REA 安装完整指南：两条路径装好 rea 命令，接入 AI 智能体
【免费下载链接】reaReverse engineer anything with agents, from app behavior down to native binaries.项目地址: https://gitcode.com/GitHub_Trending/rea2/rea
REA 是一个开源 MCP 项目，把 AI 智能体接到本地分析引擎上，逆向分析原生二进制、JavaScript/Electron 应用等目标，结论附带证据。本文只需你具备 Node.js 环境，约 10 分钟，就能拿到可用的rea命令和智能体接入方法。
动手前自检：Node 版本与平台前提
这节解决"能不能装"的问题，先确认环境能省掉大部分排错。
| 项目 | 要求 | 说明 |
|---|---|---|
| Node.js | 22.x（≥22.19）、24.x（≥24.11）或 26+ | Node 23、25 及预发布版不受支持 |
| npm | 随 Node.js 自带 | 安装器不会替你升级 Node 或 npm |
| 操作系统 | macOS / 64 位 Linux（curl 脚本）；任意支持 Node 的平台含 Windows（npm 方式） | curl 脚本自行校验平台 |
用node -v查当前版本。版本不合规时，安装器会直接报 "unsupported" 并给出切换方法——照提示用 nvm 或 fnm 切到受支持的版本重试即可，不用自己猜原因。
主路径：npm 全局安装 rea 命令步骤
这节给你最稳的通用路径，任何平台都适用，两条命令完成。
- 全局安装
rea-agents包，让rea进入 shell PATH； - 跑验证命令确认命令真的可用。
# 全局安装，rea 命令进入 shell PATH npm install --global rea-agents # 验证安装成功 rea --help第一条把包装进 npm 全局前缀，第二条在终端里确认可执行文件能被解析到。
⚠️ 高频坑：装完终端里找不到命令，多半是第一步漏了
--global。此时可执行文件只落在当前项目的node_modules/.bin里，shell 根本找不到它；补上--global重装一次就解决。
简单说：全局标志别漏，主路径半分钟就走完。
备选路径：curl 一行安装脚本与 npx 免安装运行
这节覆盖另外两个入口：macOS / Linux 的一行 curl 脚本，和只跑单条命令的npx。
curl 一行脚本（macOS / Linux）
# 一行执行官方安装脚本，先打印安装计划再动手 curl -fsSL https://raw.githubusercontent.com/morluto/rea/main/install.sh | bash它本质是替你装好"全局 npm 包"，再顺路引导配置。执行时先打印一份安装计划：
| 计划字段 | 含义 |
|---|---|
Version | 将安装的 REA 版本号 |
Runtime | 当前检测到的 Node.js 版本 |
Command | 实际执行的 npm 命令 |
Binary | rea命令最终落地的路径 |
Setup | 是否安装后自动启动rea setup |
装完后若当前有可用终端，会自动进入rea setup引导流程，否则只提示你稍后手动运行。
选项用bash -s --追加，例如bash -s -- --dry-run：
| 参数 | 作用 | 典型场景 |
|---|---|---|
--version <semver> | 锁定精确版本 | 回滚、团队版本对齐 |
--dry-run | 只打印计划，零修改 | 装前先预演会做什么 |
--no-setup/--no-prompt | 装完不进 setup、跳过交互 | CI、无头环境 |
--verbose | 打印详细执行日志 | 排安装故障 |
落点有平台差异：Linux 的 prefix 固定为~/.local，rea落在~/.local/bin/rea；macOS 跟随 npm 全局前缀。
npx 免安装跑单条命令
只想对某个 JS 应用做一次静态分析，不用安装：
# 免安装跑最新版，--json 输出完整 Evidence 记录 npx -y rea-agents@latest analyze-javascript-application /absolute/path/to/app --json💡 npm 问"是否下载并运行"时，那次确认只授权下载包本身；REA 自己的
setup会做的改动（改智能体配置、装 Hopper）会在之后单独展示、单独请求批准，两者不是一回事。另外--no-prompt与非交互模式都不会授权任何外部依赖，装 Hopper 仍需显式批准。
简单说：图省事用 curl，只要一条命令用 npx，谁也不会替你偷偷改配置。
按场景快速选型：该选哪种安装方式
这节直接给结论，不用你再翻表格：
- 如果你是 macOS / Linux 用户想最快跑起来 → curl 一行脚本；
- 如果你在 Windows 上（curl 脚本不支持）→ npm 全局安装；
- 如果你在 CI / 无交互环境 → curl 加
--no-setup，或干脆npx免安装； - 如果你需要锁版本或回滚 → curl 加
--version <semver>，或 npm 指定rea-agents@x.y.z； - 如果你想先预演再决定 →
--dry-run只读模式看一眼计划。
一句话收束：凡是能跑 Node 的环境，npm 全局都能兜底；Mac / Linux 想省事就一行流。
装完先跑通：rea setup 智能体接入与 doctor 体检
装完的只是 CLI 本体，这节解决"让 AI 真正用上"的问题。
先跑一次引导式配置：
# 引导式配置，把智能体接入 REA npx rea-agents setup流程分四步：多选要接入的智能体（Claude Code、Codex、Cursor、Gemini CLI 等十余种客户端，现有注册默认选中）；审阅精确计划——改哪些配置路径、装哪些外部软件、走哪些网络来源，批准后才写入文件，且自动备份原配置；Hopper 是独立可选项，需单独明确批准才安装/连接，不影响其余步骤；按完成提示重启对应客户端即可开工。
再用只读命令体检：
# 严格只读体检，不做任何修改 rea doctor --json要升级或卸载，分别用rea update和rea uninstall（加--purge-data连~/.rea下的缓存状态一起清）。逐项细节看 官方安装文档 与 CLI 参考。
💡 只想要工作流说明、不装分析引擎？走 skill-only 路径，只装
reverse-engineer-anything技能说明：
# 只装技能说明，不装分析引擎 npx skills add morluto/rea --skill reverse-engineer-anything技能内容见 SKILL.md。
简单说：setup 就是"通电"这一步，批准计划、重启客户端后，智能体就能派它干第一个逆向分析的活了。
排障速查：常见安装问题与一句话解法
这节把装完最常见的四种现象收进一张表，按现象直接查：
| 现象 | 可能原因 | 一句话解法 |
|---|---|---|
| 安装时报 Node.js 版本不支持 | 版本不在 22.19+ / 24.11+ / 26+ 范围（23、25 及预发布版不受支持） | 用 nvm 等切换到受支持版本后重试 |
curl 装完提示rea: command not found | ~/.local/bin不在PATH里 | 把它加进 shell 启动配置，重开终端 |
| 需要锁版本或回滚 | MCP 注册固定在实际执行 setup 的那个版本 | --version 6.4.0或装rea-agents@6.4.0，回滚后重跑一次 setup 对齐注册 |
| 智能体里看不到工具 | 体检项失败，或客户端未重启 | 先跑rea doctor --json按失败项修复；会话缺工具多半是没重启，重启或重连客户端 |
收尾
挑一条路径把rea装进终端，现在就去跑rea --help验证，然后接着执行rea setup完成接入。
【免费下载链接】reaReverse engineer anything with agents, from app behavior down to native binaries.项目地址: https://gitcode.com/GitHub_Trending/rea2/rea
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
