4 步装好 rea-agents：终端逆向分析工具，从试跑到接入 AI 智能体-平芜编程栈

4 步装好 rea-agents：终端逆向分析工具，从试跑到接入 AI 智能体

【免费下载链接】reaReverse engineer anything with agents, from app behavior down to native binaries.项目地址: https://gitcode.com/GitHub_Trending/rea2/rea

本文把 rea 安装的完整路径拆成四步：零安装试跑、分平台安装、接入 AI 智能体、排障收口。rea（npm 包名 rea-agents）是一款逆向分析命令行工具，把 App 运行时行为、JavaScript/Electron 应用、原生二进制这三类目标统一放进终端里分析。你可以自己敲命令，也可以以 MCP（Model Context Protocol，一种让 AI 智能体调用外部工具的标准协议）服务器形式把它接给智能体使用。

先试再装：用 npx 完成 60 秒零安装静态分析

还没准备好环境时，可以先验证工具效果再决定要不要长期用。npx 会临时拉取包并直接执行，不会把工具留在本机：

npx -y rea-agents@latest \ analyze-javascript-application /path/to/app --json

把/path/to/app换成实际的应用目录路径。这里逐字解释一下参数：-y只授权自动下载包，不会改动本机任何配置；--json让分析结果以 JSON 格式输出，方便管道处理或肉眼核对。

执行后应看到：终端打印一份 JSON 分析文档。路径不存在或目录不是 JS 应用时，会收到报错提示且没有 JSON 产出。确认效果符合预期后，再进入正式安装。

分平台安装命令：macOS、Linux、Windows 各一条

三条路线都只有一个前置动作：先确认 Node 版本。

node -v

受支持的范围是 22.x（≥22.19）、24.x（≥24.11）和 26+；23、25 以及任何预发布版都不在支持之列。这个约束与项目package.json的engines字段保持一致，装前核对一遍能省掉大部分环境问题。

macOS 与 64 位 Linux：一条 curl 命令走安装脚本

curl -fsSL https://raw.githubusercontent.com/morluto/rea/main/install.sh | bash

为什么推荐脚本而不是裸跑 npm：执行前它会先打印一份安装计划，包含版本号、当前 Node 运行时、实际执行的 npm 命令，以及rea二进制最终落盘的路径。在 Linux 上这个路径是~/.local/bin/rea。确认计划无误后才会真正写入。

如果只想看计划、不落盘，追加--dry-run做一次只读预演：

curl -fsSL https://raw.githubusercontent.com/morluto/rea/main/install.sh | bash -s -- --dry-run

执行后应看到：同样的计划输出，末尾跟一句 "Dry run complete; no changes made."，然后退出，本机无任何改动。

正式安装跑完 npm 步骤后，脚本会自动进入rea setup流程（下一节展开）。各平台的 PATH 细节和差异，可对照安装文档。

Windows：npm 全局安装两条命令

上面的 curl 脚本只支持 macOS 与 64 位 Linux，Windows 上请直接走标准 npm 路线：

npm install --global rea-agents rea --help

执行后应看到：npm 的安装完成信息，随后是rea的帮助说明。

这里区分一下--global的作用：它把rea放进全局命令目录，之后在任意路径都能调用。如果不带--global做本地安装，可执行文件只会出现在项目的node_modules/.bin里，shell 里是敲不出rea的。

接入 AI 智能体：rea setup 配置 Claude Code、Codex、Cursor

CLI 装好只是第一步，rea setup负责把智能体打通：

rea setup

执行后应看到：终端列出十余种客户端（Claude Code、Codex、Cursor、Gemini CLI 等）供你勾选。接着它展示一份精确的修改计划，你批准后才会写入配置，并自动备份原文件。Hopper 是独立选项，需要单独明确批准才会安装。全部完成后按提示重启对应智能体即可生效。

如果安装阶段因为环境不支持交互而跳过了 setup，随时手动补跑这条命令。

进阶：CI 锁版本与三条日常维护命令

CI 场景需要可复现的版本，脚本和 npm 各有锁版本的写法。脚本路线推荐组合--version与--no-prompt，全程无交互：

curl -fsSL https://raw.githubusercontent.com/morluto/rea/main/install.sh | bash -s -- --version 6.4.0 --no-prompt

npm 路线则把版本直接写进包名：npm install --global rea-agents@6.4.0。想先查一下当前最新发布版：

npm view rea-agents dist-tags.latest

执行后应看到：一个纯版本号，例如6.7.0，以发布时的实际值为准。

日常维护只有三条命令，各司其职：

rea doctor --json rea update rea uninstall

rea doctor --json：严格只读体检，输出 JSON，可直接接入脚本做判断；
rea update：升级当前安装；
rea uninstall：只移除 REA 自有的注册项，不碰你自己的配置。

参数全貌见 CLI 文档。

自检与排障：四种常见报错的对应处理 🩹

遇到报错时按症状对号入座，比从头重查快得多：

报错症状	可能原因	处理方法
安装时报 Node.js 版本不支持	当前 Node 不在支持范围（22.x ≥22.19、24.x ≥24.11、26+；23、25 及预发布版不支持）	用`node -v`查看版本；装过 nvm 的话执行`nvm use`切到受支持版本后重跑安装
装完提示`rea: command not found`	Linux 上`~/.local/bin`不在 PATH；macOS 上 npm 全局 bin 目录不在 PATH	Linux：把`~/.local/bin`加进 shell 启动配置后重开终端；macOS：检查 npm 全局前缀是否在 PATH 内
需要回滚旧版本	当前版本出现问题需要退回	用`npm install --global rea-agents@旧版本号`重装。注意 MCP 注册固定在当初执行 setup 的版本上，回滚后建议再跑一次`rea setup`对齐注册
curl 脚本在 Windows 上报错	脚本只支持 macOS 与 64 位 Linux	直接改用上面的 npm 路线，不要用 curl 脚本