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)
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:
npx.cmd rea-agents@latest setup
macOS
При первой установке скачайте установщик Node.js 24 LTS для macOS (.pkg), откройте его и следуйте инструкциям. Затем снова откройте Терминал.
Уже пользуетесь Homebrew?
brew install node
Linux
Если curl и unzip отсутствуют, сначала установите их. В Debian или Ubuntu выполните sudo apt install curl unzip; в других дистрибутивах используйте свой пакетный менеджер.
curl -fsSL https://fnm.vercel.app/install | bash
Закройте терминал, откройте его снова, затем выполните:
fnm install 24
fnm use 24
fnm default 24
Собственный пакет nodejs вашего дистрибутива часто старше версии 22.19, поэтому проверьте node -v, если вы используете его вместо этого.
Предпочитаете обычный установщик? Загрузите версию LTS с сайта nodejs.org.
Создайте рабочую папку для агента
В терминале создайте папку для упражнения и перейдите в неё:
mkdir rea-work
cd rea-work
Оставьте этот терминал открытым для следующего шага. Если у вас уже есть рабочая папка, откройте её вместо новой.
2. Выберите ИИ-помощника для программирования
Агент , это ИИ, с которым вы общаетесь. REA предоставляет ему инструменты для исследования программ. Выберите одно приложение-клиент ниже; если раньше им не пользовались, откройте инструкции.
Codex · используйте свой аккаунт ChatGPT
Установите 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.
Cursor, Windsurf или VS Code · используйте редактор
- Установите редактор для своей операционной системы и войдите в аккаунт.
- Откройте папку rea-work, созданную на шаге 1.
- Откройте чат с ИИ в редакторе и выберите режим Agent. В Windsurf или Devin Desktop откройте чат агента; в VS Code сначала настройте GitHub Copilot.
Настройка Cursor · Настройка Windsurf / Devin Desktop · Настройка VS Code и Copilot
Claude Code · используйте свой аккаунт Claude
Установите с помощью команды для своей операционной системы:
irm https://claude.ai/install.ps1 | iex
curl -fsSL https://claude.ai/install.sh | bash
Снова откройте терминал, вернитесь в рабочую папку и запустите claude. Следуйте инструкциям для входа. Для доступа нужна подходящая подписка Claude или настроенный API-аккаунт.
Claude Desktop · используйте настольный чат
Установите Claude Desktop в Windows или macOS и войдите в аккаунт. Полностью закройте приложение, затем выполните эту команду в терминале, открытом вне Claude:
npx rea-agents@latest setup --client claude_desktop
Просмотрите и одобрите план, снова откройте Claude, затем проверьте подключение по шагу 3.
Скачать Claude Desktop · Подробности подключения Claude Desktop
OpenCode · выберите модель ИИ
npm install --global opencode-ai
Запустите opencode в рабочей папке. В его чате используйте /connect, чтобы подключить свой аккаунт для доступа к моделям, затем выберите модель.
Все поддерживаемые клиенты и их идентификаторы для настройки
Выпуск 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, используя эту команду на компьютере бота:
npx -y rea-agents@6.4.0 mcp
3. Подключите REA
Вставьте этот запрос в своего ИИ-помощника для программирования:
Установи REA и подключи его к этому ИИ-помощнику с помощью npx rea-agents@latest setup. Сначала покажи план изменений и дождись моего одобрения. Затем проверь установку.
Или запустите программу настройки самостоятельно
npx rea-agents@latest setup
Для конкретного клиента добавьте его идентификатор для настройки:
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 ): выйдите из сеанса и запустите его снова.
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.
Проверьте предсказание в пошаговом упражнении →
Скачайте пример сами или используйте своё приложение
Если ваш агент не может загрузить файлы, распакуйте этот архив самостоятельно. Укажите путь к папке 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 , коммерческая программа; ограничения демоверсии определяет разработчик.
npx -y rea-agents@latest doctor --provider hopper --json
Если macOS запросит разрешение на автоматизацию, разрешите приложению, запускающему REA, доступ в «Системные настройки → Конфиденциальность и безопасность → Автоматизация», затем повторите попытку.
Ghidra · установите бесплатный инструмент анализа и Java
- Установите 64-битный JDK 21 или новее, включающий компилятор Java. Выберите пакет для архитектуры своего компьютера.
-
Скачайте Ghidra 12.1.4 из списка Assets выпуска и распакуйте архив
ghidra_…_PUBLIC_….zip. Выберите архив выпуска, а не «Source code». -
Найдите распакованную папку, содержащую
ghidraRunилиghidraRun.bat. Используйте её дляGHIDRA_INSTALL_DIR.
Скачать JDK · Скачать Ghidra 12.1.4
Проверьте Java. Первая команда выводит java.home; используйте эту папку для JAVA_HOME. Вторая подтверждает, что компилятор установлен:
java -XshowSettings:properties -version
javac -version
Подключите Ghidra к Windows
Windows x64 имеет экспериментальную поддержку только для чтения собственных приложений x86 и x64 PE и библиотек DLL на фиксированных локальных дисках NTFS. Используйте существующую установку Ghidra 12.1.x и 64-разрядную версию JDK 21 или новее:
$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
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 и сохраните пути к нему для своего клиента:
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 файл может выглядеть так:
{
"command": "idalib-mcp",
"args": ["--stdio", "--max-workers", "1"],
"mode": "headless"
}
Для подключённого прежнего GUI-сервера версии 1.4.0 скопируйте в файл его рабочие значения command, args и, при наличии, env. Откройте исходный бинарный файл в IDA и запустите плагин на стороне IDA, прежде чем просить REA его исследовать.
$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
Используйте JSON-файл регистрации, подготовленный по руководству провайдера, затем снова запустите настройку и перезапустите агента.
После подключения сообщите агенту полный путь к исходному исполняемому файлу и укажите провайдер анализа:
Используй 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:
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.
Получение помощи
Если ваш агент не видит 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:
npx.cmd rea-agents@latest setup
Обновите или удалите REA
Чтобы обновить подключение агента, ещё раз выполните последнюю команду настройки, просмотрите её план и перезапустите клиент.
npx rea-agents@latest setup
Если CLI установлен глобально, обновите его с помощью rea update. Используйте npx rea-agents@latest uninstall, чтобы удалить конфигурацию клиента REA и навык.
- REA задаваемые вопросы по обновлениям, агентам и анализу.
- Выберите руководство по исследованию и примеры для двоичного файла, приложения Electron и браузера.
- Проблемы GitHub Сообщают о проблеме с командой и диагностикой.
- REA Вопросы сообщества, расследования и текущая работа.
