REAをセットアップします。

コンピューターとコーディングエージェントを準備し、REAを接続して、小さなアプリを調べましょう。

初めての方は、以下の4つの手順を進めてください。すでにエージェントを使っている方は、REAを接続するに進めます。

1. コンピューターを準備する

調べたいファイルが保存されているコンピューターを使ってください。ローカルで動くコーディングエージェントは、そのファイルを読み、ツールを実行できます。

ターミナルを開くにはどうすればよいですか?
  • Windows : スタートメニューを開き、次のように入力します PowerShell Enterキーを押します。
  • macOS : プレス ⌘ Space、タイプ ターミナル Enterキーを押します。
  • Linux : プレス Ctrl Alt T ほとんどのデスクトップで。

でコマンドを貼り付ける Ctrl V (macOS : ⌘ V;Linux端子: Ctrl Shift V)を押し、Enterキーを押します。

コマンドはターミナルに入力します。「あなたのコーディングエージェント」と書かれたプロンプトは、エージェントのチャットに入力します。

あなたが必要になります Node.js 22 (22.19+), 24 (24.11+) または26+。 npmはと来ます Node.js.

持っていない Node.js、またはわからない?

ターミナルを開いて確認してください:

ターミナル
node -v
npm -v

もし node -v 印刷v22.19+、v24.11+またはv26+、準備が整いました。 古いバージョンまたは"認識されません"/"コマンドが見つかりません"を印刷する場合は、インストールします Node.js 24LTS:

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

条件に同意するように求められた場合は、"Y"と入力します。 PowerShellを閉じて、もう一度開き、実行します node -v.

wingetが使えない場合は、Node.jsのインストーラーをダウンロードしてください。

後でnpxを実行した際に、PowerShellが「このシステムではスクリプトの実行が無効になっています」と表示したら、代わりに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. コーディングエージェントを選ぶ

エージェントは、あなたが会話するAIです。REAは、そのAIが使う調査ツールを提供します。以下からクライアントを1つ選び、初めて使う場合は説明を開いてください。

Codex · ChatGPTアカウントで使う

お使いのOSに対応するコマンドで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. お使いのOS用のエディターをインストールして、ログインします。
  2. 手順1で作ったrea-workフォルダーを開きます。
  3. エディターのAIチャットを開き、Agentモードを選びます。WindsurfまたはDevin Desktopではエージェントのチャットを開き、VS Codeでは先にGitHub Copilotを設定してください。

Cursorの設定 · Windsurf / Devin Desktopの設定 · VS CodeとCopilotの設定

Claude Code · Claudeアカウントで使う

お使いのOSに対応するコマンドでインストールします。

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 · デスクトップのチャットで使う

WindowsまたはmacOSにClaude Desktopをインストールし、ログインします。完全に終了してから、Claudeの外で開いたターミナルで次のコマンドを実行してください。

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

計画を確認して承認し、Claudeを開き直したら、手順3で接続を確認してください。

Claude Desktopをダウンロード · Claude Desktopの接続方法

OpenCode · AIモデルを選ぶ
Terminal
npm install --global opencode-ai

作業フォルダーでopencodeを実行します。チャットで/connectを使ってモデルのアカウントを接続し、モデルを選んでください。

OpenCodeのインストールとモデル設定

対応クライアントとセットアップIDの一覧

npmの6.4.0リリースは、以下のクライアントに対応しています。クライアントを指定する場合は、--clientにこのIDを渡してください。

クライアント セットアップID
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 · Botが動くコンピューターで接続する

Grok Botのチャットで、Botのコンピューター上で以下のコマンドを使い、reaという名前のカスタムMCPサーバーを追加するように頼んでください。

Grok Bot
npx -y rea-agents@6.4.0 mcp

Grok Botのコネクター設定手順

3. REAを接続する

このプロンプトをコーディングエージェントに貼り付けてください:

あなたのコーディングエージェント

npx rea-agents@latest setup を使って REA をインストールし、このコーディングエージェントに接続してください。まず変更内容を提示し、私が承認してから実行してください。その後、インストールを確認してください。

または自分でセットアップを実行します
Terminal
npx rea-agents@latest setup

特定のクライアントに接続する場合は、そのセットアップIDを追加します。

Terminal
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):セッションを終了し、再度開始します。

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

codexを、お使いのクライアントのセットアップIDに置き換えてください。チェックが成功すると"healthy": trueが表示されます。その後、エージェントに次のように頼んでください。

REAが接続されているか確認し、使えるREAツールを教えてください。

4. 初めての調査を試す

この例では、6つのファイルElectronアプリを使用しています。 ノートのエクスポート ボタン。 エージェントは、Electronをインストールまたは起動せずにコードを検査できます。

あなたのコーディングエージェント

https://rea.tools/examples/notes-example.zip を新しいサンプル用フォルダーにダウンロードして展開してください。REAを使い、Export notesをクリックすると何が起きるかを調べてください。notes.csv がどこに書き込まれ、どのフィールドを含むか、関連するファイルと行を示してください。

ファイルと行の参照に関する簡単な説明を探してください:

ボタンはnotes:exportメッセージを送ります。メインプロセスはメモをCSV形式に変換し、ユーザーのダウンロードフォルダーにnotes.csvを保存します。列はidとtitleです。

ガイド付きの練習で予測を確かめる →

サンプルを自分でダウンロードする、または自分のアプリを使う

ダウンロード例ZIP

エージェントがファイルをダウンロードできない場合は、このアーカイブを自分で解凍します。 それへの道を与えてください notes-example フォルダと同じエクスポートの質問。

REAで/absolute/path/to/appにあるアプリを調べてください。データをどうエクスポートするかを探し、関連するファイルと行を示してください。

フォルダのフルパスを取得するにはどうすればよいですか?
  • Windows : ファイルエクスプローラーで、フォルダーを右クリックして、次を選択します パスとしてコピー. Windows10で、Shiftキーを押しながら右クリックします。
  • macOS : Finderで、フォルダを右クリックし、オプションを押したまま、を選択します パス名として"..."をコピーします.
  • 任意のシステム: フォルダをターミナルウィンドウにドラッグすると、そのパスが表示されます。

ターミナルでは、スペースを含むパスの周りに引用符を付けます。

別の種類のソフトウェアを分析する

調べたい対象の項目を選んでください。分析プロバイダーとは、その種類のソフトウェアを調べるためにREAが使うローカルの分析ツールです。

ネイティブ実行ファイルとライブラリー · Hopper、Ghidra、IDA

REAを実行するコンピューターに、分析ツールを1つインストールしてください。ホストはお使いのOS、対象は調べたいプログラムです。

分析プロバイダー Windows macOS Linux
Hopper 利用不可 12+ 対応ディストリビューション
Ghidra x64 · 実験的対応 x64 / arm64 x64 / arm64
IDA 検証済みの構成 検証済みのヘッドレス構成 プロバイダーガイドを参照
Hopper · セットアップでインストールまたは接続する

HopperをmacOSまたはLinuxに接続します。 上記のsetupコマンドを実行します。既存のインストールを検出するか、承認のためのインストール計画を提供します。

セットアップで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. Javaコンパイラーを含む64ビットのJDK 21以降をインストールしてください。コンピューターのアーキテクチャに合うパッケージを選びます。
  2. リリースのAssets一覧からGhidra 12.1.4をダウンロードし、ghidra_…_PUBLIC_….zipアーカイブを展開してください。「Source code」ではなく、リリース用のアーカイブを選びます。
  3. 展開したフォルダーのうち、ghidraRunまたはghidraRun.batが入っているものを探してください。そのフォルダーをGHIDRA_INSTALL_DIRに指定します。

JDKをダウンロード · Ghidra 12.1.4をダウンロード

Javaを確認します。最初のコマンドに表示されるjava.homeのフォルダーをJAVA_HOMEに指定してください。2つ目のコマンドで、コンパイラーがインストールされているか確認します。

Terminal
java -XshowSettings:properties -version
javac -version
GhidraをWindowsに接続する

Windows x64では、固定ローカルNTFSドライブ上のネイティブx86/x64 PEアプリとDLLに実験的な読み取り専用対応があります。既存の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

2つのパスをインストールに置き換えてから、セットアップの計画を確認します。

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の設定とアーキテクチャ要件 · Windows向けGhidraガイド

IDA · 既存のインストールを接続する

IDAプロバイダーガイドに従い、接続先MCPサーバーの登録設定を用意してください。元のバイナリーを開いたGUIに接続するか、専用のデータベースを開くヘッドレススーパーバイザーを選びます。

検証済みの構成には、Windowsの従来型GUIとヘッドレススーパーバイザー、およびIDA Professional 9.1を使うmacOS arm64のヘッドレススーパーバイザーがあります。任意のネイティブGUIブリッジには、独自のバージョンとプラットフォーム要件があります。

macOSのヘッドレス構成とネイティブGUIブリッジには、REAのソースビルド、またはこれらの変更を含むリリースが必要です。npmの6.4.0には含まれていません。

ビルド済みのソースディレクトリで、下のnpxコマンドの代わりにnode scripts/rea.mjs doctor --provider ida --jsonとnode scripts/rea.mjs setupを実行してください。

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"
}

接続済みの従来型1.4.0 GUIサーバーでは、動作確認済みのcommand、args、任意のenvをファイルにコピーしてください。REAに調査を頼む前に、IDAで元のバイナリーを開き、接続先のプラグインを起動します。

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を調べてください。関数と文字列を一覧にし、ユーザー入力を処理する部分をコードの参照付きで説明してください。

ネイティブ分析の例を進める

Webサイト、Android、.NET、ファームウェアなど

お持ちの対象に対応するガイドを開いてください。各ガイドで、追加のツール、対応ホスト、最初のコマンドを説明しています。

対象 準備するツール ガイド
JavaScript / Electron Node.js + npm ガイドを開く
Webサイト 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のクライアントチェックに、お使いのセットアップIDを指定してください。エディター型のクライアントでは、MCP設定でREAを有効にし、エージェントのチャットでツールの使用を許可します。

プロバイダが注意を必要とする場合

使用しているプロバイダーを確認してください。 Ghidraのため :

一つのプロバイダを確認してください
npx -y rea-agents@latest doctor --provider ghidra --json

レポートには、失敗したチェックと推奨される次のステップが表示されます。

Windows、WSL、スペースを含むパス

Windowsのクライアントや分析ツールにはWindows PowerShellを使ってください。エージェントがWSL内で動く場合は、そのLinux環境内にNode.jsとREAをインストールし、Linuxのパスを使います。ヘッドレスプロバイダーはREAと同じホストで動作します。

ターミナルでは、スペースを含むパスの周りに引用符を付けます。

Windows用のセットアップコマンド:

Windows PowerShell
npx.cmd rea-agents@latest setup
REAを更新または削除する

エージェントの接続を更新するには、最新のセットアップコマンドを再実行し、計画を確認して、クライアントを再起動してください。

Terminal
npx rea-agents@latest setup

グローバルCLIをインストールした場合は、rea updateで更新します。REAのクライアント設定とスキルを削除するには、npx rea-agents@latest uninstallを使ってください。

更新とアンインストールの詳細

トップ