Настройте REA .

Подготовьте компьютер и ИИ-помощника для программирования, подключите REA, затем исследуйте небольшое приложение.

Впервые пробуете? Пройдите четыре шага ниже. Уже пользуетесь агентом? Сразу переходите к разделу «Подключите REA».

1. Подготовьте компьютер

Используйте компьютер, на котором хранятся исследуемые файлы. Локальный ИИ-помощник для программирования может читать их и запускать инструменты за вас.

Как мне открыть терминал?
  • Windows : откройте меню "Пуск", введите PowerShell и нажмите Enter.
  • macOS : нажмите ⌘ Space, введите Terminal и нажмите Enter.
  • Linux : нажмите Ctrl Alt T на большинстве настольных компьютеров.

Введите команду с помощью Ctrl V ( macOS : ⌘ V; Linux для терминалов: Ctrl Shift V), затем нажмите Enter.

Команды вводите в терминале. Запросы с пометкой «Ваш ИИ-помощник для программирования» отправляйте в чат агента.

Вам понадобится Node.js22 (22.19+), 24 (24.11+) или 26+. В комплект поставки входит Node.jsnpm .

У вас нет Node.js или вы не уверены?

Откройте терминал и проверьте:

Терминал
node -v
npm -v

Если node -v печатает версии v22.19+, v24.11+ или v26+, все готово. Если он выводит более старую версию или "не распознается" / "команда не найдена", установите Node.js 24 LTS:

Windows (PowerShell)
Windows PowerShell
winget install --exact --id OpenJS.NodeJS.LTS

Введите Y, если вас попросят принять условия. Закройте PowerShell, откройте его снова, затем запустите node -v.

Если winget недоступен, скачайте установщик Node.js.

Если позже при запуске npx PowerShell сообщит "running scripts is disabled on this system", используйте вместо него npx.cmd. Для npm используйте npm.cmd:

Windows PowerShell
npx.cmd rea-agents@latest setup
macOS

При первой установке скачайте установщик Node.js 24 LTS для macOS (.pkg), откройте его и следуйте инструкциям. Затем снова откройте Терминал.

Уже пользуетесь Homebrew?
macOS · Homebrew
brew install node
Linux

Если curl и unzip отсутствуют, сначала установите их. В Debian или Ubuntu выполните sudo apt install curl unzip; в других дистрибутивах используйте свой пакетный менеджер.

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

Закройте терминал, откройте его снова, затем выполните:

Linux
fnm install 24
fnm use 24
fnm default 24

Собственный пакет nodejs вашего дистрибутива часто старше версии 22.19, поэтому проверьте node -v, если вы используете его вместо этого.

Предпочитаете обычный установщик? Загрузите версию LTS с сайта nodejs.org.

Создайте рабочую папку для агента

В терминале создайте папку для упражнения и перейдите в неё:

Terminal
mkdir rea-work
cd rea-work

Оставьте этот терминал открытым для следующего шага. Если у вас уже есть рабочая папка, откройте её вместо новой.

2. Выберите ИИ-помощника для программирования

Агент , это ИИ, с которым вы общаетесь. REA предоставляет ему инструменты для исследования программ. Выберите одно приложение-клиент ниже; если раньше им не пользовались, откройте инструкции.

Codex · используйте свой аккаунт ChatGPT

Установите Codex с помощью команды для своей операционной системы:

Windows PowerShell
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
macOS / Linux
curl -fsSL https://chatgpt.com/codex/install.sh | sh

После установки снова откройте терминал и вернитесь в рабочую папку. Затем запустите Codex:

Terminal
codex

Выберите «Sign in with ChatGPT», завершите вход в браузере и вернитесь в терминал. Когда появится поле для сообщения, переходите к шагу 3.

Установка Codex и вход в аккаунт

Cursor, Windsurf или VS Code · используйте редактор
  1. Установите редактор для своей операционной системы и войдите в аккаунт.
  2. Откройте папку rea-work, созданную на шаге 1.
  3. Откройте чат с ИИ в редакторе и выберите режим Agent. В Windsurf или Devin Desktop откройте чат агента; в VS Code сначала настройте GitHub Copilot.

Настройка Cursor · Настройка Windsurf / Devin Desktop · Настройка VS Code и Copilot

Claude Code · используйте свой аккаунт Claude

Установите с помощью команды для своей операционной системы:

Windows PowerShell
irm https://claude.ai/install.ps1 | iex
macOS / Linux
curl -fsSL https://claude.ai/install.sh | bash

Снова откройте терминал, вернитесь в рабочую папку и запустите claude. Следуйте инструкциям для входа. Для доступа нужна подходящая подписка Claude или настроенный API-аккаунт.

Установка Claude Code и варианты аккаунтов

Claude Desktop · используйте настольный чат

Установите Claude Desktop в Windows или macOS и войдите в аккаунт. Полностью закройте приложение, затем выполните эту команду в терминале, открытом вне Claude:

Terminal
npx rea-agents@latest setup --client claude_desktop

Просмотрите и одобрите план, снова откройте Claude, затем проверьте подключение по шагу 3.

Скачать Claude Desktop · Подробности подключения Claude Desktop

OpenCode · выберите модель ИИ
Terminal
npm install --global opencode-ai

Запустите opencode в рабочей папке. В его чате используйте /connect, чтобы подключить свой аккаунт для доступа к моделям, затем выберите модель.

Установка OpenCode и настройка модели

Все поддерживаемые клиенты и их идентификаторы для настройки

Выпуск 6.4.0 в npm поддерживает перечисленные ниже клиенты. Чтобы явно выбрать клиент, укажите его идентификатор с --client.

Клиент Идентификатор для настройки
Claude Code claude_code
Claude Desktop claude_desktop
Codex codex
Cursor cursor
Gemini CLI gemini_cli
Windsurf windsurf
Devin devin
OpenCode opencode
Antigravity antigravity
GitHub Copilot CLI copilot_cli
Command Code commandcode
Qwen Code qwen_code
VS Code vscode
Grok Build grok_build
OMP omp
Pi pi
Hermes hermes

Qoder (qoder), Factory Droid (droid), Trae (trae), ZCode (zcode) и DeepSeek Harness (dsh) доступны в ветке main репозитория; используйте сборку из исходного кода или выпуск с этими интеграциями.

Настройка клиентов и устранение неполадок · Доступность в выпусках

Grok Bot · подключите на компьютере, где он работает

В чате Grok Bot попросите добавить пользовательский MCP-сервер с именем rea, используя эту команду на компьютере бота:

Grok Bot
npx -y rea-agents@6.4.0 mcp

Инструкции по подключению Grok Bot

3. Подключите REA

Вставьте этот запрос в своего ИИ-помощника для программирования:

Ваш ИИ-помощник для программирования

Установи REA и подключи его к этому ИИ-помощнику с помощью npx rea-agents@latest setup. Сначала покажи план изменений и дождись моего одобрения. Затем проверь установку.

Или запустите программу настройки самостоятельно
Terminal
npx rea-agents@latest setup

Для конкретного клиента добавьте его идентификатор для настройки:

Terminal
npx rea-agents@latest setup --client codex

Если npm попросит разрешить скачивание пакета, введите y и нажмите Enter. В списке клиентов REA перемещайтесь стрелками, выберите клиент клавишей Space и нажмите Enter для продолжения.

Выберите клиент и просмотрите план настройки. REA добавляет подключение MCP и соответствующий навык исследования, сохраняя резервную копию существующей конфигурации. Перед применением изменений он спрашивает вашего разрешения.

MCP , это соединение, через которое агент вызывает REA. Навык задаёт порядок действий для исследования программ.

Для первого упражнения можно пропустить необязательную установку Hopper. Когда настройка завершится, перезапустите клиент.

Как мне перезапустить мой клиент?

Приложения для настольных компьютеров (Claude для настольных компьютеров, Cursor, Windsurf , VS Code ): полностью закройте приложение, затем откройте его снова. Закрыть окно недостаточно. На macOS нажмите ⌘ Q; на Windows также завершите работу с помощью значка в трее, если он есть.

Терминальные агенты ( Claude Code , Codex , Gemini CLI ): выйдите из сеанса и запустите его снова.

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

Замените codex идентификатором своего клиента для настройки. При успешной проверке выводится "healthy": true. Затем попросите агента:

Проверь, что REA подключён, и покажи, какие инструменты REA ты можешь использовать.

4. Попробуйте первое исследование

Примером может служить приложение Electron, состоящее из шести файлов, с кнопкой экспорта заметок. Ваш агент может проверить его код, не устанавливая и не запуская Electron.

Ваш ИИ-помощник для программирования

Скачай https://rea.tools/examples/notes-example.zip в новую папку для примера и распакуй архив. С помощью REA выясни, что происходит при нажатии Export notes. Покажи, куда записывается notes.csv, какие поля он содержит, а также соответствующие файлы и строки.

Ищите краткое объяснение со ссылками на файлы и строки:

Кнопка отправляет сообщение notes:export. Основной процесс форматирует заметки как CSV и записывает notes.csv в папку загрузок пользователя. Это столбцы id и title.

Проверьте предсказание в пошаговом упражнении →

Скачайте пример сами или используйте своё приложение

Пример загрузки ZIP-файла

Если ваш агент не может загрузить файлы, распакуйте этот архив самостоятельно. Укажите путь к папке notes-example и задайте тот же вопрос об экспорте.

Исследуй приложение по пути /absolute/path/to/app с помощью REA. Найди, как оно экспортирует данные, и покажи соответствующие файлы и строки.

Как мне получить полный путь к папке?
  • Windows : в проводнике щелкните правой кнопкой мыши папку и выберите "Копировать как путь". На Windows 10, удерживая Shift, щелкните правой кнопкой мыши.
  • macOS : в Finder щелкните правой кнопкой мыши папку, удерживайте опцию и выберите Копировать "..." в качестве пути.
  • Любая система: перетащите папку в окно терминала, и появится путь к ней.

В терминале заключите путь, содержащий пробелы, в кавычки.

Исследуйте другой вид программ

Выберите раздел для своей цели. Провайдер анализа , это локальный инструмент, который REA использует для этого вида программ.

Исполняемые файлы и библиотеки машинного кода · Hopper, Ghidra или IDA

Установите один инструмент анализа на компьютер, где работает REA. Хост , это ваша операционная система, а цель , программа, которую вы хотите исследовать.

Провайдер анализа Windows macOS Linux
Hopper Недоступно 12+ Поддерживаемые дистрибутивы
Ghidra x64 · экспериментально x64 / arm64 x64 / arm64
IDA Проверенные профили Проверенный профиль без графического интерфейса См. руководство провайдера
Hopper · разрешите установщику установить или подключить его

Подключите Hopper к macOS или Linux. Запустите приведенную выше команду установки; она обнаружит существующую установку или предложит план установки для вашего одобрения.

Выберите Hopper при настройке и просмотрите отдельный план его установки. В macOS при первом открытии Hopper выберите деморежим или активируйте лицензию. В Linux установщик подготавливает поддерживаемую демоверсию и отдельный дисплей для неё.

Хосты Linux: Ubuntu 24.04+, Fedora 41+, Nobara 44+, Arch Linux, CachyOS или Omarchy. Hopper , коммерческая программа; ограничения демоверсии определяет разработчик.

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

Если macOS запросит разрешение на автоматизацию, разрешите приложению, запускающему REA, доступ в «Системные настройки → Конфиденциальность и безопасность → Автоматизация», затем повторите попытку.

Настройка Hopper и устранение неполадок

Ghidra · установите бесплатный инструмент анализа и Java
  1. Установите 64-битный JDK 21 или новее, включающий компилятор Java. Выберите пакет для архитектуры своего компьютера.
  2. Скачайте Ghidra 12.1.4 из списка Assets выпуска и распакуйте архив ghidra_…_PUBLIC_….zip. Выберите архив выпуска, а не «Source code».
  3. Найдите распакованную папку, содержащую ghidraRun или ghidraRun.bat. Используйте её для GHIDRA_INSTALL_DIR.

Скачать JDK · Скачать Ghidra 12.1.4

Проверьте Java. Первая команда выводит java.home; используйте эту папку для JAVA_HOME. Вторая подтверждает, что компилятор установлен:

Terminal
java -XshowSettings:properties -version
javac -version
Подключите Ghidra к Windows

Windows x64 имеет экспериментальную поддержку только для чтения собственных приложений x86 и x64 PE и библиотек DLL на фиксированных локальных дисках NTFS. Используйте существующую установку Ghidra 12.1.x и 64-разрядную версию JDK 21 или новее:

Windows PowerShell
$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

Замените эти два пути вашими установками, затем просмотрите план установки.

Подключите вашу установку Ghidra
macOS / Linux
export GHIDRA_INSTALL_DIR="/absolute/path/to/ghidra_12.1.4_PUBLIC"
export JAVA_HOME="/absolute/path/to/jdk-21"

Замените оба пути путями к существующим установкам. Для новой установки в macOS или Linux arm64 перед продолжением соберите нативный декомпилятор для своего компьютера.

Соберите нативный декомпилятор Ghidra

Для сборки в macOS нужны Xcode Command Line Tools, make и bison. Используйте руководство для своего компьютера:

Затем проверьте Ghidra и сохраните пути к нему для своего клиента:

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

Выполняйте эти команды в одном сеансе терминала. После указания путей снова запустите настройку, одобрите обновлённую конфигурацию клиента и перезапустите агента.

Настройка Ghidra и требования к архитектуре · Руководство по Ghidra в Windows

IDA · подключите существующую установку

По руководству провайдера IDA подготовьте регистрацию MCP-сервера на стороне IDA. Выберите подключение к графическому интерфейсу с открытым исходным бинарным файлом или к супервизору без графического интерфейса, который открывает отдельную базу данных.

Проверенные профили включают прежнее подключение к GUI в Windows и супервизор без графического интерфейса, а также супервизор без графического интерфейса в macOS arm64 с IDA Professional 9.1. У необязательного нативного моста к GUI свои требования к версиям и платформам.

Для headless-профиля macOS и нативного GUI-моста нужна сборка REA из исходников или выпуск с этими изменениями. В npm 6.4.0 их нет.

Из каталога собранного исходного кода запустите node scripts/rea.mjs doctor --provider ida --json и node scripts/rea.mjs setup вместо приведённых ниже команд npx.

Подготовьте файл регистрации IDA

Установите и настройте сервер на стороне IDA по руководству ниже. Затем сохраните его рабочую регистрацию как ida-mcp.json в текстовом редакторе. В Windows при сохранении в Блокноте выберите «Все файлы», чтобы он не добавил .txt.

Для супервизора без графического интерфейса с инструментами idb_open, idb_list и idb_close файл может выглядеть так:

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

Для подключённого прежнего GUI-сервера версии 1.4.0 скопируйте в файл его рабочие значения command, args и, при наличии, env. Откройте исходный бинарный файл в IDA и запустите плагин на стороне IDA, прежде чем просить REA его исследовать.

Windows PowerShell
$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
macOS / Linux
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

Используйте JSON-файл регистрации, подготовленный по руководству провайдера, затем снова запустите настройку и перезапустите агента.

Профили IDA, примеры регистрации и проверенные платформы

После подключения сообщите агенту полный путь к исходному исполняемому файлу и укажите провайдер анализа:

Используй REA с настроенным мной провайдером, чтобы исследовать /absolute/path/to/program. Перечисли функции и строки, затем объясни часть, обрабатывающую пользовательский ввод, со ссылками на код.

Пройдите пример анализа машинного кода

Сайты, Android, .NET, прошивки и другие цели

Откройте руководство для своей цели. В каждом указаны дополнительные инструменты, поддерживаемые хосты и первая команда.

Цель Необходимые инструменты Руководство
JavaScript / Electron Node.js + npm Открыть руководство
Сайт Chrome / Chromium / Edge Открыть руководство
.NET / Flutter / пакеты Node.js + npm Открыть руководство
Android APK JADX + JDK 17+ Открыть руководство
Устройство Android adb Открыть руководство
Ресурсы Android Apktool + Java Открыть руководство
Проект JEB JEB + MCP Открыть руководство
Прошивка Binwalk / Unblob · Linux Открыть руководство
WASM WABT Открыть руководство
База данных SQLite Node.js 24.15+ / 26+ Открыть руководство
Байткод EVM Node.js · Linux x64 Открыть руководство
ELF / сбой Linux pwntools / GDB / pwndbg Открыть руководство
HAR / SAZ / mitmproxy Node.js / mitmdump Открыть руководство
PCAP / PCAPNG TShark / capinfos · Linux Открыть руководство
Логические сигналы sigrok-cli · Linux Открыть руководство
Поведение процесса PTY · Linux / macOS Открыть руководство

Руководство по Flutter · Пакеты и ресурсы · Байткод EVM · Все руководства по исследованию

Используйте REA из терминала

Команды CLI, глобальная установка и curl

Проанализируйте папку приложения JavaScript или Electron или архив ASAR, не запуская приложение:

Статический анализ приложений
npx -y rea-agents@latest analyze-javascript-application "/absolute/path/to/app" --json

Замените путь на каталог вашего извлеченного приложения или файл .asar. В Windows здесь работает путь, например "D:/apps/example".

Где мне найти asar-файл приложения?

Приложения Electron обычно хранят его в папке resources:

  • Windows : C:\Users\<you>\AppData\Local\Programs\<App>\resources\app.asar
  • macOS : /Applications/<App>.app/Contents/Resources/app.asar (щелкните правой кнопкой мыши приложение и выберите Показать содержимое пакета)
  • Linux : часто /opt/<App>/resources/app.asar

Некоторые приложения устанавливаются в другом месте. Найдите в папке приложения app.asar.

Результат идентифицирует приложение, показывает соединения между модулями и указывает местоположение их источников. В результате отмечаются соединения, которые REA не может разрешить.

Если вы хотите, чтобы в вашей оболочке была постоянная команда rea:

Установите CLI
npm install --global rea-agents

Продолжайте читать руководство по применению JavaScript

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

Замените main именем или адресом функции из списка функций цели. Сначала нужно настроить Ghidra.

В macOS или Linux после подготовки Node.js можно также воспользоваться установщиком через curl:

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

Следуйте подсказкам настройки, чтобы подключить агента. Если они не появились, запустите rea setup.

Если оболочка не находит rea, используйте путь к исполняемому файлу, который вывел установщик. В Linux команда настройки по умолчанию , "$HOME/.local/bin/rea" setup.

Получение помощи

Если ваш агент не видит REA

Перезапустите или повторно подключите клиент после установки. Проверьте его REA-соединение с doctor; для Codex :

Выполните проверку клиента из шага 3 со своим идентификатором для настройки. В редакторах включите REA в настройках MCP и разрешите его инструменты в чате агента.

Если поставщик услуг нуждается во внимании

Проверьте, каким провайдером вы пользуетесь. Для Ghidra :

Проверьте одного поставщика
npx -y rea-agents@latest doctor --provider ghidra --json

В отчете содержится информация о неудачной проверке и предлагаемый следующий шаг.

Windows, WSL и пути с пробелами

Для клиентов и инструментов анализа Windows используйте Windows PowerShell. Если агент работает внутри WSL, установите Node.js и REA в эту среду Linux и используйте там пути Linux. Провайдеры без графического интерфейса работают на том же хосте, что и REA.

В терминале заключите путь, содержащий пробелы, в кавычки.

Команда настройки для Windows:

Windows PowerShell
npx.cmd rea-agents@latest setup
Обновите или удалите REA

Чтобы обновить подключение агента, ещё раз выполните последнюю команду настройки, просмотрите её план и перезапустите клиент.

Terminal
npx rea-agents@latest setup

Если CLI установлен глобально, обновите его с помощью rea update. Используйте npx rea-agents@latest uninstall, чтобы удалить конфигурацию клиента REA и навык.

Подробнее об обновлении и удалении

Топ