REA 安装完整指南:两条路径装好 rea 命令,接入 AI 智能体

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.js22.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 命令步骤

这节给你最稳的通用路径,任何平台都适用,两条命令完成。

  1. 全局安装rea-agents包,让rea进入 shell PATH;
  2. 跑验证命令确认命令真的可用。
# 全局安装,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 命令
Binaryrea命令最终落地的路径
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),仅供参考