为编程智能体安装 REA

01. 开始之前

你需要终端、npm，以及支持本地 MCP 的编程智能体。本指南涵盖 Claude Code、Codex 和 Cursor。请使用你拥有或获准分析的软件。

node --version
npm --version

REA 当前支持 22.x 中的 Node.js 22.19+、24.x 中的 24.11+，或 26+。23、25 和预发布版本不在支持范围内。如有需要，可从 Node.js 获取兼容版本。

本示例在 macOS arm64、Node.js 22.23.1 和 REA 6.4.0 环境中验证。额外引擎的平台支持有所不同，请按目标查看 官方安装参考。

02. 连接编程智能体

选择客户端，获得针对该客户端的配置命令。“在安装时选择”会打开交互式客户端选择。

npx rea-agents@latest setup

1. 运行命令。npm 可能会先询问是否下载软件包。
2. 查看 REA 提出的计划：客户端配置文件、配套 skill 指令，以及可选的引擎安装。
3. 确认你需要的修改。如果首个目标是 JavaScript，可以先不安装原生分析引擎。
4. 重启或重新连接编程智能体，使其加载新的 MCP 服务器。

安装流程会同时配置 MCP 注册和配套工作流指令。只安装 skill 并不会建立工具连接。

想让智能体代劳？

使用 npx rea-agents@latest setup 为这个编程智能体安装 REA。应用配置前，先展示计划进行的修改。然后说明如何重启并验证连接。我的第一个目标是本地 JavaScript 软件包。

03. 检查连接

重启后，询问智能体是否能看到 REA 工具。在第一篇教程中，它应该能调用 analyze_javascript_application。

检查当前会话是否能使用 REA 的 analyze_javascript_application 工具。如果能，请说明它需要什么本地路径。如果缺失，请如实报告，不要假装已运行分析。

也可从终端检查客户端配置。按需将 codex 替换为 claude_code 或 cursor。

npx -y rea-agents@latest doctor --client codex --json

04. 添加目标需要的工具

从想分析的软件类型出发，无需安装所有分析引擎。

商业引擎有自己的许可证，REA 不提供引擎授权。添加前请检查官方平台要求。

05. 遇到问题怎么办

智能体看不到 REA

先重启客户端。如果仍找不到工具，运行上方针对该客户端的 doctor 命令。你可以只查看配置修复计划而不应用：

npx rea-agents@latest setup --client codex --dry-run --json

确认计划后，如果要应用修改，请去掉 --dry-run --json 再运行相同的 setup 命令。修改配置后再次重启。

“rea: command not found”

项目本地 npm 安装不会把 rea 加入全局 shell 路径。本指南的 npx 命令无需全局安装。如果希望长期使用 CLI：

npm install --global rea-agents
rea --version

引擎检查失败

缺少原生分析引擎，不会影响不需要该引擎的 JavaScript 静态分析。请检查当前目标需要的分析后端。处理大型原生二进制文件时，可参考官方对相应引擎启动超时的说明。

06. 保持客户端注册配置更新

对于基于 npx 的配置，重新运行最新版 setup，检查修改，再重启客户端：

npx rea-agents@latest setup

对于全局 CLI，运行 rea update，再按提示刷新配置。GitHub 上出现新指令，并不会自动更新已经运行的 MCP 服务器。

第一次使用这个工具？ REA 是什么？ · 我们如何核查教程