REA 使い方教本
（高校生向け）

こんにちは。この教本では「REA（レア）」というツールの使い方を、なるべくやさしい言葉で説明していきます。

パソコンにちょっと詳しい人も、「ターミナルって聞いたことはあるけど…」という人も大丈夫。順番に読んで、手を動かしてもらえれば最後には自分で使えるようになっています。肩の力を抜いていきましょう。

1REAってなに？

ひとことで言うと、REAはAIがプログラムの中身を調べるときに使う「道具箱」です。

最近は、Cursor や Claude Code、Codex のように、コードを読んだり書いたりしてくれるAIがあります。こういうAIを「コーディングエージェント」と呼びます。REAはこのエージェントにつないで使います。

たとえ話をしてみますね。わからない問題があって、頭のいい家庭教師に質問したとします。いい先生なら「たぶんこうだよ」で終わらせず、教科書を開いて「ほら、ここの何ページに書いてあるでしょ」と指さしてくれますよね。

REAがやるのはまさにそれです。アプリやゲーム、Webサイトといったプログラムを「教科書」だとすると、AIがその教科書を開いて、答えが書いてあるページ（どのファイルの何行目か）を見せてくれる。だからAIの答えに根拠（証拠）がつくんです。

それから、分析はあなたのパソコンの中（ローカル）で動きます。

2できること・できないこと

道具は、得意なことと苦手なことを知っておくとぐっと使いやすくなります。

3つ目、けっこう大事です。REAはあくまで調べものの相棒なので、出てきた答えを自分でも読んで「なるほど」と思えるところまで行くと、本当の力になりますよ。

★使う前の約束ごと

怖い話をしたいわけじゃないんです。図書館の本を借りるときにルールがあるのと同じで、気持ちよく使うための約束だと思ってください。

調べていいのは、こんなもの

• 自分で作ったアプリ
• オープンソースのプロジェクト（中身の公開が認められているもの）
• 公式が用意しているサンプルアプリ
• 学習用の教材

やってはいけないこと

• 他人の秘密（パスワードや個人情報など）を盗み出す
• 許可されていないシステムに入り込む
• 自分のものではないソフトの、有料機能の保護を外す
• 他の人やサービスを攻撃する

迷ったら「これ、作った人に見せても胸を張れるかな？」と自分に聞いてみてください。それで答えが出ることがほとんどです。

3準備するもの

そろえるものは4つだけです。

4セットアップ4ステップ（公式どおり）

ここからは実際に手を動かしていきます。公式サイトの手順に沿って進めるので、安心してついてきてください。

ステップ1：パソコンを準備する

まずはターミナルを開きましょう。開き方はOSによって少し違います。

• Windows：スタートメニューで「PowerShell」と入力して Enter
• macOS：⌘ + Space を押して「ターミナル」と入力して Enter
• Linux：たいていのデスクトップでは Ctrl + Alt + T

開けたら、Node.js が入っているか確認します。次の2行を打ってみてください。

node -v
npm -v

node -v の結果が v22.23.4以上、v24.22.1以上、v26.12.1以上のどれかなら準備OKです。古いバージョンが出たり、「認識されません」「command not found」と言われたりしたら、Node.js 24 LTS を入れましょう。

Windows なら PowerShell でこれを実行します。

winget install --exact --id OpenJS.NodeJS.LTS

途中で同意を求められたら「Y」と入力。終わったら PowerShell をいったん閉じて開き直し、もう一度 node -v で確かめてください。macOS の人は公式サイトから Node.js 24 LTS のインストーラーを入れるのがわかりやすいです（Linux の手順も公式ページに載っています）。

npx.cmd rea-agents@latest setup

最後に、練習用のフォルダーを作ってその中に移動しておきます。

mkdir rea-work
cd rea-work

このターミナルは次でも使うので、開いたままにしておいてくださいね。

ステップ2：コーディングエージェントを選ぶ

エージェントは、あなたが実際に話しかけるAIのことです。REAはそのAIに「調べるための道具」を渡す役なんですね。代表的なものを挙げておきます。

インストールやログインのやり方はエージェントごとに違うので、公式のはじめにページで自分が選んだものの説明を見てください。

ステップ3：REAを接続する

やり方は2通りあります。好きなほうでどうぞ。

やり方A：エージェントにお願いする。次の文章をそのままエージェントのチャットに貼り付けます。

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

やり方B：自分でターミナルに打つ。

npx rea-agents@latest setup

つなぐ相手が決まっているなら、--client をつけて指定できます。Cursor ならこうです。

npx rea-agents@latest setup --client cursor

Codex なら codex、Claude Code なら claude_code を入れます。ほかの名前は公式ページの一覧で確認してください。

実行すると、まず「こう変更しますよ」という計画（プラン）が表示されます。中身を見て、よければ承認しましょう。パッケージのダウンロードを聞かれたら y を押して Enter。クライアントの一覧では、矢印キーで動いて、Space で選んで、Enter で次に進みます。

再起動したら、ちゃんとつながったか健康診断（doctor）をしてみましょう。

npx -y rea-agents@latest doctor --client cursor --json

cursor の部分は自分のエージェントの名前に変えてください。"healthy": true と出ていれば合格です。仕上げに、エージェントにこう聞いてみてください。

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

ステップ4：はじめての調査

つながったら、公式のサンプルで練習してみましょう。次の章でくわしく説明します。

5はじめての練習（公式サンプル）

練習に使うのは、公式が用意してくれている小さなメモアプリです。6つのファイルでできた Electron アプリで、「Export notes（メモを書き出す）」というボタンがついています。アプリを起動しなくても、コードを読むだけで調べられますよ。

サンプルはここからダウンロードできます：
https://rea.tools/examples/notes-example.zip

エージェントにダウンロードと展開（zipの解凍）まで頼んでもいいですし、自分で解凍してもかまいません。エージェントへの頼み方はこんな感じです。

https://rea.tools/examples/notes-example.zip を新しいサンプル用フォルダーにダウンロードして展開してください。REAを使い、Export notes を押すと何が起きるかを調べてください。notes.csv がどこに保存され、どんな列があるか、関連するファイルと行を示してください。

うまくいくと、だいたいこんな答えが返ってきます（言い方は毎回少し違います）。

ボタンは notes:export というメッセージを送ります。それを受け取ったメインプロセスがメモを CSV 形式にして、ユーザーのダウンロードフォルダーに notes.csv を保存します。列は id と title です。

ここで見てほしいのは、答えに「どのファイルの何行目か」がちゃんとついているかどうかです。ついていたら、実際にそのファイルを開いて確かめてみてください。「本当に書いてある！」という体験が、いちばんの勉強になります。

6上手な頼み方

AIへの頼み方しだいで、答えの質はけっこう変わります。先生に質問するときと同じで、聞き方がうまいと答えもわかりやすくなるんです。ポイントは4つ。

1. 1回に1つの機能だけ聞く。「保存のしくみ」と「ログイン」と「画面の色」をまとめて聞くと、どれも中途半端になりがちです。
2. フォルダーの場所をフルパスで伝える。「あのアプリ」じゃなくて「/Users/あなた/rea-work/notes-example」のように書きましょう。
3. 証拠を出してもらう。「関連するファイルと行を示して」と一言そえるだけで、答えの信頼度がぐんと上がります。
4. 「事実」「推測」「わからないこと」を分けてもらう。コードで確認できたことと、AIの予想とを混ぜないためです。

7ターミナルでも使える

REAはエージェント経由だけでなく、ターミナルから直接動かすこともできます。たとえば JavaScript や Electron のアプリのフォルダー（または .asar ファイル）を、アプリを起動せずに分析するならこうです。

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

/absolute/path/to/app のところを、調べたいアプリのフルパスに書きかえてください。結果には、アプリの情報やモジュール同士のつながり、ソースの場所が出てきます。REAが解決しきれなかったつながりには、ちゃんと印がついています。

毎回 npx と打つのが面倒なら、rea コマンドとしてパソコンに入れておくこともできます。

npm install --global rea-agents
rea --help
rea update

rea --help で使い方の一覧が見られて、rea update で新しい版に更新できます。

8調べられるものの種類（ざっくり）

REAはいろいろな種類のソフトに対応しています。ここでは全体像だけつかんでおきましょう。

9困ったときは

うまくいかなくても大丈夫。よくあるつまずきと、その直し方をまとめておきます。

10コピー用プロンプト集

そのまま貼って使える文章を置いておきます。右上の「コピー」ボタンが使えないときは、選択してコピーしてください。

① REAをセットアップしてもらう

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

② はじめてのサンプル調査

https://rea.tools/examples/notes-example.zip を新しいサンプル用フォルダーにダウンロードして展開してください。REAを使い、Export notes を押すと何が起きるかを調べてください。notes.csv がどこに保存され、どんな列があるか、関連するファイルと行を示してください。

③ ある機能を証拠つきで調べてもらう（ひな形）

REAで「［調べたいアプリのフルパス］」にあるアプリを調べてください。
知りたいのは「［1つの機能。例：保存ボタンを押したときの動き］」です。
関連するファイルと行を示しながら説明してください。
答えは「コードで確認できた事実」「推測」「わからないこと」に分けて書いてください。
※これは自分が調べる許可を持っているアプリです。

◆公式サイトへのリンク

もっと知りたくなったら、公式サイトをのぞいてみてください。

• REA 公式サイト：https://rea.tools/ja/
• はじめに（セットアップ）：https://rea.tools/ja/get-started/

ここまで読んでくれてありがとう。まずはサンプルで「ファイルの何行目に答えがあった！」を体験してみてください。それができたら、もう立派なREAユーザーです。