Configure REA .

Prepara tu ordenador y tu agente de programación, conecta REA y después investiga una pequeña aplicación.

¿Es tu primera vez? Sigue los cuatro pasos de abajo. ¿Ya tienes un agente? Ve directamente a Conectar REA.

1. Prepara tu ordenador

Usa el ordenador donde están los archivos que quieres investigar. Un agente de programación local puede leer esos archivos y ejecutar herramientas por ti.

¿Cómo abro una terminal?
  • Windows : abra el menú Inicio, escriba PowerShell y presione Entrar.
  • macOS: pulsa ⌘ Space, escribe Terminal y pulsa Enter.
  • Linux: pulsa Ctrl Alt T en la mayoría de los escritorios.

Pegue un comando con Ctrl V ( macOS : ⌘ V; Terminales Linux: Ctrl Shift V), luego presione Entrar.

Los comandos se introducen en la terminal. Las instrucciones etiquetadas como «Tu agente de programación» se escriben en el chat del agente.

Necesitarás Node.js 22 (22.19+), 24 (24.11+) o 26+. npm viene con Node.js.

No tengo Node.js, ¿ o no estás seguro?

Abra una terminal y verifique:

Terminal
node -v
npm -v

Si node -v muestra v22.19+, v24.11+ o v26+, ya puedes continuar. Si muestra una versión anterior o "not recognized" / "command not found", instala Node.js 24 LTS:

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

Escriba Y si se le pide que acepte los términos. Cierre PowerShell, ábralo nuevamente y luego ejecute node -v.

Descarga el instalador de Node.js si winget no está disponible.

Si más adelante PowerShell muestra "running scripts is disabled on this system" al ejecutar npx, usa npx.cmd en su lugar. Para npm, usa npm.cmd:

Windows PowerShell
npx.cmd rea-agents@latest setup
macOS

Para una primera instalación, descarga el instalador de Node.js 24 LTS para macOS (.pkg), ábrelo y sigue sus instrucciones. Después, vuelve a abrir Terminal.

¿Ya usas Homebrew?
macOS · Homebrew
brew install node
Linux

Instala primero curl y unzip si faltan. En Debian o Ubuntu, ejecuta sudo apt install curl unzip; en otras distribuciones, usa tu gestor de paquetes.

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

Cierra la terminal, ábrela de nuevo y después ejecuta:

Linux
fnm install 24
fnm use 24
fnm default 24

Tu propia distribución nodejs el paquete suele ser anterior a 22.19, así que verifique node -v si lo usas en su lugar.

¿Prefiere un instalador regular? Descargue la versión LTS desde nodejs.org.

Crea una carpeta de trabajo para tu agente

En la terminal, crea una carpeta para el ejercicio y entra en ella:

Terminal
mkdir rea-work
cd rea-work

Mantén esta terminal abierta para el siguiente paso. Si ya tienes una carpeta de trabajo, abre esa en su lugar.

2. Elige un agente de programación

Tu agente es la IA con la que hablas. REA le proporciona las herramientas de inspección. Elige una aplicación cliente de la lista y abre sus instrucciones si nunca la has usado.

Codex · usa tu cuenta de ChatGPT

Instala Codex con el comando de tu sistema operativo:

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

Tras la instalación, vuelve a abrir la terminal y entra en la carpeta de trabajo. Después, inicia Codex:

Terminal
codex

Elige «Sign in with ChatGPT», inicia sesión en el navegador y vuelve a la terminal. Cuando aparezca el cuadro de mensajes, continúa con el paso 3.

Instalación e inicio de sesión de Codex

Cursor, Windsurf o VS Code · usa un editor
  1. Instala el editor para tu sistema operativo e inicia sesión.
  2. Abre la carpeta rea-work que creaste en el paso 1.
  3. Abre el chat de IA y elige el modo Agent. En Windsurf o Devin Desktop, abre el chat del agente; en VS Code, configura primero GitHub Copilot.

Configuración de Cursor · Configuración de Windsurf / Devin Desktop · Configuración de VS Code y Copilot

Claude Code · usa tu cuenta de Claude

Instala con el comando de tu sistema operativo:

Windows PowerShell
irm https://claude.ai/install.ps1 | iex
macOS / Linux
curl -fsSL https://claude.ai/install.sh | bash

Vuelve a abrir la terminal, entra en tu carpeta de trabajo y ejecuta claude. Sigue las instrucciones de inicio de sesión. Para acceder necesitas una suscripción de Claude compatible o una cuenta de API configurada.

Instalación de Claude Code y opciones de cuenta

Claude Desktop · usa un chat de escritorio

Instala Claude Desktop en Windows o macOS e inicia sesión. Ciérralo por completo y después ejecuta este comando en una terminal que hayas abierto fuera de Claude:

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

Revisa y aprueba el plan, vuelve a abrir Claude y comprueba la conexión en el paso 3.

Descargar Claude Desktop · Detalles de conexión de Claude Desktop

OpenCode · elige un modelo de IA
Terminal
npm install --global opencode-ai

Ejecuta opencode en tu carpeta de trabajo. Usa /connect en su chat para conectar tu cuenta de modelos y después elige un modelo.

Instalación de OpenCode y configuración de modelos

Todos los clientes compatibles y sus identificadores de configuración

La versión 6.4.0 de npm admite los clientes de abajo. Usa el identificador con --client cuando quieras elegir un cliente de forma explícita.

Cliente ID de configuración
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) y DeepSeek Harness (dsh) están disponibles en la rama main del repositorio. Usa una compilación del código fuente o una versión publicada que incluya esas integraciones.

Configuración de clientes y solución de problemas · Disponibilidad en versiones publicadas

Grok Bot · conecta en su ordenador alojado

En el chat de Grok Bot, pídele que añada un servidor MCP personalizado llamado rea ejecutando este comando en el ordenador del bot:

Grok Bot
npx -y rea-agents@6.4.0 mcp

Instrucciones del conector de Grok Bot

3. Conecta REA

Copia este prompt en tu agente de programación:

Tu agente de programación

Instala REA y conéctalo a este agente de programación usando npx rea-agents@latest setup. Muéstrame los cambios propuestos y espera mi aprobación antes de aplicarlos. Después, verifica la instalación.

O ejecute la configuración usted mismo
Terminal
npx rea-agents@latest setup

Para un cliente concreto, añade su identificador de configuración:

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

Si npm pide descargar el paquete, escribe y y pulsa Enter. En la lista de clientes de REA, usa las flechas para moverte, Espacio para seleccionar tu cliente y Enter para continuar.

Elija su cliente y revise el plan de configuración. REA agrega su conexión MCP y la habilidad de investigación correspondiente, manteniendo una copia de seguridad de la configuración existente. Pregunta antes de aplicar los cambios.

MCP es la conexión que permite a tu agente llamar a REA. La skill le proporciona un flujo de trabajo para investigar software.

Para el primer ejercicio puedes omitir la instalación opcional de Hopper. Reinicia tu cliente cuando termine la configuración.

¿Cómo reinicio mi cliente?

Aplicaciones de escritorio (Escritorio Claude, Cursor , Windsurf , VS Code): salga de la aplicación por completo y luego ábrala nuevamente. Cerrar la ventana no es suficiente. En prensa macOS ⌘ Q; en Windows, también salga del icono de la bandeja, si lo hay.

Agentes terminales ( Claude Code, Codex, Gemini CLI ): salga de la sesión y vuelva a iniciarla.

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

Sustituye codex por el identificador de configuración de tu cliente. Una comprobación correcta muestra "healthy": true. Después, pide a tu agente:

Comprueba que REA está conectado y muéstrame qué herramientas de REA puedes usar.

4. Prueba tu primera investigación

El ejemplo es una aplicación Electron de seis archivos con un Notas de exportación botón. Su agente puede inspeccionar su código sin instalar ni iniciar Electron .

Tu agente de programación

Descargar https://rea.tools/examples/notes-example.zip en una nueva carpeta de ejemplo y descomprímala. Use REA para averiguar qué sucede cuando hago clic en Exportar notas. Mostrar dónde notes.csv está escrito, qué campos contiene y los archivos y líneas relevantes.

Busque una breve explicación con referencias de archivos y líneas:

El botón envía un notes:export mensaje. El proceso principal formatea las notas como CSV y escribe notes.csv en la carpeta de descargas del usuario. Las columnas son id y title.

Comprueba una predicción en el ejercicio guiado →

Descarga el ejemplo tú mismo o usa tu propia aplicación

Descargar ZIP de ejemplo

Si su agente no puede descargar archivos, descomprímalo usted mismo. Dale el camino al notes-example carpeta y la misma pregunta de exportación.

Usa REA para inspeccionar la aplicación en /absolute/path/to/app. Averigua cómo exporta los datos y muestra los archivos y las líneas relevantes.

¿Cómo obtengo la ruta completa de una carpeta?
  • Windows : en el Explorador de archivos, haga clic con el botón derecho en la carpeta y elija Copiar como ruta. En Windows 10, mantenga presionada la tecla Mayús mientras hace clic con el botón derecho.
  • macOS: en Finder, haz clic derecho en la carpeta, mantén pulsada la tecla Opción y elige Copiar «…» como nombre de ruta.
  • Cualquier sistema: arrastre la carpeta a una ventana de terminal y aparecerá su ruta.

En una terminal, coloque comillas alrededor de una ruta que contenga espacios.

Analiza otro tipo de software

Elige la sección correspondiente a tu objetivo. Un proveedor de análisis es la herramienta local que REA usa para ese tipo de software.

Ejecutables y bibliotecas nativas · Hopper, Ghidra o IDA

Instala una herramienta de análisis en el ordenador donde se ejecuta REA. El host es tu sistema operativo; el objetivo es el programa que quieres inspeccionar.

Proveedor de análisis Windows macOS Linux
Hopper No disponible 12+ Distribuciones compatibles
Ghidra x64 · experimental x64 / arm64 x64 / arm64
IDA Perfiles verificados Perfil sin interfaz gráfica verificado Consulta la guía del proveedor
Hopper · deja que la configuración lo instale o lo conecte

Conecte Hopper en macOS o Linux . Ejecute el comando de instalación anterior; detecta una instalación existente u ofrece un plan de instalación para su aprobación.

Elige Hopper durante la configuración y revisa su plan de instalación por separado. En macOS, elige el modo de demostración o activa tu licencia cuando Hopper se abra por primera vez. En Linux, la configuración prepara la demostración compatible y su pantalla privada.

Hosts Linux: Ubuntu 24.04+, Fedora 41+, Nobara 44+, Arch Linux, CachyOS u Omarchy. Hopper es software comercial; su demostración tiene límites definidos por el fabricante.

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

Si macOS pide permiso de Automatización, autoriza la aplicación que inicia REA en Ajustes del Sistema → Privacidad y seguridad → Automatización y vuelve a intentarlo.

Configuración de Hopper y solución de problemas

Ghidra · instala la herramienta de análisis gratuita y Java
  1. Instala un JDK de 64 bits, versión 21 o posterior, que incluya el compilador de Java. Elige el paquete correspondiente a la arquitectura de tu ordenador.
  2. Descarga Ghidra 12.1.4 desde la lista Assets de la versión publicada y extrae el archivo ghidra_…_PUBLIC_….zip. Elige el archivo de la versión, no «Source code».
  3. Busca la carpeta extraída que contiene ghidraRun o ghidraRun.bat. Usa esa carpeta para GHIDRA_INSTALL_DIR.

Descargar un JDK · Descargar Ghidra 12.1.4

Comprueba Java. El primer comando muestra java.home; usa esa carpeta para JAVA_HOME. El segundo confirma que el compilador está instalado:

Terminal
java -XshowSettings:properties -version
javac -version
Conecte Ghidra en Windows

Windows x64 tiene soporte experimental de solo lectura para aplicaciones y DLL nativas x86 y x64 PE en unidades NTFS locales fijas. Usa una instalación existente de Ghidra 12.1.x y un JDK de 64 bits, versión 21 o posterior:

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

Reemplace las dos rutas con sus instalaciones, luego revise el plan de configuración.

Conecte su instalación de Ghidra
macOS / Linux
export GHIDRA_INSTALL_DIR="/absolute/path/to/ghidra_12.1.4_PUBLIC"
export JAVA_HOME="/absolute/path/to/jdk-21"

Sustituye ambas rutas por las de tus instalaciones existentes. En una instalación nueva de macOS o Linux arm64, compila el descompilador nativo para tu ordenador antes de continuar.

Compila el descompilador nativo de Ghidra

En macOS, la compilación necesita Xcode Command Line Tools, make y bison. Usa la guía correspondiente a tu ordenador:

Después, comprueba Ghidra y guarda sus rutas para tu cliente:

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

Ejecuta estos comandos en la misma sesión de terminal. Tras establecer las rutas, vuelve a ejecutar la configuración, aprueba la configuración actualizada del cliente y reinicia tu agente.

Configuración de Ghidra y requisitos de arquitectura · Guía de Ghidra en Windows

IDA · conecta una instalación existente

Usa la guía del proveedor IDA para preparar el registro MCP del servidor al que REA se conecta. Elige una interfaz gráfica conectada con el binario original abierto o un supervisor sin interfaz gráfica que abra una base de datos privada.

Los perfiles verificados incluyen la interfaz gráfica heredada y el supervisor sin interfaz gráfica de Windows, además de un supervisor sin interfaz gráfica en macOS arm64 con IDA Professional 9.1. El puente nativo opcional de la interfaz gráfica tiene sus propios requisitos de versión y plataforma.

El perfil sin interfaz de macOS y el puente GUI nativo requieren una compilación de REA desde el código fuente o una versión que incluya estos cambios. npm 6.4.0 no los incluye.

Desde el directorio del código fuente ya compilado, ejecuta node scripts/rea.mjs doctor --provider ida --json y node scripts/rea.mjs setup en lugar de los comandos npx de abajo.

Prepara el archivo de registro de IDA

Instala y configura el servidor al que REA se conecta siguiendo la guía de IDA de abajo. Después, guarda su registro funcional como ida-mcp.json en un editor de texto. En Windows, elige «Todos los archivos» al guardar con el Bloc de notas para que no añada .txt.

Para un supervisor sin interfaz gráfica que ofrezca idb_open, idb_list y idb_close, el archivo puede ser así:

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

Para un servidor de interfaz gráfica heredado 1.4.0 conectado, copia en el archivo sus valores funcionales de command, args y, si lo usa, env. Abre el binario original en IDA e inicia el complemento de ese servidor antes de pedir a REA que lo inspeccione.

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

Usa el archivo JSON de registro que preparaste siguiendo la guía del proveedor. Después, vuelve a ejecutar la configuración y reinicia tu agente.

Perfiles de IDA, ejemplos de registro y plataformas verificadas

Una vez conectado, dale a tu agente la ruta completa del ejecutable original e indica el proveedor de análisis:

Usa REA con el proveedor que he configurado para inspeccionar /absolute/path/to/program. Enumera sus funciones y cadenas, y después explica la parte que procesa la entrada del usuario con referencias al código.

Sigue un ejemplo de análisis nativo

Sitios web, Android, .NET, firmware y otros objetivos

Abre la guía del tipo de objetivo que tienes. Cada guía indica las herramientas adicionales, los hosts compatibles y el primer comando.

Objetivo Herramientas necesarias Guía
JavaScript / Electron Node.js + npm Abrir guía
Sitio web Chrome / Chromium / Edge Abrir guía
.NET / Flutter / paquetes Node.js + npm Abrir guía
APK de Android JADX + JDK 17+ Abrir guía
Dispositivo Android adb Abrir guía
Recursos de Android Apktool + Java Abrir guía
Proyecto JEB JEB + MCP Abrir guía
Firmware Binwalk / Unblob · Linux Abrir guía
WASM WABT Abrir guía
Base de datos SQLite Node.js 24.15+ / 26+ Abrir guía
Bytecode de EVM Node.js · Linux x64 Abrir guía
ELF / fallo de Linux pwntools / GDB / pwndbg Abrir guía
HAR / SAZ / mitmproxy Node.js / mitmdump Abrir guía
PCAP / PCAPNG TShark / capinfos · Linux Abrir guía
Señales lógicas sigrok-cli · Linux Abrir guía
Comportamiento de procesos PTY · Linux / macOS Abrir guía

Guía de Flutter · Paquetes y recursos · Bytecode de EVM · Todas las guías de investigación

Usa REA desde una terminal

Comandos CLI, instalación global y curl

Analice una carpeta de aplicación JavaScript o Electron o un archivo ASAR sin ejecutar la aplicación:

Análisis estático de aplicaciones
npx -y rea-agents@latest analyze-javascript-application "/absolute/path/to/app" --json

Reemplace la ruta con el directorio de la aplicación extraída o .asar archivo. En Windows, una ruta como "D:/apps/example" trabaja aquí.

¿Dónde encuentro el archivo .asar de una aplicación?

Las aplicaciones Electron generalmente lo mantienen en un resources carpeta:

  • Windows : C:\Users\<you>\AppData\Local\Programs\<App>\resources\app.asar
  • macOS : /Applications/<App>.app/Contents/Resources/app.asar (haga clic con el botón derecho en la aplicación y elija Mostrar Contenido del Paquete)
  • Linux : a menudo /opt/<App>/resources/app.asar

Algunas aplicaciones se instalan en otro lugar. Busque en la carpeta de la aplicación app.asar.

El resultado identifica la aplicación, muestra las conexiones entre los módulos y proporciona sus ubicaciones de origen. Las conexiones REA que no se pueden resolver están marcadas en el resultado.

Si desea un permanente rea comando en tu shell:

Instale el CLI
npm install --global rea-agents

Continúe con la guía de aplicación del JavaScript

Terminal
npx -y rea-agents@latest function "/absolute/path/to/program" main --provider ghidra --json

Sustituye main por un nombre o una dirección de función de la lista de funciones del objetivo. Ghidra debe estar configurado previamente.

En macOS o Linux también puedes usar el instalador curl después de preparar Node.js:

macOS / Linux
curl -fsSL https://raw.githubusercontent.com/morluto/rea/main/install.sh | bash

Sigue las indicaciones de configuración para conectar tu agente. Si no aparecen, ejecuta rea setup.

Si el shell no encuentra rea, usa la ruta del ejecutable que muestra el instalador. En Linux, el comando de configuración predeterminado es "$HOME/.local/bin/rea" setup.

Cómo obtener ayuda

Si su agente no ve REA

Reinicie o vuelva a conectar el cliente después de la configuración. Compruebe su conexión REA con doctor; para Codex :

Usa la comprobación del cliente del paso 3 con tu identificador de configuración. En los clientes que son editores, activa REA en los ajustes MCP y autoriza sus herramientas en el chat del agente.

Si un proveedor necesita atención

Verifique el proveedor que está usando. Para Ghidra :

Consulte a un proveedor
npx -y rea-agents@latest doctor --provider ghidra --json

El informe proporciona la verificación fallida y un siguiente paso sugerido.

Windows, WSL y rutas con espacios

Usa Windows PowerShell para los clientes y las herramientas de análisis de Windows. Si tu agente se ejecuta dentro de WSL, instala Node.js y REA en ese entorno Linux y usa allí rutas de Linux. Los proveedores sin interfaz gráfica se ejecutan en el mismo host que REA.

En una terminal, coloque comillas alrededor de una ruta que contenga espacios.

Comando de configuración para Windows:

Windows PowerShell
npx.cmd rea-agents@latest setup
Actualiza o elimina REA

Para actualizar la conexión de tu agente, vuelve a ejecutar el comando de configuración más reciente, revisa el plan y reinicia tu cliente.

Terminal
npx rea-agents@latest setup

Si instalaste la CLI global, actualízala con rea update. Usa npx rea-agents@latest uninstall para eliminar la configuración de clientes y la skill de REA.

Detalles de actualización y desinstalación

Arriba