Configurar REA .

• Windows : abra o menu Iniciar, escreva PowerShell e prima Enter.
• macOS: pressione ⌘ Space, digite Terminal e pressione Enter.
• Linux: pressione Ctrl Alt T na maioria dos ambientes de desktop.

Colar um comando com Ctrl V (macOS : ⌘ V; Terminais Linux: Ctrl Shift V) e, em seguida, prima Enter.

Os comandos vão no terminal. As instruções com o rótulo “Seu agente de programação” vão no chat do agente.

Abrir um terminal e verificar:

node -v
npm -v

Se node -v mostrar v22.19+, v24.11+ ou v26+, você já pode continuar. Se mostrar uma versão mais antiga ou "not recognized" / "command not found", instale 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

Prefere um instalador regular? Baixe a versão LTS de nodejs.org.

No terminal, crie uma pasta para o exercício e entre nela:

mkdir rea-work
cd rea-work

Mantenha este terminal aberto para o próximo passo. Se você já tem uma pasta de trabalho, abra essa pasta no lugar.

Instale o Codex com o comando correspondente ao seu sistema operacional:

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

curl -fsSL https://chatgpt.com/codex/install.sh | sh

Após a instalação, reabra o terminal e volte à pasta de trabalho. Depois, inicie o Codex:

codex

Escolha “Sign in with ChatGPT”, entre na conta pelo navegador e volte ao terminal. Quando a caixa de mensagem aparecer, continue no passo 3.

Instalação e login do Codex

1. Instale o editor para seu sistema operacional e entre na conta.
2. Abra a pasta rea-work que você criou no passo 1.
3. Abra o chat de IA e escolha o modo Agent. No Windsurf ou Devin Desktop, abra o chat do agente; no VS Code, configure o GitHub Copilot primeiro.

Configuração do Cursor · Configuração do Windsurf / Devin Desktop · Configuração do VS Code e Copilot

Instale com o comando correspondente ao seu sistema operacional:

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

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

Reabra o terminal, volte à sua pasta de trabalho e execute claude. Siga as instruções de login. O acesso exige uma assinatura elegível do Claude ou uma conta de API configurada.

Instalação do Claude Code e opções de conta

Instale o Claude Desktop no Windows ou macOS e entre na conta. Feche completamente e depois execute este comando em um terminal que você abriu fora do Claude:

npx rea-agents@latest setup --client claude_desktop

Revise e aprove o plano, reabra o Claude e verifique a conexão no passo 3.

Baixar o Claude Desktop · Detalhes de conexão do Claude Desktop

npm install --global opencode-ai

Execute opencode na sua pasta de trabalho. Use /connect no chat para conectar sua conta de modelos e depois escolha um modelo.

Instalação do OpenCode e configuração de modelos

A versão 6.4.0 publicada no npm suporta os clientes abaixo. Use o ID com --client quando quiser escolher um cliente explicitamente.

Qoder (qoder), Factory Droid (droid), Trae (trae), ZCode (zcode) e DeepSeek Harness (dsh) estão disponíveis na branch main do repositório. Use uma compilação do código-fonte ou uma versão publicada que contenha essas integrações.

Configuração dos clientes e solução de problemas · Disponibilidade nas versões publicadas

npx -y rea-agents@6.4.0 mcp

npx rea-agents@latest setup

Para um cliente específico, acrescente seu ID de configuração:

npx rea-agents@latest setup --client codex

Se o npm pedir para baixar o pacote, digite y e pressione Enter. Na lista de clientes do REA, use as setas para navegar, Espaço para selecionar seu cliente e Enter para continuar.

Aplicações Desktop (Claude Desktop, Cursor , Windsurf, VS Code ): feche o aplicativo completamente e abra-o novamente. Fechar a janela não é suficiente. Em macOS imprensa ⌘ Q; em Windows, também saia do ícone da bandeja, se houver um.

Agentes terminais (Claude Code, Codex, Gemini CLI ): saia da sessão e inicie-a novamente.

Baixar exemplo ZIP

Se o seu agente não puder baixar arquivos, Descompacte este arquivo você mesmo. Dê-lhe o caminho para o notes-example pasta e a mesma questão de exportação.

Use o REA para inspecionar o aplicativo em /absolute/path/to/app. Descubra como ele exporta dados e mostre os arquivos e as linhas relevantes.

Instale uma ferramenta de análise no computador que executa o REA. O host é seu sistema operacional; o alvo é o programa que você quer inspecionar.

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

Após conectar, forneça ao seu agente o caminho completo do executável original e indique o provedor de análise:

Use REA com o provedor que configurei para inspecionar /absolute/path/to/program. Liste suas funções e strings, depois explique a parte que processa a entrada do usuário com referências ao código.

Siga um exemplo de análise nativa

Abra o guia correspondente ao seu alvo. Cada guia informa as ferramentas adicionais, os hosts compatíveis e o primeiro comando.

Guia de Flutter · Pacotes e recursos · Bytecode EVM · Todos os guias de investigação

Analisar uma pasta de Aplicação JavaScript ou Electron ou um arquivo ASAR sem executar a aplicação:

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

Substitua o caminho pelo diretório do aplicativo extraído ou .asar ficheiro. Em Windows, um caminho como "D:/apps/example" trabalha aqui.

O resultado identifica o aplicativo, mostra as conexões entre os módulos e fornece suas localizações de origem. As ligações REA não podem ser resolvidas estão marcadas no resultado.

Se quiser ter o comando rea sempre disponível no seu shell:

npm install --global rea-agents

Continue com o Guia de Aplicação JavaScript

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

Substitua main por um nome ou endereço de função da lista de funções do alvo. O Ghidra precisa estar configurado antes.

No macOS ou Linux, você também pode usar o instalador curl depois de preparar o Node.js:

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

Siga as instruções de configuração para conectar seu agente. Se elas não aparecerem, execute rea setup.

Se o shell não encontrar rea, use o caminho do executável exibido pelo instalador. No Linux, o comando de configuração padrão é "$HOME/.local/bin/rea" setup.

Reinicie ou volte a ligar o cliente após a configuração. Verificar a ligação REA com doctor; para Codex :

Use a verificação do cliente do passo 3 com seu ID de configuração. Nos clientes que são editores, habilite o REA nas configurações MCP e permita suas ferramentas no chat do agente.

Verifique o fornecedor que está a utilizar. Para Ghidra :

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

O relatório apresenta a verificação falhada e sugere o próximo passo.

Use o Windows PowerShell para clientes e ferramentas de análise do Windows. Se seu agente roda dentro do WSL, instale o Node.js e o REA nesse ambiente Linux e use caminhos Linux ali. Os provedores sem interface gráfica rodam no mesmo host que o REA.

Em um terminal, coloque aspas em torno de um caminho que contém espaços.

Comando de configuração para Windows:

npx.cmd rea-agents@latest setup

Para atualizar a conexão do agente, execute novamente o comando de configuração mais recente, revise o plano e reinicie seu cliente.

npx rea-agents@latest setup

Se você instalou a CLI global, atualize com rea update. Use npx rea-agents@latest uninstall para remover a configuração dos clientes e a skill do REA.

Detalhes de atualização e desinstalação