安装与配置 REA。

• Windows：打开开始菜单，输入 PowerShell，按 Enter。
• macOS：按 ⌘ Space，输入 Terminal，按 Enter。
• Linux：多数桌面环境可以按 Ctrl Alt T。

用 Ctrl V 粘贴命令（macOS：⌘ V；Linux 终端：Ctrl Shift V），再按 Enter。

命令粘贴到终端；标着“你的编程助手”的提问粘贴到助手的聊天框。

打开终端，检查版本：

node -v
npm -v

如果 node -v 显示 v22.19+、v24.11+ 或 v26+，就可以继续。如果版本更旧，或显示“无法识别”/“command not found”，先安装 Node.js 24 LTS：

winget install --exact --id OpenJS.NodeJS.LTS

npx.cmd rea-agents@latest setup

brew install node

curl -fsSL https://fnm.vercel.app/install | bash

fnm install 24
fnm use 24
fnm default 24

更喜欢普通安装包？从 nodejs.org 下载 LTS 版。

在终端中为练习建一个文件夹，然后进入它：

mkdir rea-work
cd rea-work

下一步继续使用这个终端。如果已经有工作文件夹，进入那个文件夹即可。

使用适合你操作系统的命令安装 Codex：

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

curl -fsSL https://chatgpt.com/codex/install.sh | sh

安装后，重新打开终端并回到工作文件夹，再启动 Codex：

codex

选择“Sign in with ChatGPT”，在浏览器中登录后回到终端。看到消息输入框后，继续第 3 步。

Codex 安装与登录

1. 安装适合你操作系统的编辑器，然后登录。
2. 打开第 1 步创建的 rea-work 文件夹。
3. 打开 AI 聊天面板，选择 Agent 模式。Windsurf 或 Devin Desktop 使用其助手聊天面板；VS Code 先配置 GitHub Copilot。

Cursor 安装 · Windsurf / Devin Desktop 安装 · VS Code 与 Copilot 配置

使用适合你操作系统的安装命令：

irm https://claude.ai/install.ps1 | iex

curl -fsSL https://claude.ai/install.sh | bash

重新打开终端，回到工作文件夹并运行 claude，按提示登录。你需要符合条件的 Claude 订阅或已配置的 API 账号。

Claude Code 安装与账号选项

在 Windows 或 macOS 上安装 Claude Desktop 并登录。先完全退出它，再在 Claude 之外打开一个终端，运行这条命令：

npx rea-agents@latest setup --client claude_desktop

查看并确认计划，重新打开 Claude，再按第 3 步检查连接。

下载 Claude Desktop · Claude Desktop 连接详情

npm install --global opencode-ai

在工作文件夹里运行 opencode。在聊天框中使用 /connect 连接模型账号，再选择模型。

OpenCode 安装与模型配置

npm 6.4.0 支持下面这些客户端。指定客户端时，在 --client 后填写对应的 ID。

Qoder（qoder）、Factory Droid（droid）、Trae（trae）、ZCode（zcode）和 DeepSeek Harness（dsh）已在 main 中提供；需要使用源码构建或包含这些集成的新版本。

客户端配置与故障排查 · 版本支持情况

npx -y rea-agents@6.4.0 mcp

npx rea-agents@latest setup

如果只配置一个指定客户端，附上它的 setup ID：

npx rea-agents@latest setup --client codex

如果 npm 询问是否下载，输入 y 后按 Enter。在 REA 的客户端列表中，用方向键移动、空格键选择，然后按 Enter 继续。

桌面应用（Claude Desktop、Cursor、Windsurf、VS Code）：完全退出后再打开，只关窗口不够。macOS 上按 ⌘ Q；Windows 上，如果有托盘图标，也要从那里退出。

终端助手（Claude Code、Codex、Gemini CLI）：退出当前会话，再启动一次。

下载示例ZIP

如果助手不能下载文件，你也可以手动解压。把 notes-example 文件夹的路径交给它，再问同一个导出问题。

用 REA 检查 /absolute/path/to/app 中的应用。找出它怎样导出数据，并给出相关文件和行号。

在运行 REA 的电脑上安装一个分析工具。Host 指你使用的操作系统，target 指要分析的程序。

npx -y rea-agents@latest doctor --provider hopper --json

java -XshowSettings:properties -version
javac -version

$env:GHIDRA_INSTALL_DIR = "C:/tools/ghidra_12.1.4_PUBLIC"
$env:JAVA_HOME = "C:/tools/jdk-21"
npx -y rea-agents@latest doctor --provider ghidra --json
npx rea-agents@latest setup

export GHIDRA_INSTALL_DIR="/absolute/path/to/ghidra_12.1.4_PUBLIC"
export JAVA_HOME="/absolute/path/to/jdk-21"

npx -y rea-agents@latest doctor --provider ghidra --json
npx rea-agents@latest setup

{
  "command": "idalib-mcp",
  "args": ["--stdio", "--max-workers", "1"],
  "mode": "headless"
}

$env:REA_IDA_MCP_CONFIG = "C:/analysis/ida-mcp.json"
$env:REA_ANALYSIS_PROVIDER = "ida"
npx -y rea-agents@latest doctor --provider ida --json
npx rea-agents@latest setup

export REA_IDA_MCP_CONFIG="/absolute/path/to/ida-mcp.json"
export REA_ANALYSIS_PROVIDER="ida"
npx -y rea-agents@latest doctor --provider ida --json
npx rea-agents@latest setup

连接后，把原始可执行文件的完整路径和分析工具名称告诉编程助手：

使用 REA 和我已配置的分析工具检查 /absolute/path/to/program。列出其中的函数和字符串，然后说明处理用户输入的部分，并给出代码引用。

跟着示例分析原生程序

打开对应目标的指南，其中会列出额外工具、支持的平台和第一条分析命令。

Flutter 指南 · 软件包与资源 · EVM 字节码 · 全部分析指南

静态分析 JavaScript 或 Electron 应用目录、ASAR 文件，无需启动应用：

npx -y rea-agents@latest analyze-javascript-application "/absolute/path/to/app" --json

把路径换成解包后的应用目录或 .asar 文件。Windows 上也可以使用 "D:/apps/example" 这样的路径。

结果会识别应用，展示模块之间的关系，并给出源码位置。REA 无法解析的关系会在结果中注明。

如果希望在 shell 中直接使用 rea 命令：

npm install --global rea-agents

继续看 JavaScript 应用指南

npx -y rea-agents@latest function "/absolute/path/to/program" main --provider ghidra --json

把 main 换成目标函数列表中的名称或地址。先完成 Ghidra 配置再运行。

macOS 或 Linux 准备好 Node.js 后，也可以使用 curl 安装：

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

按设置提示连接你的助手。如果没有出现提示，运行 rea setup。

如果终端找不到 rea，请使用安装器打印的可执行文件路径。在 Linux 上，默认的设置命令是 "$HOME/.local/bin/rea" setup。

配置后重启或重新连接客户端。用 doctor 检查 REA 连接。以 Codex 为例：

在第 3 步的检查命令中填写你的 setup ID。使用编辑器时，在 MCP 设置中启用 REA，并在助手聊天中允许使用它的工具。

检查正在使用的分析后端。以 Ghidra 为例：

npx -y rea-agents@latest doctor --provider ghidra --json

报告会列出失败的检查和建议的下一步。

Windows 客户端和分析工具使用 Windows PowerShell。如果编程助手在 WSL 内运行，就在那个 Linux 环境中安装 Node.js 和 REA，并使用 Linux 路径。无界面 provider 与 REA 在同一个系统环境中运行。

在终端里，包含空格的路径需要加引号。

Windows setup 命令：

npx.cmd rea-agents@latest setup

要更新编程助手的连接，重新运行最新版 setup，查看并确认计划，然后重启客户端。

npx rea-agents@latest setup

全局安装的 CLI 用 rea update 更新。使用 npx rea-agents@latest uninstall 移除 REA 的客户端配置和 skill。

更新与卸载详情