REA را تنظیم کنید .

• Windows : منوی Start را باز کنید ، تایپ کنید PowerShell و Enter را فشار دهید.
• macOS: کلیدهای ⌘ Space را بزنید، Terminal را تایپ کنید و Enter بزنید.
• Linux: در بیشتر محیط‌های دسکتاپ کلیدهای Ctrl Alt T را بزنید.

یک دستور را با Ctrl V (macOS : ⌘ V; ترمینال های Linux: Ctrl Shift V), سپس Enter را فشار دهید.

فرمان‌ها را در ترمینال وارد کنید. متن‌هایی با عنوان «دستیار برنامه‌نویسی شما» را در گفت‌وگوی دستیار بفرستید.

ترمینال رو باز کن و چک کن:

node -v
npm -v

اگر node -v مقدار v22.19+، v24.11+ یا v26+ را چاپ کرد، آماده‌اید. اگر نسخه‌ای قدیمی‌تر یا "not recognized" / "command not found" را نشان داد، Node.js 24 LTS را نصب کنید:

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

npx.cmd rea-agents@latest setup

brew install node

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

fnm install 24
fnm use 24
fnm default 24

یک نصب کننده معمولی را ترجیح می دهید ؟ دانلود نسخه LTS از nodejs.org.

در ترمینال پوشه‌ای برای تمرین بسازید و سپس وارد آن شوید:

mkdir rea-work
cd rea-work

این ترمینال را برای مرحلهٔ بعد باز نگه دارید. اگر از قبل پوشهٔ کار دارید، همان را باز کنید.

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 بروید.

نصب Codex و ورود به حساب

1. ویرایشگر مناسب سیستم‌عاملتان را نصب کنید و وارد حساب شوید.
2. پوشهٔ rea-work را که در مرحلهٔ 1 ساختید باز کنید.
3. گفت‌وگوی هوش مصنوعی را باز کنید و حالت Agent را انتخاب کنید. در Windsurf یا Devin Desktop، گفت‌وگوی دستیار را باز کنید؛ در VS Code ابتدا GitHub Copilot را راه‌اندازی کنید.

راه‌اندازی Cursor · راه‌اندازی Windsurf / Devin Desktop · راه‌اندازی VS Code وCopilot

با فرمان مناسب سیستم‌عاملتان نصب کنید:

irm https://claude.ai/install.ps1 | iex

curl -fsSL https://claude.ai/install.sh | bash

ترمینال را دوباره باز کنید، به پوشهٔ کار برگردید و claude را اجرا کنید. مراحل ورود را دنبال کنید. دسترسی به اشتراک واجد شرایط Claude یا حساب API پیکربندی‌شده نیاز دارد.

نصب Claude Code و گزینه‌های حساب

Claude Desktop را در Windows یا macOS نصب کنید و وارد حساب شوید. آن را کاملاً ببندید و این فرمان را در ترمینالی که خارج از Claude باز کرده‌اید اجرا کنید:

npx rea-agents@latest setup --client claude_desktop

طرح را بررسی و تأیید کنید، Claude را دوباره باز کنید و اتصال را در مرحلهٔ 3 بررسی کنید.

دانلود Claude Desktop · جزئیات اتصال Claude Desktop

npm install --global opencode-ai

در پوشهٔ کار opencode را اجرا کنید. در گفت‌وگوی آن از /connect برای اتصال حساب مدل استفاده کنید، سپس یک مدل انتخاب کنید.

نصب OpenCode و راه‌اندازی مدل

نسخهٔ npm 6.4.0 از برنامه‌های زیر پشتیبانی می‌کند. برای انتخاب صریح یک برنامه، شناسهٔ آن را همراه --client به کار ببرید.

Qoder ‏(qoder)، Factory Droid ‏(droid)، Trae ‏(trae)، ZCode ‏(zcode) و DeepSeek Harness ‏(dsh) در شاخهٔ main مخزن موجودند؛ از ساخت از روی منبع یا نسخه‌ای که این یکپارچه‌سازی‌ها را دارد استفاده کنید.

پیکربندی برنامه‌ها و رفع اشکال · دسترسی در نسخه‌ها

npx -y rea-agents@6.4.0 mcp

npx rea-agents@latest setup

برای یک برنامهٔ مشخص، شناسهٔ راه‌اندازی آن را اضافه کنید:

npx rea-agents@latest setup --client codex

اگر npm برای دانلود بسته سؤال کرد، y را وارد کنید و Enter بزنید. در فهرست برنامه‌های REA با کلیدهای جهت جابه‌جا شوید، با Space برنامه‌تان را انتخاب کنید و با Enter ادامه دهید.

برنامه‌های دسکتاپ (Claude Desktop، Cursor، Windsurf، VS Code): برنامه را کاملاً ببندید و دوباره باز کنید. بستن پنجره کافی نیست. در macOS کلیدهای ⌘ Q را بزنید؛ در Windows، اگر نماد سینی سیستم دارد، از آن هم خارج شوید.

عوامل ترمینال (Claude Code ، Codex ، Gemini CLI ): از جلسه خارج شوید و دوباره شروع کنید.

دانلود نمونه زیپ

اگر نماینده شما نمی تواند فایل ها را دانلود کند ، خودتان این آرشیو را باز کنید. راه رو به سمت notes-example پوشه و همان سوال صادرات.

با REA برنامهٔ موجود در /absolute/path/to/app را بررسی کن. پیدا کن چگونه داده‌ها را خروجی می‌دهد و فایل‌ها و خط‌های مرتبط را نشان بده.

یک ابزار تحلیل روی رایانه‌ای که REA را اجرا می‌کند نصب کنید. میزبان، سیستم‌عامل شماست و هدف، برنامه‌ای است که می‌خواهید بررسی کنید.

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

java -XshowSettings:properties -version
javac -version

$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

export GHIDRA_INSTALL_DIR="/absolute/path/to/ghidra_12.1.4_PUBLIC"
export JAVA_HOME="/absolute/path/to/jdk-21"

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

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

$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

پس از اتصال، مسیر کامل فایل اجرایی اصلی را به دستیار بدهید و ابزار تحلیل را مشخص کنید:

با REA و ابزار تحلیلی که تنظیم کرده‌ام، /absolute/path/to/program را بررسی کن. توابع و رشته‌ها را فهرست کن، سپس بخش پردازش ورودی کاربر را با ارجاع به کد توضیح بده.

یک نمونهٔ تحلیل بومی را دنبال کنید

راهنمای هدف خود را باز کنید. هر راهنما ابزارهای اضافی، میزبان‌های پشتیبانی‌شده و فرمان اول را مشخص می‌کند.

راهنمای Flutter · بسته‌ها و منابع · بایت‌کد EVM · همهٔ راهنماهای بررسی

یک پوشه برنامه JavaScript یا Electron یا آرشیو ASAR را بدون اجرای برنامه تجزیه و تحلیل کنید:

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

مسیر را با دایرکتوری برنامه استخراج شده خود جایگزین کنید یا .asar فایل. در Windows ، مسیری مانند "D:/apps/example" اینجا کار میکنه

نتیجه برنامه را شناسایی می کند ، اتصالات بین ماژول ها را نشان می دهد و مکان منبع آنها را می دهد. اتصالات REA نمی تواند حل شود در نتیجه مشخص شده است.

اگر می‌خواهید فرمان rea همیشه در پوستهٔ شما در دسترس باشد:

npm install --global rea-agents

ادامه با راهنمای برنامه JavaScript

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 آن را با doctor بررسی کنید؛ برای Codex:

بررسی برنامه در مرحلهٔ 3 را با شناسهٔ راه‌اندازی‌تان اجرا کنید. در ویرایشگرها، REA را در تنظیمات MCP فعال کنید و در گفت‌وگوی دستیار به ابزارهایش اجازه بدهید.

ارائه دهنده ای که استفاده می کنید را بررسی کنید. برای Ghidra :

npx -y rea-agents@latest doctor --provider ghidra --json

گزارش چک شکست خورده و گام بعدی پیشنهاد شده را ارائه می دهد.

برای برنامه‌ها و ابزارهای تحلیل Windows از Windows PowerShell استفاده کنید. اگر دستیار در WSL اجرا می‌شود، Node.js و REA را در همان محیط Linux نصب کنید و از مسیرهای Linux استفاده کنید. ارائه‌دهنده‌های بدون رابط گرافیکی روی همان میزبان REA اجرا می‌شوند.

در یک ترمینال ، نقل قول ها را در اطراف مسیری قرار دهید که شامل فضاها است.

فرمان راه‌اندازی Windows:

npx.cmd rea-agents@latest setup

برای تازه‌سازی اتصال دستیار، فرمان راه‌اندازی آخرین نسخه را دوباره اجرا کنید، طرح آن را بررسی کنید و برنامهٔ دستیار را دوباره اجرا کنید.

npx rea-agents@latest setup

اگر CLI سراسری را نصب کرده‌اید، آن را با rea update به‌روز کنید. از npx rea-agents@latest uninstall برای حذف پیکربندی برنامه‌ها و مهارت REA استفاده کنید.

جزئیات به‌روزرسانی و حذف