Skonfiguruj REA .

Przygotuj komputer i agenta programistycznego, połącz REA, a następnie zbadaj małą aplikację.

Próbujesz po raz pierwszy? Wykonaj cztery kroki poniżej. Masz już agenta? Przejdź od razu do sekcji Połącz REA.

1. Przygotuj komputer

Użyj komputera, na którym znajdują się badane pliki. Lokalny agent programistyczny może je czytać i uruchamiać narzędzia za Ciebie.

Jak otworzyć terminal?
  • Windows : otwórz menu Start, wpisz PowerShell i naciśnij Enter.
  • macOS : prasa ⌘ Space, Typ Terminal i naciśnij Enter.
  • Linux : prasa Ctrl Alt T na większości komputerów stacjonarnych.

Wklej polecenie za pomocą Ctrl V (macOS : ⌘ V; Terminale Linux: Ctrl Shift V), a następnie naciśnij Enter.

Komendy wpisuj w terminalu. Polecenia oznaczone „Twój agent programistyczny” wklejaj do czatu agenta.

Będziesz potrzebować Node.js 22 (22.19+), 24 (24.11+) lub 26+. npm pochodzi z Node.js.

Nie masz Node.js, czy nie jesteś pewien?

Otwórz terminal i sprawdź:

Terminal
node -v
npm -v

Jeśli node -v drukuje v22.19+, v24.11+ lub v26+, jesteś gotowy. Jeśli wydrukuje starszą wersję lub "nie rozpoznano" / "nie znaleziono polecenia", zainstaluj Node.js 24 LTS:

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

Wpisz Y, jeśli zostaniesz poproszony o zaakceptowanie warunków. Zamknij PowerShell, otwórz go ponownie, a następnie uruchom node -v.

Jeśli winget jest niedostępny, pobierz instalator Node.js.

Jeśli później podczas uruchamiania npx PowerShell wyświetli "running scripts is disabled on this system", użyj zamiast tego npx.cmd. W przypadku npm użyj npm.cmd:

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

Przy pierwszej instalacji pobierz instalator Node.js 24 LTS dla macOS (.pkg), otwórz go i postępuj zgodnie z instrukcjami. Następnie ponownie otwórz Terminal.

Korzystasz już z Homebrew?
macOS · Homebrew
brew install node
Linux

Jeśli brakuje curl lub unzip, najpierw je zainstaluj. W Debian lub Ubuntu wykonaj sudo apt install curl unzip; w innych dystrybucjach użyj swojego menedżera pakietów.

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

Zamknij terminal, otwórz go ponownie, a następnie wykonaj:

Linux
fnm install 24
fnm use 24
fnm default 24

Twoja dystrybucja własna nodejs Pakiet jest często starszy niż 22.19, więc sprawdź node -v jeśli zamiast tego go użyjesz.

Wolisz zwykłego instalatora? Pobierz wersję LTS z nodejs.org.

Utwórz folder roboczy dla agenta

W terminalu utwórz folder na ćwiczenie, a następnie przejdź do niego:

Terminal
mkdir rea-work
cd rea-work

Zostaw ten terminal otwarty do następnego kroku. Jeśli masz już folder roboczy, otwórz go zamiast nowego.

2. Wybierz agenta programistycznego

Agent to AI, z którą rozmawiasz. REA dostarcza jej narzędzia do badania programów. Wybierz jedną aplikację kliencką poniżej; jeśli jeszcze jej nie znasz, otwórz instrukcje.

Codex · użyj swojego konta ChatGPT

Zainstaluj Codex za pomocą komendy dla swojego systemu operacyjnego:

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

Po instalacji ponownie otwórz terminal i wróć do folderu roboczego. Następnie uruchom Codex:

Terminal
codex

Wybierz „Sign in with ChatGPT”, zaloguj się w przeglądarce i wróć do terminala. Gdy pojawi się pole wiadomości, przejdź do kroku 3.

Instalacja Codex i logowanie

Cursor, Windsurf lub VS Code · użyj edytora
  1. Zainstaluj edytor dla swojego systemu operacyjnego i zaloguj się.
  2. Otwórz folder rea-work utworzony w kroku 1.
  3. Otwórz czat AI w edytorze i wybierz tryb Agent. W Windsurf lub Devin Desktop otwórz czat agenta; w VS Code najpierw skonfiguruj GitHub Copilot.

Konfiguracja Cursor · Konfiguracja Windsurf / Devin Desktop · Konfiguracja VS Code i Copilot

Claude Code · użyj swojego konta Claude

Zainstaluj za pomocą komendy dla swojego systemu operacyjnego:

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

Otwórz ponownie terminal, wróć do folderu roboczego i uruchom claude. Postępuj zgodnie z instrukcjami logowania. Dostęp wymaga odpowiedniej subskrypcji Claude lub skonfigurowanego konta API.

Instalacja Claude Code i opcje konta

Claude Desktop · użyj czatu w aplikacji desktopowej

Zainstaluj Claude Desktop w Windows lub macOS i zaloguj się. Całkowicie zamknij aplikację, a następnie wykonaj tę komendę w terminalu otwartym poza Claude:

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

Przejrzyj i zatwierdź plan, ponownie otwórz Claude, a następnie sprawdź połączenie w kroku 3.

Pobierz Claude Desktop · Szczegóły połączenia z Claude Desktop

OpenCode · wybierz model AI
Terminal
npm install --global opencode-ai

Uruchom opencode w folderze roboczym. W jego czacie użyj /connect, aby połączyć konto dostępu do modeli, a następnie wybierz model.

Instalacja OpenCode i konfiguracja modelu

Wszystkie obsługiwane klienty i identyfikatory konfiguracji

Wydanie 6.4.0 w npm obsługuje klienty wymienione poniżej. Aby wskazać konkretny klient, użyj jego identyfikatora z --client.

Klient Identyfikator konfiguracji
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) i DeepSeek Harness (dsh) są dostępne w gałęzi main repozytorium; użyj kompilacji ze źródeł lub wydania zawierającego te integracje.

Konfiguracja klientów i rozwiązywanie problemów · Dostępność w wydaniach

Grok Bot · połącz na komputerze, na którym działa

W czacie Grok Bot poproś o dodanie własnego serwera MCP o nazwie rea, używając tej komendy na komputerze bota:

Grok Bot
npx -y rea-agents@6.4.0 mcp

Instrukcje połączenia Grok Bot

3. Połącz REA

Wklej to polecenie do swojego agenta programistycznego:

Twój agent programistyczny

Zainstaluj REA i połącz je z tym agentem programistycznym za pomocą npx rea-agents@latest setup. Najpierw pokaż plan zmian i poczekaj na moją zgodę. Potem sprawdź instalację.

Lub uruchom samodzielnie konfigurację
Terminal
npx rea-agents@latest setup

Dla konkretnego klienta dodaj jego identyfikator konfiguracji:

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

Jeśli npm poprosi o zgodę na pobranie pakietu, wpisz y i naciśnij Enter. Na liście klientów REA poruszaj się strzałkami, zaznacz swój klient klawiszem Space i naciśnij Enter, aby kontynuować.

Wybierz swojego klienta i przejrzyj plan konfiguracji. REA dodaje swoje połączenie MCP i umiejętność badania dopasowania, zachowując kopię zapasową istniejącej konfiguracji. Pyta przed zastosowaniem zmian.

MCP to połączenie, przez które agent wywołuje REA. Umiejętność daje mu sposób postępowania przy badaniu programów.

W pierwszym ćwiczeniu możesz pominąć opcjonalną instalację Hopper. Po zakończeniu konfiguracji uruchom ponownie klienta.

Jak zrestartować klienta?

Aplikacje komputerowe (Claude Desktop, Cursor, Windsurf, VS Code): całkowicie zamknij aplikację, a następnie otwórz ją ponownie. Zamknięcie okna nie wystarczy. Na prasie macOS ⌘ Q; na Windows Zamknij również ikonę w zasobniku, jeśli taka istnieje.

Agenci terminalowi (Claude Code , Codex , Gemini CLI ): Zamknij sesję i uruchom ją ponownie.

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

Zastąp codex identyfikatorem konfiguracji swojego klienta. Poprawna kontrola zwraca "healthy": true. Następnie poproś agenta:

Sprawdź, czy REA jest połączone, i pokaż, z jakich narzędzi REA możesz korzystać.

4. Spróbuj pierwszego badania

Przykładem jest sześcioplikowa aplikacja Electron z Eksportuj notatki przycisk. Twój agent może sprawdzić swój kod bez instalowania lub uruchamiania Electron .

Twój agent programistyczny

Pobierz https://rea.tools/examples/notes-example.zip do nowego przykładowego folderu i rozpakuj go. Użyj REA, aby dowiedzieć się, co się stanie, gdy kliknę Eksportuj notatki. Pokaż gdzie notes.csv jest napisane, które pola zawiera, oraz odpowiednie pliki i wiersze.

Poszukaj krótkiego wyjaśnienia z odniesieniami do plików i linii:

Przycisk wysyła notes:export wiadomość. Główny proces formatuje notatki jako CSV i zapisuje notes.csv w folderze Pobrane użytkownika. Kolumny są id oraz title.

Sprawdź przewidywanie w ćwiczeniu krok po kroku →

Pobierz przykład samodzielnie lub użyj własnej aplikacji

Pobierz przykład ZIP

Jeśli twój agent nie może pobrać plików, rozpakuj to archiwum samodzielnie. Daj mu drogę do notes-example folder i to samo pytanie o eksport.

Użyj REA do zbadania aplikacji pod ścieżką /absolute/path/to/app. Znajdź, jak eksportuje dane, i pokaż odpowiednie pliki oraz linie.

Jak uzyskać pełną ścieżkę folderu?
  • Windows : w Eksploratorze plików kliknij folder prawym przyciskiem myszy i wybierz Kopiuj jako ścieżkę. Na Windows 10 przytrzymaj klawisz Shift, klikając prawym przyciskiem myszy.
  • macOS : w Finderze kliknij prawym przyciskiem myszy folder, przytrzymaj opcję i wybierz Skopiuj " ... " jako ścieżkę.
  • Dowolny system: przeciągnij folder do okna terminala, a pojawi się jego ścieżka.

W terminalu umieść cudzysłowy wokół ścieżki zawierającej spacje.

Zbadaj inny rodzaj oprogramowania

Wybierz sekcję dla swojego celu. Dostawca analizy to lokalne narzędzie, którego REA używa do badania tego rodzaju oprogramowania.

Pliki wykonywalne i biblioteki kodu maszynowego · Hopper, Ghidra lub IDA

Zainstaluj jedno narzędzie analizy na komputerze, na którym działa REA. Host to Twój system operacyjny, a cel to program, który chcesz zbadać.

Dostawca analizy Windows macOS Linux
Hopper Niedostępne 12+ Obsługiwane dystrybucje
Ghidra x64 · eksperymentalnie x64 / arm64 x64 / arm64
IDA Zweryfikowane profile Zweryfikowany profil bez interfejsu graficznego Zobacz przewodnik dostawcy
Hopper · pozwól konfiguratorowi go zainstalować lub połączyć

Podłącz Hopper na macOS lub Linux . Uruchom powyższe polecenie konfiguracji; wykrywa istniejącą instalację lub oferuje plan instalacji do zatwierdzenia.

Wybierz Hopper podczas konfiguracji i przejrzyj jego oddzielny plan instalacji. W macOS przy pierwszym uruchomieniu Hopper wybierz tryb demonstracyjny lub aktywuj licencję. W Linux konfigurator przygotowuje obsługiwaną wersję demonstracyjną i osobny ekran dla niej.

Hosty Linux: Ubuntu 24.04+, Fedora 41+, Nobara 44+, Arch Linux, CachyOS lub Omarchy. Hopper to oprogramowanie komercyjne; ograniczenia wersji demonstracyjnej określa producent.

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

Jeśli macOS poprosi o uprawnienie do automatyzacji, zezwól aplikacji uruchamiającej REA w Ustawienia systemowe → Prywatność i ochrona → Automatyzacja, a następnie spróbuj ponownie.

Konfiguracja Hopper i rozwiązywanie problemów

Ghidra · zainstaluj bezpłatne narzędzie analizy i Javę
  1. Zainstaluj 64-bitowy JDK 21 lub nowszy, zawierający kompilator Java. Wybierz pakiet pasujący do architektury Twojego komputera.
  2. Pobierz Ghidra 12.1.4 z listy Assets wydania i rozpakuj archiwum ghidra_…_PUBLIC_….zip. Wybierz archiwum wydania, a nie „Source code”.
  3. Znajdź rozpakowany folder zawierający ghidraRun lub ghidraRun.bat. Użyj go jako GHIDRA_INSTALL_DIR.

Pobierz JDK · Pobierz Ghidra 12.1.4

Sprawdź Javę. Pierwsza komenda wyświetla java.home; użyj tego folderu jako JAVA_HOME. Druga potwierdza, że kompilator jest zainstalowany:

Terminal
java -XshowSettings:properties -version
javac -version
Połącz Ghidra na Windows

Windows x64 ma eksperymentalną obsługę tylko do odczytu dla natywnych aplikacji x86 i x64 PE oraz bibliotek DLL na stałych lokalnych dyskach NTFS. Użyj istniejącego Ghidra 12.1.instalacja x i 64-bitowy JDK 21 lub nowszy:

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

Zastąp dwie ścieżki instalacjami, a następnie przejrzyj plan konfiguracji.

Podłącz instalację Ghidra
macOS / Linux
export GHIDRA_INSTALL_DIR="/absolute/path/to/ghidra_12.1.4_PUBLIC"
export JAVA_HOME="/absolute/path/to/jdk-21"

Zastąp obie ścieżki ścieżkami do swoich istniejących instalacji. Przy nowej instalacji w macOS lub Linux arm64 przed kontynuowaniem skompiluj natywny dekompilator dla swojego komputera.

Skompiluj natywny dekompilator Ghidra

W macOS kompilacja wymaga Xcode Command Line Tools, make i bison. Użyj przewodnika dla swojego komputera:

Następnie sprawdź Ghidra i zapisz jego ścieżki dla swojego klienta:

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

Wykonuj te komendy w tej samej sesji terminala. Po ustawieniu ścieżek ponownie uruchom konfigurację, zatwierdź zaktualizowaną konfigurację klienta i uruchom ponownie agenta.

Konfiguracja Ghidra i wymagania architektury · Przewodnik po Ghidra w Windows

IDA · połącz istniejącą instalację

Przygotuj rejestrację serwera MCP po stronie IDA zgodnie z przewodnikiem dostawcy IDA. Wybierz połączenie z interfejsem graficznym, w którym otwarty jest oryginalny plik binarny, lub z nadzorcą bez interfejsu graficznego, który otwiera osobną bazę danych.

Zweryfikowane profile obejmują starsze połączenie GUI i nadzorcę bez interfejsu graficznego w Windows oraz nadzorcę bez interfejsu graficznego w macOS arm64 z IDA Professional 9.1. Opcjonalny natywny most do GUI ma własne wymagania dotyczące wersji i platformy.

Profil bez interfejsu na macOS i natywny most GUI wymagają REA zbudowanego ze źródeł lub wydania zawierającego te zmiany. npm 6.4.0 ich nie zawiera.

W katalogu zbudowanego kodu źródłowego uruchom node scripts/rea.mjs doctor --provider ida --json i node scripts/rea.mjs setup zamiast poniższych poleceń npx.

Przygotuj plik rejestracji IDA

Zainstaluj i skonfiguruj serwer po stronie IDA zgodnie z przewodnikiem poniżej. Następnie zapisz jego działającą rejestrację jako ida-mcp.json w edytorze tekstu. W Windows podczas zapisywania w Notatniku wybierz „Wszystkie pliki”, aby nie dodał .txt.

Dla nadzorcy bez interfejsu graficznego udostępniającego idb_open, idb_list i idb_close plik może wyglądać tak:

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

Dla podłączonego starszego serwera GUI 1.4.0 skopiuj do pliku jego działające wartości command, args i opcjonalnie env. Otwórz oryginalny plik binarny w IDA i uruchom wtyczkę po stronie IDA, zanim poprosisz REA o jego zbadanie.

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

Użyj pliku rejestracji JSON przygotowanego według przewodnika dostawcy, a następnie ponownie uruchom konfigurację i agenta.

Profile IDA, przykłady rejestracji i zweryfikowane platformy

Po połączeniu podaj agentowi pełną ścieżkę do oryginalnego pliku wykonywalnego i nazwę dostawcy analizy:

Użyj REA z dostawcą, którego skonfigurowałem, aby zbadać /absolute/path/to/program. Wymień funkcje i ciągi znaków, a następnie wyjaśnij część obsługującą dane użytkownika, podając odwołania do kodu.

Przejdź przez przykład analizy kodu maszynowego

Witryny, Android, .NET, firmware i inne cele

Otwórz przewodnik dla swojego celu. Każdy podaje dodatkowe narzędzia, obsługiwane hosty i pierwszą komendę.

Cel Narzędzia do przygotowania Przewodnik
JavaScript / Electron Node.js + npm Otwórz przewodnik
Witryna Chrome / Chromium / Edge Otwórz przewodnik
.NET / Flutter / pakiety Node.js + npm Otwórz przewodnik
Android APK JADX + JDK 17+ Otwórz przewodnik
Urządzenie Android adb Otwórz przewodnik
Zasoby Android Apktool + Java Otwórz przewodnik
Projekt JEB JEB + MCP Otwórz przewodnik
Firmware Binwalk / Unblob · Linux Otwórz przewodnik
WASM WABT Otwórz przewodnik
Baza danych SQLite Node.js 24.15+ / 26+ Otwórz przewodnik
Bajtkod EVM Node.js · Linux x64 Otwórz przewodnik
ELF / awaria Linux pwntools / GDB / pwndbg Otwórz przewodnik
HAR / SAZ / mitmproxy Node.js / mitmdump Otwórz przewodnik
PCAP / PCAPNG TShark / capinfos · Linux Otwórz przewodnik
Sygnały logiczne sigrok-cli · Linux Otwórz przewodnik
Zachowanie procesu PTY · Linux / macOS Otwórz przewodnik

Przewodnik po Flutter · Pakiety i zasoby · Bajtkod EVM · Wszystkie przewodniki badania

Używaj REA z terminala

Komendy CLI, instalacja globalna i curl

Analizuj folder aplikacji JavaScript lub Electron lub archiwum ASAR bez uruchamiania aplikacji:

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

Zastąp ścieżkę wyodrębnionym katalogiem aplikacji lub .asar akta. Na Windows ścieżka taka jak "D:/apps/example" działa tutaj.

Gdzie znajdę aplikację .plik asar?

Aplikacje Electron zwykle przechowują go w resources folder:

  • Windows : C:\Users\<you>\AppData\Local\Programs\<App>\resources\app.asar
  • macOS : /Applications/<App>.app/Contents/Resources/app.asar (kliknij aplikację prawym przyciskiem myszy i wybierz Pokaż Zawartość Opakowania)
  • Linux : często /opt/<App>/resources/app.asar

Niektóre aplikacje instalują się gdzie indziej. Wyszukaj w folderze aplikacji app.asar.

Wynik identyfikuje aplikację, pokazuje połączenia między modułami i podaje ich lokalizacje źródłowe. Połączenia REA nie można rozwiązać są oznaczone w wyniku.

Jeśli chcesz mieć stałe rea polecenie w Twojej powłoce:

Zainstaluj CLI
npm install --global rea-agents

Kontynuuj korzystanie z Przewodnika po aplikacjach JavaScript

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

Zastąp main nazwą lub adresem funkcji z listy funkcji celu. Najpierw trzeba skonfigurować Ghidra.

W macOS lub Linux po przygotowaniu Node.js możesz również użyć instalatora przez curl:

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

Postępuj zgodnie ze wskazówkami konfiguracji, aby połączyć agenta. Jeśli się nie pojawią, uruchom rea setup.

Jeśli powłoka nie znajduje rea, użyj ścieżki pliku wykonywalnego wyświetlonej przez instalator. W systemie Linux domyślne polecenie konfiguracji to "$HOME/.local/bin/rea" setup.

Uzyskiwanie pomocy

Jeśli twój agent nie widzi REA

Uruchom ponownie lub podłącz ponownie Klienta po konfiguracji. Sprawdź połączenie REA z doctor; dla Codex :

Wykonaj kontrolę klienta z kroku 3, podając swój identyfikator konfiguracji. W edytorach włącz REA w ustawieniach MCP i zezwól na jego narzędzia w czacie agenta.

Jeśli dostawca wymaga uwagi

Sprawdź dostawcę, którego używasz. Dla Ghidra :

Sprawdź jednego dostawcę
npx -y rea-agents@latest doctor --provider ghidra --json

Raport zawiera nieudaną kontrolę i sugerowany następny krok.

Windows, WSL i ścieżki ze spacjami

Dla klientów i narzędzi analizy Windows używaj Windows PowerShell. Jeśli agent działa w WSL, zainstaluj Node.js i REA w tym środowisku Linux i używaj w nim ścieżek Linux. Dostawcy bez interfejsu graficznego działają na tym samym hoście co REA.

W terminalu umieść cudzysłowy wokół ścieżki zawierającej spacje.

Komenda konfiguracji dla Windows:

Windows PowerShell
npx.cmd rea-agents@latest setup
Zaktualizuj lub usuń REA

Aby odświeżyć połączenie agenta, ponownie wykonaj najnowszą komendę konfiguracji, przejrzyj jej plan i uruchom ponownie klienta.

Terminal
npx rea-agents@latest setup

Jeśli CLI jest zainstalowane globalnie, zaktualizuj je za pomocą rea update. Użyj npx rea-agents@latest uninstall, aby usunąć konfigurację klienta REA i umiejętność.

Szczegóły aktualizacji i usuwania

Top