安装 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。
npx rea-agents@latest setup03 / 检查所需能力
下面以 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 发布记录