REA 사용법, 설치 한 줄 뒤 에이전트에게 말로 시키기

REA(Reverse Engineer Anything)는 역공학 도구입니다. 역공학은 완성된 프로그램을 거꾸로 뜯어 보며 어떻게 만들어졌는지 알아내는 일을 말합니다. REA를 쓰면 AI 에이전트가 앱이나 웹사이트의 코드를 읽고 어떤 구조로 만들어졌는지 설명해 줍니다. 여기서 에이전트는 Claude Code처럼 사람 대신 파일을 열고 명령을 실행하며 일을 처리하는 AI 프로그램입니다.

분석할 때 치는 명령은 없습니다. 설치할 때만 명령 한 줄을 치고, 그다음부터는 에이전트에게 한국어로 물으면 됩니다. 이 글은 처음 쓰는 분을 위한 사용법입니다. 2026년 10월 21일 Windows 11 PC에 REA 6.7.0을 직접 설치하고, 처음 물어볼 만한 질문 5개를 Claude Code에 직접 물어본 결과를 정리했습니다. 분석 결과를 명령으로 직접 꺼내 보는 방법은 REA 설치부터 앱·웹사이트 분석까지에 따로 있습니다.

준비물 두 가지

REA를 쓰려면 Node.js와 에이전트가 필요합니다.

• Node.js — REA를 실행하는 데 필요한 기본 프로그램입니다. nodejs.org에서 받아 설치합니다.
• 에이전트 — REA가 지원하는 에이전트 가운데 하나가 있어야 합니다. Claude Code, Codex(OpenAI), Cursor, Gemini CLI 등이 있고, 이 글은 Claude Code로 했습니다. Claude Code가 아직 없다면 앤트로픽 워크숍으로 정리한 Claude Code 설정법을 보고 설치와 로그인까지 마친 뒤 돌아오십시오.

명령은 PowerShell에 칩니다. PowerShell은 Windows에 들어 있는 명령 입력 창으로, 시작 메뉴에서 'PowerShell'을 검색하면 열 수 있습니다.

Node.js 버전부터 확인하기

PowerShell에 아래 명령을 치면 지금 설치된 Node.js 버전이 나옵니다. 오류가 나면 Node.js가 없는 것이니 nodejs.org에서 받아 설치하십시오.

REA는 Node.js 버전을 꽤 까다롭게 봅니다. 아래 셋 가운데 하나여야 하고, 23 계열이나 24.10 이하는 안 됩니다.

• 22 계열: 22.19 이상
• 24 계열: 24.11 이상
• 26 이상: 26.0부터 모두

이 PC는 24.10이었습니다. 그래서 뒤에 나오는 설치 명령이 아래 안내를 내보내고 멈췄습니다. 'Node.js를 조건에 맞는 버전으로 설치하고 다시 실행하라'는 안내입니다. nodejs.org에서 24.20을 받아 설치하고 PowerShell을 다시 열자 설치가 그대로 진행됐습니다.

공식 주소 세 곳

REA가 인기를 끌면서 이름이 비슷한 가짜 코드 보관함(GitHub 저장소)이 생겼습니다. REA 설명서는 아래 세 곳만 공식이라고 밝히고, 이름이 비슷하거나 설명서를 그대로 베껴 놓은 곳도 공식이 아닐 수 있다고 경고합니다. 'REA 설치 프로그램(.exe)'처럼 내려받는 파일은 공식 배포 방식이 아니니 쓰지 마십시오. 이 글의 설치 명령은 아래 세 번째 공식 경로로 REA를 받아 옵니다.

• GitHub 저장소: github.com/morluto/rea↗
• 공식 사이트: rea.tools↗ (한국어판 rea.tools/ko↗)
• npm(Node.js 프로그램을 배포하는 곳)의 rea-agents 패키지↗

설치: 명령 한 줄

PowerShell에 아래 한 줄을 칩니다. npx는 Node.js를 설치하면 함께 들어오는 명령으로, 프로그램을 내려받아 바로 실행해 줍니다.

명령을 실행하면 어느 에이전트와 연결할지 묻고, 설정이 어떻게 바뀌는지 먼저 보여 줍니다. 화면 안내에 따라 쓰는 에이전트(이 글에서는 Claude Code)를 고르고, 바뀔 내용을 확인한 뒤 승인하면 설치가 끝납니다. 이 PC에서는 18초가 걸렸습니다.

PowerShell이 낯설다면 에이전트에게 설치를 맡기는 방법도 있습니다. rea.tools/ko 첫 화면 오른쪽 '설정REA' 칸에 있는 문장을 복사해 Claude Code 같은 에이전트의 입력칸에 붙여 넣으면 됩니다. 그 문장은 에이전트에게 설치 계획을 먼저 보여 주고 승인을 받은 뒤 설치하라고 요청합니다.

설치 명령은 두 가지를 바꿉니다. Claude Code 설정 파일(.claude.json, 내 사용자 폴더 안)에 REA를 적어 넣고, 'REA 사용 안내 파일'을 Claude Code가 추가 기능(스킬)을 모아 두는 폴더에 복사해 둡니다. 원래 설정 파일은 .claude.json.rea.backup이라는 이름으로 따로 복사해 둡니다.

이렇게 설치하면 이 컴퓨터에서 Claude Code를 여는 모든 폴더에서 REA를 쓸 수 있습니다. 특정 폴더에서만 쓰고 싶다면 GitHub 저장소의 docs/installation.md에서 'Limit REA to one project or agent profile' 항목을 따르십시오.

설치됐는지 확인하기

Claude Code를 닫았다가 다시 엽니다. 입력칸에 /mcp를 치면 Claude Code에 연결된 외부 도구 목록이 나오는데, 여기에 rea가 보이면 성공입니다. PowerShell에서 claude mcp list를 쳐도 같은 목록이 나옵니다.

이 PC에서는 처음 확인할 때 rea 항목에 '연결이 30초를 넘겨 실패했다(connection timed out after 30000ms)'는 오류가 표시됐습니다. Claude Code는 REA를 쓸 때마다 npx로 불러오는데, 처음 한 번은 필요한 파일을 내려받느라 30초를 넘겼기 때문입니다. 한 번 받아 둔 뒤에는 10초 안팎이면 실행됐습니다. 필자의 PC 환경 때문일 수도 있지만, 인터넷 속도나 PC 상태에 따라 누구든 처음 실행할 때 시간 초과가 날 수 있습니다. 같은 오류가 나면 PowerShell에서 아래 명령을 한 번 실행해 파일을 미리 받아 두고, Claude Code를 다시 여십시오.

Claude Code가 아닌 에이전트를 쓴다면

Codex나 Cursor, Gemini CLI를 쓴다면 설치 명령은 위와 같습니다. npx rea-agents@latest setup을 실행하고, 에이전트 목록에서 쓰는 것을 고르면 됩니다. 여러 개를 함께 골라도 됩니다. 설치가 끝나면 그 에이전트를 껐다가 다시 켜십시오. 질문도 아래 '처음 물어볼 질문 5개'의 문장을 그 에이전트 입력칸에 그대로 붙여 넣으면 됩니다.

다만 이 글은 Claude Code로만 해 봤습니다. 아래 표는 REA 설명서(10월 22일 확인)를 바탕으로 정리한 것입니다. 아래 확인 명령에 넣는 이름과, 설명서가 따로 당부한 점만 적었습니다.

연결됐는지 확인하는 /mcp는 Claude Code에서만 쓰는 방법입니다. 다른 에이전트에서는 PowerShell에 아래 명령을 치면, 그 에이전트의 설정 파일에 REA가 제대로 등록됐는지 점검해 줍니다. codex 자리에는 위 표의 이름을 넣으십시오. 이 명령은 설정을 바꾸지 않고 확인만 합니다. 다만 이 명령은 설정 파일만 보고 실제 연결은 확인하지 않습니다. 등록이 맞는데도 에이전트에서 REA가 보이지 않으면 에이전트를 껐다가 다시 켜십시오.

지원하는 에이전트는 24개이고, 전체 목록과 에이전트별 주의점은 REA 설치부터 앱·웹사이트 분석까지에 따로 정리했습니다.

처음 물어볼 질문 5개

시험 대상은 제가 직접 만든 연습용 메모 앱입니다. 웹 기술로 만든 PC 프로그램(Electron 앱)이고, 파일 5개짜리 작은 앱입니다. 분석해 볼 앱이 없다면 내가 만든 앱 폴더를 쓰거나, Claude Code에게 연습용 작은 앱을 하나 만들어 달라고 해도 됩니다. 다른 사람이 만든 앱은 저작권법의 보호를 받으므로, 연습은 내가 만든 앱으로 하십시오. 남의 앱을 분석하기 전에는 맨 아래 '사용 전 알아 둘 저작권과 데이터 문제'를 꼭 읽으십시오.

PowerShell에서 cd 명령으로 memo-app 폴더가 들어 있는 폴더로 이동한 뒤, claude를 쳐 Claude Code를 열었습니다. 예를 들어 memo-app이 문서 폴더 안의 rea-test 폴더에 있다면 아래처럼 칩니다.

그다음 아래 표의 문장을 입력칸에 붙여 넣고 Enter를 눌렀습니다. memo-app은 예시 이름이니, 분석할 폴더 이름으로 바꿔 쓰십시오.

질문마다 받은 분석 결과를 정리하면 이렇습니다.

• 어떤 앱인지: '문서' 폴더의 메모 파일을 단어로 찾아 주는 앱이라고 설명했습니다. 기능은 검색, 복사, 동기화(메모를 인터넷 서버로 보내 저장하는 기능) 세 가지인데, 화면에 버튼이 있는 것은 검색뿐이라는 점까지 알려 줬습니다.
• 기능 하나 따라가기: 복사 요청이 preload.js를 거쳐 main.js 8번째 줄의 복사 담당 코드로 넘어가는 흐름이라고 정리했습니다. 그 코드가 9번째 줄에서 클립보드(복사한 내용을 잠시 담아 두는 곳)에 글을 넣는다는 것까지 줄 번호로 알려 줬습니다.
• 인터넷으로 보내는 것: 인터넷으로 메모를 보내는 기능은 동기화 하나뿐이고, 보내는 주소는 sync.example.com이라고 찾았습니다. 로그인이나 비밀번호 확인 없이 보낸다는 점도 알려 줬습니다.
• 보안상 약한 곳: 이 앱은 검색 결과의 파일 이름을 화면에 그대로 표시합니다. 누군가 파일 이름에 악성 웹 코드를 숨겨 두면 그 코드가 앱 안에서 실행될 수 있고, 에이전트는 이것을 가장 위험하다고 봤습니다. 항목마다 고치는 방법도 한 줄씩 덧붙였습니다.
• 비슷한 기능 만들기: 검색 기능이 동작하는 순서를 네 단계로 정리하고 예제 코드를 보여 줬습니다. 예제는 memo-app의 약점 두 가지(검색하는 동안 앱이 멈출 수 있는 점, 위의 보안 문제)를 피하도록 작성했습니다. 다만 에이전트는 이 예제를 직접 실행해 보지는 않았다고 밝혔습니다.

REA는 화면 파일(index.html) 안에 바로 적힌 스크립트 코드는 분석하지 않는다고 결과에 밝혀 둡니다. 에이전트는 그 부분을 파일을 열어 직접 확인했다고 다섯 번 모두 적었습니다.

질문은 작고 구체적으로

질문이 막연하면 분석 결과도 막연해집니다. REA 저장소 토론방에 올라온 초보자 안내 글(영어)도 질문을 작고 구체적으로 하라고 권합니다. 큰 앱을 통째로 맡기면 에이전트가 한 번에 다룰 수 있는 분량을 넘어 빠뜨리는 곳이 생기고, 결과가 틀려도 확인하기 어렵기 때문입니다. 그 글의 예시를 참고해 막연한 질문과 구체적인 질문을 비교하면 이렇습니다.

분석 결과 확인하는 법

에이전트가 내놓은 분석 결과에서 세 가지를 확인하십시오.

• 근거 — 믿을 만한 분석 결과에는 파일 이름과 줄 번호가 함께 적혀 있습니다. main.js:8은 'main.js 파일의 8번째 줄'이라는 표기입니다. 결과에 ev_로 시작하는 긴 번호가 적혀 있으면 REA가 실제로 분석한 기록이라는 표시입니다.
• 모르는 부분 — REA는 확인하지 못한 것을 따로 적습니다. 에이전트가 "REA가 이 부분은 분석하지 않았다"고 하면, 그 부분은 직접 파일을 열어 확인하거나 그 부분만 골라 다시 물으십시오.
• 실행 여부 — REA가 알려 주는 것은 코드에 적힌 내용까지입니다. 실제로 그렇게 동작하는지는 프로그램을 실행해 봐야 압니다. 이번 다섯 결과도 모두 앱을 실행하지 않고 코드만 읽었다고 밝혔습니다.

자주 막히는 곳

• 설치가 바로 멈출 때 — Node.js 버전이 낮은 경우입니다. nodejs.org에서 새 버전을 받아 설치한 뒤, PowerShell을 닫고 다시 열어 같은 명령을 치십시오.
• rea가 연결되지 않을 때(시간 초과) — 처음 실행할 때 파일을 내려받느라 늦어진 경우입니다. 위 '설치됐는지 확인하기'의 명령으로 파일을 미리 받아 두십시오.
• Windows에서 'ERR_MODULE_NOT_FOUND' 오류가 날 때 — GitHub에 이 오류를 신고한 글(이슈 #5259)이 있고, 10월 21일 기준으로 아직 해결됐다는 표시가 없습니다. 답글을 단 사람은 npx로 파일을 내려받던 중 연결이 끊긴 것을 원인으로 꼽았습니다. 이 경우 파일이 일부만 저장돼 오류가 난다는 설명입니다. 이 PC에서는 이 오류가 나지 않았습니다.
• 분석 결과가 엉뚱하거나 너무 길 때 — 맡긴 앱이나 질문의 범위가 너무 큰 경우가 많습니다. 파일 하나, 기능 하나로 범위를 줄여서 다시 물으십시오.

다 쓴 뒤 지우는 법

아래 명령 한 줄이면 에이전트와 REA의 연결이 지워집니다.

이 PC에서 실행해 보니 Claude Code 설정 파일에서 REA 항목이 지워지고, 스킬 폴더의 REA 안내 파일도 지워졌습니다. 다른 설정과 다른 스킬은 그대로였습니다. 설치 때 만든 백업 파일(.claude.json.rea.backup)은 남는데, 필요 없으면 파일 탐색기에서 직접 지워도 됩니다.

사용 전 알아 둘 저작권과 데이터 문제

분석해도 되는 앱

마음 놓고 분석해도 되는 것은 내가 직접 만든 앱, 그리고 만든 사람이나 회사에게 분석을 허락받은 앱(예: 회사가 맡긴 보안 점검)입니다.

돈을 내고 산 앱이라도 마음대로 분석해도 되는 것은 아닙니다. 저작권법 제101조의4(프로그램코드역분석)가 허락 없는 분석을 인정하는 경우는 좁습니다. 프로그램을 정당하게 쓰는 사람이어야 합니다. 그리고 호환(다른 프로그램과 함께 쓰는 것)에 필요한 정보를 다른 방법으로는 얻기 어려워야 합니다. 이때도 호환에 필요한 부분만 분석할 수 있습니다. 그렇게 얻은 정보도 호환 말고 다른 목적에 쓰거나 남에게 넘길 수 없습니다. 원래 프로그램과 비슷한 프로그램을 만드는 데 쓰는 것도 금지돼 있습니다.

앱과 웹 서비스의 이용약관이 역공학 자체를 금지하는 경우도 많습니다. REA의 이용 안내(DISCLAIMER)도 돕지 않는 일을 밝혀 두었습니다. 복제 방지 장치(DRM)나 정품 인증을 우회하는 일, 로그인이나 접근 제한을 우회하는 일, 남의 프로그램을 복제하는 일입니다. 회사 일로 남의 앱을 분석해야 한다면 법무 담당자와 먼저 확인하십시오.

분석 결과가 가는 곳

분석은 내 컴퓨터에서 하지만, 그 결과는 에이전트가 읽습니다. 그래서 분석 결과가 에이전트가 쓰는 AI 모델 회사의 서버로 보내집니다. Claude Code라면 앤트로픽, Codex라면 OpenAI, Gemini CLI라면 구글입니다. Cursor처럼 여러 회사의 모델을 골라 쓰는 에이전트는 고른 모델에 따라 달라집니다. 회사 내부 앱처럼 민감한 대상이라면 이 점부터 확인하십시오.

REA 같은 도구가 늘면서 개발자의 일이 AI에게 일을 시키고 결과를 점검하는 쪽으로 바뀌고 있습니다. 이 흐름은 개발자는 '핸들러'로 남을까에서 다뤘습니다.