코딩 에이전트와 함께 REA 사용하기: 첫 번째 조사

코딩 에이전트와 함께 REA를 사용하려면 npx rea-agents@latest setup을 실행하고, 선택한 클라이언트의 설정 변경을 승인한 뒤 해당 클라이언트를 다시 시작하세요. 그런 다음 에이전트에 로컬 소프트웨어 대상과 조사할 구체적인 동작 하나를 알려 주세요. 무언가를 만들라고 요청하기 전에 관련 코드, 소스 위치와 한계를 먼저 요청하세요.

REA는 오픈 소스 CLI 겸 MCP 서버입니다. 이 글은 독립 커뮤니티 가이드이며, rea.tools와 morluto/rea 저장소가 공식 프로젝트 출처입니다.

REA를 설치하기 전에 무엇이 필요한가요?

REA에는 Node.js 22.19부터 시작하는 22.x 계열, Node.js 24.11부터 시작하는 24.x 계열 또는 Node.js 26 이상과 npm이 필요합니다. Node.js 23, 25와 사전 릴리스 버전은 문서에 명시된 지원 범위에 포함되지 않습니다. 새 컴퓨터를 설정할 때는 공식 설치 가이드를 확인하세요.

소유하고 있거나 분석 허가를 받은 대상을 선택하세요. 압축을 푼 JavaScript 애플리케이션이나 Electron ASAR 아카이브는 첫 대상으로 유용합니다. REA의 정적 애플리케이션 분석에는 Hopper, Ghidra나 IDA가 필요하지 않기 때문입니다. 심층 네이티브 바이너리 분석은 이러한 엔진 중 하나를 사용하며, 추가적인 플랫폼 및 버전 요구 사항이 있습니다. REA README에 지원되는 대상 유형과 사전 요구 사항이 나와 있습니다.

무엇을 하려 하나요?	권장 시작 도구	입력	결과
에이전트에 기능 설명 요청	REA MCP 설정	로컬 대상 경로와 구체적인 질문	분석 결과, 근거와 후속 조사
에이전트 없이 앱 분석	REA CLI	압축을 푼 JavaScript 앱 디렉터리 또는 ASAR	구조화된 애플리케이션 분석 근거
웹 레이아웃을 직접 살펴보거나 JavaScript 실행 일시 중지	Chrome DevTools	Chrome에서 열린 페이지	DOM/CSS 직접 편집과 중단점 제어
바이너리의 함수와 그래프를 직접 탐색	Ghidra	지원되는 실행 파일 또는 라이브러리	대화형 디스어셈블, 디컴파일과 분석 프로젝트

Chrome DevTools와 Ghidra는 직접 분석에 유용한 인터페이스를 제공합니다. REA는 에이전트의 도움을 받아 조사를 진행하고, 선택한 분석 결과를 설명이나 구현으로 이어 가고 싶을 때 유용합니다. 저희의 Ghidra 비교와 Chrome DevTools 비교를 참조하세요.

REA를 코딩 에이전트에 어떻게 연결하나요?

터미널에서 공식 설정 명령을 실행하세요.

npx rea-agents@latest setup

원하는 클라이언트를 선택하고, 정확한 설정 내용과 스킬 경로를 검토한 뒤 계획을 승인하세요. 설정 과정에서 REA의 로컬 MCP 서버가 등록되고, 이에 맞는 조사 지침이 설치됩니다. 실행 중인 에이전트가 연결을 인식할 수 있도록 완료 메시지에 명시된 클라이언트를 다시 시작하세요. 공식 설정 문서에 미리보기, 백업과 범위 제어가 설명되어 있습니다.

Codex 등록을 확인하려면 다음 명령을 사용하세요.

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

필요한 경우 codex를 지원되는 클라이언트 ID로 바꾸세요. 정상적인 doctor 결과는 등록 파일과 사전 요구 사항을 확인해 주지만, 현재 에이전트 세션이 다시 연결되었음을 입증하지는 않습니다. 에이전트가 여전히 REA를 찾지 못한다면 다시 시작하거나 재연결하고 MCP 연결 오류를 살펴보세요. skills.sh에서 스킬만 설치하면 지침은 제공되지만 MCP 연결은 구성되지 않습니다. 공식 문제 해결 안내에서 이러한 차이를 다룹니다.

첫 프롬프트에서는 REA에 무엇을 찾아 달라고 해야 하나요?

애플리케이션 전체의 재구현을 요청하기보다 관찰 가능한 동작 하나를 고르세요. 분석 권한이 있는 애플리케이션이라면 다음처럼 구체적으로 요청할 수 있습니다.

REA로 /absolute/path/to/my-notes-app을 분석해 주세요.
애플리케이션이 노트를 CSV로 내보내는 방식을 설명해 주세요.
관련 모듈, 소스 위치와 근거를 보여 주세요.
확인된 동작과 판단할 수 없는 사항을 구분해 주세요.

경로를 실제 분석 대상의 경로로 바꾸세요. REA는 조사 결과를 제공하고, 코딩 에이전트는 이를 해석합니다. 답을 받아들이기 전에 결과에 대상 파일, 관련 코드와 불완전한 분석 범위가 명시되어 있는지 확인하세요. 근거가 되는 위치 없이 그럴듯한 설명만 있다면, 추가 조사가 필요한 가설입니다.

MCP를 사용할 수 없다면 정적 JavaScript 분석을 직접 실행할 수도 있습니다.

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

이 명령은 압축을 푼 애플리케이션 디렉터리나 ASAR을 입력받아 Evidence 레코드를 반환합니다. 점검 중 네이티브 프로바이더에서 오류가 발생했다고 해서 이 별도의 JavaScript 작업 흐름까지 자동으로 막히는 것은 아닙니다. REA의 작업 범위별 준비 상태 안내는 실제로 필요한 작업의 준비 상태를 확인하도록 권장합니다.

기능을 재구현하기 전에 결과를 어떻게 확인하나요?

설명을 작은 예측으로 바꿔 보세요. CSV 내보내기 기능이라면 일반 노트와 쉼표, 따옴표 또는 줄 바꿈이 들어 있는 노트를 비교하세요. 어떤 분기에서 이러한 문자를 처리하는지, 예측한 출력이 원본 애플리케이션에서 관찰한 내보내기 결과와 어떻게 일치하는지 에이전트에 물어보세요. 관찰된 출력과 에이전트가 제안한 대체 코드는 구분해 두세요.

공식 Notes 조사는 CSV 내보내기를 통해 이 과정을 설명합니다. 공식 공룡 예제는 다른 대상을 보여 줍니다. REA가 브라우저 게임에서 로드된 스크립트를 읽고, 에이전트가 가속 규칙을 파악하며, 작은 재구현을 통해 속도를 조절할 수 있게 합니다. 이는 프로젝트가 작성한 실습 예제이며, 독립 사용자의 체험담이 아닙니다.

릴리스와 개인정보 보호에는 어떤 한계가 있나요?

저장소의 main 브랜치에는 공개된 npm 패키지보다 새로운 기능이 문서화되어 있을 수 있습니다. @latest는 현재 npm 릴리스를 요청하며, 지속적으로 유지되는 MCP 등록은 설정을 수행한 정확한 버전에 고정됩니다. 업데이트할 때는 설정을 갱신하고 에이전트를 다시 시작하세요. main 브랜치의 모든 기능이 설치되어 있다고 가정하지 말고, 연결된 서버의 실제 도구 목록과 스키마를 기준으로 기능을 선택하세요. 공식 릴리스 경계 설명에서 이 차이를 설명합니다.

REA는 사용자의 컴퓨터에서 대상을 분석합니다. 도구 결과는 코딩 에이전트로 전송되며, 에이전트의 모델 제공업체에는 자체 데이터 정책이 있습니다. 결과를 공유하기 전에 무엇이 포함되어 있는지 검토하세요. 특히 소스 코드 일부, 로컬 경로, 캡처된 요청이나 애플리케이션 데이터에 주의하세요. 공식 FAQ에 로컬 분석과 모델 제공업체 사이의 경계가 설명되어 있습니다.

첫 조사 후에는 어떤 질문이 자주 나오나요?

Hopper, Ghidra나 IDA 없이 REA를 사용할 수 있나요?

네. JavaScript/Electron과 .NET의 정적 분석에는 네이티브 분석 엔진이 필요하지 않습니다. 심층 네이티브 분석에는 필요합니다. 모든 선택적 프로바이더를 필수로 간주하지 말고, 대상에 맞춰 사전 요구 사항을 선택하세요.

REA가 원본 소스 코드를 복원하나요?

네이티브 분석은 근거가 되는 분석 결과와 함께 어셈블리와 의사 코드를 반환합니다. 의사 코드는 분석을 위한 표현이며, 원본 소스 코드를 재현한다는 약속이 아닙니다. 에이전트는 분석 결과를 활용해 새 구현을 작성하고 테스트할 수 있습니다.

AI 구독 없이 REA를 실행할 수 있나요?

REA의 CLI는 분석 작업 흐름을 직접 실행할 수 있습니다. 코딩 에이전트를 사용하려면 해당 클라이언트 자체의 접근 요구 사항과 모델 제공업체 약관이 적용됩니다. REA의 MIT 라이선스는 모델 접근 권한이나 상용 분석 엔진 라이선스를 제공하지 않습니다.

명령이 실패하면 어떻게 해야 하나요?

먼저 문서에 명시된 사전 요구 사항을 확인하고 REA를 업데이트하세요. 전역으로 설치한 CLI에서는 rea update가 해당 CLI가 속한 설치본을 업데이트합니다. npx 기반 에이전트 설정에서는 npx rea-agents@latest setup을 다시 실행하고 클라이언트를 다시 시작하세요. 계속 실패한다면 공식 이슈 트래커에 REA 버전, 운영체제, 대상 유형, 프로바이더, 재현 단계와 오류 출력을 보고하세요.