코딩 에이전트로 리버스엔지니어링: REA 설치부터 실전까지

🔍 1. REA란: 에이전트에게 분석의 눈을 쥐여주기

REA(Reverse Engineer Anything)는 코딩 에이전트가 프로그램을 조사하고 동작을 설명할 수 있도록 분석 도구를 제공하는 오픈소스 프로젝트입니다(GitHub: morluto/rea, MIT 라이선스). 한 줄로 정의하면 에이전트용 리버스엔지니어링 도구 상자입니다.

전통적인 리버스엔지니어링은 진입 장벽이 매우 높았습니다. 개발자가 Ghidra, IDA Pro, x64dbg 같은 전문 분석기를 직접 다루며 수천 줄의 어셈블리 명령어를 한 줄씩 읽고, 제어 흐름 그래프(Control Flow Graph)를 머릿속에서 재조립해야 했습니다.

REA는 이 패러다임을 완전히 바꿉니다. 코딩 에이전트(Claude Code, Cursor, OpenCode, Windsurf 등)가 두뇌(해석 및 추론)를 맡고, REA가 눈과 손(디컴파일 및 호출 관계 추출)을 맡습니다.

구조적 역할 분담은 아래 표와 같이 명확합니다.

REA의 실체는 npm 패키지인 rea-agents(6.x대)이며, 터미널 CLI와 Model Context Protocol(MCP) 서버 인터페이스를 동시에 갖추고 있습니다. 즉, MCP를 지원하는 코딩 에이전트라면 별도의 플러그인 개발 없이 곧바로 붙여서 사용할 수 있습니다.

---

⚙️ 2. 설치 및 준비: 사전 요구사항과 자동 감지 설정

2-1. 사전 요구사항 (Prerequisites)

• Node.js: v18.0.0 이상 (v20+ 권장, npx 환경)
• (선택) Ghidra / Java 런타임: C/C++, Rust, Go 등 네이티브 기계어 바이너리를 심층 디컴파일할 경우 백엔드로 Ghidra 환경이 연동될 수 있습니다. (JS, Electron, 웹 앱 분석은 Node.js만으로 즉시 동작)

2-2. 대화형 자동 설치

공식적으로 권장되는 설치 방법은 사용 중인 코딩 에이전트의 프롬프트 창에 아래 명령을 전달하는 것입니다.

npx rea-agents@latest setup을 사용해 REA를 설치하고
이 코딩 에이전트에 MCP 도구로 연결해 줘.
먼저 설정 파일 변경 계획을 보여 주고 내 승인을 받은 뒤 실행해 줘.
마지막으로 설치 완료 여부를 확인해 줘.

터미널에서 직접 실행할 수도 있습니다.

npx rea-agents@latest setup

setup 스크립트를 실행하면 시스템에 설치된 코딩 도구(Claude Code, Cursor, OpenCode, Windsurf, Claude Desktop 등)를 자동으로 감지하고, 해당 도구의 설정 파일(예: opencode.json, .cursor/mcp.json 등)에 REA MCP 서버를 등록할지 대화형으로 묻습니다.

핵심은 설정 변경 계획을 사전에 확인하고 승인받은 뒤 실행하는 흐름입니다. 에이전트가 로컬 환경 설정을 변경하는 작업이므로, 보안상 permission.bash = ask 원칙을 철저히 유지해야 안전합니다. 설정 반영 후에는 코딩 에이전트를 재시작하면 REA 도구가 활성화됩니다.

---

🦕 3. 예제 해부 1: 크롬 공룡 게임 가속 알고리즘 복원

공식 사이트의 대표적인 실습 예제는 크롬 오프라인 공룡 러너(Chrome Dino Runner) 게임의 가속 규칙 복원입니다. 목표는 "게임이 어떤 속도로 시작하고, 매 프레임 얼마나 증가하며, 어디서 가속이 멈추는가"를 코드로 복원하는 것입니다.

REA를 연결한 코딩 에이전트에게 공룡 게임 스크립트 분석을 요청하면, REA는 난독화된 번들에서 러너 클래스의 틱 업데이트 함수를 찾아내 아래 핵심 로직을 추출합니다.

// REA가 디컴파일하여 추출한 속도 업데이트 분기
if (this.currentSpeed < this.config.MAX_SPEED) {
  this.currentSpeed += this.config.ACCELERATION;
}

에이전트는 이 코드를 바탕으로 설정 객체(config)의 원본 상수 값을 역추적해 복원해 냅니다.

• 시작 속도 (Initial Speed): 6.0
• 프레임당 가속도 (Acceleration): 0.001
• 최대 속도 상한 (Max Speed): 13.0

에이전트는 단순히 이 숫자를 알려주는 데서 멈추지 않고, 슬라이더로 시작 속도와 가속도를 자유롭게 조절할 수 있는 독립적인 웹 미니게임 컴포넌트를 클린룸 방식으로 새롭게 구현해 사용자에게 제공합니다.

---

🧮 4. 예제 해부 2: Windows 계산기 200 + 10%는 왜 220일까

두 번째 실전 예제는 Windows 계산기 애플리케이션의 % (퍼센트) 연산자 분기 해부입니다. 일반인에게는 단순해 보이는 % 버튼이지만, 실제 계산기 앱에서는 직전 연산자가 무엇이냐에 따라 동작이 극적으로 갈립니다.

"200 + 10%를 누르면 왜 20이 아니라 220이 계산되는가?"

REA를 통해 계산기 이벤트 핸들러를 추적한 결과, 에이전트가 복원해낸 규칙은 아래와 같은 분기 구조였습니다.

// 계산기 퍼센트 연산자 핸들러의 분기 메커니즘
if (operation === multiply || operation === divide) {
  // 곱셈(*) 또는 나눗셈(/) 뒤에 %가 오는 경우: 단순 비율 변환
  percent = current / 100;
} else {
  // 덧셈(+) 또는 뺄셈(-) 뒤에 %가 오는 경우: 기준값의 백분율로 환산
  percent = (current * previous) / 100;
}

• 덧셈·뺄셈 케이스: 기준값(200)의 10%인 20을 구한 뒤, 원래 연산에 적용 ➔ 200 + 20 = 220
• 곱셈·나눗셈 케이스: 10%를 단순 백분율 0.1로 변환 ➔ 200 × 0.1 = 20

바이너리 속에 숨겨진 미묘한 비즈니스 로직 분기를 어셈블리를 한 줄도 모르는 개발자라도 "이 버튼의 연산 규칙이 어떻게 구현되어 있어?"라는 자연어 질문 하나로 온전히 파악할 수 있는 것입니다.

---

🗂️ 5. 분석 분야 3종과 실무 3대 활용 시나리오

REA 공식 문서는 분석 대상을 아래 3개 분야로 분류하여 제공합니다.

💡 실무 개발에서의 3대 활용 시나리오

1. 문서 없는 사내 레거시 시스템 규격 복원:
   • 소스코드가 유실되었거나 주석/문서가 전무한 오래된 바이너리/패키지에서 핵심 데이터 처리 알고리즘 및 직렬화 포맷을 역공학해 최신 언어로 마이그레이션.
2. 비공개 내부 API 프로토콜 역추적:
   • 네트워크 패킷만으로는 암호화되거나 압축되어 알 수 없는 클라이언트 측 요청 페이로드 생성 로직 및 서명(Signature) 알고리즘 분석.
3. 서드파티 라이브러리 의존성 및 보안 감사:
   • 블랙박스 형태로 제공되는 외부 SDK나 Electron 앱이 백그라운드에서 어떤 시스템 리소스와 레지스트리에 접근하는지 투명하게 추적.

---

🔌 6. 에이전트 연결: OpenCode, Cursor, Claude Code 설정

REA는 표준 Model Context Protocol(MCP) 서버로 구현되어 있으므로, 사용 중인 도구의 설정 파일에 등록하기만 하면 즉시 연동됩니다.

6-1. OpenCode (opencode.json)

OpenCode 환경에서는 프로젝트 루트의 설정 파일 또는 글로벌 설정에 아래와 같이 추가합니다.

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "rea": {
      "type": "local",
      "command": ["npx", "-y", "rea-agents@latest"],
      "enabled": true
    }
  }
}

6-2. Cursor (.cursor/mcp.json)

Cursor를 사용 중인 경우 워크스페이스 또는 글로벌 MCP 설정에 등록합니다.

{
  "mcpServers": {
    "rea": {
      "command": "npx",
      "args": ["-y", "rea-agents@latest"]
    }
  }
}

6-3. Claude Desktop / Claude Code

Claude Desktop의 경우 claude_desktop_config.json의 mcpServers 항목에 동일하게 지정합니다.

{
  "mcpServers": {
    "rea": {
      "command": "npx",
      "args": ["-y", "rea-agents@latest"]
    }
  }
}

6-4. 실전 프롬프트 템플릿

연결 후에는 아래 2단계 프롬프트를 활용하여 체계적으로 분석을 지시합니다.

[1단계: 계획 수립 및 조사]
REA 도구를 사용해 './target_app'의 계산 로직을 분석해 줘.
실제 분석 도구를 실행하기 전에 어떤 파일과 함수를 조사할 것인지 계획을 먼저 설명하고 내 승인을 받아 줘.

[2단계: 클린룸 재구현]
분석된 분기 규칙을 명세서(Specification) 형태로 정리해 주고,
기존 코드를 복사하지 않고 TypeScript 독립 모듈로 동일하게 동작하는 코드를 새로 작성해 줘.

---

⚖️ 7. 합법·윤리적 가이드라인: 클린룸(Clean-Room) 리버스엔지니어링 원칙

리버스엔지니어링은 강력한 도구인 만큼 법적·윤리적 경계선(Clean-Room)을 명확히 인지하고 사용해야 합니다.

• 합법적으로 권장되는 영역:
  • 상호 운용성(Interoperability) 확보를 위한 파일 포맷 및 통신 규격 분석
  • 자체 개발 소프트웨어의 유실된 레거시 소스 복원 및 마이그레이션
  • 소프트웨어 취약점 분석 및 보안 감사(Security Auditing)
• 절대 금지되는 영역:
  • 저작권 기술적 보호조치(DRM) 무단 우회 및 크랙(Crack) 제작
  • 상용 소프트웨어의 핵심 독점 코드를 무단 복제하여 상업적 복제품 출시
  • 악성코드 제작, 침투 테스트 허가를 받지 않은 외부 시스템 리버스엔지니어링

---

❓ 자주 묻는 질문 (FAQ)

Q1. 어셈블리어를 몰라도 정말 사용할 수 있나요?
A. 네, 가능합니다. REA가 추출한 로우 레벨 바이트코드와 분기 흐름을 코딩 에이전트의 LLM이 고수준(High-level) 의사코드나 JavaScript/TypeScript 코드로 번역하고 설명해 주기 때문입니다. 다만 도출된 결과의 정확성을 검증하기 위해 함수의 호출 구조나 기본 논리 연산에 대한 이해는 갖추는 것이 좋습니다.

Q2. Windows 전용인가요? Mac이나 Linux에서도 동작하나요?
A. 공식 계산기 예제가 Windows 앱이었을 뿐, REA 자체는 Node.js 기반으로 구동되며 macOS와 Linux를 완벽히 지원합니다. 특히 Electron 및 웹 앱, Linux ELF 바이너리 분석도 플랫폼 제약 없이 수행할 수 있습니다.

Q3. Ghidra나 IDA Pro가 반드시 설치되어 있어야 하나요?
A. 아닙니다. JavaScript, TypeScript, 웹 번들, Electron ASAR 아카이브 분석은 Node.js 환경만으로 즉시 구동됩니다. 네이티브 C/C++ 컴파일 바이너리의 심층 분석이 필요할 때만 백엔드 디컴파일러 환경이 보조적으로 요구됩니다.

Q4. 난독화(Obfuscation)되어 변수명이 a, b, c로 바뀐 코드도 풀 수 있나요?
A. 에이전트가 가장 뛰어난 능력을 발휘하는 영역입니다. REA가 난독화된 추상 구문 트리(AST)를 제공하면, LLM 에이전트가 함수의 입출력 파라미터와 호출 관계를 맥락적으로 추론하여 의미 있는 변수명과 함수명으로 디맹글링(De-mangling)해 복원해 줍니다.

---

🎯 8. 총평: 블랙박스를 화이트박스로 바꾸는 힘

REA의 진정한 가치는 복잡한 분석 도구의 설치나 조작법을 외울 필요 없이, "도구는 읽고, 에이전트는 해석하며, 개발자는 승인하고 검증한다"는 명확한 협업 구조를 만든 데 있습니다.

수십 년간 소수 보안 전문가의 전유물이었던 리버스엔지니어링이 이제는 모든 개발자가 레거시 코드를 이해하고 닫힌 시스템의 원리를 배우는 일상적인 엔지니어링 도구로 내려왔습니다. 관심이 있다면 계산기나 작은 오픈소스 유틸리티 하나로 첫 조사를 시작해 보세요.

---

🔗 연관 아티클 & 공식 링크 바로가기

• REA 공식 사이트: 코딩 에이전트와 함께 리버스 엔지니어링 (공식 ↗)
• REA 소스코드: GitHub morluto/rea, MIT 라이선스 (↗)
• 관련 글: OpenCode 무료 활용법: Muse Spark 설치부터 실전까지 (↗)