裝好 Node 就能接上:REA 安裝實作,Windows、macOS、Linux 三平台差異與 Claude Code、Codex、Hermes 註冊

目錄
共 13 個章節
先搞清楚要裝的是什麼:REA 是中介層,不是反編譯器
看到 REA,很多人第一個反應是「又一個反編譯器」。不是。反編譯器是把編譯過的程式還原成人看得懂程式碼的工具,像是 Ghidra、IDA、Hopper。REA 本身不做反編譯,它是夾在中間的協調層:幫你挑對工具、下對參數,再把結果整理成統一格式。

架構分三層。最上層是你慣用的 AI coding agent(Claude Code、Codex、Cursor 都算);中間是 REA,同時提供命令列(CLI)與 MCP server 兩種介面,後者是讓 AI 助理直接呼叫外部工具的標準協定;最下層才是 Ghidra、JADX、adb、Apktool 這些既有工具。官方說得很直白:CLI 能做的 MCP 也能做,反之亦然,同一套引擎。
它賣的是證據鏈,不是答案
每完成一次分析,REA 會留下一份結構化證據,把結論拆成 4 種標記:觀察(工具實際看到什麼)、推導(從觀察算出來的)、推論(合理但還沒證明)、未知(明確標示沒查到的部分)。官方原則寫死一句話:失敗與未知永遠不得被聚合成通過。這是它跟「直接叫 AI 猜」最大的差別,也決定了你之後要花多少時間讀輸出。
先看這張表,再決定要不要裝
下表左邊是你要分析的目標,右邊是要先準備什麼。
| 要分析的目標 | REA 回傳什麼 | 要先準備什麼 |
|---|---|---|
| JavaScript / Electron | 模組、import、路由、IPC 與原生外掛關係 | 只要 Node.js 與 npm |
| .NET 組件 | metadata、CIL 指令、原生依賴、版本比較 | 無,純靜態 |
| Android APK | manifest、類別、反編譯方法與引用 | 完整 JDK 加無頭 JADX |
| 原生執行檔 | 虛擬碼、組語、字串、符號 | Ghidra(免費)或 Hopper、IDA |
結論很簡單:要處理網頁前端、Electron 桌面程式或 .NET 組件,裝好 Node.js(22.19 以上或 24.11 以上)就能開工,一毛錢都不用花。真正要另外花錢、花時間設定的,只有原生執行檔那一類。想看它實際做過什麼,官方案例頁有 5 個完整拆解。
安裝前的環境盤點:Node 版本、三個平台基線、Windows 只算實驗性支援
先查 node -v、npm -v、作業系統版本(macOS 用 sw_vers,Linux 用 cat /etc/os-release)與硬碟空間。6.4.0 安裝檔約 11 MB、內含 1161 個檔案,吃空間的是後續分析吐出的證據檔。

Node.js 要 22.19 以上或 24.11 以上,23、25 與所有 prerelease 都不支援。安裝腳本只檢查,不會幫你升級 Node.js、npm、Homebrew 或 Java;版本不對就用 nvm 或 fnm 切換。工作機實測 Node v22.23.3 可完整跑完 JavaScript 靜態分析,Node 20 則直接停下報錯。Android APK 需要完整 JDK,同樣只檢查、不代裝。
原生執行檔分析的基線是 macOS 12 以上、Ubuntu 24.04 以上、Fedora 41 以上、Nobara 44 以上,以及 64 位元的 Arch Linux、CachyOS、Omarchy。台灣團隊常踩的坑是伺服器還停在 Ubuntu 22.04 或 CentOS 系,舊版 glibc 與工具鏈常在載入階段就失敗。
三個平台的實際能力對照
| 平台 | 靜態分析 | 原生執行檔分析 |
|---|---|---|
| macOS 12+ | 可 | Ghidra 或 Hopper |
| Ubuntu 24.04+ / Fedora 41+ | 可 | Ghidra 或 IDA |
| Windows | 可 | 僅 Ghidra,實驗性 P0 |
P0 是官方標記「嚴重度最高」的代號。Windows 原生分析只能接 Ghidra,其他 provider 一律不支援,問題優先處理但不保證穩定;macOS 若目標程式啟用 hardened runtime 又缺 get-task-allow 權限,執行時擷取會直接失敗。只做 JavaScript、Electron 或 .NET 純靜態分析,裝好 Node 就能跑,不需 Ghidra、Hopper、IDA;需付費的只有原生執行檔路線:Ghidra 免費、Hopper 個人授權 99 歐元、Binary Ninja 個人版 199 美元,建議改用 macOS 或 Linux。setup 可在你核准後代裝 Hopper,Ghidra 與 IDA 一律自備。
install.sh 提供 --version、--dry-run、--no-setup、--no-prompt、--verbose 五個選項;第一次安裝建議加 --dry-run:setup 會先列出變更計畫、要求核准(預設答案是 No)並備份既有設定。細節可查官方安裝文件。
npm 套件名稱是 rea-agents,維護者僅 morluto 一人;6.4.0 版沒有 postinstall 腳本,registry 安裝時不會在背景執行任何東西。社群已出現多個冒名儲存庫與打著 REA 名號的加密代幣,官方 README 聲明「沒有發行任何加密貨幣或代幣」。
支援的 coding agent 有 17 個,涵蓋 Claude Code、Codex、Cursor、Gemini CLI、Windsurf、GitHub Copilot CLI、VS Code、Qwen Code、Hermes 等;Grok Bot 因連接器形式不同,要從對話裡加入。6.4.0 的 CHANGELOG 明寫新增 Pi、Hermes 與 Qwen Code 設定支援,Hermes 另支援 active profile。裝完先跑 rea doctor --json 看它列出缺什麼,rea providers --json 與 rea capabilities --json 分別回報可用的分析引擎,與這台機器能處理的目標類型。
實戰:從安裝指令到註冊進 Claude Code、Codex、Hermes
安裝有兩條路,結果一樣,挑順手的就好。手上有 Node.js 就直接打 npx -y rea-agents@latest,不必先裝任何東西;想把設定留在本機,就執行官方的 install.sh。npm 套件名是 rea-agents,2026 年 10 月最新版 6.4.0。它不會順手幫你升級 Node.js 或 Java,環境得自己顧。

Node.js 版本限制先看清楚:只收 22.19 以上、24.11 以上與 26 以上,23 和 25 這兩個奇數版被排除,很多人第一次就卡在這裡。作業系統要 macOS 12 以上或 Ubuntu 24.04 以上;Windows 只支援 Ghidra,官方自己標成實驗性。台灣公司常見的 Ubuntu 22.04 不在清單內,得先升級。
選 client:17 種 coding agent 任你挑:安裝時會跑一次 setup,問你要註冊進哪個 AI coding agent(就是幫你寫程式的 AI 助手)。6.4.0 支援 17 種,包含 Claude Code、Codex、Cursor、Gemini CLI、GitHub Copilot CLI、VS Code 與 Hermes。差別在這裡:Hermes 支援 active-profile,能把 REA 掛成不同情境的設定檔;Grok Bot 的連接器形式不同,要從對話裡手動加入,setup 幫不上忙。setup 會先列變更計畫、要你核准,預設是 No,也會備份原設定,不怕它偷改環境。
環境檢查與第一次分析
註冊完別急著分析,先跑三行自我診斷:rea doctor 看整體環境、rea providers 看有哪些逆向工具可用、rea capabilities 看目前能處理哪些目標類型。三個都加 --json,輸出就能接進腳本或丟給 agent 讀。doctor 出現紅字,通常是 Node.js 版本不對或工具路徑沒設好。
第一次練習挑 JavaScript 或 Electron 應用最省事,只要 Node.js 就能跑,不必買付費工具:npx -y rea-agents@latest analyze-javascript-application /絕對路徑 --json。跑完會吐出一份證據檔,每個結論都標明是觀察、推導、推論還是未知,還附上信心值。
最容易卡住的是檔案太大。官方舉例,Obsidian 的完整證據檔約 334 MB,根本餵不進 agent 的上下文。解法是先存檔再「投影」:把輸出存成檔案,用 jq 包成 summary view,334 MB 會縮到約 10 KB,再用 rea inspect-analysis-view 讀取。原始證據留著,要細節時回頭查,這一招直接解掉最常見的實務障礙,大檔也不會塞爆你的對話視窗。
替代方案有限公司觀點:裝得起來,跟該不該用在你手上的檔案是兩件事
我們的測試機是 Linux Mint 22.3(Ubuntu 24.04 基底)、Node v22.23.3。跑 JavaScript 與 Electron 靜態分析一路順暢,不需付費工具;換到原生執行檔那一類,就得先確認機器落在哪條官方基線,Ubuntu 22.04、CentOS 系列都不在支援清單內。這點我們在客戶端踩過,安裝跑得完,分析階段才發現引擎叫不起來。

官方自己列的限制(見官方安全說明),我們實測後大致同意。它不是沙箱,執行捕捉會用你的使用者權限真的把目標程式跑起來;分析結果會離開你的機器,進到 agent 背後的模型供應商;能模仿外部行為,推不出內部的快取策略或衝突解決邏輯。
我們內部的判斷順序,以及不建議丟進去的檔案
我們的順序是:先問有沒有權利分析,再問資料敏感度,接著看目標類型,才談要不要花錢買工具。目標類型排後面,是因為 JavaScript、Electron、.NET 這三類裝好 Node 就能跑,真正需要付費引擎的只有原生執行檔。
- 沒有取得授權的第三方商用軟體,我們一律不做
- 含客戶個資、金鑰的檔案,除非先確認模型供應商的資料處理條款
- 你沒有維護權或原始碼的系統,分析結果無法落地成修正
- Windows 原生分析官方仍標示實驗性,我們不擺進正式流程
台灣團隊的落地建議:先開一台獨立虛擬機或容器當分析環境,別在日常工作機上跑;Node 記得升到 22.19 或 24.11 以上,23 與 25 版不支援;把 JavaScript 與 Electron 當練手題,熟悉證據鏈長相之後再碰原生。
說句誠實話。對已經有逆向方法論的人,REA 的價值是省下工具串接與整理證據的時間,不是能力躍升。我們建議把它當成「證據整理加速器」,而不是「什麼都解得開的黑盒子」;先想清楚要拿它回答哪個具體問題,再決定要不要裝。
台灣團隊用得到的三種場景,與各自要付的成本
台灣團隊會想裝 REA,通常不是為了學逆向工程,而是手上突然多了一個沒人能解釋的執行檔。最常見的三種狀況:客戶交付的舊系統沒有原始碼,得先摸清介面才敢接手;離職同事留下的軟體沒有文件,只能靠觀察行為把規格補回來;資安稽核被問「這支程式到底連去哪裡」,需要一份有憑有據的紀錄。這些要的不是破解,而是講得清楚、附得上證據的答案。
而這三種場景多半不用花錢。REA 支援 15 類分析目標,其中 JavaScript、Electron 與 .NET 不必額外付費工具,裝好 Node.js 就能跑;需要掏錢或花時間設定的是原生執行檔路線,因為它得接上 Ghidra、Hopper 或 IDA 這類反編譯引擎。
三種場景對上三條路線
| 你的情境 | 建議路線 | 額外成本 |
|---|---|---|
| 客戶舊系統沒原始碼 | 原生執行檔分析,接 Ghidra | 免費,但要看得懂虛擬碼 |
| 交接軟體沒文件、要補規格 | JavaScript、Electron 或 .NET 靜態分析 | 免費,Node.js 就能跑 |
| 稽核要確認程式連去哪裡 | 網路封包紀錄加程序行為觀察 | 免費,但得實際跑一次 |
付費選項也有:Hopper 個人授權 99 歐元、Binary Ninja 個人版 199 美元(2026 年官網價格),買的其實是介面與時間。
環境先過關,Ubuntu 22.04 得先升級
容易被忽略的是環境門檻。REA 的原生分析基線是 macOS 12 以上、Ubuntu 24.04 以上,Windows 只支援 Ghidra 且標示實驗性。台灣機房常見的 Ubuntu 22.04 不在名單內,想跑原生分析得先升級系統;Node.js 也要 22.19 或 24.11 以上,23 與 25 版不支援,細節寫在官方安裝文件。
稽核那個場景還要多一句提醒。官方安全說明寫得很白:這不是沙箱,行為捕捉會用你的使用者權限,真的把目標程式跑起來。別在存放機密的日常機器上做,開一台乾淨的虛擬機比較安心。
常見問題 FAQ
Q:我只是想試試看,需要先花錢買 Hopper 或 IDA 嗎?
不用。文章裡講得很清楚,JavaScript、Electron、.NET 這三類完全不需要額外付費工具,裝好 Node 就能跑。REA 自己是 MIT 授權的開源專案,npm 套件名稱是 rea-agents,用 npx 就能做靜態分析。真正要花錢的只有原生執行檔那一類,可以搭 Ghidra(免費開源)、Hopper(個人版 99 歐元)、IDA 或 Binary Ninja(個人版 199 美元)。Ghidra 免費但 REA 不代裝,要自己準備;Hopper 則可以在 setup 流程代裝,但只在你按下核准之後才動作。所以最省的入門路線是:先裝 Node,拿 JavaScript 或 .NET 的程式練手,真的需要碰原生二進位再來考慮付費工具。
Q:分析過程的資料會不會傳出去?在公司電腦上跑安全嗎?
老實說,不會完全不出門。官方 SECURITY.md 明講這不是沙箱,也不防禦已經在你帳號下執行的惡意程式;執行時捕捉會用你的使用者權限真的去跑目標程式。而且官方也寫明,分析結果會進到 agent 的模型供應商,不是完全留在本機。白話講就是:分析本身在本機跑,但整理出來的證據會交給 AI coding agent,再送到你選的模型供應商。所以牽涉敏感資料時要自己評估,另外深度調查很吃 token,成本得另外算,不是裝完就零花費。
Q:我的電腦是 Windows,可以裝嗎?跟 macOS、Linux 差在哪?
Windows 目前只支援 Ghidra,而且官方標示為實驗性 P0,意思是還在早期階段、能玩的範圍有限。支援比較完整的是 macOS 12 以上、Ubuntu 24.04 以上、Fedora 41 以上這類基線;台灣公司常見的 Ubuntu 22.04 或 CentOS 系並不在官方支援清單裡,這點要先確認。另外 Node.js 版本有硬規定:要 22.19 以上或 24.11 以上,Node 23、25 以及所有 prerelease 都不支援。官方的安裝腳本不會順手幫你升級 Node.js、npm、Homebrew 或 Java,裝之前版本要自己先看好。
📩 有任何問題或需要協助,歡迎聯絡我們:[email protected]
Related





