REA MCP 逆向分析 CLI 五步跑通：从选型安装到接入 AI 智能体的完整指南

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

REA（Reverse Engineer Anything）是一款开源逆向分析工具：装完后终端里多一条rea命令，可以检查本地应用行为、解析 JavaScript/Electron 应用的模块结构、分析原生二进制，且每个结论都附带证据。再跑一次 setup，就能把这套 MCP 能力注册进 Claude Code、Codex 等 AI 智能体，全程在本地机器上完成。本指南写给第一次安装的人，跟到文末即可独立完成安装、验证与智能体接入。

🧭 装不上：先按平台和场景选路线

三条安装路径装出来的是同一个工具，差别只在平台与用途——先对照下表确认自己该走哪条，再敲命令。

两个关键差异：curl 脚本会先做自检，Node 版本不满足直接拒绝，且不会替你升级 Node；Linux 上 Ghidra、JADX、固件工具及静态 JavaScript 分析工作流要求 PATH 上有 procps 兼容的ps，装发行版的procps包即可。

🛠️ command not found：先验安装，再修 PATH

装完报 command not found，几乎都是 shell 的 PATH 没包含可执行文件所在目录——先确认安装本身没问题，再补 PATH。

跑之前想探路，用 dry-run 只打印计划不动任何东西：

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

怎么算成功：输出安装计划（目标版本、Node 运行时、将执行的 npm 命令、rea 落点）并以 "Dry run complete; no changes made." 收尾，文件系统零改动。其余常用参数：--version 6.7.0锁定精确版本，回滚靠它；--no-setup跳过装完后的自动 setup，适合无头环境；--verbose输出详细日志。

确认安装本身：

rea --help

怎么算成功：出现正常帮助输出。再跑一条严格只读、不写任何文件的体检命令：

rea doctor --json

怎么算成功：输出结构化 JSON 健康报告，列明当前主机前提与注册状态。

若终端仍报找不到命令，按平台对落点：curl 装法在 Linux 上固定在~/.local/bin/rea；macOS 跟随 npm 全局前缀，可用npm prefix --global查看；此前若跑过不带--global的npm install rea-agents，可执行文件只落在当前项目的node_modules/.bin里，补--global重装即可。Linux 的修法是在~/.bashrc或~/.zshrc末尾追加一行：

export PATH="$HOME/.local/bin:$PATH"

影响边界：这一行只改当前用户的 shell 启动脚本，不涉及系统文件或其他用户配置。重开终端再跑rea --help，能出帮助就算修好。

🔌 智能体调不动 REA：setup 两层授权一次配通

只装 CLI 手里只有一个终端工具；要让 AI 智能体真正调用 REA，还要跑 setup 把 REA 的 MCP 服务器注册进智能体配置。这一步涉及两次相互独立的批准，别混：npm 弹窗问"下载并运行"时，确认的只是下载这个包；setup 改智能体配置或装 Hopper 时，会另起计划、另行请求批准。

最小路径——不想装分析引擎，只想给智能体一份"怎么用"的说明：

npx skills add morluto/rea --skill reverse-engineer-anything

怎么算成功：命令无错完成；它只安装智能体说明与参考资料，不做 MCP 注册、不装引擎。

完整路径——注册 MCP 并安装工作流说明：

npx rea-agents setup

（全局安装后也可以直接rea setup。）setup 依次做三件事：

1. 多选要配置的智能体：官方支持 Claude Code、Codex、Cursor、Gemini CLI 等二十余种客户端；
2. 列出一份精确修改计划——涉及的每个配置路径、外部软件与网络来源——批准后才写文件，旧配置自动备份；
3. Hopper 是独立选项，单独批准才安装；不批准就复用已有的 Hopper、Ghidra 或 IDA 安装。

影响边界：这一步只写你选中的智能体配置文件并安装 REA 工作流说明文件，不动其他 MCP 服务器条目和无关配置；旧配置在写入前备份，任意一步都可以取消，取消即零改动。

怎么算成功：completion 消息点名需要重启的智能体，重启它即可开工。想确认某个智能体注册是否正确：

rea doctor --client codex --json

codex换成对应智能体的 client ID（见 docs/installation.md 的--client对照表）。怎么算成功：该客户端的注册检查项通过。

🔄 想换想删：升级、锁版本、卸载三条命令

升级（npm 或 Bun 全局安装）：

rea update

它只更新拥有当前 CLI 的那个全局安装，影响范围不含源码检出与 npx 副本；完成后会打印一条刷新智能体注册的 setup 命令——跑掉它、批准、重启智能体即可。npx 路线用npx rea-agents@latest setup刷新。

锁版本 / 回滚：

npm install --global rea-agents@6.7.0

curl 脚本则加--version 6.7.0（必须是精确语义化版本号）。注意：智能体的 MCP 注册锁在真正执行 setup 的那个版本上，回滚后把 setup 再跑一遍对齐。

卸载：

rea uninstall rea uninstall --purge-data

前者只移除 REA 自己拥有的智能体注册与 skill 文件；--purge-data额外清掉~/.rea下的 REA 缓存与状态。Hopper、Node.js、无关的 skill 与其他 MCP 服务器一律保留；遇到格式损坏或不可读的智能体配置，会在删除任何内容之前中止。

🩹 报错了：三个高频问题三行速查

问题一：安装中断，提示 Node 版本不受支持

• 症状：安装器拒绝继续，打印当前 Node.js 版本不受支持。
• 原因：当前 Node 不在受支持区间 22.x（≥22.23.4）/ 24.x（≥24.22.1）/ 26.12.1+；23、25 与预发布版均不在其内，且安装器不会替你升级 Node。
• 处理：先对版本再动手，依次执行node -v和nvm install 24 && nvm use 24，切到受支持主版本后重跑安装。

问题二：静态分析正常，二进制分析报引擎不可用

• 症状：JavaScript/Electron 静态分析没问题，但二进制相关工具报引擎不可用。
• 原因：深度原生分析需要 Hopper、Ghidra、IDA 三者之一；静态 JavaScript 与 .NET 检查不需要任何原生引擎。
• 处理：先查引擎状态，再决定补装：

rea doctor --provider hopper --json

引擎缺失就重跑rea setup并批准 Hopper 安装选项；已有 Ghidra 或 IDA 的，直接在 setup 里选择复用现有安装。

问题三：版本回滚后，智能体行为还停在旧版

• 症状：CLI 已回滚，智能体调用的行为却像旧版本。
• 原因：智能体的 MCP 注册锁在实际执行 setup 时使用的版本，回滚不会自动刷新注册。
• 处理：重跑rea setup，批准变更计划，再重启智能体。

📚 再深挖：官方文档与桥接源码入口

装、验证、接入、维护都做完后，rea 命令就正式可用了；想往下挖，从这三个入口进：

• docs/installation.md：setup 完整流程、受支持的智能体清单与 Hopper 安装机制，想细化智能体注册从这入手；
• docs/cli.md：doctor、update、uninstall 等日常命令的用法与退出码约定，想脚本化或读懂诊断输出从这入手；
• bridge/：Hopper、Ghidra、JADX 等各分析器的桥接实现代码，想读逆向分析引擎是怎么被接进来的从这入手。

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