Налаштуйте 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 Desktop, 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 та навичку.

Докладніше про оновлення та видалення

Топ