遇到问题，从哪一步检查
按环境、客户端注册、引擎和目标文件依次排查。每次只缩小一个问题，保留真实诊断结果。
终端提示 rea: command not found
仅使用 npx，或执行 npm install rea-agents（不含 --global），不一定会把 rea 加入终端 PATH。先用下面的 npx 命令检查帮助。
如需长期使用全局命令，可运行 npm install --global rea-agents。安装完成后仍找不到命令时，检查 npm 全局可执行文件路径是否进入当前终端的 PATH。
npx -y rea-agents@latest --helpsetup 成功，但客户端没有 REA 工具
先确认 setup 选中了你正在使用的客户端，并批准了注册变更。完全关闭后重新启动该客户端，再用新会话检查工具。
以 Codex 为例可运行客户端诊断。安装 skill 只增加指令，不代表本地 MCP 服务已经连通。
npx -y rea-agents@latest doctor --client codex --jsondoctor 返回 healthy: false
阅读每一项检查，找到失败的客户端或 provider。总体未就绪可能只是某个引擎缺失；静态 JavaScript 分析与原生分析的前置条件不同。
按实际目标修复必需项，不要为一个静态 JS 问题把所有原生引擎都安装一遍。
安装提示 Node.js 版本不受支持
检查 node --version。5.0.0 文档要求 22.x ≥22.19、24.x ≥24.11 或 26+ 稳定版本。23、25 和预发布版本不在支持范围内。
如果你已升级但仍报错，检查当前终端实际使用的 Node.js 路径，避免版本管理器与系统安装混用。
node --version
npm --version分析结果缺失，或者仍有 unknown
先核对路径、输入类型和资源是否完整。动态关系、缺失的原生扩展或尚未捕获的运行行为，可能无法仅凭静态文件确定。
保留 unknown，并列出下一步需要的证据。缺失观察不等于功能不存在，也不能据此证明两个实现一致。
更新后仍能复现问题
先按安装页更新 REA 和客户端配置，再用相同输入复现。向官方提交问题时，提供版本、系统、目标类型、复现步骤和相关错误。
分享日志前检查其中的本地路径、私有代码和凭据，只保留定位问题所需的内容。不要公开上传无权分享的应用文件。
来源与版本
本页为官方文档的独立整理，未对你的环境或应用执行验证。官方 main 可能领先 npm 发布版本。
官方安装、诊断与更新说明官方常见问题官方问题反馈