tutorial · REA no Claude Code

Entenda como qualquer software funciona e construa o seu

Com a REA, o Claude Code investiga um programa instalado no seu computador, mostra como cada função funciona com as provas, e você reescreve a sua versão do zero.

Passo 2 e Passo 3
npx rea-agents setupnpx rea-agents setup --client claude_codeclaude mcp list
Como funciona

Como funciona

A REA, de Reverse Engineer Anything, é um projeto de código aberto com licença MIT, publicado no GitHub em morluto/rea. Ela não é um aplicativo à parte. Ela entra no seu agente como um servidor MCP mais uma skill com o roteiro de investigação. O MCP aqui é a ponte entre a REA e o Claude Code, não uma conexão com o servidor da empresa que vende o software. A análise roda no seu computador, em cima do programa instalado, e cada conclusão volta com as provas e os limites.

01

Instalar a REA no Claude Code

npx rea-agents setup

02

Ver se o Claude Code enxerga a REA

claude mcp list

03

Conferir a instalação e a skill

npx rea-agents doctor --client claude_code --skill --json

04

Analisar um app JavaScript ou Electron pelo terminal

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

05

Atualizar a REA e a skill

npx rea-agents@latest setup

06

Tirar a REA do Claude Code

claude mcp remove --scope user rea

Antes de começar

Pré-requisitos

01

O Claude Code instalado e funcionando.

O plano Free do Claude não inclui o Claude Code; Pro, Max, Team e Enterprise incluem. O Pro custa US$ 20 por mês no mensal, ou US$ 200 por ano. Se você ainda não usa o Claude Code, comece pelo manual Claude Code na Prática, no gratis.denderson.ai.

02

O Node.js com o npm, na linha 22, 24 ou 26.

Na versão 6.7.0 da REA publicada no npm, o mínimo é o 22.19 na linha 22 e o 24.11 na linha 24.

03

Um programa que você tem o direito de analisar.

Pode ser um programa seu, um de código aberto ou um que você comprou e cuja licença não proíbe engenharia reversa.

04

Para programa nativo compilado, como um .exe do Windows ou um app do Mac, um motor de análise: Hopper, Ghidra ou IDA.

App JavaScript ou Electron, programa .NET e site não precisam de motor.

Passo a passo

Passo a passo

Os comandos estão exatamente como na documentação da REA. Os pedidos ao agente ficam em inglês no exemplo oficial e ganham uma versão em português logo abaixo.

0 de 8 passos concluídos

A REA roda com o Node.js e é instalada pelo npm, que vem junto com ele. Abra o terminal do seu computador e rode o comando abaixo. Se aparecer um número menor que 22, ou um erro dizendo que o comando não existe, baixe o instalador da versão LTS em nodejs.org/en/download, instale, feche e abra o terminal de novo e confira outra vez.

Comando
node --version
Como saber que deu certo

Aparece v22.19.0 ou um número maior.

Pegue a REA só das fontes oficiais: o repositório morluto/rea, o site rea.tools ou o pacote rea-agents no npm. A própria documentação avisa que um repositório com nome parecido ou um README copiado não prova que o download é oficial. O comando abaixo faz duas perguntas separadas. Primeiro o npm pede para baixar o pacote. Depois a REA mostra a lista de agentes: marque o Claude Code, confira os caminhos e as mudanças do plano e aprove. Para o Claude Code ela grava o servidor rea no ~/.claude.json e instala a skill reverse-engineer-anything em ~/.claude/skills, com backup da configuração que já existia. O Hopper é uma escolha à parte, com aprovação própria, e você pode recusar. Se apertar Ctrl-C ou recusar, nada muda. No fim, feche e abra o Claude Code.

Comando
npx rea-agents setup
Para ir direto ao Claude Code, sem a lista
npx rea-agents setup --client claude_code
Como saber que deu certo

A mensagem final diz quais agentes reiniciar. Reinicie o Claude Code e siga para o Passo 3.

O primeiro comando lista os servidores MCP que o Claude Code conhece, e o rea tem que estar lá. O segundo é o doctor da REA, só para o Claude Code e para a skill. Ele só lê, não muda nada, e confere arquivos e pré-requisitos. Ele não testa a conexão ao vivo com o agente: essa prova vem no Passo 6, quando o Claude Code usar a REA de verdade.

Comandos, um de cada vez, no terminal
claude mcp list
npx rea-agents doctor --client claude_code --skill --json
Como saber que deu certo

O rea aparece no claude mcp list e o doctor devolve o relatório em JSON sem erro na skill e no registro do Claude Code.

O setup registra a REA no Claude Code inteiro, então todo projeto que você abrir pode chamar a REA. Para ela aparecer só quando você quiser, use um perfil separado pela variável CLAUDE_CONFIG_DIR. O primeiro comando instala a REA nesse perfil. O segundo abre o Claude Code nele. Um perfil novo pode pedir login de novo. Abra o Claude Code sem a variável e você volta ao perfil de sempre, sem a REA. Vale saber também que a REA não é uma caixa de areia: abrir um programa de origem duvidosa passa a análise para o motor local com as permissões do seu usuário. Programa suspeito, analise numa máquina ou conta separada.

Comandos
CLAUDE_CONFIG_DIR=~/.claude-rea npx rea-agents setup --client claude_code
CLAUDE_CONFIG_DIR=~/.claude-rea claude
Como saber que deu certo

No perfil separado, o claude mcp list mostra o rea. No perfil de sempre, não.

A REA trabalha melhor com uma pergunta clara sobre uma função: como a busca funciona, como o relatório é calculado, como o arquivo é salvo. Antes, veja que tipo de programa você tem, porque isso decide o que a REA consegue ler.

App JavaScript ou Electron. Muito programa de computador é feito assim por dentro, como o Notion, que é um dos casos publicados pela REA. Ela devolve os módulos, as importações, as rotas e a comunicação entre as partes do app, sem motor de análise.

Programa .NET. Ela lê os metadados e as instruções do programa sem executar nada.

Site. Ela observa a estrutura da página, os scripts e o tráfego de rede. Precisa de um navegador da família do Chrome.

Programa nativo compilado. Ela devolve pseudocódigo, assembly, textos internos, símbolos e chamadas, pelo Hopper, pelo Ghidra ou pelo IDA. O Hopper é software comercial com demo grátis limitada. O Ghidra é gratuito e de código aberto.

Como saber que deu certo

Você tem o nome do programa, o tipo dele e uma frase dizendo qual função quer entender.

Abra o Claude Code na pasta do seu projeto e faça o pedido. Troque Notes pelo programa que você escolheu e search pela função. O agente chama a REA, inspeciona o programa, segue o código que interessa e responde com o que achou, as provas e o que ficou sem resposta. A partir daí você pode fazer novas perguntas, pedir a explicação ou pedir a implementação com teste.

Exemplo oficial, em inglês
Understand how search works in the Notes app, show me the evidence, and build a
similar feature for my project.
A mesma ideia, em português
Use a REA para entender como funciona a busca do app Notes, me mostre as provas e construa uma funcionalidade parecida no meu projeto.
Como saber que deu certo

A resposta cita a REA, traz os achados com as provas e diz quais pontos ficaram em aberto.

Para um app JavaScript ou Electron, aponte a REA para a pasta extraída do app ou para o arquivo ASAR, com o caminho completo. O resultado traz os módulos, as importações e as fronteiras do Electron, com as provas. No Windows, o caminho fica no formato "D:/apps/example". Se for usar sempre, instale o comando rea no computador.

Comando
npx -y rea-agents@latest analyze-javascript-application /absolute/path/to/app --json
Para instalar o comando rea
npm install --global rea-agents
rea --help
Como saber que deu certo

O terminal devolve um JSON com os módulos e as importações do app.

A REA devolve pseudocódigo, assembly ou o mapa dos módulos. Ela não entrega o código-fonte original nem um sistema pronto. Quem escreve e testa a implementação é o seu agente, a partir dos achados. Aqui mora o cuidado que separa construir o seu sistema de copiar o dos outros: leve para o seu projeto o comportamento, a regra de negócio e o fluxo, e escreva tudo de novo. Código, textos, imagens e marca do programa original ficam fora. Ter o resultado da análise não dá direito sobre o programa analisado nem sobre o que saiu dele. Confira cada conclusão antes de confiar nela, porque descompilação e reconstrução podem vir incompletas ou erradas.

Como saber que deu certo

O seu projeto tem a função funcionando, com código escrito por você e pelo seu agente, e com teste passando.

O que dá e o que não dá

Dá

  • Entender como uma função de um programa instalado funciona, com as provas e os limites de cada conclusão.
  • Inspecionar apps JavaScript e Electron, programas .NET, sites e programas nativos com Hopper, Ghidra ou IDA.
  • Pedir ao Claude Code para construir e testar uma versão parecida no seu projeto.
  • Rodar a análise no seu computador, sem a REA enviar o programa para lugar nenhum.
  • Usar no Claude Code, no Codex, no Cursor, no Gemini CLI e em outros agentes com MCP local.
  • Rodar a mesma análise pelo terminal, sem agente.

Não dá

  • Receber um clone idêntico e pronto. O que volta é análise, e o código novo é escrito pelo seu agente.
  • Puxar o código do servidor do fornecedor. A REA olha o que está no seu computador.
  • Furar licença, DRM, login ou proteção de acesso. O projeto não ajuda nisso.
  • Levar código, textos, imagens e marca do programa original para o seu produto.
  • Usar no plano Free do Claude, que não inclui o Claude Code.

FAQ

No Brasil, a Lei 9.609/1998, a lei do software, diz no artigo 6º que não ofende o dono de um programa a semelhança com outro programa quando ela vem das características funcionais da aplicação. É isso que o Passo 8 faz: você entende a função e escreve a sua do zero. Dois cuidados continuam valendo. O contrato de licença e os termos de uso do programa podem restringir engenharia reversa, e o próprio projeto da REA diz que ela é para análise lícita, em software seu ou que você tem autorização para examinar. Se o seu sistema novo vai virar produto para vender, passe o caso por um advogado.

Não. O MCP liga a REA ao seu agente, no seu computador. A REA analisa o programa instalado e não envia o programa para lugar nenhum. O seu agente recebe os resultados, e o provedor do modelo segue a política de dados dele.

A REA é grátis, com licença MIT. O Claude Code precisa de um plano pago do Claude. Para programa nativo, o Ghidra é gratuito e de código aberto, o Hopper tem demo grátis com limites e licença paga opcional, e o IDA é comercial.

O site da REA traz guia de instalação para Windows, Mac e Linux. App JavaScript, Electron, .NET e site funcionam sem motor de análise. Para programa nativo, o instalador automático do Hopper é para Mac e algumas distribuições Linux, e o Ghidra no Windows ainda é experimental.

Ela muda rápido e cada versão traz correção. Se você instalou o comando rea, rode o primeiro comando. Se usa pelo npx, rode o segundo, revise o plano e reinicie o Claude Code.

Comando
rea update
npx rea-agents@latest setup

O primeiro comando tira o registro da REA do Claude Code. Depois apague a pasta da skill, em ~/.claude/skills/reverse-engineer-anything. O rea uninstall tira a REA de todos os agentes que ela configurou, e com --purge-data também apaga o cache.

Comando
claude mcp remove --scope user rea
rea uninstall
rea uninstall --purge-data

IMERSÃO AGENTE DE IA NA PRÁTICA

Aprenda a criar agentes de IA que te ajudam a faturar +100k sem aumentar nenhuma pessoa no time.

Imersão AGENTE DE IA NA PRÁTICA. Participe.

Quero participar