Instale o REA e configure o seu agente de codificação

Ligue o seu agente de codificação

Execute a configuração para conectar o REA ao seu agente de codificação. As opções do cliente incluem Claude Code, Codex , Cursor , Gemini CLI , Windsurf , Grok Build e outros clientes MCP suportados. O conector do Grok Bot é adicionado a partir do seu chat.

Novo em agentes de codificação?

Um agente de codificação é um assistente de IA que funciona em seu computador em vez de em uma guia do navegador. Ele pode ler arquivos e executar comandos, e pergunta antes de fazer alterações. REA dá-lhe ferramentas da reverso-engenharia.

Se ainda não tiver um, escolha um, Siga a sua página de instalação e inicie sessão:

Claude Code por Anthropic . Precisa de um plano Claude pago.
Codex por OpenAI . Inicie sessão com a sua conta ChatGPT.
OpenCode , código aberto. Conecte o Provedor do modelo de sua escolha.

Em seguida, abra-o e copie o prompt abaixo para ele. O agente executa a configuração do REA e mostra o plano antes de alterar qualquer coisa.

O seu agente de codificação

Instale o REA e conecte-o a este agente de programação usando npx rea-agents@latest setup. Mostre primeiro as alterações propostas e espere minha aprovação. Depois, verifique a instalação.

Ou execute a configuração você mesmo

Como abrir um terminal?

Windows : abra o menu Iniciar, escreva PowerShell e prima Enter.
macOS : imprensa ⌘ Space, tipo Terminal e prima Enter.
Linux : imprensa Ctrl Alt T na maioria dos desktops.

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

Terminal

npx rea-agents@latest setup

Escolha o seu cliente e reveja o plano de configuração. REA adiciona sua conexão MCP e a habilidade de investigação correspondente, mantendo um backup da configuração existente. Pergunta antes de aplicar as alterações.

Reinicie o cliente quando a configuração terminar.

Como faço para reiniciar meu cliente?

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.

Dê ao seu agente um caminho de destino e uma pergunta específica. Para um aplicativo JavaScript ou Electron, você pode começar com:

Olhe para /absolute/path/to/app e descubra como exporta dados. Mostre os pontos de entrada, chamadas e dependências envolvidas, com os locais de origem das suas descobertas.

Substitua o caminho pelo seu destino local.

Como obtenho o caminho completo de uma pasta?

Windows : no Explorador de Ficheiros, clique com o botão direito do rato na pasta e escolha Copiar como caminho. Em Windows 10, mantenha pressionada a tecla Shift enquanto clica com o botão direito do mouse.
macOS : no Finder, clique com o botão direito na pasta, segure Option e escolha Copiar " ... " como caminho.
Qualquer sistema: arraste a pasta para uma janela de terminal e seu caminho será exibido.

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

Utilizar o CLI

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

Análise estática da 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.

Onde encontro um aplicativo .ficheiro asar?

Os aplicativos Electron geralmente o mantêm em um resources pasta:

Windows : C:\Users\<you>\AppData\Local\Programs\<App>\resources\app.asar
macOS : /Applications/<App>.app/Contents/Resources/app.asar (clique com o botão direito do mouse no aplicativo e escolha Mostrar O Conteúdo Da Embalagem)
Linux : muitas vezes /opt/<App>/resources/app.asar

Alguns aplicativos são instalados em outro lugar. Pesquise na pasta do aplicativo app.asar.

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 você quiser uma permanente rea comando na sua concha:

Instalar o CLI

npm install --global rea-agents

Continue com o Guia de Aplicação JavaScript

Configurar a análise de programas de código de máquina

Os programas de código de máquina precisam de uma ferramenta de análise local. Escolha e configure um abaixo e, em seguida, forneça ao REA seu executável ou biblioteca.

Escolha uma ferramenta: Ghidra, Hopper ou IDA

Ghidra

Use um Ghidra 12.1 existente.x Instalação e um JDK de 64 bits 21 ou mais recente em Linux ou macOS, em x64 ou arm64. Sua instalação do Ghidra precisa de um descompilador nativo para sua arquitetura de host. Definir os caminhos antes de executar a configuração:

Conecte sua instalação Ghidra

Ligação Ghidra * macOS / Linux

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

Substitua os dois caminhos pelas instalações existentes. A configuração verifica - os e regista definições válidas para o cliente selecionado. No Linux arm64, pode ser necessário construir o decompilador nativo do Ghidra separadamente.

Ligar Ghidra em Windows

O Windows x64 tem suporte experimental somente leitura para aplicações nativas x86 e x64 PE e DLLs em unidades NTFS locais fixas. Use um Ghidra 12.1 existente.x Instalação e um JDK de 64 bits 21 ou mais recente:

Ligação Ghidra * 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

Substitua os dois caminhos pelas suas instalações e, em seguida, reveja o plano da instalação.

Hopper

Conecte Hopper em macOS ou Linux . Execute o comando setup acima; ele detecta uma instalação existente ou oferece um plano de instalação para sua aprovação.

No macOS, conclua a primeira escolha do modo de demonstração ou ativação da licença do Hopper antes de uma análise autônoma.

IDA

As configurações IDA verificadas usam Windows, com um registro MCP existente para uma GUI anexada ou um banco de dados sem cabeça. A análise sem cabeça Linux e macOS permanece não verificada.

Ligar um registo IDA MCP existente

Manter o funcionamento do servidor upstream command, args e facultativo env em um arquivo JSON. Um existente mcpServers objecto com um ida-pro-mcp a entrada também é aceita. Aponte REA nesse ficheiro antes da configuração:

Ligação IDA * 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

O perfil anexado usa ferramentas 1.4.0 herdadas upstream com o binário original já aberto no IDA . O perfil headless usa a API upstream database-supervisor e um registro com "mode": "headless"; a verificação real abrange um supervisor IDA 9.3 Windows x64. O médico verifica o registo sem iniciar o IDA .

Dê a REA o caminho executável original, com --provider ida em uma consulta CLI. Para um agente, incluir REA_IDA_MCP_CONFIG no ambiente do registro REA e selecione IDA ao abrir o binário.

Para uma configuração existente do Ghidra, inspecione uma função com:

Análise de funções

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

Substituir main com o nome ou endereço da função que pretende inspecionar.

Como funcionam as sessões de análise de programas de código de máquina

Cada comando CLI importa e analisa o binário e, em seguida, fecha sua sessão. As consultas MCP do seu agente reutilizam o binário importado enquanto essa sessão está aberta.

Seguir um exemplo de análise de programas de código de máquina para ver como o resultado da função conduz a um cálculo recuperado.

Obter ajuda

Se o seu agente não vir REA

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

Verificar um cliente

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

Se um fornecedor precisar de atenção

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

Verificar um fornecedor

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

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

REA FAQRespostas rápidas sobre actualizações, agentes e análises.
Escolha um guia de investigaçãoExemplos trabalhados para um binário, um aplicativo Electron e um navegador.
Questões GitHubRelate um problema com o comando e o diagnóstico.
Comunidade REAPerguntas, investigações e trabalhos em curso.

Configurar REA .