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)
winget install --exact --id OpenJS.NodeJS.LTS
条件に同意するように求められた場合は、"Y"と入力します。 PowerShellを閉じて、もう一度開き、実行します node -v.
wingetが使えない場合は、Node.jsのインストーラーをダウンロードしてください。
後でnpxを実行した際に、PowerShellが「このシステムではスクリプトの実行が無効になっています」と表示したら、代わりに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. コーディングエージェントを選ぶ
エージェントは、あなたが会話するAIです。REAは、そのAIが使う調査ツールを提供します。以下からクライアントを1つ選び、初めて使う場合は説明を開いてください。
Codex · ChatGPTアカウントで使う
お使いのOSに対応するコマンドで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 · エディターで使う
- お使いのOS用のエディターをインストールして、ログインします。
- 手順1で作ったrea-workフォルダーを開きます。
- エディターのAIチャットを開き、Agentモードを選びます。WindsurfまたはDevin Desktopではエージェントのチャットを開き、VS Codeでは先にGitHub Copilotを設定してください。
Cursorの設定 · Windsurf / Devin Desktopの設定 · VS CodeとCopilotの設定
Claude Code · Claudeアカウントで使う
お使いのOSに対応するコマンドでインストールします。
irm https://claude.ai/install.ps1 | iex
curl -fsSL https://claude.ai/install.sh | bash
ターミナルを開き直し、作業フォルダーに戻ってclaudeを実行します。表示される案内に従ってログインしてください。利用には、対象のClaudeサブスクリプション、または設定済みのAPIアカウントが必要です。
Claude Desktop · デスクトップのチャットで使う
WindowsまたはmacOSにClaude Desktopをインストールし、ログインします。完全に終了してから、Claudeの外で開いたターミナルで次のコマンドを実行してください。
npx rea-agents@latest setup --client claude_desktop
計画を確認して承認し、Claudeを開き直したら、手順3で接続を確認してください。
OpenCode · AIモデルを選ぶ
npm install --global opencode-ai
作業フォルダーでopencodeを実行します。チャットで/connectを使ってモデルのアカウントを接続し、モデルを選んでください。
対応クライアントとセットアップ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サーバーを追加するように頼んでください。
npx -y rea-agents@6.4.0 mcp
3. REAを接続する
このプロンプトをコーディングエージェントに貼り付けてください:
npx rea-agents@latest setup を使って REA をインストールし、このコーディングエージェントに接続してください。まず変更内容を提示し、私が承認してから実行してください。その後、インストールを確認してください。
または自分でセットアップを実行します
npx rea-agents@latest setup
特定のクライアントに接続する場合は、そのセットアップIDを追加します。
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):セッションを終了し、再度開始します。
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です。
サンプルを自分でダウンロードする、または自分のアプリを使う
エージェントがファイルをダウンロードできない場合は、このアーカイブを自分で解凍します。 それへの道を与えてください 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は商用ソフトウェアで、デモには提供元が定めた制限があります。
npx -y rea-agents@latest doctor --provider hopper --json
macOSがオートメーションの許可を求めたら、「システム設定 → プライバシーとセキュリティ → オートメーション」でREAを起動するアプリを許可し、もう一度試してください。
Ghidra · 無料の分析ツールとJavaをインストールする
- Javaコンパイラーを含む64ビットのJDK 21以降をインストールしてください。コンピューターのアーキテクチャに合うパッケージを選びます。
-
リリースのAssets一覧からGhidra 12.1.4をダウンロードし、
ghidra_…_PUBLIC_….zipアーカイブを展開してください。「Source code」ではなく、リリース用のアーカイブを選びます。 -
展開したフォルダーのうち、
ghidraRunまたはghidraRun.batが入っているものを探してください。そのフォルダーをGHIDRA_INSTALL_DIRに指定します。
JDKをダウンロード · Ghidra 12.1.4をダウンロード
Javaを確認します。最初のコマンドに表示されるjava.homeのフォルダーをJAVA_HOMEに指定してください。2つ目のコマンドで、コンパイラーがインストールされているか確認します。
java -XshowSettings:properties -version
javac -version
GhidraをWindowsに接続する
Windows x64では、固定ローカルNTFSドライブ上のネイティブx86/x64 PEアプリとDLLに実験的な読み取り専用対応があります。既存の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
2つのパスをインストールに置き換えてから、セットアップの計画を確認します。
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
これらのコマンドは、同じターミナルセッションで実行してください。パスを設定したらセットアップを再実行し、更新されたクライアント設定を承認して、エージェントを再起動します。
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を提供するヘッドレススーパーバイザーでは、次のようなファイルを使えます。
{
"command": "idalib-mcp",
"args": ["--stdio", "--max-workers", "1"],
"mode": "headless"
}
接続済みの従来型1.4.0 GUIサーバーでは、動作確認済みのcommand、args、任意のenvをファイルにコピーしてください。REAに調査を頼む前に、IDAで元のバイナリーを開き、接続先のプラグインを起動します。
$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を調べてください。関数と文字列を一覧にし、ユーザー入力を処理する部分をコードの参照付きで説明してください。
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 | ガイドを開く |
ターミナルから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
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のクライアントチェックに、お使いのセットアップ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用のセットアップコマンド:
npx.cmd rea-agents@latest setup
REAを更新または削除する
エージェントの接続を更新するには、最新のセットアップコマンドを再実行し、計画を確認して、クライアントを再起動してください。
npx rea-agents@latest setup
グローバルCLIをインストールした場合は、rea updateで更新します。REAのクライアント設定とスキルを削除するには、npx rea-agents@latest uninstallを使ってください。
