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 Desktop, 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.
Перевірте передбачення в покроковій вправі →
Завантажте приклад самостійно або використовуйте свій застосунок
Приклад завантаження 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 , комерційна програма; обмеження демоверсії визначає розробник.
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 питання спільноти, розслідування та поточна робота.
