文档 / 开始使用GUIDE 01
REA installation & MCP setup

安装 REA,连接你的 AI 客户端

从检查 Node.js,到注册 MCP、重启客户端和检查连接。先完成基础配置,再按分析目标选择引擎。

01 / 检查运行环境

REA 通过 Node.js 和 npm 运行。5.0.0 安装文档支持 Node.js 22.x(至少 22.19)、24.x(至少 24.11),或 26 及以上稳定版本;23、25 和预发布版本不在支持范围内。

先在终端查看版本。若命令不存在或版本不满足要求,先安装受支持的 Node.js,再回到本页。

终端 · 只读检查
node --version
npm --version

静态 JavaScript / Electron 分析无需 Hopper 或 Ghidra。原生二进制分析则需要另外配置分析引擎。

02 / 注册 MCP 和工作流指令

在下面选择系统,查看配置提示。setup 会显示拟修改的客户端配置;确认目标客户端后,审阅并批准变更。

setup 默认同时注册本地 MCP 服务并安装匹配的工作流指令。仅从技能目录安装 skill,并不等于 MCP 已注册。

  • 选择实际使用的客户端,例如 Claude Code、Codex 或 Cursor。
  • 核对 setup 显示的配置路径和改动内容。已有配置会按官方机制备份。
  • 完成后重启客户端,重新打开会话,再检查 REA 工具是否可用。

在 Terminal 中运行。静态 JS 分析无需额外引擎;原生分析按官方指南连接 Hopper、Ghidra 或已支持的 provider。

macOS · 安装并配置
npx rea-agents@latest setup

03 / 检查所需能力

下面以 Codex 为例诊断客户端注册。使用其他客户端时,依据官方安装文档选择对应的 client 参数。

诊断反映本机当前环境。某个原生引擎未安装,不代表静态 JavaScript 分析也不可用;应结合各项结果判断。

终端 · 客户端诊断
npx -y rea-agents@latest doctor --client codex --json

看到配置成功但客户端仍找不到工具时,先完整重启客户端。不要把“注册完成”直接当成目标分析成功。

04 / 可选:使用全局命令

日常频繁使用时,可以全局安装,让 rea 命令出现在终端中。使用 npx 已能完成上面的步骤,无需重复安装。

终端 · 可选全局安装
npm install --global rea-agents
rea --help

更新时,同步刷新客户端配置

全局安装用户运行 rea update,再执行更新结果提示的 setup 命令并重启客户端。npx 用户重新运行 npx rea-agents@latest setup。

本指南核对的是 5.0.0 文档。@latest 会使用执行当时的 npm 版本;遇到新旧命令差异,请以对应发布版本及命令帮助为准。

终端 · 仅全局安装用户
rea update

来源与版本

本页为官方文档的独立整理,未对你的环境或应用执行验证。官方 main 可能领先 npm 发布版本。

官方安装与 MCP 配置官方 Node.js 版本声明REA 5.0.0 发布记录
继续阅读 / GUIDE 02第一次分析:读懂 Electron 应用