REA 설치 방법｜맥·윈도우 GitHub 설치와 MCP 연결

“AI가 내 컴퓨터의 앱을 분석해준다는데, 어디서부터 시작해야 할까?” REA에 관심이 생겨 GitHub를 열었지만 파일 목록과 낯선 용어에서 멈췄다면, 일단 먼저 간단한 것부터 시작하면 됩니다.

REA를 코딩 에이전트에 연결하고, 작은 메모 앱의 내보내기 기능을 분석하는 것이 목적이기 때문에 실행 파일 분석이 필요할 때 도구를 추가하면 됩니다.

이 글에서는 맥·윈도우의 일반 설치와 GitHub 소스를 직접 받아 빌드하는 방법을 구분해요.

GitHub 최신 릴리스는 rea-agents 6.7.0입니다. @latest는 실행 시점의 npm 배포 버전을 선택

맥 설치로 이동 · 윈도우 설치로 이동 · 첫 실습 · GitHub 소스 빌드

REA 설치 전, 세 가지를 구분하세요

구성 요소	하는 일	첫 실습에 필요?
Node.js와 npm	REA 패키지를 실행하는 환경	필수
코딩 에이전트	질문을 받고 REA 도구를 호출	대화형 사용에 필요
Hopper·Ghidra·IDA	네이티브 실행 파일을 깊게 분석	이 글의 Electron 정적 분석에는 불필요

REA를 설치했다고 AI 모델 자체가 설치되는 것은 아니에요. 이미 사용하는 Claude Code·Codex·Gemini CLI·Cursor 등의 로그인과 사용 환경은 별도로 준비돼 있어야 해요. REA 자체와 에이전트 사용 요금도 구분해 주세요.

REA 공식 분석 흐름 — 공식 분석 흐름: 질문 → 파일 분석 → 근거 확인 → 설명·구현·검증. 원본 도식을 PNG로 변환했습니다. 출처

공식 GitHub에서 확인하고, 배포 패키지로 시작하기

공식 저장소는 github.com/morluto/rea예요. README의 설치 안내는 npm 패키지 rea-agents로 이어집니다. npx는 필요한 패키지를 받아 실행하는 명령이에요.

따라서 GitHub에서 프로젝트를 확인하더라도, 일반 사용자는 소스 ZIP을 받아 컴파일하지 않고 시작할 수 있어요. GitHub 소스 빌드는 REA 자체를 수정하거나 개발 중인 기능을 확인할 때 선택하는 별도 경로입니다.

공식 런타임 조건은 Node.js 22.19 이상인 22.x, 24.11 이상인 24.x, 또는 26 이상이에요. 23·25와 사전 배포 버전은 공식 설치 문서에서 지원 대상으로 보지 않아요. 처음이라면 공식 가이드가 안내하는 Node.js 24 LTS 계열로 시작해도 좋아요.

맥에서 REA 설치하기

1. 터미널에서 Node.js 확인

⌘ + Space → 터미널을 열고 입력해요.

node -v
npm -v

두 명령이 버전을 표시하고 Node.js가 지원 범위라면 다음으로 넘어가세요. 설치되지 않았다면 Node.js 공식 다운로드에서 macOS용 설치 파일을 받아 설치한 뒤 터미널을 다시 여세요. 기존에 버전 관리 도구를 쓴다면 그 도구에서 버전을 맞추면 됩니다.

2. REA 설정 시작

npx rea-agents@latest setup

패키지 다운로드 확인이 나오면 내용을 확인하고 진행하세요. 이어지는 목록에서 실제 사용하는 에이전트만 선택하면 돼요. 방향키로 이동 → Space로 선택 → Enter로 진행하는 방식입니다.

첫 실습에서는 Hopper 설치 제안을 건너뛰어도 괜찮아요. 설정 계획 화면에서 어떤 에이전트의 파일이 바뀌는지 확인한 뒤 적용합니다. REA는 기존 설정의 백업을 만들고 연결과 관련 작업 지침을 추가해요.

3. 에이전트를 재시작하고 연결 확인

터미널형 에이전트는 현재 세션을 종료하고 다시 실행해요. 데스크톱 앱은 창만 닫기보다 완전히 종료한 후 다시 열어주세요. Claude Desktop을 설정할 때는 설정 적용 전부터 앱을 완전히 종료하는 것이 공식 안내입니다.

예를 들어 Codex를 선택했다면 다음과 같이 확인해요.

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

healthy: true는 선택한 클라이언트의 설정 검사가 통과했다는 뜻이에요. 실제 에이전트에서도 “REA가 연결돼 있는지 확인하고 사용할 수 있는 도구를 보여줘”라고 요청하세요. 설정 파일 검사와 실행 중인 MCP 연결 확인은 서로 다른 단계입니다.

윈도우에서 REA 설치하기

1. PowerShell과 Node.js 준비

시작 메뉴에서 PowerShell을 검색해 열어요. 이 글의 Windows 명령은 PowerShell 기준입니다.

node -v
npm.cmd -v

Node.js가 없으면 공식 설치 파일을 사용하거나, winget을 사용할 수 있는 환경에서 아래 명령으로 설치할 수 있어요.

winget install --exact --id OpenJS.NodeJS.LTS

설치 후 PowerShell을 닫았다가 다시 열고 버전을 확인하세요. winget은 실행 시점의 LTS를 설치하므로 결과가 REA의 지원 범위인지 확인하는 단계가 필요해요.

2. npx.cmd로 설정 실행

npx.cmd rea-agents@latest setup

npx.cmd를 사용하면 PowerShell에서 npm 스크립트 실행 정책 때문에 막히는 흔한 상황을 피할 수 있어요. 별도로 보안 정책을 풀기 전에 이 경로부터 사용하세요.

에이전트 선택, 변경 계획 확인, 적용 순서는 맥과 같아요. 사용 중인 클라이언트만 선택하고 완료 뒤 다시 실행하면 됩니다.

3. 선택한 에이전트 진단

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

Codex가 아닌 클라이언트라면 아래 표에 맞게 바꾸세요.

사용할 에이전트	–client 뒤에 넣는 값
Claude Code	`claude_code`
Claude Desktop	`claude_desktop`
Codex	`codex`
Gemini CLI	`gemini_cli`
Cursor	`cursor`
VS Code	`vscode`

한 클라이언트만 설정하고 싶다면 setup --client gemini_cli처럼 범위를 지정할 수도 있어요. Windows 앱에 연결할 때는 Windows 쪽에서 설치하세요. 에이전트를 WSL 안에서 실행한다면 Node.js와 REA도 WSL 환경에 준비하고 Linux 경로를 사용해야 해요.

영상으로 설치와 첫 분석 흐름 확인하기

명령어가 어디에 들어가는지 헷갈린다면 아래 영상을 함께 보세요. 터미널에서 설정하는 장면과 에이전트에게 분석을 요청하는 장면을 구분해서 보면 좋습니다. 영상의 화면이나 버전이 다르면 위의 공식 문서 기준 명령을 우선하세요.

Jigs Dev의 REA 설치·실습 영상입니다. VS Code와 Electron 예제, Ghidra 연결 과정을 다룹니다. YouTube에서 보기

설치 후 첫 실습: 메모가 CSV로 저장되는 길 찾기

설치 완료 메시지만으로 끝내기보다 작은 분석을 한 번 성공시켜보세요. 공식 예제는 파일 6개로 구성된 작은 Electron 앱이에요. 분석을 위해 Electron을 설치하거나 앱을 실행할 필요가 없어서 첫 대상으로 적합해요.

공식 Notes 예제 ZIP 다운로드를 받아 새 폴더에 압축을 풀고, 에이전트에 폴더의 전체 경로와 함께 아래처럼 요청해요.

REA로 이 notes-example 폴더를 분석해줘. Export notes 버튼을 누르면 어떤 코드가 실행되는지 추적하고, notes.csv의 저장 위치와 컬럼을 알려줘. 근거 파일명과 줄 번호를 함께 보여줘. 우선 코드를 읽는 분석만 진행해줘.

공식 예제에서 확인할 흐름은 renderer.js의 버튼, preload.js의 메시지 전달, main.js의 저장 처리, csv.js의 CSV 변환이에요. 코드는 Downloads 폴더에 notes.csv를 쓰도록 구성돼 있고 컬럼은 id와 title입니다.

이것은 분석으로 확인하는 코드의 동작이에요. 정적 분석만 했다고 내 Downloads 폴더에 CSV가 생성되는 것은 아니에요. 후속으로 제목에 쉼표와 따옴표가 들어간 입력을 정해 변환 함수만 실행하고, 예측과 실제 출력이 일치하는지 확인하면 실습을 더 깊게 할 수 있어요.

에이전트 없이 터미널에서 구조 분석을 실행할 수도 있어요. 경로는 자신의 압축 해제 위치로 바꾸세요.

macOS

npx -y rea-agents@latest analyze-javascript-application "/Users/yourname/Downloads/notes-example" --json

Windows PowerShell

npx.cmd -y rea-agents@latest analyze-javascript-application "C:/Users/yourname/Downloads/notes-example" --json

DX-Ball Notion TH04를 소개하는 REA 공식 사례 이미지 — DX-Ball·Notion·TH04의 공식 사례 소개 이미지. 분석 내용을 설명한 도식입니다. 출처

작은 예제 다음에는 Notion의 복사 기능이나 게임의 특정 계산처럼 한 가지 동작에 집중해볼 수 있어요. 위 이미지는 공식 공개 사례의 설명 도식이며 설치 성공 화면은 아닙니다.

Hopper와 Ghidra는 언제 설치하나요?

소스 형태의 JavaScript를 읽는 단계에서 네이티브 실행 파일의 함수까지 들어가고 싶을 때, 별도 분석 엔진이 필요해요.

경로	적합한 시작점	준비할 내용
macOS + Hopper	네이티브 코드 분석을 추가	setup의 선택 설치 또는 기존 설치 연결. 별도 제품이며 데모 제한 확인
macOS + Ghidra	무료 분석 도구 활용	Ghidra·JDK. 공식 가이드의 macOS용 네이티브 디컴파일러 준비 절차 확인
Windows + Ghidra	지원 범위의 PE·DLL 분석	Ghidra·JDK와 실제 REA 버전의 Windows 지원 범위 확인

Hopper는 Windows 호스트용 경로로 안내되지 않아요. Windows Ghidra 경로는 실험적 지원이며 대상 형식과 저장 장치 조건이 있으므로, ‘설치됐으니 모든 실행 파일이 분석된다’고 보지는 마세요. 6.7.0 릴리스 노트에도 분석 대상 확장이 포함돼 있어 버전별 문서를 확인하는 것이 중요해요.

REA가 Hopper에서 네이티브 바이너리를 분석하는 공식 화면 — REA가 Hopper를 통해 네이티브 바이너리를 살펴보는 실제 공식 화면. 출처

Ghidra 경로를 설정할 때의 예시는 아래와 같아요. 두 경로를 본인의 실제 설치 폴더로 바꿔야 합니다. 경로만 지정한다고 Ghidra나 Java가 설치되지는 않아요.

macOS 터미널

export GHIDRA_INSTALL_DIR="/absolute/path/to/ghidra"
export JAVA_HOME="/absolute/path/to/jdk/Contents/Home"
npx -y rea-agents@latest doctor --provider ghidra --json
npx rea-agents@latest setup

Windows PowerShell

$env:GHIDRA_INSTALL_DIR = "C:/tools/ghidra"
$env:JAVA_HOME = "C:/tools/jdk-21"
npx.cmd -y rea-agents@latest doctor --provider ghidra --json
npx.cmd rea-agents@latest setup

환경 변수 설정과 setup은 같은 터미널 세션에서 이어서 실행해요. 설정 계획을 확인해 적용하고 에이전트를 재시작합니다. Ghidra 디컴파일러 빌드와 아키텍처별 준비는 공식 Ghidra 연결 안내를 따르세요.

GitHub 소스를 직접 받아 설치하고 싶다면

이 부분은 선택 사항이에요. 앞의 패키지 설치로 첫 분석이 된다면 건너뛰어도 됩니다. REA 자체를 수정할 때나 main 브랜치의 기능을 확인할 때 사용하는 개발 경로예요.

맥: 저장소 복제와 빌드

Git과 개발용 Node.js·npm을 준비한 다음 새 작업 폴더에서 실행해요. 저장소의 .nvmrc와 package.json의 packageManager가 개발 기준입니다. 확인 당시 각각 Node.js 24.18.0, npm 11.16.0이었으며 main 브랜치가 바뀌면 다시 확인해야 해요.

git clone https://github.com/morluto/rea.git
cd rea
cat .nvmrc
node -p "require('./package.json').packageManager"

출력된 버전에 맞춘 뒤 다음을 실행해요. 이미 nvm을 쓰고 있다면 저장소 안에서 nvm install, nvm use로 Node.js 버전을 맞출 수 있어요.

npm ci
npm run build:cached
node scripts/rea.mjs --help
node scripts/rea.mjs setup

이후에는 설치 폴더를 유지하세요. 소스 경로를 사용하는 설정을 만들어놓고 폴더를 옮기거나 삭제하면 연결이 깨질 수 있어요. 개발 중인 main은 npm 배포판과 같은 상태라고 보장되지 않아요.

윈도우: 소스 빌드 전에 네이티브 파일을 준비해야 해요

Windows의 일반 사용에는 앞에서 설명한 npm 배포판을 권장해요. 배포판에 들어 있는 rea-windows-x64.node와 manifest.json이 Git 저장소에는 포함되지 않기 때문이에요. 공식 개발 문서는 이 파일 없이 필요한 Windows 제어 기능을 사용할 수 없다고 설명합니다.

직접 빌드할 경우 먼저 같은 방법으로 저장소를 받아 개발용 Node.js·npm 버전을 맞추세요.

git clone https://github.com/morluto/rea.git
cd rea
Get-Content .nvmrc
node -p "require('./package.json').packageManager"

다음은 checkout의 package.json 버전과 정확히 같은 npm 배포판에서 두 파일을 가져오는 공식 절차를 PowerShell로 옮긴 예시예요. Windows x64와 tar 사용 가능 환경을 전제로 합니다. 각 명령이 성공한 뒤 다음 줄로 진행하세요.

$reaVersion = node -p "require('./package.json').version"
npm.cmd pack "rea-agents@$reaVersion"
New-Item -ItemType Directory -Force ".rea-native-package"
tar -xzf "rea-agents-$reaVersion.tgz" -C ".rea-native-package"
New-Item -ItemType Directory -Force "native/windows/build"
Copy-Item ".rea-native-package/package/native/windows/build/manifest.json" "native/windows/build/"
Copy-Item ".rea-native-package/package/native/windows/build/rea-windows-x64.node" "native/windows/build/"
npm.cmd ci
npm.cmd run build:cached
node scripts/rea.mjs --help
node scripts/rea.mjs setup

동일 버전이 npm에 없거나 파일이 없다면 그 지점에서 멈추세요. 임의로 다른 버전의 파일을 넣는 방식은 맞지 않아요. 대안은 공개된 배포판으로 돌아가거나 공식 문서의 Linux·MinGW-w64 빌드 절차를 따르는 것입니다. 상세 조건은 Windows 네이티브 파일 안내에서 확인할 수 있어요.

설치했는데 연결이 안 될 때 확인할 것

증상	먼저 확인할 항목
node 또는 npm을 찾을 수 없음	설치 후 터미널을 다시 열었는지, 현재 PATH에 실행 파일이 있는지 확인
PowerShell에서 스크립트 실행이 차단됨	`npx.cmd`·`npm.cmd` 사용
setup 이후 에이전트에 REA가 안 보임	선택한 클라이언트와 재시작 여부, 에디터의 MCP 도구 활성화 확인
doctor 전체 결과가 false	`--client` 또는 `--provider`로 필요한 범위만 진단
소스 빌드는 했지만 Windows 분석이 실패	네이티브 파일과 manifest, 패키지 버전 일치 확인
안내와 도구 목록이 다름	main 문서와 npm 릴리스의 차이, 재시작 전의 이전 서버 여부 확인

전체 doctor 검사에는 사용하지 않는 선택 엔진도 포함될 수 있어요. Hopper가 없다는 결과만으로 JavaScript 분석까지 실패했다고 판단할 필요는 없습니다.

업데이트와 연결 제거

npx 방식은 최신 setup을 다시 실행해 변경 계획을 적용하고 재시작해요. Windows에서는 npx.cmd로 바꿔 실행하면 됩니다.

npx rea-agents@latest setup

전역 설치를 선택한 경우에는 아래 흐름을 사용해요. 업데이트 뒤 도구가 출력하는 연결 갱신 안내도 확인하세요.

npm install --global rea-agents
rea setup
rea update

REA가 추가한 연결 설정과 스킬을 제거하려면 다음 명령을 사용해요. 이 작업은 여러 클라이언트에 영향을 줄 수 있으므로 제시되는 범위를 확인하세요. Node.js·Hopper와 별도로 설치한 전역 npm 패키지까지 모두 지우는 명령은 아닙니다.

npx rea-agents@latest uninstall

REA 설치의 첫 성공 기준은 단순해요. 에이전트가 도구를 실제로 호출하고, 내보내기 버튼의 동작을 파일명과 코드 근거로 설명하는 것이에요. 작은 성공을 확인한 뒤 자신이 궁금한 기능으로 분석 범위를 넓혀보세요.

REA 설치 방법｜GitHub 공식 경로로 맥·윈도우에서 시작하기