01 / 설치 / 읽는 시간: 6분
코딩 에이전트용 REA 설치
Claude Code, Codex 또는 Cursor를 선택하고 REA 설정 명령을 복사해 연결을 확인하세요. 그런 다음 네이티브 디컴파일러가 필요 없는 작은 분석부터 시작하세요.
이 페이지의 내용
간단한 순서
지원되는 Node.js 릴리스를 설치하고 REA 설정을 실행해 변경 예정 내용을 검토한 뒤 코딩 에이전트를 다시 시작하세요. 그런 다음 작은 로컬 대상 하나를 분석해 달라고 요청하세요.
01. 시작하기 전에
터미널, npm, 로컬 MCP를 지원하는 코딩 에이전트가 필요합니다. 이 가이드는 Claude Code, Codex, Cursor를 다룹니다. 소유하거나 분석 권한이 있는 소프트웨어를 사용하세요.
node --version
npm --versionREA가 현재 지원하는 버전은 Node.js 22.x의 22.19 이상, 24.x의 24.11 이상 또는 26 이상입니다. 23, 25 및 프리릴리스 버전은 지원 범위 밖입니다. 필요하다면 다음에서 호환되는 릴리스를 받으세요: Node.js 공식 사이트.
이 사이트의 예제 검증은 macOS arm64에서 Node.js 22.23.1과 REA 6.4.0으로 실행했습니다. 추가 엔진의 플랫폼 지원은 서로 다르므로 공식 설치 참조 문서 내용을 분석 대상에 맞게 확인하세요.
02. 코딩 에이전트 연결하기
클라이언트를 선택하면 해당 클라이언트용 설정 명령이 표시됩니다. ‘설정 중 선택’은 대화형 클라이언트 선택을 엽니다.
npx rea-agents@latest setup- 명령을 실행하세요. npm이 먼저 패키지 다운로드 여부를 물을 수 있습니다.
- REA가 제안하는 클라이언트 설정 파일, 대응하는 스킬 지침, 선택 사항인 엔진 설정을 검토하세요.
- 원하는 변경을 승인하세요. 첫 대상이 JavaScript라면 네이티브 엔진 없이 시작할 수 있습니다.
- 코딩 에이전트를 다시 시작하거나 다시 연결하세요. 그러면 새 MCP 서버를 불러옵니다.
설정은 MCP 등록과 해당 작업 지침을 모두 설치합니다. 스킬만 설치해서는 도구가 연결되지 않습니다.
에이전트에 요청하고 싶다면?
npx rea-agents@latest setup으로 이 코딩 에이전트에 REA를 설치하세요. 적용 전에 변경 예정인 설정을 보여 주세요. 그다음 다시 시작하는 방법과 연결을 확인하는 방법을 알려 주세요. 첫 분석 대상은 로컬 JavaScript 패키지입니다.03. 연결 확인하기
다시 시작한 뒤 에이전트에 REA 도구가 보이는지 물어보세요. 첫 튜토리얼에서는 다음 도구를 호출할 수 있어야 합니다: analyze_javascript_application.
현재 세션에서 REA의 analyze_javascript_application 도구를 사용할 수 있는지 확인하세요. 사용할 수 있다면 필요한 로컬 경로를 알려 주세요. 도구가 없다면 분석을 실행한 척하지 말고 없다고 보고하세요.터미널에서도 클라이언트 설정을 확인할 수 있습니다. 클라이언트에 맞게 codex 대신 claude_code 또는 cursor 중 해당하는 값을 사용하세요.
npx -y rea-agents@latest doctor --client codex --json설정이 정상인 것과 실제로 연결된 것은 다릅니다. Doctor는 등록과 사전 요구 사항을 확인합니다. 다시 시작한 에이전트에서 도구를 성공적으로 호출해야 전체 연결 경로를 검증할 수 있습니다.
04. 대상에 필요한 도구 추가하기
분석하려는 소프트웨어 종류부터 확인하세요. 모든 분석 엔진을 설치할 필요는 없습니다.
| 대상 | 준비할 항목 | 시작 가이드 |
|---|---|---|
| JavaScript / Electron | Node.js, npm, 로컬 패키지 파일 | 첫 분석 |
| 네이티브 바이너리 | 지원되는 Ghidra, Hopper 또는 IDA 설치본 | 공식 네이티브 가이드 |
| Android APK | JDK와 REA가 요구하는 헤드리스 JADX 브리지 | 공식 Android 참조 문서 |
| 브라우저 동작 | Chrome 계열 브라우저와 명시적으로 설정한 디버깅 연결 | 공식 브라우저 가이드 |
상용 엔진에는 별도 라이선스가 필요합니다. REA는 엔진 라이선스를 제공하지 않습니다. 엔진을 추가하기 전에 공식 플랫폼 요구 사항을 확인하세요.
05. 문제가 생겼을 때
에이전트에 REA가 보이지 않음
먼저 클라이언트를 다시 시작하세요. 도구가 여전히 없다면 위의 해당 클라이언트용 doctor 명령을 실행하세요. 적용하지 않고 설정 복구 계획만 확인할 수도 있습니다:
npx rea-agents@latest setup --client codex --dry-run --json계획을 검토한 뒤 적용하려면 같은 설정 명령에서 다음 옵션을 빼고 실행하세요: --dry-run --json 옵션을 제외하면 됩니다. 설정 변경 후 다시 시작하세요.
‘rea: command not found’
프로젝트 로컬 npm 설치로는 rea 명령이 전역 셸 경로에 추가되지는 않습니다. 이 가이드의 npx 명령은 전역 설치 없이 동작합니다. 계속 사용할 CLI를 설치하려면 다음을 실행하세요:
npm install --global rea-agents
rea --version엔진 검사 실패
네이티브 엔진이 없어도 관련 없는 JavaScript 정적 분석은 가능합니다. 분석 대상에 필요한 프로바이더를 확인하세요. 큰 네이티브 바이너리는 공식 문서의 엔진별 시작 시간 제한 지침을 참조하세요.
06. 클라이언트 등록 최신 상태 유지하기
npx 기반 설정이라면 최신 설정을 다시 실행하고 변경 사항을 검토한 다음 클라이언트를 다시 시작하세요:
npx rea-agents@latest setup전역 CLI를 사용한다면 다음 명령을 실행하세요: rea update. 그다음 안내되는 설정 갱신 절차를 따르세요. GitHub에 새 지침이 올라왔다고 실행 중인 MCP 서버가 자동으로 갱신되지는 않습니다.
출처: REA 설치 참조 문서, 공식 README 및 로컬에서 확인한 REA 6.4.0 CLI 도움말을 참조했습니다. 검토일은 2026년 10월 12일입니다. 원본 저장소의 main에는 npm 릴리스보다 새로운 기능이 설명되어 있을 수 있습니다.